잠비아 가입 테스트를 위한 +260 SMS 인증 자동화

잠비아 OTP API 연동은 어떤 엔드포인트를 호출하나요?

연동은 https://otproute.com/api/v1로 가는 짧은 HTTPS 호출 체인이며, 각 호출에는 or_live_ 접두사 키를 담은 Authorization: Bearer가 포함됩니다. 잠비아의 국가 id는 zm입니다.

• GET /api/v1/countries와 GET /api/v1/services: 참조 데이터이며 하루 동안 캐시해도 됩니다.
• GET /api/v1/prices?country=zm&service=<id>: 실시간 가격과 해당 경로가 지금 주문을 받을 수 있는지 여부.
• {"service": "whatsapp", "country": "zm"}와 함께 POST /api/v1/activations: activation id와 +260 번호를 반환합니다.
• GET /api/v1/activations/{id}: 상태와, 수신되면 코드.
• POST /api/v1/activations/{id}/cancel: 번호를 일찍 반납합니다.
• GET /api/v1/balance: 가장 먼저 실행해 지갑이 비어 있으면 테스트 스위트가 빨리 멈추게 합니다.

Developer 콘솔에서 계정당 최대 10개의 키를 생성할 수 있으며, 환경마다 하나씩 두는 것이 깔끔한 패턴입니다. 계정 한도는 분당 300회 요청입니다. 전체 스키마는 API 문서에 있습니다.

+260 코드를 받는 웹훅은 어떻게 작성해야 하나요?

폴링도 동작하지만, 여러 활성화가 동시에 실행되면 웹훅이 더 깔끔합니다. Developer 콘솔에서 엔드포인트를 최대 5개 추가하고 activation.sms_received, activation.expired, activation.cancelled를 구독하세요.

각 요청에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 문자열 <t>.<raw body>를 만들어 엔드포인트의 시크릿으로 HMAC-SHA256을 계산하고 상수 시간으로 v1과 비교하세요. 수신한 그대로의 원본 바이트를 사용하고, 몇 분보다 오래된 타임스탬프는 거부하며, 재시도된 전달이 아무것도 바꾸지 않도록 결과를 activation id 키로 저장하세요. 2xx를 빠르게 응답하고 느린 작업은 그 뒤에 처리하세요. HMAC으로 OTP 웹훅 보호하기 워크스루에 더 자세한 내용이 있으며, CI 파이프라인의 SMS OTP 테스트는 빌드의 어느 위치에 이것이 들어가는지 보여 줍니다.

잠비아 인증 번호는 어떤 서비스의 코드를 받을 수 있나요?

실시간 스냅샷에서 잠비아는 1,100개가 넘는 서비스를 제공합니다. 그중에는 WhatsApp, Facebook, Google (Gmail & YouTube), Telegram, Instagram, TikTok, X (Twitter), LinkedIn, Uber, imo, Microsoft & Outlook, Amazon, Netflix가 있습니다. 경로는 시간 단위로 바뀌므로 주문하기 전에 가격 엔드포인트가 지금 열려 있는 항목을 코드에 알려 주도록 하세요.

잠비아 번호 형식과 코드가 도착하는 언어

잠비아 번호는 국내에서 트렁크 0과 아홉 자리로 다이얼합니다. 국제 형식에서는 0이 사라져 +260 뒤에 아홉 자리가 옵니다. 저장하기 전에 모든 것을 그 E.164 형식으로 정규화하고, 입력란이 사용자가 실제로 입력하는 현지 방식과 국제 방식을 모두 받아들이는지 확인하세요.

영어가 공용어이며 벰바어, 니안자어, 통가어, 로지어 같은 언어도 널리 쓰입니다. 인증 SMS는 보통 영어로 도착해 파싱이 단순하지만, 발신자의 문구 변경이 테스트를 깨뜨리지 않도록 여전히 숫자로 매칭하세요.

