제품 팀이 상투메 프린시페에서 테스트하는 이유는 무엇인가요?
이 섬나라는 아프리카에서 가장 작은 시장 중 하나이지만, 포르투갈어권을 대상으로 하는 제품에는 중요합니다. 루소폰 아프리카 전역으로 출시하거나 섬, 포르투갈, 앙골라를 오가는 고객을 지원하는 팀은 +239 번호가 가입 양식을 통과하는지, 포르투갈어 문구가 자연스러운지 확인해야 합니다.
공용어는 포르투갈어이며, 해외 앱의 인증 문자는 계정 설정에 따라 포르투갈어나 영어로 오는 경우가 많습니다. 포로 같은 현지 크리올어는 널리 쓰이지만 자동 발송 SMS에는 거의 나오지 않습니다.
실무적인 이유도 있습니다. 상투메 섬이나 프린시페 섬에 직원이 있는 NGO, 개발 협력 기관, 원격 근무 중심 고용주는 온보딩이 현지 번호에서 잘 되는지 확인해야 하는 경우가 많고, 포르투갈발 송금 노선을 넓히는 핀테크 팀은 +239 고객이 가입을 끝낼 수 있다는 증거가 필요합니다. 실제 섬 번호로 QA를 돌려 보면 혼란스러워하는 사용자의 지원 티켓을 기다리는 것보다 빠르게 답을 얻을 수 있습니다.
+239 번호는 어떻게 표기하고 저장하나요?
국내 번호는 7자리이고 휴대전화 번호는 대개 9로 시작합니다. E.164로는 +239 뒤에 7자리를 붙입니다. 이렇게 짧은 번호는 최소 길이를 8자리 이상으로 잡은 검증기에 걸리기 쉬우므로, 파싱 테스트에 +239 케이스를 추가하고 값을 저장하기 전에 공백이나 대시를 정규화하세요.
몇 가지 습관을 들이면 데이터를 깨끗하게 유지할 수 있습니다.
- 표준
+239문자열을 저장하고, 감지된 국가는 별도 열에 보관합니다. - 사용자가 오래된 연락처 카드에서 붙여 넣은
00239국제 접두어는 제거합니다. - 7자리 번호를 고정 길이 데이터베이스 필드에 맞춰 0으로 채우지 말고, 필드를 넓히세요.
- 단위 테스트에 +239 픽스처를 하나 이상 넣어, 나중에 검증기가 바뀌어도 조용히 깨지지 않게 하세요.
OTP Gateway는 상투메 프린시페에 무엇을 제공하나요?
이 나라의 실시간 카탈로그에는 600개가 넘는 서비스가 있습니다. 인기 서비스로는 WhatsApp, Telegram, Facebook, Instagram, Google (Gmail & YouTube), Microsoft & Outlook, Discord, LinkedIn, Signal, Viber, imo, Amazon 등이 있습니다.
작은 시장은 시간대에 따라 커버리지가 줄어들 수 있습니다. 어제의 결과를 믿지 말고 주문 전마다 GET /api/v1/prices를 확인하세요. 경로가 비어 있으면 카보베르데 같은 가까운 루소폰 경로나 앙골라처럼 규모가 큰 경로와 비교해 보세요.
국가 id st의 API 흐름은 어떻게 되나요?
GET /api/v1/prices?country=st&service=<id>는 실시간 가격과 가용 여부를 반환합니다.POST /api/v1/activations에{"service": "<id>", "country": "st"}를 보내 번호를 확보합니다.- 앱에서 번호를 사용한 뒤, 웹훅으로
activation.sms_received를 기다리거나GET /api/v1/activations/{id}를 폴링합니다. POST /api/v1/activations/{id}/cancel로 더 필요 없는 시도를 종료합니다.
호출은 Bearer or_live_ 키로 https://otproute.com/api/v1에 보냅니다. X-OTPRoute-Signature("<t>.<raw body>"의 HMAC-SHA256)를 확인하고 오래된 타임스탬프는 버리세요. 방법은 HMAC으로 OTP 웹훅 보호하기에서 볼 수 있습니다.
코드를 다루지 않는 사람도 쓸 수 있나요?
네. 이메일 코드나 Google로 가입한 뒤 OTP Gateway를 열고, 서비스를 고르고 상투메 프린시페를 선택한 다음 실시간 가격을 확인하고 주문하면 됩니다. 번호가 바로 나타나며 SMS가 도착하면 같은 화면에 코드가 표시됩니다.
섬에서 온 고객 불만을 재현하는 지원 담당자나, 출시 전에 포르투갈어 온보딩 화면을 한 번 직접 확인하려는 프로덕트 매니저에게 적합합니다. 대시보드에는 지갑과 수신한 코드가 모두 있으므로 계정에 TOTP 2단계 인증을 켜 두세요.
장기 번호, 결제, 샌드박스는 어떻게 되나요?
셀프서비스 방식의 +239 장기 번호는 없습니다. 전용 가상 번호(Dedicated Virtual Number)는 월 $1.95부터 시작하는 미국·캐나다 전용 상품입니다. 섬에서 오래 쓸 회선이 필요하면 [email protected]으로 이메일을 보내 주세요. 가능 여부는 현지 규정에 달려 있습니다.
결제는 월 이용료 없는 선불 USD 지갑 하나로 이루어지며 카드나 USDT/USDC로 충전하고, 충전할 때마다 PDF 인보이스가 발행됩니다. 샌드박스 계정은 통합 테스트용으로 시뮬레이션 번호와 코드를 반환합니다. 자세한 내용은 /pricing에서 확인하세요.
지갑은 모든 국가에서 공유되므로 상투메 프린시페와 포르투갈이나 브라질을 함께 테스트하는 팀은 모든 활성화를 하나의 잔액과 하나의 인보이스 묶음으로 볼 수 있어, 월말 재무 대조가 간단해집니다.
자주 묻는 질문
섬에 가지 않고도 내 앱의 상투메 프린시페 가입을 확인할 수 있나요?
네. OTP Route OTP Gateway에서 +239 번호를 주문해 앱에 입력하고, 대시보드나 API로 코드를 확인하세요.
+239 코드가 오지 않으면 어떻게 하나요?
활성화에 20분을 모두 주고, 이후 나중에 다시 시도하거나 다른 서비스 경로를 써 보세요. 몇 초 간격으로 반복 주문하는 것은 피하세요.
실패한 상투메 프린시페 활성화에도 요금이 청구되나요?
아니요. 창이 닫히기 전에 SMS가 오지 않거나 직접 취소하면 전액이 지갑으로 돌아갑니다.
앱이 내 상투메 프린시페 인증 번호를 거부하는 이유는 무엇인가요?
일부 서비스는 가상 번호를 허용하지 않습니다. 이는 OTP Route가 통제할 수 없는 부분이며, 그래서 사용하지 않은 활성화는 환불됩니다.
인증 문자는 포르투갈어로 오나요?
공용어가 포르투갈어라서 자주 그렇지만, 문구는 앱마다 다르고 영어를 쓸 수도 있습니다.
상투메 프린시페 OTP API에는 요청 한도가 있나요?
계정당 분당 300건까지 요청할 수 있으며, API 키는 최대 10개, 웹훅 엔드포인트는 최대 5개까지 보유할 수 있습니다.
CI 작업에서 실행할 수 있나요?
네, 실행당 활성화 하나씩 주문하면 됩니다. QA 테스트 페이지에 팀들이 구성하는 방법이 정리되어 있습니다.
OTP Route는 어떤 용도를 허용하나요?
각 서비스의 약관과 OTP Route의 이용 정책(Acceptable Use Policy) 범위 안에서, 본인 제품의 테스트와 정당한 비즈니스 계정 운영을 허용합니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.