카보베르데(+238) 인증 코드를 테스트 스택으로 가져오기

+238 활성화에는 어떤 엔드포인트가 쓰이나요?

카보베르데 OTP API 연동에는 https://otproute.com/api/v1 아래의 짧은 호출 목록이면 충분합니다. 모든 요청에는 개발자 콘솔에서 만든 or_live_로 시작하는 Bearer 키가 들어갑니다. 카보베르데의 국가 ID는 cv이고, 서비스 ID는 테스트하는 앱의 api_service 값입니다.

1. GET /api/v1/services와 GET /api/v1/countries로 카탈로그를 가져옵니다. 하루 동안은 캐시해도 됩니다.
2. GET /api/v1/prices?country=cv&service=<id>는 현재 가격을 읽고 지금 경로가 열려 있는지 알려 줍니다. 재고는 하루 중에도 바뀌므로 값을 하드코딩하지 말고 주문 전에 조회하세요.
3. {"service": "whatsapp", "country": "cv"}로 POST /api/v1/activations를 호출하면 활성화 ID와 가입 폼에 입력할 +238 번호가 반환됩니다.
4. 웹훅을 쓰지 않는다면 GET /api/v1/activations/{id}로 코드를 폴링할 수 있습니다.
5. POST /api/v1/activations/{id}/cancel은 테스트가 중단될 때 번호를 해제하여, 보류된 금액이 지갑으로 돌아가게 합니다.

실행 전에 GET /api/v1/balance를 호출하면 테스트 스위트가 중간에 실패하는 대신 일찍 멈출 수 있습니다. 한도는 계정당 분당 300건이며, 모든 필드는 API 레퍼런스에 나와 있습니다.

카보베르데 코드용 서명된 웹훅은 어떻게 받나요?

스크립트 하나라면 폴링으로 충분하지만, 여러 작업이 병렬로 돌기 시작하면 웹훅이 더 깔끔합니다. 개발자 콘솔에서 엔드포인트를 등록하고(계정당 5개까지 가능) activation.sms_received, activation.expired, activation.cancelled를 구독하세요.

각 POST는 t=<unix>,v1=<hex> 형식의 X-OTPRoute-Signature 헤더와 함께 도착합니다. <t>.<raw body> 문자열을 다시 만들어 해당 엔드포인트의 시크릿으로 HMAC-SHA256 서명을 계산하고, 결과를 v1과 상수 시간 비교로 대조하세요. 타임스탬프가 몇 분 넘게 지난 요청은 버려서, 가로챈 요청이 재전송되지 못하게 하세요. 그다음에는 활성화 ID를 기준으로 처리합니다. 같은 이벤트가 두 번 도착해도 두 번째는 아무것도 바꾸지 않아야 합니다. 예외 상황은 HMAC으로 OTP 웹훅 보호하기 글에서 다룹니다.

현재 카보베르데 번호로 코드를 보낼 수 있는 앱은 무엇인가요?

cv의 라이브 카탈로그는 800개 넘는 서비스를 포함합니다. 지금 열려 있는 인기 서비스로는 WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Airbnb, Uber, Viber, Telegram, Netflix가 있습니다. 이 목록은 스냅샷으로 읽으세요. 경로는 파트너 용량에 따라 열리고 닫히며, 그래서 약속만 적어 둔 페이지가 아니라 가용성을 실시간으로 알려 주는 API를 통한 OTP 라우팅이 의미가 있습니다.

팀에 코드를 쓰는 사람이 없다면 대시보드로도 같은 일을 할 수 있습니다. 서비스를 고르고 카보베르데를 선택한 뒤 화면의 가격을 확인하고 번호를 복사하세요. 코드가 도착하면 활성화 카드에 표시됩니다.

+238 번호는 저장할 때 어떤 형태인가요?

카보베르데는 폐쇄형 번호 체계를 사용하며 국내 번호는 7자리이고 트렁크 프리픽스가 없어서 제거할 맨 앞의 0이 없습니다. E.164에서는 +238 뒤에 그 7자리를 붙이면 됩니다. 그래서 정규화는 간단하지만, 모든 가입자 번호가 더 길다고 가정하는 검증기는 이 짧은 길이에 걸려 올바른 카보베르데 입력을 거부하곤 합니다. E.164 문자열을 저장하고, 표시 형식은 UI에서 원하는 대로 정하며, 전화번호 입력란의 단위 테스트에 +238 케이스를 추가하세요.

