사우디 출시를 위한 +966 인증 코드 프로그램 방식 수신

+966 활성화 한 건은 API에서 어떻게 보이나요?

이 페이지를 읽는 분 대부분은 SMS 인증 API를 테스트 스위트나 사내 도구에 연결하려는 분이므로 호출부터 시작합니다. 모든 엔드포인트는 https://otproute.com/api/v1 아래에 있으며, 개발자 콘솔에서 만든 or_live_ 접두어의 Bearer 키가 필요합니다.

1. GET /api/v1/countries와 GET /api/v1/services로 id를 확인합니다. 사우디아라비아는 sa입니다.
2. GET /api/v1/prices?country=sa&service=<id>는 해당 조합의 실시간 요금을 반환합니다. 테스트 실행 기록 옆에 남겨 두세요.
3. POST /api/v1/activations에 {"service": "<id>", "country": "sa"}를 보내면 활성화 id와 +966 번호가 반환됩니다.
4. 테스트가 앱에 번호를 입력하면 코드가 이벤트로 오거나 GET /api/v1/activations/{id}로 조회됩니다.
5. 테스트를 중단하면 POST /api/v1/activations/{id}/cancel로 해제하고 지갑에 환불받습니다.

GET /api/v1/balance는 사전 점검에 유용해서, 야간 작업이 실행 도중이 아니라 처음에 명확한 메시지와 함께 실패하게 해 줍니다. 계획할 때 염두에 둘 한도는 계정당 키 10개, 웹훅 엔드포인트 5개, 분당 요청 300건입니다.

웹훅 수신기는 사우디 OTP 이벤트를 어떻게 처리해야 하나요?

엔드포인트를 등록하고 activation.sms_received, activation.expired, activation.cancelled를 구독하세요. 모든 요청에는 t=<unix>,v1=<hex> 형식의 X-OTPRoute-Signature가 포함됩니다.

• 서명 대상 문자열을 <t>.<raw body>로 재구성하고 해당 엔드포인트의 시크릿으로 HMAC-SHA256을 계산합니다.
• v1과 상수 시간 함수로 비교하고, 타임스탬프가 너무 오래된 요청은 거부합니다.
• 각 이벤트는 활성화 id를 키로 처리해, 재전송되어도 아무것도 두 번 갱신되지 않게 합니다.
• 2xx로 빠르게 응답하고 느린 작업은 백그라운드 작업으로 넘깁니다.

인바운드 연결을 받을 수 없는 러너에서는 폴링도 여전히 유효한 대안입니다. 더 자세한 내용은 웹훅 기반 OTP 수신과 HMAC으로 OTP 웹훅 보호하기 글에서 다룹니다.

제품 팀이 +966 번호로 테스트하는 이유는 무엇인가요?

사우디아라비아는 걸프 지역에서 규모가 큰 디지털 시장 중 하나이며, 이 페이지를 찾는 팀에는 현실적인 이유가 있습니다. 사우디 거주자를 위한 온보딩을 준비하는 핀테크, 걸프 지역 판매자를 받는 마켓플레이스, 고객이 지역 로그인 점검을 요구하는 SaaS 업체, 리야드나 제다 사무소의 비즈니스 계정을 관리하는 운영 팀 등입니다. 어느 경우든 실제 사우디 인증 번호로 흐름이 작동함을 증명해야 하며, 게이트웨이를 통한 OTP 라우팅을 쓰면 SIM 카드를 현지로 보내지 않아도 됩니다. 이 시나리오는 핀테크 온보딩 페이지에 더 자세히 설명되어 있습니다.

사우디 경로에서 어떤 서비스가 코드를 받을 수 있나요?

사우디아라비아의 실시간 스냅샷에는 1,000개가 넘는 서비스가 포함됩니다. 자주 쓰이는 서비스로는 Snapchat, WhatsApp, X (Twitter), Uber, TikTok, Instagram, Google (Gmail & YouTube), Telegram, Amazon, Microsoft & Outlook, LinkedIn, Discord, Netflix가 있습니다. Snapchat과 X는 왕국 내 이용자층이 특히 커서 현지화 체크리스트에 자주 오릅니다. 재고는 하루 중에도 바뀌므로 실행 시점에 API를 조회하세요.

+966 번호는 어떻게 포맷하고 아랍어 메시지는 어떻게 파싱하나요?

