+27 인증 흐름 테스트: 남아공 출시를 위한 체크리스트

첫 +27 주문 전에: 간단한 준비 목록

아래를 확인하면 첫 남아공 activation이 문제없이 진행될 가능성이 높습니다.

1. 지갑 충전. 하나의 선불 USD 지갑으로 모든 것을 결제합니다. 카드 또는 USDT/USDC로 충전하세요. 구독은 없습니다.
2. 키 발급. Developer console에서 Bearer 키(or_live_로 시작)를 생성합니다. CI용과 스테이징용 키를 따로 두세요(최대 10개).
3. 웹훅 등록. HTTPS 엔드포인트를 추가하고 서명 시크릿을 보관합니다. 최대 5개까지 등록할 수 있습니다.
4. 번호 정규화 테스트. 082 123 4567 같은 입력을 넣고 앞의 0이 제거된 +2782...가 만들어지는지 확인합니다.
5. 서비스 ID 확인. ID를 추측하지 말고 GET /api/v1/services에서 카탈로그를 가져오세요.
6. 샌드박스(선택). 지원팀이 개발 계정을 샌드박스로 전환해 주면, 실제 비용을 쓰기 전에 시뮬레이션된 번호와 코드로 코드를 검증할 수 있습니다.

이 요소들을 파이프라인에 연결하는 방법은 CI 테스트 가이드에 나와 있습니다.

남아공 번호는 어떻게 저장하고 정규화해야 하나요?

남아프리카공화국은 트렁크 접두어 0을 사용합니다. 국내 표기의 휴대전화 번호는 082 123 4567처럼 10자리이며, 휴대전화 대역은 보통 06, 07, 08로 시작합니다. 국제 형식에서는 0이 사라져 같은 회선이 +27 82 123 4567, 공백을 제거하면 +27821234567이 되며, 국가 코드 뒤에 9자리가 옵니다.

대표적인 버그는 양식이 0을 빼지 않고 국가 코드를 국내 번호에 붙여서 +270821234567 같은 값이 저장되는 것입니다. 입력 시 정규화하고, E.164만 저장하며, 공백이 들어간 국내 형식은 표시용으로만 렌더링하세요. 직접 발신 SMS를 보낸다면 같은 규칙이 전달 리포트와 사용자 조회의 일관성을 유지해 줍니다.

어떤 서비스가 남아공 인증 번호로 코드를 보낼 수 있나요?

현재 za의 인기 경로에는 WhatsApp, Facebook, Instagram, TikTok, Google(Gmail & YouTube), Uber, Telegram, Microsoft & Outlook, LinkedIn, Netflix, Amazon, X(Twitter), ChatGPT(OpenAI), Discord가 있습니다. 전체 카탈로그에서 이 나라는 1,700개 넘는 서비스를 지원하며, 재고는 하루 중 변동하므로 현재 가용성은 API에서 읽는 것이 좋습니다.

팀들이 이 시장을 고르는 이유는 무엇일까요? 요하네스버그와 케이프타운은 자리 잡은 기술·금융 거점이며, 많은 기업이 남아공을 남부 아프리카 전체 출시의 기반으로 삼습니다. 영어, 이시줄루어, 이시코사어, 아프리칸스어를 비롯한 여러 공용어가 있지만 대부분의 인증 메시지는 영어로 도착하므로, 현지화 QA는 SMS 문구보다 주변 화면에 초점을 맞추는 편입니다.

단계: 테스트 하네스에서 남아공 OTP API 호출하기

요청은 Bearer 키와 함께 https://otproute.com/api/v1로 보내며, 분당 최대 300건입니다.

1. GET /api/v1/prices?country=za&service=<id>가 원하는 조합의 실시간 가격을 반환합니다.
2. POST /api/v1/activations에 {"service": "<id>", "country": "za"}를 보내면 +27 번호가 예약되고 activation id가 반환됩니다.
3. 테스트에서 앱에 번호를 입력하고 SMS를 발생시킵니다.
4. activation.sms_received 이벤트가 웹훅으로 도착합니다. 신뢰하기 전에 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 다시 계산해 X-OTPRoute-Signature의 v1과 비교하고, 타임스탬프가 너무 오래된 요청은 버리세요.
5. 폴링을 선호하나요? 적당한 간격으로 GET /api/v1/activations/{id}를 읽으세요.
6. 중단된 실행은 POST /api/v1/activations/{id}/cancel을 호출하고, GET /api/v1/balance로 잔액이 부족하면 작업을 일찍 멈출 수 있습니다.

