한국어
QA, 출시, OTP 라우팅을 위한 콜롬비아 인증 번호
네, OTP Route를 사용하면 일회성 가입이나 로그인 확인을 위한 콜롬비아(+57) 인증번호를 대시보드에서 받거나 REST API와 서명된 웹훅으로 받을 수 있습니다. OTP Gateway 요금은 $0.20/코드부터이며, 20분 유효 시간 안에 SMS가 실제로 도착한 경우에만 비용을 내면 됩니다. 현지 SIM 카드를 구입하지 않고도 콜롬비아 시장용 스페인어 온보딩을 테스트하는 데 활용할 수 있습니다.
콜롬비아 SMS OTP 코드를 받는 API 호출 네 번
콜롬비아 OTP API 연동에 필요한 요청은 몇 개뿐입니다. 먼저 GET /api/v1/prices?country=co&service=whatsapp로 경로가 열려 있는지 확인하세요. 서비스 ID는 테스트 중인 서비스로 바꾸면 되며, 응답에는 해당 조합의 실시간 가격이 담겨 있습니다. 다음으로 서비스와 국가 co를 지정한 JSON 본문과 함께 POST /api/v1/activations로 주문을 만듭니다. 그러면 activation id와 테스트 중인 앱에 입력할 +57 번호가 반환됩니다.
그다음 메시지를 기다립니다. 대부분의 팀은 웹훅 엔드포인트를 등록해 activation.sms_received를 수신하고, 일부는 GET /api/v1/activations/{id}를 느긋한 간격으로 호출합니다. 마지막으로 정리 단계입니다. 테스트 방향이 바뀌었다면 POST /api/v1/activations/{id}/cancel로 예약된 금액을 해제하세요. 각 요청의 자세한 내용은 개발자 문서에 있습니다.
현재 콜롬비아 경로에서 쓸 수 있는 앱은 무엇인가요?
콜롬비아 OTP 라우팅은 최신 스냅샷 기준 1,900개가 넘는 서비스를 지원합니다. 자주 요청되는 서비스로는 WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal, Netflix 등이 있습니다. 용량은 하루 중에도 달라지므로, 정기 테스트는 하드코딩한 목록을 믿지 말고 GET /api/v1/services와 가격 엔드포인트로 지금 열려 있는 서비스를 확인해야 합니다.
E.164 저장을 위한 +57 휴대폰 번호 형식
콜롬비아 휴대폰 번호는 국가 코드 뒤에 10자리가 오고 3으로 시작하므로 E.164 형태는 +57 3XX XXX XXXX입니다. 국내에서는 앞에 0 없이 걸기 때문에 정규화는 간단합니다. 공백, 대시, 괄호를 지우고 더하기 기호와 57을 유지한 채 표준 문자열 하나로 저장하세요. 클라이언트 쪽에서 맨 앞 3을 검사해 두면, 유선 전화번호를 붙여 넣은 테스터가 SMS 단계에서 아무 말 없이 실패하는 대신 명확한 안내 메시지를 볼 수 있습니다.
QA 팀은 왜 콜롬비아 시장을 찾을까요?
콜롬비아는 스페인어권에서 규모가 큰 시장 중 하나이며, 많은 중남미 출시가 이곳이나 인근에서 시작됩니다. 인증 문자는 보통 스페인어로 오므로, 현지화 점검에서는 자사 템플릿이 자연스럽게 읽히는지, 악센트 문자가 인코딩 후에도 유지되는지, 긴 문장 속에서도 숫자가 눈에 잘 띄는지를 확인해야 합니다. 이 지역의 차량 호출, 배달, 결제, 마켓플레이스 제품은 모두 전화번호 확인에 의존하기 때문에, 테스트용 +57 번호는 출시 체크리스트에 계속 등장합니다. QA 테스트 페이지에는 어떤 SMS 인증 API에서도 통하는 패턴이 정리되어 있습니다.
+57 코드가 늦어요. 이제 어떻게 하죠?
각 활성화는 20분 동안 유지됩니다. SMS 없이 유효 시간이 끝나거나 먼저 취소하면 결제 금액 전액이 자동으로 지갑에 돌아오고, 엔드포인트로는 activation.expired 또는 activation.cancelled가 전달됩니다. 다시 시도하기 전에 다음을 확인하세요.
- 테스트 중인 앱이 가상 번호를 허용하는지 확인합니다.
- 새 주문을 쌓지 말고 현재 유효 시간이 끝날 때까지 기다립니다.
- 짧은 간격으로 반복 주문하지 말고 재시도 간격을 둡니다.
- 나중 시간대에 다시 시도하거나, 같은 서비스에 다른 경로를 써 봅니다.
각 단계의 이유는 OTP 전송 실패 줄이기 글에서 설명합니다.
콜롬비아 회선을 몇 달씩 유지할 수 있나요?
셀프서비스로는 불가능합니다. 문자 수신·발신과 브라우저 통화가 포함된 전용 가상 번호(Dedicated Virtual Numbers)는 미국과 캐나다에서만 판매되며 월 $1.95부터 시작합니다. 대시보드에서 장기 +57 회선을 구입할 수는 없습니다. 운영상 필요하다면 [email protected]으로 문의하세요. 가능 여부는 현지 규정에 따라 달라지며 미리 약속할 수는 없습니다.
콜롬비아 인증 요금은 어떻게 결제하나요?
OTP Route는 월 요금이나 선택할 요금제 없이 선불 USD 지갑으로 운영됩니다. 카드 또는 USDT/USDC 스테이블코인으로 충전할 수 있고, 충전할 때마다 재무 담당자가 PDF 인보이스를 이메일로 받습니다. 콜롬비아 경로는 $0.20/코드부터 시작하며 서비스에 따라 다르고, 확정 전에 정확한 금액이 표시됩니다. 연동 작업 중에는 지원팀에 요청해 개발 계정을 샌드박스로 전환할 수 있으며, 시뮬레이션 번호와 코드로 지갑 잔액을 쓰지 않고 전체 흐름을 미리 연습할 수 있습니다. 현재 요금은 요금 페이지에서 확인하세요.
자주 묻는 질문
현지 SIM 없이 앱의 콜롬비아 가입 절차를 테스트할 수 있나요?
네. 확인하려는 서비스용 +57 번호를 주문해 가입 양식에 입력하고, 대시보드나 웹훅에서 코드를 읽으면 됩니다. 실물 SIM을 배송하거나 개통할 필요가 없습니다.
대시보드에서 콜롬비아 인증 번호는 어떻게 주문하나요?
로그인한 뒤 OTP Gateway를 열고 서비스와 콜롬비아를 선택한 다음 가격을 확인하고 주문을 확정하세요. 화면에 번호가 표시되고, SMS가 도착하면 그 옆에 코드가 나타납니다.
API에서 콜롬비아의 국가 ID는 무엇인가요?
country 필드와 가격 조회에 co를 사용하세요. 서비스 ID는 GET /api/v1/services에서 가져오며, 예를 들면 telegram이나 uber입니다.
코드가 오지 않는 +57 번호에도 요금을 내야 하나요?
아니요. SMS 없이 20분 유효 시간이 끝나거나 취소하면 결제 금액 전액이 자동으로 지갑에 돌아옵니다.
콜롬비아 인증 SMS는 어떤 언어로 오나요?
발신처에 따라 다르지만 콜롬비아 사용자는 대체로 스페인어 템플릿을 받습니다. 템플릿은 예고 없이 바뀌므로 고정된 문구를 매칭하지 말고 숫자를 추출하세요.
CI 파이프라인이 스스로 콜롬비아 SMS OTP 코드를 받을 수 있나요?
네. 파이프라인에서 활성화를 만들고 웹훅을 기다리거나 활성화 상태를 폴링한 뒤 코드를 테스트에 넘기면 됩니다. 타임아웃과 정리 방법은 CI에서의 OTP 테스트 글에서 다룹니다.
웹훅이 정말 OTP Route에서 온 것인지 어떻게 확인하나요?
모든 요청에는 X-OTPRoute-Signature가 포함되며, 여기에는 타임스탬프와, 타임스탬프·점·원본 본문을 엔드포인트 시크릿으로 계산한 HMAC-SHA256이 들어 있습니다. 이를 다시 계산해 상수 시간으로 비교하고, 오래된 타임스탬프는 버리세요.
+57 번호로 인증할 수 있는 대상에 제한이 있나요?
네. 번호는 자사 제품과 합법적인 비즈니스 계정에만 사용하고, 각 서비스의 약관을 따르며, 모든 주문에 OTP Route 이용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.