가나(+233) OTP 테스트 및 운영을 위한 실전 체크리스트

시작하기 전에: 가나 준비 목록

다음 항목을 점검하면 +233 테스트에서 놀랄 일이 거의 없습니다.

1. 자격 증명. Developer 콘솔의 Bearer 키(접두사 or_live_). 로컬, 스테이징, CI에 각각 다른 키를 쓰면 폐기가 쉬워집니다.
2. 국가 및 서비스 id. 가나는 gh이고, 서비스 id는 GET /api/v1/services에서 가져옵니다.
3. 트렁크 0을 이해하는 번호 파서. 가나 사람들은 국내에서 휴대전화 번호 앞에 0을 붙여 쓰므로, 양식에는 두 가지 방식이 모두 들어옵니다.
4. 전달 구조. 폴링 루프 또는 시크릿을 안전하게 보관한 웹훅 엔드포인트 중 하나.
5. 다룰 서비스의 짧은 목록. 무엇이든 주문하기 전에 어떤 가입 및 로그인 흐름에 가나 번호가 필요한지 정하세요.
6. 예산 가시성. 배치 전에 GET /api/v1/balance를 읽어 두면 스위트 중간에 멈추는 일을 피할 수 있습니다.

가나 휴대전화 번호는 어떻게 표기되며 어떻게 저장해야 하나요?

가나의 국가 코드는 +233이고 트렁크 접두사는 0입니다. 국내 표기 휴대전화 번호는 0으로 시작하는 10자리이고, 국제 형식에서는 0이 사라지고 +233 뒤에 9자리가 옵니다. 전형적인 데이터 품질 버그는 사용자가 +233을 선택한 뒤 0이 포함된 국내 번호를 그대로 입력해 자릿수가 하나 늘어나는 경우입니다. 국가 코드가 있을 때는 맨 앞의 0을 하나 제거한 뒤 E.164로 저장하여, 중복 제거, 검색, SMS 발송이 모두 같은 표현을 쓰게 하세요.

공용어는 영어이며 인증 문자는 대부분 영어로 가나 번호에 도착하지만, 아칸어(트위), 에웨어, 가어, 다그바니어도 널리 쓰이고 일부 앱은 문구를 현지화합니다. 코드 추출기는 주변 단어가 아니라 숫자 열에 집중하게 하세요.

왜 여기서 테스트할까요? 서아프리카에 출시하는 팀, 모바일 머니와 결제를 중심으로 한 제품, 영국과 북미의 가나 디아스포라를 상대하는 기업은 모두 +233 가입이 동작함을 확인해야 합니다. 핀테크 팀은 KYC 측면에서 핀테크 온보딩 노트를 참고할 수 있습니다.

SMS 인증 API로 +233 번호 주문하기

기본 URL은 https://otproute.com/api/v1입니다.

1. GET /api/v1/prices?country=gh&service=<id>로 해당 조합의 실시간 가격을 가져옵니다. 지금 경로를 이용할 수 있는지도 함께 알려 줍니다.
2. {"service": "<id>", "country": "gh"}를 본문으로 POST /api/v1/activations를 보내고, 반환된 activation id를 테스트 케이스와 함께 보관하세요.
3. 테스트 대상 제품에 +233 번호를 입력합니다.
4. activation.sms_received 웹훅으로 코드를 받거나, 적당한 간격으로 GET /api/v1/activations/{id}를 폴링합니다.
5. 실패하거나 정리할 때는 POST /api/v1/activations/{id}/cancel을 호출합니다.

웹훅 요청에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 타임스탬프, 점, 원문 본문의 HMAC-SHA256을 다시 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프는 거부하세요. 재전송된 배달이 같은 테스트를 두 번 채우지 않도록 activation id를 키로 삼아 핸들러를 멱등하게 만드세요. 개발자 허브에 SDK 예제와 레퍼런스가 모여 있습니다.

현재 가나를 통해 라우팅되는 서비스는 무엇인가요?

가나 경로에서는 1,600개가 넘는 서비스를 이용할 수 있습니다. 현재 스냅샷의 인기 서비스는 WhatsApp, Telegram, Facebook, Instagram, TikTok, Snapchat, Google(Gmail & YouTube), LinkedIn, Uber, Amazon, ChatGPT (OpenAI), Claude, Discord, Signal입니다. 가나 사용자가 가입하는 서비스는 소셜 및 메시징 앱이 대부분이라 현지화 QA의 첫 점검 대상으로 자연스럽습니다.

