QA, 핀테크, 출시 팀을 위한 나이지리아(+234) SMS 인증 API

나이지리아 OTP를 받으려면 어떤 엔드포인트를 호출해야 하나요?

모든 요청은 https://otproute.com/api/v1 아래에 있으며 or_live_로 시작하는 Bearer 키로 인증합니다. 나이지리아의 국가 ID는 ng입니다. 일반적인 연동은 네 번의 호출로 이루어집니다.

1. GET /api/v1/prices?country=ng&service=<id>로 주문 전에 현재 가격을 확인합니다.
2. POST /api/v1/activations에 {"service": "<id>", "country": "ng"}를 보내 +234 번호를 예약합니다. 반환된 활성화 ID를 보관하세요. 이후의 모든 호출과 웹훅 이벤트가 이 ID를 기준으로 연결됩니다.
3. GET /api/v1/activations/{id}로 상태를 읽고, 코드가 도착하면 코드를 확인합니다.
4. 업스트림에서 테스트가 실패해 번호가 더 이상 필요 없다면 POST /api/v1/activations/{id}/cancel을 호출합니다.

GET /api/v1/balance는 CI의 사전 점검에 유용하므로, 야간 테스트 스위트가 지갑 잔액 부족 시 곧바로 실패하도록 만들 수 있습니다. OTP API 연동 가이드에서 오류 처리를 포함한 동일한 흐름을 단계별로 살펴볼 수 있습니다.

라고스 테스트 스위트는 폴링과 웹훅 중 무엇을 써야 하나요?

수동으로 몇 번 실행하는 정도라면 폴링으로 충분합니다. 하지만 파이프라인이 +234 번호 여러 개를 병렬로 주문한다면 웹훅이 더 깔끔합니다. 5개까지 만들 수 있는 엔드포인트 중 하나를 개발자 콘솔에 등록하고 activation.sms_received, activation.expired, activation.cancelled를 구독하세요.

각 요청에는 X-OTPRoute-Signature: t=<unix>,v1=<hex> 헤더가 포함됩니다. 엔드포인트 시크릿으로 타임스탬프, 점, 원본 본문을 이어 붙인 값의 HMAC-SHA256을 다시 계산하고, 상수 시간으로 비교한 뒤, 타임스탬프가 오래된 요청은 버리세요. 처리한 활성화 ID를 저장해 두면 재전송된 이벤트가 테스트를 두 번 실행하지 않습니다. HMAC으로 OTP 웹훅 보호하기 글에 더 자세한 체크리스트가 있습니다. 계정당 전체 트래픽은 분당 300건 이내로 유지하세요. 촘촘한 폴링 대신 이벤트에 의존하면 충분히 여유 있는 수치입니다.

+234 경로에서는 어떤 서비스를 사용할 수 있나요?

ng 경로에는 현재 2,700개가 넘는 서비스가 등록되어 있습니다. 자주 요청되는 서비스로는 WhatsApp, Telegram, Google (Gmail & YouTube), TikTok, Facebook, Instagram, X (Twitter), Snapchat, LinkedIn, Uber, Discord, Microsoft & Outlook, Amazon, ChatGPT (OpenAI) 등이 있습니다. 재고는 파트너 통신사의 공급 상황에 따라 하루 동안에도 바뀌므로, 어제 보인 서비스가 지금도 있다고 가정하지 말고 실시간 가용성을 조회하세요.

팀이 나이지리아 인증 번호를 필요로 하는 이유는 무엇인가요?

나이지리아는 아프리카에서 핀테크와 소비자 앱이 가장 활발한 시장 중 하나이며, 많은 서비스가 전화번호를 기본 신원으로 취급합니다. 그래서 SMS 단계는 지갑, 대출 앱, 호출 서비스, 배달, 소셜 서비스의 온보딩에서 핵심 부분이 됩니다. 현지 밖의 팀은 테스트용 +234 번호로 가입 흐름, 재전송 타이머, 오류 문구가 현지 사용자에게 보이는 것과 같이 동작하는지 확인합니다.

