기니(+224) 인증 코드를 테스트와 도구로 받아오는 방법

테스트용으로 +224 번호가 필요한 이유는 무엇인가요?

기니는 서아프리카의 프랑스어권 국가이고, 이 지역으로 진출하는 제품은 마케팅 비용을 쓰기 전에 기니 가입자의 회원가입이 정상 동작하는지 먼저 확인해야 하는 경우가 많습니다. 프랑스를 비롯한 해외의 기니 디아스포라를 대상으로 하는 앱, 프랑스어권 시장용 핀테크 온보딩 흐름 점검, 코나크리에서 공용 비즈니스 계정을 관리하는 현장·운영팀 등이 대표적인 사례입니다. 어느 경우든 팀원이 휴대폰을 따로 들고 다니지 않아도 되는 테스트용 +224 번호가 필요합니다.

OTP Route는 현지 SIM을 조달하는 번거로움 없이 이 요구를 해결합니다. 릴리스 체크리스트에 이 과정을 넣는 방법은 QA 테스트 페이지에서 볼 수 있습니다.

기니 인증 번호로 코드를 보낼 수 있는 서비스는 무엇인가요?

현재 기니 스냅샷에서 많이 쓰이는 서비스로는 WhatsApp, imo, Telegram, Viber, Facebook, Instagram, TikTok, Snapchat, Signal, Google(Gmail & YouTube), Microsoft & Outlook, ChatGPT(OpenAI)가 있습니다. 모든 카테고리를 합치면 이 경로에서 1,700개 이상의 서비스를 이용할 수 있습니다.

이 경로의 이용 가능 여부는 하루 중에도 바뀌므로, 목록을 몇 주씩 캐시하지 말고 API에서 실시간으로 읽으세요. 목록 맨 위에 있다는 이유로 고르지 말고, 테스트 케이스가 실제로 의존하는 서비스를 선택하세요. 예를 들어 온보딩이 기니 사용자에게 인기 있는 메신저 앱으로 코드를 보낸다면, 검증할 가치가 있는 것은 바로 그 서비스입니다.

기니 OTP API는 어떤 순서로 동작하나요?

https://otproute.com/api/v1에 Bearer 키(접두사 or_live_)로 인증합니다. 먼저 GET /api/v1/prices?country=gn&service=<id>로 해당 서비스가 기니에서 사용 가능한지 확인하세요. 그다음 POST /api/v1/activations에 {"service": "<id>", "country": "gn"}를 보내 활성화 ID를 보관하고, 받은 번호를 테스트 중인 앱에 입력합니다.

전달은 등록한 웹훅의 activation.sms_received 이벤트로 이루어지며, GET /api/v1/activations/{id}를 폴링할 수도 있습니다. X-OTPRoute-Signature 헤더(엔드포인트 시크릿으로 계산한 <t>.<raw body>의 HMAC-SHA256)를 검증하고, 오래된 타임스탬프는 거부하며, 이미 처리한 활성화의 중복 이벤트는 무시하세요. 실행을 중단하려면 POST /api/v1/activations/{id}/cancel을 호출합니다. 더 자세한 내용은 연동 가이드와 문서를 참고하세요.

비개발 직원을 위한 브라우저 방식은 무엇인가요?

OTP Gateway를 열고 기니를 선택한 뒤 서비스를 검색하고, 가격을 확인한 다음 주문하세요. 받은 번호를 인증 화면에 붙여 넣으면 도착한 SMS가 대시보드의 활성화 카드에 표시됩니다. 기니의 고객 계정을 다루는 에이전시는 이 방식을 선호하는 경우가 많은데, 하나의 공용 지갑으로 모두가 쓸 수 있고 API 키가 엔지니어링 팀 밖으로 나갈 필요가 없기 때문입니다. 가입은 이메일과 6자리 이메일 코드만 있으면 되고, 계정 자체에는 인증 앱을 이용한 2단계 로그인도 사용할 수 있습니다.

+224 번호는 어떻게 저장하고, 코드는 어떤 언어로 오나요?