팀들은 남부 아프리카로 확장하거나, 모바일 머니 또는 대출 상품의 온보딩을 구축하거나, 지역 운영 센터에서 고객을 지원할 때 잠비아에서 테스트합니다. 핀테크 온보딩 페이지가 이 시나리오를 다룹니다.

대시보드에서도 같은 작업을 할 수 있나요?

네, 일회성 점검에 편리합니다. 로그인해서 OTP Gateway를 열고 서비스와 잠비아를 선택한 뒤 표시된 가격을 확인하고 주문하세요. +260 번호를 앱에 입력하면 코드가 도착했을 때 대시보드에 나타납니다. 더 이상 필요 없는 활성화를 취소하면 그 금액이 지갑으로 돌아옵니다.

코드가 오지 않으면 어떻게 하나요? 전용 회선이 더 나은 경우는 언제인가요?

활성화는 20분 동안 유지되며 코드가 도착할 때만 결제합니다. 시간이 만료되거나 취소하면 전체 금액이 자동으로 돌아갑니다. 일부 서비스는 가상 번호를 거부하며, 이것이 환불이 존재하는 이유입니다. +260 코드가 느릴 때는 시간이 끝날 때까지 기다리고, 나중에 또는 다른 서비스 경로로 다시 시도하고, 서비스가 가상 번호를 허용하는지 확인하고, 빠르게 반복 주문하지 마세요.

나중에 다시 로그인하거나 접근을 복구해야 하는 계정에는 일회용 번호가 맞지 않는 도구입니다. 전용 가상 번호(Dedicated Virtual Numbers)가 그 역할을 하지만 미국과 캐나다에서만 월 $1.95부터 제공됩니다. OTP Route에는 셀프 서비스 방식의 잠비아 장기 회선이 없습니다. 실제 필요가 있다면 [email protected]으로 문의하되, 현지 규정이 결정하며 아무것도 보장되지 않는다는 점을 염두에 두세요.

번호는 자사의 정당한 제품과 계정에만 사용하고, 각 서비스의 약관을 따르며, OTP Route의 Acceptable Use Policy가 적용됨을 기억하세요.

잠비아 연동은 어떻게 청구되고 안전하게 테스트하나요?

하나의 선불 USD 지갑이 모든 것을 결제하며 월 요금도 요금제도 없습니다. 카드 또는 USDT/USDC로 충전하고 그때마다 PDF 인보이스를 이메일로 받습니다. 개발하는 동안에는 개발 계정에 샌드박스 모드를 요청하세요. 시뮬레이션된 번호와 코드로 지갑 지출 없이 OTP 라우팅 전체 경로를 연습할 수 있습니다. 현재 요금은 요금제 페이지에 있습니다.

자주 묻는 질문

OTP Route는 잠비아에 어떤 국가 id를 사용하나요?

zm이며, {"service": "telegram", "country": "zm"}를 담은 POST /api/v1/activations처럼 사용합니다.

잠비아 SIM 카드 없이 잠비아 SMS OTP 코드를 받을 수 있나요?

네. OTP Gateway가 테스트용 +260 번호를 제공하며, 코드는 대시보드, 웹훅 또는 폴링으로 전달됩니다.

+260 번호는 어떻게 올바르게 저장하나요?

국내 트렁크 0을 빼고 E.164 형식으로 +260과 아홉 자리를 저장하세요. 표시용 서식은 별도로 적용합니다.

WhatsApp 등의 서비스가 번호를 거부하면 돈이 환불되나요?

네. 20분 안에 코드가 오지 않거나 취소하면 금액이 자동으로 지갑에 환불됩니다.

앞으로의 로그인을 위해 잠비아 번호를 계속 보유할 수 있나요?

셀프 서비스로는 안 됩니다. 장기 번호는 미국·캐나다 상품이며, 잠비아는 [email protected]으로 이메일을 보내 문의하되 약속은 없습니다.

실제 코드 비용을 내기 전에 연동을 시험해 볼 수 있나요?

네. 개발 계정에 샌드박스 모드를 요청하면 엔드 투 엔드 테스트용 시뮬레이션 번호와 코드를 받을 수 있습니다.

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