공용어가 영어이므로 인증 문자도 보통 영어로 도착하며, 덕분에 자동화 테스트의 검증 로직이 단순해집니다. 특히 핀테크 팀은 OTP Route가 대체하지 않는 신원 확인 절차와 이 기능을 어떻게 함께 쓰는지 핀테크 온보딩 페이지에서 확인해 보세요.

나이지리아 휴대전화 번호는 어떤 형식인가요?

국가 번호는 +234이고 국내 접두 번호(trunk prefix)는 0입니다. 나이지리아 사람들은 보통 휴대전화 번호를 0803 123 4567처럼 0으로 시작하는 11자리로 적습니다. 국제 형식에서는 0이 빠져 +234 803 123 4567이 됩니다. E.164 값(+234803...)으로 저장하고, 입력에서는 현지 11자리 형식을 받아들이되 저장 전에 앞의 0을 제거하세요. 전체 길이만 검사하는 검증기는 +2340803...도 통과시키는데, 이것이 운영 환경에서 발송 실패가 자주 생기는 원인입니다.

대시보드에서 나이지리아 번호를 주문할 수도 있나요?

네. 이메일 코드 또는 Google 계정으로 가입하고, 지갑을 충전한 뒤 OTP Gateway를 열어 나이지리아와 서비스를 선택하고 표시된 가격을 확인하세요. 번호는 즉시 준비되며, 코드가 도착하면 주문 옆에 표시됩니다.

코드가 오지 않으면 20분의 유효 시간이 끝날 때까지 기다리세요. 코드가 도착한 경우에만 비용을 내며, 만료되거나 취소된 주문은 자동으로 환불됩니다. 그런 다음 잠시 후 새로 주문하거나, 테스트가 허용한다면 가나 같은 다른 경로를 시도하고, 해당 서비스가 가상 번호를 거부하는지 확인하세요. 새 주문을 짧은 간격으로 연달아 보내는 것은 피하세요.

나이지리아 장기 회선, 결제, 샌드박스는 어떤가요?

OTP Route는 나이지리아 장기 번호를 셀프 서비스로 제공하지 않습니다. 전용 번호(Dedicated Numbers)는 미국과 캐나다에서만 월 $1.95부터 판매합니다(From $1.95/month). 오래 유지할 +234 회선이 필요하면 [email protected]으로 문의하세요. 제공 가능 여부는 현지 규정에 따라 달라집니다.

비용은 요금제나 월 사용료가 없는 단일 선불 USD 지갑에서 차감됩니다. 카드 또는 USDT/USDC로 충전할 수 있고, 충전할 때마다 PDF 청구서를 받습니다. 지원팀에 요청해 개발 계정을 샌드박스 모드로 전환하면 연동 환경이 시뮬레이션된 번호와 코드를 받으므로, 지갑 잔액을 쓰지 않고 웹훅 전체 경로를 테스트할 수 있습니다.

자주 묻는 질문

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

네. OTP Gateway에서 +234 번호를 주문하고 대시보드나 API로 코드를 확인하세요.

OTP Route API에서 나이지리아의 국가 ID는 무엇인가요?

가격 조회와 활성화 요청의 country 값으로 ng를 사용하세요.

나이지리아 SMS OTP를 받는 데 비용이 얼마나 드나요?

코드당 $0.20부터이며, 정확한 금액은 서비스에 따라 다르고 가격 엔드포인트가 반환합니다.

SMS가 도착하지 않으면 비용을 내야 하나요?

아니요. 20분 안에 아무것도 도착하지 않거나 취소하면 전액이 지갑으로 돌아갑니다.

0803 123 4567 같은 번호는 어떻게 저장해야 하나요?

앞의 0을 빼고 공백 없는 E.164 형식인 +2348031234567로 저장하세요.

이 번호를 아무 계정에나 써도 되나요?

본인의 정상적인 제품과 계정에만 사용하세요. 각 서비스의 약관과 OTP Route 허용 사용 정책(Acceptable Use Policy)을 따라야 하며, 일부 서비스는 가상 번호를 아예 거부합니다.

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