사우디 휴대전화 번호는 국내에서 트렁크 0을 붙여 보통 05 뒤에 8자리로 씁니다. 국제 형식에서는 이 0을 빼고 +966 5와 나머지 8자리가 됩니다. 입력 시점에 모든 번호를 E.164로 정규화하고, 사용자가 국가 코드 뒤에 0을 입력하면 제거하세요.

공용어는 아랍어이므로 인증 문자는 아랍어, 영어, 또는 둘 다로 올 수 있습니다. 아랍어는 오른쪽에서 왼쪽으로 쓰며, 일부 템플릿은 서양 숫자 대신 아랍-인도 숫자를 쓸 수 있습니다. 매칭 전에 이 숫자를 ASCII로 변환하고 원본 UTF-8을 로그로 남기는 파서라면 짜증 나는 유형의 오탐 실패를 피할 수 있습니다.

코드를 다루지 않는 사람을 위한 대시보드 방법이 있나요?

네. OTP Route에 로그인해 OTP Gateway를 열고 사우디아라비아와 서비스를 선택한 다음 가격을 확인하고 주문하세요. 번호가 바로 나타나며 코드는 도착하는 대로 옆에 표시됩니다. 지원 담당자는 이 방법으로 고객의 가입 문제를 몇 분 안에 재현할 수 있습니다.

코드가 오지 않으면 어떻게 하나요? 장기 회선과 결제는요?

20분 안에 SMS가 오지 않거나 직접 취소하면 전액이 자동으로 지갑에 돌아갑니다. 창이 끝날 때까지 기다리고, 나중에 다시 시도하거나 다른 서비스 경로를 쓰고, 서비스가 가상 번호를 허용하는지 확인하고, 짧은 간격으로 반복 주문하는 것은 피하세요.

셀프서비스 방식의 사우디 장기 번호는 없습니다. 전용 가상 번호(Dedicated Virtual Number)는 월 $1.95부터 미국과 캐나다에서만 제공됩니다. 장기 +966 회선이 필요하면 [email protected]으로 이메일을 보내 주세요. 가능 여부는 현지 규정에 달려 있다는 점을 감안해 주세요.

결제는 선불 USD 지갑 하나로 하며, 사용한 만큼 지불하고 월 이용료는 없습니다. 충전은 카드와 USDT/USDC 모두 가능하고, 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 개발 계정은 요청 시 샌드박스로 전환해 시뮬레이션 번호와 코드를 받을 수 있습니다. 현재 요금은 요금 페이지를 확인하세요.

자주 묻는 질문

API로 사우디 SMS OTP를 받으려면 어떻게 하나요?

국가 sa와 서비스 id로 활성화를 만든 뒤, activation.sms_received 웹훅으로 코드를 받거나 활성화를 폴링하세요.

코드가 실패하면 테스트용 +966 번호에도 요금이 청구되나요?

아니요. 코드가 오지 않으면 20분 창이 닫히거나 취소할 때 전액이 지갑으로 돌아갑니다.

현지 SIM 없이 내 앱의 사우디 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway가 코드 하나를 받을 수 있는 +966 번호를 발급하며, 이를 앱에 입력하고 대시보드나 API로 확인하면 됩니다.

05XXXXXXXX로 입력된 사우디 휴대전화 번호는 어떻게 저장해야 하나요?

트렁크 0을 빼고 E.164 형식의 +966 5와 나머지 8자리로 저장하세요.

나중 로그인을 위해 같은 사우디 번호를 계속 쓸 수 있나요?

셀프서비스 상품으로는 불가능합니다. 장기 전용 번호는 미국과 캐나다에서만 제공되기 때문입니다. 사우디 회선이 필요하면 팀에 이메일을 보내 주세요. 제공 가능하다는 보장은 없습니다.

실제 비용이 들기 전에 사우디 흐름을 미리 시험해 볼 방법이 있나요?

네. 개발 계정에서 샌드박스 모드를 요청하면 웹훅을 포함해 시뮬레이션 번호와 코드를 받을 수 있습니다.

OTP Route는 어떤 용도를 허용하나요?

본인의 정당한 제품과 계정의 테스트 및 운영입니다. 모든 서비스의 약관을 따라야 하며 OTP Route 이용 정책(Acceptable Use Policy)이 적용됩니다.

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