요청부터 시작하기: API로 PNG 번호 주문하기
파푸아뉴기니의 국가 ID는 pg입니다. 개발자 콘솔에서 발급한 Bearer 키(접두 or_live_)가 있으면, https://otproute.com/api/v1에 대해 최소한의 연동에는 몇 번의 요청이면 충분합니다.
GET /api/v1/prices?country=pg&service=<id>는 해당 조합의 실시간 가격을 반환합니다.POST /api/v1/activations에{"service": "telegram", "country": "pg"}를 보내면 코드 하나를 위한 +675 번호를 예약합니다.GET /api/v1/activations/{id}는 상태를 알려주고, 코드를 받았다면 코드를 반환합니다.POST /api/v1/activations/{id}/cancel은 쓰지 않을 활성화를 닫고 환불합니다.GET /api/v1/balance로 파이프라인이 일괄 실행 전에 잔액을 확인할 수 있습니다.
계정당 최대 키 10개, 웹훅 엔드포인트 5개, 분당 300건의 요청이 허용됩니다. 개발자 페이지에 레퍼런스와 클라이언트 예제가 링크되어 있습니다.
서명된 웹훅으로 +675 코드 받기
소수의 테스트에는 폴링으로 충분하지만 웹훅이 확장성이 더 좋습니다. 엔드포인트를 등록하면 OTP Route가 코드가 도착할 때 activation.sms_received를, 코드 없이 유효 시간이 끝나면 activation.expired를, 누군가 번호를 해제하면 activation.cancelled를 전송합니다.
각 요청에는 t=<unix>,v1=<hex> 형식의 X-OTPRoute-Signature가 포함됩니다. 엔드포인트 시크릿으로 "<t>.<raw body>"에 대한 HMAC-SHA256을 다시 계산하고, 상수 시간으로 비교하며, 타임스탬프가 오래된 요청은 거부하세요. 이벤트는 활성화 ID를 기준으로 하므로, 그 ID를 처리 완료 플래그와 함께 저장하고 중복은 무시하세요. 웹훅 기반 OTP 캡처의 짧은 글에서 큐잉과 재시도를 다룹니다.
파푸아뉴기니 번호로 무엇을 인증할 수 있나요?
파푸아뉴기니의 실시간 목록에는 800개가 넘는 서비스가 있습니다. 이 나라에서 또는 이 나라와 일하는 팀은 메시징으로 Facebook, WhatsApp, Telegram, Signal을, 업무 계정으로 Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn을 흔히 테스트합니다. ChatGPT (OpenAI)와 Claude 같은 AI 도구와 함께 Instagram, TikTok, Discord, Amazon도 있습니다.
규모가 작은 시장의 커버리지는 하루 동안 더 눈에 띄게 달라질 수 있습니다. 작업이 먼저 GET /api/v1/services를 읽도록 하고, 서비스가 pg에 현재 등록되어 있지 않으면 매끄럽게 건너뛰거나, 호주 같은 인근 태평양 경로로 테스트를 돌리세요.
PNG 전화번호는 어떤 구조인가요?
파푸아뉴기니는 국내 접두 번호(trunk prefix)를 쓰지 않으므로 E.164 형식은 +675 뒤에 국내 번호가 이어지는 것이 전부입니다. 휴대전화 번호는 8자리이며 대체로 7로 시작하고, 유선 전화는 7자리로 더 짧습니다. 오래된 기록에는 국가가 8자리로 바꾸기 전의 7자리 휴대전화 번호가 남아 있을 수 있으니, 조용히 허용하지 말고 데이터 정리 때 표시해 두세요.
번호는 E.164로 저장하고, 유형에 따라 길이를 검증하며, 절대 0을 앞에 붙이지 마세요. 공용어는 영어, 톡 피신, 히리 모투이며 +675 번호로 가는 인증 메시지는 대부분 영어로 도착합니다. 그래도 파서는 고정 문구가 아니라 숫자를 추출해야 합니다.
여기서 테스트하는 이유로는 현장 직원을 온보딩하는 자원 부문과 물류 운영, 모바일 도구를 운영하는 NGO와 개발 프로그램, PNG 고객에게 제품을 확장하는 호주 및 태평양 지역 기업, 톡 피신 인터페이스 문구의 현지화 점검이 있습니다.
대시보드에서 주문하기
운영 담당자는 코드를 작성하지 않고도 같은 흐름을 따라갈 수 있습니다.
- 이메일과 6자리 코드 또는 Google 계정으로 가입합니다.
- 지갑을 충전합니다.
- OTP Gateway에서 파푸아뉴기니와 서비스를 선택하고, 가격을 확인한 뒤 확정합니다.
- 앱에 +675 번호를 입력하고 활성화 화면에 코드가 나타나기를 기다립니다.
브라우저 주문과 API 주문은 하나의 지갑과 하나의 활성화 기록을 공유합니다.
응답 없는 +675 활성화 문제 해결
모든 활성화는 20분 동안 유지됩니다. SMS가 도착하지 않거나 취소하면 전체 금액이 지갑으로 자동 환불됩니다. 전달 시간은 서비스와 경로에 따라 다르므로 조치하기 전에 유효 시간이 끝나기를 기다리세요.
코드가 오지 않을 때는 다음을 해보세요.
- 앱에서 재전송을 한 번 요청한 뒤 기다립니다.
- 나중에 다시 시도하거나 같은 서비스의 다른 경로를 이용합니다.
- 서비스가 가상 번호를 받는지 확인합니다. 일부는 거부하며, 그래서 환불이 자동으로 이루어집니다.
- 자동화에서는 재시도 횟수에 상한을 두고 주문 사이에 지연을 둡니다.
각 서비스의 약관과 OTP Route 허용 사용 정책(Acceptable Use Policy)을 지키세요.
장기 회선, 지갑, 샌드박스
파푸아뉴기니에는 셀프 서비스 장기 번호가 없습니다. 팀에 지속적인 +675 회선이 필요하면 [email protected]으로 연락하세요. 가능 여부는 현지 규정이 정하며 아무것도 약속하지 않습니다. 전용 가상 번호(Dedicated Virtual Numbers)는 미국과 캐나다에서만 월 $1.95부터 판매합니다(From $1.95/month).
지갑은 월 사용료나 요금제가 없는 선불 USD 종량제입니다. 카드 또는 USDT/USDC로 충전하며 충전마다 PDF 청구서를 받습니다. 요금을 참고하세요. 요청하면 개발 계정을 샌드박스로 전환할 수 있어, 시뮬레이션된 번호와 코드로 PNG 연동을 비용 없이 처음부터 끝까지 테스트할 수 있습니다.
자주 묻는 질문
OTP Route API는 파푸아뉴기니에 어떤 ID를 쓰나요?
국가 ID는 pg이며 GET /api/v1/prices와 POST /api/v1/activations에서 사용합니다.
앱의 전화번호 가입 테스트용 +675 번호를 받을 수 있나요?
네. 국가 pg로 서비스의 활성화를 주문하고, 앱에 번호를 입력한 뒤, 대시보드나 웹훅에서 코드를 읽으세요.
파푸아뉴기니 SMS OTP를 받는 데 비용이 얼마나 드나요?
코드당 $0.20부터이며, 정확한 가격은 서비스에 따라 다르고 주문 전에 실시간으로 표시됩니다.
PNG 휴대전화 번호에는 앞자리 0이 필요한가요?
아니요. 국내 접두 번호가 없으므로 E.164 휴대전화 번호는 +675 뒤에 8자리입니다.
인증 SMS가 톡 피신으로 올 가능성이 있나요?
드뭅니다. 대부분의 서비스는 +675 번호로 영어 코드를 보내지만, 파서는 숫자를 기준으로 삼아야 합니다.
PNG 번호를 앞으로의 로그인에 계속 쓸 수 있나요?
아니요. 게이트웨이 번호는 20분 유효 시간 안에 코드 하나만 처리하며, 셀프 서비스 장기 번호는 미국과 캐나다에만 있습니다.
비용을 쓰지 않고 연동을 구축할 방법이 있나요?
네. 개발 계정에 샌드박스 모드를 요청하면 시뮬레이션된 번호와 코드를 받을 수 있습니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.