경로 선택에 대한 자세한 내용은 OTP 국가별 라우팅에 있습니다.

운영 담당자를 위한 대시보드 사용 단계

코드는 필요 없습니다. OTP Gateway를 열고 남아프리카공화국과 서비스를 선택한 뒤 표시된 가격을 확인하고 확정한 다음, +27 번호를 앱에 붙여 넣으세요. SMS는 도착하는 대로 activation 페이지에 표시되며, 20분 시간 창과 자동 환불은 API와 똑같이 적용됩니다.

지연되는 남아공 코드 문제 해결

먼저 비용 측면입니다. 20분 안에 SMS가 오지 않거나 취소하면 전액이 지갑으로 자동 반환됩니다. 그다음 원인을 진단하세요.

• 먼저 기다리기. 전달 속도는 서비스와 경로에 따라 다르므로 activation이 끝까지 진행되게 두세요.
• 수락 정책. 일부 서비스는 가상 번호를 거부합니다. 이 경우의 환불은 결함이 아니라 예상된 동작입니다.
• 다른 시간 또는 경로. 나중에 다시 시도하거나, 테스트 케이스가 허용한다면 나미비아나 보츠와나 같은 인접 경로를 사용하세요.
• 연타 금지. 취소와 재주문을 짧은 간격으로 반복해도 거의 도움이 되지 않으며 요청 한도만 소모합니다.

번호는 본인 제품을 테스트하거나 본인 비즈니스 계정을 운영하는 데에만 사용하고, 각 서비스의 약관을 존중하며, OTP Route의 Acceptable Use Policy가 적용된다는 점을 유념하세요.

남아공 장기 회선과 결제 모델

셀프서비스로 구매할 수 있는 장기 +27 번호는 없습니다. 월 $1.95부터 시작하는 Dedicated Number는 미국과 캐나다에서만 제공됩니다. 영구적인 남아공 회선이 필요한 팀은 [email protected]으로 이메일을 보낼 수 있으며, 가능 여부는 현지 규정에 달려 있습니다. 결제는 선불 지갑에서 사용한 만큼 내는 방식이고, 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 전체 내용은 요금 안내에서 확인하세요.

자주 묻는 질문

현지 SIM 없이 내 앱의 남아공 가입 흐름을 테스트할 수 있나요?

예. OTP Gateway로 +27 번호를 주문하고 대시보드 또는 API에서 코드를 읽으세요. 코드당 $0.20부터이며 코드가 도착했을 때만 결제됩니다.

남아공 번호를 E.164로 변환할 때 앞의 0을 유지하나요?

아니요. 트렁크 0을 제거하고 +27을 붙이면 082 123 4567은 +27821234567이 됩니다.

남아프리카공화국의 API 국가 ID는 무엇인가요?

za이며, 가격 조회와 +27 activation을 만들 때의 JSON 본문에 사용합니다.

남아공 인증 문자는 어떤 언어로 오나요?

국가에 여러 공용어가 있지만 대부분 영어입니다. 문구는 발신 서비스가 결정합니다.

코드가 전달되지 않으면 환불되나요?

예. activation은 20분간 열려 있으며, 아무것도 도착하지 않거나 취소하면 전액이 지갑으로 자동 환불됩니다.

몇 달간 유지할 남아공 번호를 구매할 수 있나요?

셀프서비스로는 불가능합니다. Dedicated Number는 미국과 캐나다 제품이며, 남아공은 지원팀에 이메일로 문의하세요. 제공 여부는 약속할 수 없습니다.

OTP Route에서 +27 번호로 몇 개의 서비스를 인증할 수 있나요?

최근 스냅샷 기준 1,700개 넘습니다. 가용성은 하루 중 변하므로 API로 실시간 카탈로그를 확인하세요.

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