공식 언어는 포르투갈어이고 일상에서는 대부분 카보베르데 크레올어를 쓰므로, 포르투갈어 OTP 템플릿이 현지 단말에서 어떻게 보이는지 확인하세요. 팀들이 +238 번호를 테스트용으로 구하는 이유는 대개 디아스포라 때문입니다. 미국, 포르투갈, 그 밖의 유럽에 사는 카보베르데 커뮤니티는 고국 번호에 연결된 계정을 유지하고 있고, 송금, 여행, 메시징 제품은 그런 가입이 제대로 동작하기를 원합니다.

20분 안에 SMS가 오지 않으면 지갑은 어떻게 되나요?

활성화는 각각 20분 동안 열려 있습니다. 그 안에 코드가 도착하면 요금이 확정되고, 아무것도 없이 창이 닫히거나 먼저 취소하면 지원 요청 없이 결제 금액 전액이 지갑으로 돌아옵니다. 아무것도 오지 않을 때는 이렇게 하세요.

• 몇 초마다 새 주문을 넣지 말고 창이 끝날 때까지 기다리세요. 짧은 간격의 재시도는 자금만 묶어 둡니다.
• 나중에 다시 시도하거나, 다른 서비스 경로로 같은 흐름을 실행해 보세요.
• 앱이 가상 번호를 허용하는지 확인하세요. 정책상 거부하는 곳도 있으며, 환불은 바로 그런 경우를 위한 것입니다.
• 폼이 잘린 번호가 아니라 +238 번호 전체를 제출했는지 확인하세요.

진단에 대해서는 OTP 전송 실패 줄이기 가이드에서 더 자세히 다룹니다.

반복 로그인을 위해 카보베르데 번호를 계속 가질 수 있나요?

셀프서비스 방식으로는 불가능합니다. 송수신 SMS, 브라우저 통화, 웹훅 전달을 갖춘 장기 회선인 OTP Route의 전용 번호(Dedicated Numbers)는 미국과 캐나다 전용 상품이며 월 $1.95부터 시작합니다. 셀프서비스로 쓸 수 있는 장기 +238 회선은 없습니다. 팀에 실제로 필요하다면 [email protected]으로 이메일을 보내 주세요. 마련 가능 여부는 현지 규정에 따라 다르며 보장되지 않습니다. 반복해서 로그인해야 하는 스테이징 계정에는 미국 또는 캐나다 가상 번호가 현실적인 해법인 경우가 많습니다.

사용 요금은 어떻게 청구되고 라이브 전에 어떻게 테스트하나요?

요금은 하나의 선불 USD 지갑에서 청구되며 월 요금이나 요금제 등급이 없습니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하고, 충전할 때마다 PDF 인보이스가 이메일로 발송되어 재무 대사가 간단합니다. 운영 키가 지갑을 건드리기 전에 개발 계정을 샌드박스로 전환해 달라고 요청하세요. 시뮬레이션된 번호와 코드가 반환되므로, SMS 인증 API 클라이언트의 주문, 웹훅, 취소 경로를 비용 없이 CI에서 실행할 수 있습니다. 요금 페이지와 QA 테스트 개요를 참고하세요. 전 과정에서 각 서비스의 약관과 OTP Route의 이용 정책(Acceptable Use Policy)을 따르세요.

자주 묻는 질문

현지 SIM 없이 우리 앱의 카보베르데 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 +238 번호를 주문해 가입 폼에 입력하고, 대시보드, API 또는 웹훅으로 코드를 읽으면 됩니다. 팀원 누구도 섬에 있을 필요가 없습니다.

OTP Route API에서 카보베르데의 국가 ID는 무엇인가요?

cv입니다. POST /api/v1/activations와 가격 조회에서 country 값으로 전달하세요.

카보베르데 번호 앞에 0을 붙여야 하나요?

아니요. 카보베르데에는 트렁크 프리픽스가 없으므로 국제 형식은 +238 뒤에 7자리 국내 번호를 붙인 것입니다.

카보베르데 인증 번호는 얼마인가요?

OTP Gateway 요금은 코드당 $0.20부터 시작하며 서비스에 따라 다릅니다. 정확한 가격은 주문 전에 API와 대시보드에 표시됩니다. 코드가 도착했을 때만 요금이 부과됩니다.

모든 앱이 카보베르데 가상 번호로 코드를 보내 주나요?

아니요. 가상 번호를 거부하는 서비스도 있고, 경로는 하루 중에도 바뀝니다. 20분 안에 코드가 오지 않으면 금액은 지갑으로 환불됩니다.

+238 연동을 테스트할 샌드박스가 있나요?

네, 요청하시면 됩니다. 개발 계정을 샌드박스 모드로 전환하면 시뮬레이션된 번호와 코드가 반환되어, 지갑 비용 없이 연동을 처음부터 끝까지 실행할 수 있습니다.

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