QA·출시 팀을 위한 엘살바도르(+503) 인증 코드

일회용 코드와 장기 회선 중 엘살바도르 테스트에는 무엇이 필요한가요?

테스트의 형태부터 정하세요. 그것이 상품을 결정합니다.

• 단일 인증 단계(가입, 전화번호 변경, 추가 인증 확인)는 OTP Gateway에 해당합니다. 한 서비스용 +503 번호를 주문하면 코드가 한 번 도착하고 번호의 역할은 끝납니다.
• 몇 주 동안 계속 로그인해야 하는 계정에는 직접 보유하는 회선이 필요합니다. 전용 번호(Dedicated Numbers)는 미국·캐나다 전용 상품으로 월 $1.95부터이며, 대시보드에서 즉시 구매할 수 있고 수신 SMS, 발신 SMS, 브라우저 통화를 지원합니다.

엘살바도르에는 셀프 서비스 전용 번호가 없습니다. 팀에 장기 엘살바도르 회선이 정말 필요하다면 [email protected]으로 이메일을 보내세요. 제공 가능 여부는 현지 규정에 따라 다르며 보장되지 않습니다. 많은 팀은 테스트 대상 서비스가 허용한다면 "반복 로그인" 사례를 미국 회선으로 해결합니다. 엘살바도르 출시에서는 임시 번호와 전용 번호 비교의 설명을 참고해 두 가지 경로를 비교해 보세요.

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

엘살바도르는 트렁크 접두사가 없는 8자리 폐쇄형 번호 체계를 사용합니다. 현지 사람이 양식에 쓰는 번호는 국제적으로 +503 뒤에 오는 8자리와 같으므로, 정규화는 대부분 구두점을 제거하는 일입니다. 현지에서는 휴대폰 번호를 하이픈으로 구분한 4자리 두 블록으로 쓰는 경우가 많습니다.

• E.164 형식인 +503 뒤에 8자리를 붙여 하나의 열에 저장하세요.
• 휴대폰 번호는 보통 6 또는 7로 시작하고, 유선 번호는 보통 2로 시작합니다. 이 숫자들로 시작하는 번호만 받는 검증기는 대부분의 오타를 잡아냅니다.
• 앞에 붙은 0은 거부하세요. 다른 라틴 아메리카 번호 체계에 익숙한 사용자가 0을 붙이는 경우가 있으며, 일부 SMS 플랫폼은 그런 메시지를 조용히 버립니다.

이 시장을 위한 앱의 SMS 템플릿은 보통 스페인어입니다. á, í, ó 같은 문자는 기본 GSM 알파벳에 없으므로 이를 쓰는 템플릿은 UCS-2 인코딩으로 바뀌어 세그먼트당 길이가 짧아질 수 있습니다. 메시지가 분할되더라도 살아남도록 코드를 메시지 앞쪽에 두세요.

엘살바도르에서 가입 흐름을 테스트하는 이유는 무엇인가요?

몇 가지 패턴이 반복해서 나타납니다.

• 중미 출시. 과테말라, 온두라스, 엘살바도르에 걸쳐 출시되는 제품은 광고를 시작하기 전에 각 나라의 전화번호 단계를 점검하고 싶어 합니다.
• 해외 거주 고객. 많은 엘살바도르 사람들이 미국에 살면서 가족과의 연락을 위해 +503 번호를 유지하므로, 송금·결제·메시징 제품은 사용자의 주소가 미국이어도 엘살바도르 번호를 접하게 됩니다. 해당 흐름은 핀테크 온보딩을 참고하세요.
• 현지화 QA. 스페인어 문구, 국가 선택기, 번호 마스크는 모두 실제 엘살바도르 코드로 화면이 처음부터 끝까지 작동하는지 확인해야 합니다.
• 미국 달러 가격. 미국 달러가 엘살바도르의 공식 통화이므로 이 시장은 결제와 온보딩을 함께 테스트하기에 편리합니다.

엘살바도르 OTP API 호출 순서는 어떻게 되나요?

모든 요청은 Developer console에서 생성한 or_live_ 접두사의 Bearer 키(최대 10개, 분당 300건)로 https://otproute.com/api/v1에 보냅니다. 엘살바도르의 국가 id는 sv입니다.

1. GET /api/v1/countries와 GET /api/v1/services를 호출해 id를 캐시합니다.
2. GET /api/v1/prices?country=sv&service=<id>로 실시간 가격을 확인합니다. 지금 경로를 쓸 수 있는지도 알려 줍니다.
3. {"service": "telegram", "country": "sv"} 같은 본문으로 POST /api/v1/activations를 호출해 주문합니다. activation id와 번호를 저장합니다.
4. 앱의 엘살바도르 빌드가 그 번호로 인증 SMS를 보내게 합니다.
5. 엔드포인트로 오는 activation.sms_received 이벤트를 기다리고, 없으면 몇 초마다 GET /api/v1/activations/{id}를 폴링합니다.
6. 흐름을 중단하면 POST /api/v1/activations/{id}/cancel을 호출해 자금이 바로 돌아오게 합니다.

