API로 라우팅하는 QA·출시 팀용 칠레 인증 코드

칠레 테스트에는 게이트웨이 번호와 전용 번호 중 무엇이 필요한가요?

선택은 질문 하나로 정해집니다. 이 +56 번호로 나중에 다시 코드를 받아야 하는 사람이 있을까요? 가입 테스트, 일회성 온보딩 확인, 비즈니스 프로필 확인 같은 대부분의 칠레 작업에서는 답이 '아니요'이고, 이때는 OTP Gateway가 맞습니다. 번호 하나가 코드 한 건을 받으면 작업이 끝납니다.

계속 보유하는 칠레 회선은 다른 상품이며, 셀프서비스로 판매하지 않습니다. OTP Route의 전용 번호(Dedicated Numbers)는 미국과 캐나다에만 있으며 월 $1.95부터 시작합니다. 팀에 오래 쓸 +56 회선이 정말 필요하다면 [email protected]으로 이메일을 보내 사용 사례를 설명해 주세요. 마련할 수 있는지는 현지 규정에 따라 다르므로, 답이 '아니요'일 수 있다고 생각하고 계획하세요.

• 코드가 한 번만 필요할 때는 OTP Gateway를 쓰세요. 가입 회귀 테스트, 칠레 릴리스 전 스모크 테스트, 계정 확인 한 건이 그런 경우입니다.
• 공용 스테이징 로그인이 계속 코드를 받아야 하고 계정에 칠레 신원이 필요 없다면 미국 또는 캐나다 전용 번호를 쓰세요.

장단점은 임시 번호와 전용 번호 글에서 더 깊이 설명합니다.

칠레 OTP API는 주문부터 코드까지 어떻게 동작하나요?

SMS 인증 API는 https://otproute.com/api/v1 아래의 일반적인 REST이며, 개발자 콘솔에서 만든 or_live_로 시작하는 Bearer 키로 인증합니다. 칠레의 국가 ID는 cl입니다.

1. GET /api/v1/services를 호출해 테스트에서 쓰는 서비스 ID(예: whatsapp, uber)를 캐시합니다.
2. 비용을 하드코딩하지 말고 GET /api/v1/prices?country=cl&service=<id>에서 현재 금액을 읽습니다.
3. {"service": "whatsapp", "country": "cl"} 같은 본문으로 POST /api/v1/activations를 호출해 주문합니다. 응답에는 +56 번호와 활성화 ID가 들어 있습니다.
4. 그 번호를 테스트 대상 흐름에 입력하고 SMS를 발송시킵니다.
5. GET /api/v1/activations/{id}를 폴링하거나, activation.sms_received 웹훅이 알려 주게 하세요.
6. 실행을 중단한다면 POST /api/v1/activations/{id}/cancel을 보내 지갑에 곧바로 환불되게 합니다.

웹훅 전송은 서명됩니다. X-OTPRoute-Signature 헤더에는 엔드포인트 시크릿을 키로 <t>.<raw body>에 HMAC-SHA256을 적용한 t=<unix>,v1=<hex>가 들어 있습니다. 손대지 않은 요청 바이트로 다시 계산해 상수 시간으로 비교하고, 오래된 타임스탬프는 버리며, 활성화 ID를 멱등성 키로 취급해 반복된 이벤트가 아무것도 바꾸지 않게 하세요. 계정당 API 키 최대 10개, 웹훅 엔드포인트 5개, 분당 300건의 요청이 허용됩니다. OTP API 연동 가이드에서는 이 루프에 재시도와 오류 처리를 더합니다.

테스트용 +56 번호로 코드를 보낼 수 있는 앱은 무엇인가요?

칠레 경로는 현재 1,800개 넘는 서비스에 닿습니다. QA 팀이 가장 자주 찾는 서비스로는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Uber, Microsoft & Outlook, Amazon, LinkedIn, ChatGPT (OpenAI), Discord, Netflix가 있습니다.

재고는 하루 중에도 움직이므로 이 목록을 포함한 어떤 목록이든 스냅샷으로 보세요. 예약된 작업 전에 GET /api/v1/countries와 가격 엔드포인트로 cl에서 무엇이 가능한지 확인하고, 조합이 없으면 테스트 스위트 중간에 빈틈을 발견하는 대신 정상적으로 건너뛰세요.

+56 번호는 어떻게 저장하고 검증해야 하나요?

칠레 휴대폰 번호는 +56 국가 코드 뒤에 9자리이며 9로 시작하므로, E.164의 전체 휴대폰 번호는 +569 뒤에 8자리가 더 붙은 형태입니다. 현재 칠레 번호는 국내에서도 +56 뒤에 오는 것과 같은 9자리로 쓰기 때문에 정규화가 짧게 끝납니다.

그래도 사용자는 번호를 세 가지 방식으로 입력합니다. 공백과 플러스 기호를 포함하거나, 플러스 없이 56에 국내 숫자를 붙이거나, 현지 9자리만 입력하는 식입니다. 표준 E.164 문자열 하나를 저장하고, 지원 티켓을 위해 원본 입력도 옆에 보관하며, 세 가지 형태 모두에 테스트 케이스를 추가하세요. 폼 단계에서 8자리 입력을 거부하면 도착할 일이 없는 SMS를 아낄 수 있습니다.