이용 가능 여부는 고정된 것이 아니라 실시간입니다. 오늘 아침에 맞았던 목록을 믿지 말고 prices 엔드포인트로 정확한 조합을 조회하세요.

대신 대시보드에서 실행하기

팀 모두가 코드를 다룰 필요는 없습니다. 로그인해서 OTP Gateway를 열고, 가나와 서비스를 고른 뒤 주문 전에 표시되는 가격을 확인하고 확정하세요. 테스트 중인 앱에 +233 번호를 복사해 넣으면, SMS가 도착했을 때 코드가 남은 시간과 함께 주문 옆에 표시됩니다. 운영 담당자는 릴리스 후 테스트 하네스를 건드리지 않고 단일 흐름을 확인할 때 이 경로를 자주 씁니다.

응답 없는 +233 번호 문제 해결

아무것도 나타나지 않으면 이 목록을 순서대로 확인하세요.

• 제한 시간이 아직 남아 있나요? 활성화는 20분간 유지됩니다. 실패했다고 결론짓기 전에 서비스에 시간을 주세요.
• 서비스가 번호를 받아 주었나요? 일부 플랫폼은 가상 번호를 거부합니다. 양식 자체에 오류가 나면 취소하고 다른 경로를 시도하세요.
• 나중에 또는 다른 경로로 다시 시도하세요. 특정 서비스의 커버리지는 하루 중에 바뀝니다.
• 연타하지 마세요. 몇 초마다 다시 주문하는 루프는 분당 300회 한도에 요청만 낭비하고 도움이 되는 경우가 드뭅니다.
• 자체 로그를 확인하세요. 거부된 서명이나 비정상 종료된 핸들러는 코드가 오지 않은 것처럼 보입니다.

코드가 도착했을 때만 요금이 청구됩니다. 만료되거나 취소된 활성화는 전액 자동으로 지갑에 환불됩니다. 재시도 설계는 OTP 전송 실패 줄이기 글에서 더 깊이 다룹니다.

장기 회선, 결제, 샌드박스

셀프서비스 가나 장기 번호는 없습니다. 전용 회선은 미국과 캐나다 상품으로 월 $1.95부터이며 가상 번호 페이지에 설명되어 있습니다. 가나 회선이 필요하면 [email protected]으로 이메일을 보내 주세요. 현지 규정상 가능한 범위를 팀이 알려 드립니다.

OTP Route는 선불 USD 지갑 하나로 사용한 만큼만 내며 구독은 없습니다. 카드 또는 USDT/USDC로 충전하면 매번 PDF 인보이스를 이메일로 받습니다. 연동 작업에는 요청 시 개발 계정을 샌드박스로 전환해 시뮬레이션된 번호와 코드를 받을 수 있습니다. 이메일 코드나 Google 로그인으로 계정을 만들 수 있습니다. 모든 번호는 대상 서비스의 약관과 이용 정책(Acceptable Use Policy)에 맞게 사용하세요.

자주 묻는 질문

API로 가나 SMS OTP 코드를 받을 수 있나요?

네. 국가를 gh로 하여 activation을 생성하고, 웹훅 또는 activation 엔드포인트 폴링으로 코드를 수집하세요.

가나 번호는 앞의 0을 포함해서 저장해야 하나요?

아니요. 트렁크 0은 버리고 +233과 9자리로 E.164 형식으로 저장하세요. 그러면 검색과 중복 제거가 일관됩니다.

가나 번호의 인증 문자는 어떤 언어를 쓰나요?

보통 공용어인 영어입니다. 일부 앱은 문구를 현지화하므로 고정된 문구를 매칭하지 말고 숫자를 추출하세요.

테스트용 +233 번호는 비용이 얼마인가요?

OTP Gateway 코드는 코드당 $0.20부터 시작합니다. 서비스별 정확한 금액은 주문 전에 표시됩니다.

앱이 코드를 보내지 않으면 요금이 청구되나요?

아니요. 20분 제한 시간 안에 SMS가 도착하지 않거나 취소하면 전액이 지갑으로 환불됩니다.

지원팀이 가나 영구 번호를 쓸 수 있나요?

셀프서비스로는 불가합니다. 장기 회선은 미국과 캐나다에만 있으며, 다른 국가는 이메일로 팀에 문의하세요.

스테이블코인으로 결제할 수 있나요?

네. 지갑은 카드 충전과 USDT, USDC를 받으며, 충전마다 PDF 인보이스가 발급됩니다.

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