모든 웹훅에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함되며, 이는 엔드포인트 시크릿으로 타임스탬프, 점, 원본 본문에 대해 계산한 HMAC-SHA256입니다. 이를 검증하고 오래된 타임스탬프는 버리세요. OTP 웹훅 보호하기에서 방법을 설명합니다. 비개발자는 대시보드에서 같은 일을 할 수 있습니다. 엘살바도르와 서비스를 선택하고, 실시간 가격을 확정하고, activation 카드에 코드가 나타나는 것을 보면 됩니다.

엘살바도르 번호로는 어떤 서비스를 인증할 수 있나요?

실시간 스냅샷에는 엘살바도르 경로가 있는 서비스가 900개가 넘습니다. 인기 서비스로는 WhatsApp, Facebook, Instagram, TikTok, Uber, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Telegram, Signal, LinkedIn, ChatGPT (OpenAI)가 있습니다. 가용 상태는 하루 동안 바뀌므로 테스트 러너는 고정된 목록이 아니라 가격 엔드포인트를 기준으로 동작해야 합니다.

일부 서비스는 가상으로 분류한 번호를 거부합니다. 이는 저희가 통제할 수 없는 부분이며, 바로 그 때문에 환불 규칙이 있습니다.

엘살바도르 코드가 도착하지 않으면 어떻게 하나요?

+503 코드가 느리다고 해서 아직 실패한 것은 아니므로 주문을 20분 내내 열어 두세요. 아무것도 오지 않으면 주문이 만료되고 activation.expired가 발생하며 전액이 자동으로 지갑에 환불됩니다. 그다음에는 다음을 확인하세요.

• 서비스가 이런 종류의 단계에서 가상 번호를 허용하는지 확인합니다.
• 짧은 간격으로 재주문을 반복하지 말고, 나중에 다시 시도하거나 다른 서비스 경로를 선택합니다.
• 앱이 반환된 정확한 번호로, E.164 형식으로 SMS를 실제로 보냈는지 확인합니다.

중미 지역에 맞는 추가 문제 해결 방법은 OTP 전달 실패 줄이기에 있습니다.

엘살바도르 주문의 결제는 어떻게 처리되나요?

OTP Route는 월 이용료도 선택할 요금제도 없이 사용한 만큼 내는 선불 USD 지갑 하나를 사용합니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하며, 충전이나 번호 구매 후마다 PDF 인보이스가 받은편지함에 도착합니다. 연동 작업에는 요청 시 개발 계정을 샌드박스로 전환할 수 있어, 시뮬레이션된 번호와 코드가 반환되므로 지갑 잔액을 쓰지 않고 전체 과정을 실행할 수 있습니다. 현재 요금은 요금 페이지에 있습니다.

자주 묻는 질문

현지 SIM 없이 앱의 엘살바도르 가입을 테스트할 수 있나요?

네. 테스트하려는 서비스용 +503 번호를 OTP Gateway에서 주문하고, SMS를 발생시킨 다음 대시보드나 API에서 코드를 읽으세요.

엘살바도르 번호에도 0 같은 트렁크 접두사가 있나요?

아니요. 엘살바도르 번호는 트렁크 접두사가 없는 8자리이므로 국제 형식은 +503 뒤에 8자리가 이어집니다.

OTP Route API에서 엘살바도르의 국가 id는 무엇인가요?

가격 조회와 activation 본문에 sv를 사용하세요. 예: GET /api/v1/prices?country=sv&service=<id>.

+503 번호로 코드가 오지 않으면 요금이 청구되나요?

아니요. 20분 제한 시간 안에 SMS가 도착하지 않거나 먼저 취소하면 전액이 자동으로 지갑에 환불됩니다.

반복 로그인을 위해 엘살바도르 번호를 유지할 수 있나요?

셀프 서비스 상품으로는 불가능합니다. 장기 전용 번호는 미국과 캐나다에서 제공되며, 엘살바도르는 [email protected]으로 문의하실 수 있지만 제공을 약속하지는 않습니다.

OTP Route는 계정을 대량으로 만드는 용도인가요?

아니요. 자사의 정당한 제품과 계정을 테스트하고 운영하기 위한 서비스이며, 각 서비스의 약관과 OTP Route 이용 정책을 따라야 합니다.

비용을 쓰지 않고 CI에서 엘살바도르 흐름을 실행할 수 있나요?

네. 요청하면 개발 계정을 샌드박스로 전환할 수 있으며, 시뮬레이션된 번호와 코드가 반환되어 파이프라인이 전체 API 경로를 시험할 수 있습니다.

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