제품 팀이 칠레 가입 흐름을 검증하는 이유는 무엇인가요?

칠레는 중남미로 확장하는 제품이 자주 거치는 초기 기착지이며, 사용자는 스페인용으로 현지화된 문구보다 이 지역에 맞게 쓴 스페인어 문구를 기대합니다. +56 번호로 오는 코드는 보통 스페인어이지만 많은 앱이 계정 로캘을 따르므로, 주변 문구와 상관없이 파서가 숫자를 뽑아내는지 확인하세요.

팀들이 칠레 점검을 하는 다른 이유로는 현지 방문자에게 전화번호 입력란의 기본값이 +56인지 확인하기, 칠레 번호에서 전체 경로가 동작하는지 입증하기, 지원·운영 직원이 개인 SIM을 빌리지 않고 비즈니스 계정을 확인하게 하기가 있습니다. QA 테스트 페이지에서 팀들이 이를 릴리스 체크리스트에 녹이는 방법을 볼 수 있습니다.

칠레 코드가 끝내 오지 않으면 어떻게 하나요?

모든 활성화는 20분 동안 열려 있습니다. 코드가 도착한 경우에만 요금을 내며, 창이 빈 채로 닫히거나 먼저 취소하면 전액이 자동으로 지갑에 환불됩니다. +56 번호가 조용하다면 다음을 확인하세요.

• 일부 발신자는 느리므로, 테스트를 실패로 표시하기 전에 창이 끝날 때까지 기다리세요.
• 해당 앱이 애초에 가상 번호를 받는지 알아보세요. 정책상 거부하는 곳도 있으며, 환불 규정이 있는 이유가 바로 이것입니다.
• 나중에 다시 시도하거나, 같은 시나리오에 다른 서비스 경로를 써 보세요.
• 재시도 간격을 두세요. 몇 초마다 새 주문을 넣으면 번호만 소모됩니다.

더 많은 문제 해결 아이디어는 OTP 전송 실패 줄이기 글에 있습니다.

요금 청구와 샌드박스 테스트는 어떻게 동작하나요?

OTP Route는 월 요금이나 선택할 요금제 없이 종량제로 쓰는 하나의 선불 USD 지갑을 사용합니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하며, 충전할 때마다 회계팀이 쓸 PDF 인보이스가 이메일로 발송됩니다.

개발하는 동안에는 개발 계정을 샌드박스로 전환해 달라고 요청하세요. 시뮬레이션된 번호와 코드가 반환되므로 지갑 자금을 쓰지 않고 칠레 흐름 전체를 실행해 볼 수 있습니다. 터미널을 열지 않는 동료는 대시보드를 쓰면 됩니다. 칠레와 서비스를 선택하고, 표시된 가격을 확인한 뒤, 번호를 복사하고 코드가 나타나는 것을 지켜보세요.

자사 제품과 계정에만 사용하고, 각 서비스의 약관을 존중하며, OTP Route의 이용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요. 계정은 몇 분 안에 만들 수 있습니다.

자주 묻는 질문

현지 SIM 카드 없이 우리 앱의 칠레 가입을 테스트할 수 있나요?

네. OTP Gateway에서 +56 번호를 주문해 가입 폼에 입력하고, 대시보드나 API로 코드를 읽으세요. 번호 하나는 코드 한 건을 받습니다.

API에서 칠레의 국가 ID는 무엇인가요?

cl을 사용하세요. 예: GET /api/v1/prices?country=cl&service=telegram.

테스트용 +56 번호는 얼마인가요?

코드당 $0.20부터이며 정확한 금액은 서비스에 따라 다르고 API가 실시간으로 반환합니다. 코드가 도착했을 때만 요금이 부과됩니다.

다음 분기에 계정이 다시 로그인할 수 있도록 칠레 번호를 계속 보유할 수 있나요?

셀프서비스로는 불가능합니다. 전용 번호(Dedicated Numbers)는 미국과 캐나다 상품이며 월 $1.95부터입니다. +56 회선은 [email protected]으로 문의하세요. 가능 여부는 현지 규정에 따라 다릅니다.

칠레 인증 문자는 어떤 언어를 쓰나요?

보통 스페인어이지만 많은 앱이 계정에서 선택한 언어로 보냅니다. 고정된 문구를 매칭하지 말고 숫자를 파싱하세요.

칠레 테스트 실행에는 폴링과 웹훅 중 어느 쪽이 나은가요?

수동 점검 한 번에는 폴링으로 충분합니다. 여러 실행이 병렬로 진행되면 활성화 ID를 기준으로 하는 서명된 웹훅이 확장하기 더 쉽습니다.

재무팀이 스테이블코인으로 결제할 수 있나요?

네. 지갑은 카드와 USDT/USDC를 지원하며, 충전할 때마다 PDF 인보이스가 제공됩니다.

서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.