기니비사우 고객이 코드가 오지 않는다고 합니다. 어떻게 재현할 수 있나요?
작은 시장에서 들어온 지원 티켓은 대응하기 어렵습니다. 비사우의 사용자가 코드가 안 온다고 신고했는데 엔지니어는 리스본이나 다카르에 있고, +245 번호를 입력했을 때 가입 화면이 실제로 어떻게 동작하는지 아무도 볼 수 없습니다. 로그만 보고 추측해서는 좀처럼 결론이 나지 않습니다.
OTP Gateway의 일회용 +245 번호가 있으면 팀이 현지 고객과 같은 경로를 그대로 따라갈 수 있습니다. 번호를 입력하고, SMS를 발송시키고, 코드가 도착하는지 지켜보면 됩니다. 번호 하나는 인증 한 번에만 쓰이므로 수정할 때마다 오래된 데이터를 재사용하지 않고 다시 테스트할 수 있습니다. 이 방식은 티켓을 닫기 전에 근거를 확보하려는 지원 및 운영팀에도 잘 맞습니다.
현재 +245 번호로 코드를 보내는 서비스는 무엇인가요?
실시간 스냅샷 기준으로 기니비사우에는 900개 이상의 서비스가 있습니다. 잘 알려진 서비스로는 WhatsApp, Facebook, imo, Telegram, Instagram, TikTok, Google(Gmail & YouTube), Microsoft & Outlook, Signal, Viber, LinkedIn, Uber가 있습니다.
이 이름들은 고정된 카탈로그가 아니라 비사우 경로의 스냅샷으로 읽어 주세요. 규모가 작은 경로는 하루 중 용량 변동이 더 눈에 띄기 때문에, 이용 가능 여부를 요청 시점에 API에서 가져오는 것입니다. 원하는 조합이 없다면 +245 접두사에 얽매이지 않는 테스트에는 세네갈이나 카보베르데 같은 인근 경로가 도움이 될 수 있습니다.
기니비사우 OTP API는 어떤 순서로 호출하나요?
개발자 콘솔에서 만든 or_live_ 접두사의 Bearer 키로 https://otproute.com/api/v1에 인증합니다. 국가 ID는 gw입니다.
GET /api/v1/services와GET /api/v1/countries로 ID를 조회합니다.GET /api/v1/prices?country=gw&service=<id>로 현재 가격과 이용 가능 여부를 확인합니다.POST /api/v1/activations에{"service": "imo", "country": "gw"}를 보내 주문하고 활성화 ID를 기록합니다.- +245 번호를 직접 만든 앱에 입력합니다.
activation.sms_received이벤트에서 +245 코드를 받거나, 대신GET /api/v1/activations/{id}를 폴링합니다.- 시나리오가 중간에 끝나면
POST /api/v1/activations/{id}/cancel을 호출합니다.
각 웹훅 요청에는 t=<unix>,v1=<hex> 형식의 X-OTPRoute-Signature가 포함됩니다. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산하고, 불일치하거나 오래된 타임스탬프는 거부하며, 재시도가 와도 같은 작업이 두 번 일어나지 않도록 활성화 ID를 기준으로 처리하세요. 더 자세한 설명은 연동 가이드에서 볼 수 있습니다. 한 계정은 웹훅 엔드포인트를 최대 5개까지 등록하고 분당 300건의 요청을 보낼 수 있습니다.
지원 담당자가 오늘 코드 하나가 필요합니다. 코드 없이 쓰는 방법이 있나요?
단건 확인은 대시보드로 처리할 수 있습니다. 기니비사우를 선택하고 서비스를 고른 뒤 가격을 확인하고 주문하세요. 화면에 번호가 표시되며, 그 번호를 앱에 붙여 넣으면 같은 활성화 페이지에 도착한 코드가 나타납니다. 설치할 것은 없고, 사용하지 않은 활성화를 취소하면 즉시 환불됩니다.
기니비사우의 전화번호와 SMS 언어에서 특이한 점은 무엇인가요?
+245 번호는 항상 E.164 형식으로 저장하세요. 사용자는 공백, 점, 불필요한 앞자리 0 등 다양한 방식으로 입력하므로, 직접 한 번 만들어 두고 잊어버린 규칙 대신 관리되는 전화번호 라이브러리로 문장부호를 제거하고 길이를 검증해 정규화하는 것이 좋습니다.
공용어는 포르투갈어이고, 기니비사우 크리올어(크리우)가 일상에서 널리 쓰입니다. 국제 서비스의 인증 문자는 발신자에 따라 보통 포르투갈어나 영어로 도착합니다. 제품이 여러 포르투갈어권 국가의 사용자를 대상으로 한다면, +245는 포르투갈이나 브라질용으로 작성한 템플릿이 여전히 자연스럽게 읽히는지, 그리고 문구와 상관없이 파서가 숫자를 추출하는지 확인하기에 유용한 사례입니다.
기니비사우는 ECOWAS 회원국이며 이웃 나라들과 서아프리카 CFA 프랑을 함께 사용하므로, 핀테크와 마켓플레이스 팀은 더 넓은 지역과 함께 이곳을 테스트하는 경우가 많습니다.
+245 번호에 아무것도 도착하지 않았습니다. 어떻게 해야 하나요?
반응하기 전에 활성화에 20분을 전부 주세요. 그래도 코드가 오지 않으면 활성화가 만료되어 activation.expired를 받게 되고 요금은 지갑으로 되돌려집니다. 코드가 도착한 경우에만 비용을 내게 됩니다.
보통 효과가 있는 다음 단계는 이렇습니다.
- 해당 흐름에서 서비스가 가상 번호를 받아주는지 확인하세요. 받지 않는 서비스도 있습니다.
- 경로 용량이 바뀌었을 수 있으니 나중에 다시 시도하세요.
- 같은 화면에 도달하는 다른 서비스 경로를 사용해 보세요.
- 반복문으로 새 주문을 계속 보내지 말고 시도 간격을 두세요.
+245 회선을 장기간 유지할 수 있나요? 결제는 어떻게 하나요?
기니비사우에는 셀프서비스 전용 번호가 없습니다. 장기 회선은 전용 가상 번호를 통해 미국과 캐나다에서만 제공되며 월 $1.95부터 시작합니다. +245 회선이 업무에 중요하다면 [email protected]으로 문의하세요. 팀이 검토해 드리지만 현지 규정에 따라 달라지며 보장되지는 않습니다.
그 밖의 모든 것은 하나의 선불 USD 지갑에서 사용한 만큼만 내는 방식이고, 월 사용료나 요금제는 없습니다. 카드 또는 USDT·USDC 스테이블코인으로 충전하면 충전마다 PDF 인보이스가 이메일로 발송됩니다. 먼저 모의 번호와 코드로 전체 흐름을 실행해 보려면 개발 계정에 샌드박스 모드를 요청하세요. 모든 주문에는 OTP Route의 이용 정책과 각 서비스의 약관이 적용됩니다.
자주 묻는 질문
API로 기니비사우 SMS OTP 코드를 받을 수 있나요?
네. 국가 gw로 활성화를 생성한 다음, 웹훅이나 활성화 엔드포인트 폴링으로 코드를 읽으세요.
비사우에 가지 않고 앱의 +245 가입을 테스트하려면 어떻게 하나요?
OTP Gateway에서 테스트용 +245 번호를 주문해 앱에 입력하고, 대시보드에서 코드가 오는지 확인하세요.
기니비사우 인증 번호는 얼마인가요?
코드당 $0.20부터이며, 정확한 가격은 주문 전에 API와 대시보드에서 서비스별로 표시됩니다.
창 안에 코드가 도착하지 않으면 어떻게 되나요?
활성화는 20분 후에 만료되고, 별도 요청 없이 전액이 지갑으로 돌아옵니다.
기니비사우에서 인증 문자는 보통 어떤 언어로 오나요?
대부분 포르투갈어 또는 영어이며, 메시지를 보내는 서비스에 따라 다릅니다.
기니비사우의 영구 번호를 쓸 수 있나요?
셀프서비스 상품으로는 제공되지 않습니다. 전용 회선은 미국과 캐나다로 한정되며, +245는 지원팀에 이메일로 문의하실 수 있습니다.
기니비사우에서 내 서비스에 쓸 재고가 없으면 어떤 경로를 쓸 수 있나요?
나중에 다시 확인하거나, 테스트가 +245 접두사에 의존하지 않는다면 세네갈 같은 인근 서아프리카 국가를 시도해 보세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.