기니에는 트렁크 접두사가 없고 국내 번호는 9자리이며, 휴대폰 번호는 보통 6으로 시작합니다. 입력값은 +224 뒤에 그 9자리를 붙인 형태로 정규화하고, 데이터베이스에는 이 단일 E.164 형식만 보관하세요. 8자리로 기록된 예전 데이터가 있다면 데이터 정리 때 표시해 두는 것이 좋습니다.

공용어는 프랑스어이며, 풀라어, 말링케어, 수수어도 널리 쓰입니다. 글로벌 서비스는 계정의 언어 설정에 따라 인증 문자를 프랑스어 또는 영어로 보내는 경우가 많으므로, 코드 추출은 문구가 아니라 숫자에 의존하도록 구현하세요.

기니 코드가 도착하지 않을 때는 무엇을 확인해야 하나요?

• 20분 창이 끝날 때까지 기다리세요. 코드가 도착한 경우에만 요금을 내게 됩니다.
• 해당 서비스가 가상 번호를 받아주는지 확인하세요. 일부 서비스는 거부하며, 자동 환불은 바로 그런 경우를 위한 것입니다.
• 나중에 다시 시도하거나 다른 서비스 경로를 사용해 보세요. 어느 나라든 OTP 라우팅 상황은 하루 중에 바뀝니다.
• 짧은 간격으로 반복 주문하지 마세요. 짧은 백오프를 두면 요청 한도를 아낄 수 있습니다.

지역 비교용으로는 같은 테스트 케이스를 돌려볼 수 있는 인근 프랑스어권 국가인 세네갈 경로가 있습니다.

기니 번호를 장기간 유지할 수 있나요?

대시보드에서는 불가능합니다. 기니에는 셀프서비스 장기 번호가 없으며, 활성화 번호는 코드 한 건용입니다. 전용 가상 번호는 미국과 캐나다에서만 판매되며 월 $1.95부터 시작하고, 웹훅으로 전달되는 수신 SMS, 발신 SMS, 브라우저에서의 통화를 포함합니다. 기니에서 오래 쓸 회선이 필요하면 [email protected]으로 이메일을 보내세요. 제공 여부는 현지 규정에 따라 달라지며, 마련이 어려우면 팀이 솔직하게 알려드립니다.

자주 묻는 질문

현지 SIM 없이 앱의 기니 회원가입을 테스트할 수 있나요?

네. OTP Gateway에서 +224 번호를 주문해 가입 양식에 입력하고, 대시보드나 웹훅으로 코드를 확인하세요.

OTP Route에서 기니의 국가 ID는 무엇인가요?

ID는 gn입니다. 활성화 요청 본문과 가격 조회 쿼리에 넣어 사용하세요.

기니 SMS OTP를 받는 데 비용은 얼마인가요?

코드당 $0.20부터이며, 정확한 금액은 서비스에 따라 다르고 주문 전에 표시됩니다.

코드가 오지 않은 활성화에도 요금을 내나요?

아니요. 20분의 창이 SMS 없이 끝나거나 직접 취소하면 전액이 지갑으로 자동 환불됩니다.

기니 코드를 받으려면 웹훅이 꼭 필요한가요, 아니면 폴링해도 되나요?

둘 다 가능합니다. 병렬 테스트 스위트에는 웹훅이 잘 맞고, 간단한 스크립트라면 분당 300건 요청 한도 안에서 GET /api/v1/activations/{id}를 폴링해도 됩니다.

모든 서비스가 +224 OTP Route 번호를 받아주나요?

아니요. 일부 서비스는 가상 번호를 거부하며, 그래서 사용되지 않은 활성화는 환불됩니다. 항상 해당 서비스의 약관과 당사의 이용 정책을 지켜 주세요.

결제는 어떻게 하고, 인보이스도 받을 수 있나요?

카드 또는 USDT/USDC로 선불 USD 지갑 하나를 충전하면 되며, 요금제나 월 사용료는 없습니다. 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 자세한 내용은 요금을 참고하세요.

기니 연동을 개발할 샌드박스가 있나요?

네, 요청 시 제공됩니다. 개발 계정을 샌드박스로 전환하면 모의 번호와 코드가 반환되므로, 지갑 잔액을 쓰지 않고 SMS 인증 API 흐름 전체를 실행해 볼 수 있습니다.

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