개발자와 QA를 위한 프랑스령 기아나(+594) 인증 번호

코드 한 번인가, 계속 쓰는 번호인가: 프랑스령 기아나는 무엇을 지원하나요?

코드를 작성하기 전에 작업에 어떤 상품이 맞는지 먼저 정하세요.

• OTP Gateway는 일회성 인증에 적합합니다. 가입 흐름이 프랑스령 기아나 인증 번호를 받아들이는지 확인하거나, 릴리스 전 회귀 테스트를 돌리거나, 지역 비즈니스 프로필을 한 번 설정하는 경우입니다. 번호 하나로 코드 하나만 받습니다.
• Dedicated Virtual Numbers는 계속 코드를 받아야 하는 계정에 맞습니다. 예를 들어 QA 팀이 매주 여는 스테이징 로그인이 그렇습니다. 이 번호는 미국과 캐나다에서만 즉시 구매할 수 있으며 월 $1.95부터입니다.

프랑스령 기아나는 첫 번째 경우에 해당합니다. 셀프서비스 방식의 장기 +594 회선은 없습니다. 필요하다면 [email protected]으로 문의하세요. 제공 여부는 현지 규정에 따라 달라집니다. 어느 쪽이 맞는지 헷갈린다면 임시 번호와 전용 번호 비교 글이 도움이 됩니다.

프랑스령 기아나 OTP API는 어떤 순서로 동작하나요?

프랑스령 기아나의 국가 id는 gf입니다. Bearer 키(접두사 or_live_)로 https://otproute.com/api/v1을 호출합니다.

1. GET /api/v1/prices?country=gf&service=<id>는 실시간 가격을 반환하고 해당 경로가 열려 있는지 알려 줍니다.
2. POST /api/v1/activations에 {"service": "facebook", "country": "gf"}를 보내면 +594 번호가 예약되고 activation id가 반환됩니다.
3. 테스트가 테스트 대상 앱에 그 번호를 입력합니다.
4. 코드는 웹훅의 activation.sms_received로 전달되거나, 폴링한다면 GET /api/v1/activations/{id}로 가져옵니다.
5. POST /api/v1/activations/{id}/cancel은 더 이상 필요 없는 주문을 해제합니다.

웹훅 요청에는 t=<unix>,v1=<hex> 형식의 X-OTPRoute-Signature가 포함됩니다. 엔드포인트 시크릿으로 "<t>.<raw body>"의 HMAC-SHA256을 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프는 거부하고, activation id로 중복을 제거하세요. 계정당 한도는 API 키 10개, 웹훅 엔드포인트 5개, 분당 요청 300회이며 전체 레퍼런스는 문서에 있습니다.

+594 번호가 전화번호 검증을 혼란스럽게 만드는 이유는 무엇인가요?

프랑스령 기아나는 프랑스의 해외 지역이라 프랑스 번호 체계를 따르지만, 프랑스의 +33이 아닌 독자적인 국가 코드 +594를 씁니다. 국내에서는 앞에 0이 붙는 10자리 번호이며, 휴대전화는 보통 0694, 유선전화는 0594로 시작합니다. 국제 표기에서는 0을 빼므로 휴대전화는 +594 694 XX XX XX가 됩니다.

이런 구조 때문에 전형적인 버그가 몇 가지 생기고, 테스트용 +594 번호는 이를 가장 쉽게 잡아내는 방법입니다.

• 국가 선택기가 프랑스 영토를 모두 프랑스로 묶어서 0694 번호 앞에 +33을 붙이는 경우
• 전화번호 라이브러리는 지역을 GF로 보고하는데 비즈니스 로직은 FR만 아는 경우
• 표시 코드는 프랑스식 두 자리 묶음으로 포맷하면서 E.164가 아니라 포맷된 문자열을 저장하는 경우

+594…는 공백 없이 저장하고, 데이터 모델에서 지역과 국가를 별개의 개념으로 유지하세요.

어떤 앱이 프랑스령 기아나 번호로 인증 코드를 보낼 수 있나요?

현재 프랑스령 기아나 경로에서는 700개가 넘는 서비스를 이용할 수 있습니다. 실시간 스냅샷에는 WhatsApp, Facebook, Instagram, Google(Gmail & YouTube), TikTok, Snapchat, Telegram, Microsoft & Outlook, Amazon, Airbnb, Uber, LinkedIn이 포함됩니다.

SMS 문구는 보통 현지 계정에서 가장 많이 쓰는 프랑스어이지만 서비스마다 자체 템플릿을 사용하므로, 특정 문구를 찾지 말고 숫자를 추출하세요. 프랑스 본토 밖의 프랑스어 흐름을 현지화할 때, 프랑스 해외 지역 고객에게 서비스할 때, 설정을 바꾼 뒤에도 지역 계정 인증이 되는지 확인할 때 이곳에서 테스트합니다.

대시보드에서 +594 번호는 어떻게 주문하나요?

코드 작성은 필요 없습니다.

1. 이메일과 6자리 이메일 코드 또는 Google 로그인으로 가입하고, 이때 TOTP 2단계 인증도 켜 두세요.
2. 카드 또는 USDT/USDC로 지갑을 충전합니다.
3. 프랑스령 기아나와 서비스를 선택합니다. 확정하기 전에 가격이 표시됩니다.
4. 번호를 앱에 붙여 넣고 활성화 페이지에서 코드를 확인합니다.

운영 담당자와 에이전시 계정 매니저는 보통 이 방법을 쓰고, 엔지니어는 API를 연동합니다. 둘 다 같은 지갑을 사용합니다.

코드가 끝내 오지 않으면 어떻게 되나요?

활성화는 20분간 유지됩니다. 코드가 도착했을 때만 결제되며, 주문을 취소하거나 SMS 없이 시간이 끝나면 전액이 자동으로 지갑에 환불됩니다.

+594 코드를 기다리고 있다면 다음을 확인하세요.

• 제한 시간이 끝날 때까지 기다리세요. 아무 문제가 없어도 서비스가 느릴 수 있습니다.
• 서비스가 가상 번호를 받아 주는지 확인하세요. 받지 않는 곳도 있으며, 환불은 바로 그런 경우를 위해 있습니다.
• 나중에 다시 시도하거나 다른 서비스 경로를 선택하세요.
• 실패할 때마다 즉시 재주문하는 스크립트는 피하세요. 지수 백오프를 쓰면 +594 경로를 모두가 계속 이용할 수 있습니다.

OTP 전송 실패 줄이기 글에서 더 자세히 다룹니다. 프랑스령 기아나 테스트는 팀이 소유한 제품과 계정에 한정하고, 각 서비스의 약관을 지키며, OTP Route의 이용 정책(Acceptable Use Policy)을 약속의 일부로 받아들여 주세요.

결제, 인보이스, 샌드박스 테스트는 어떻게 처리되나요?

OTP Route는 선불 USD 지갑으로 운영됩니다. 사용한 만큼만 내며 월 요금도 요금제도 없습니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하고, 충전할 때마다 회계팀을 위한 PDF 인보이스가 이메일로 발송됩니다. 현재 요금은 요금 페이지에서 확인할 수 있습니다.

gf 흐름을 연동하는 엔지니어는 지원팀에 개발 계정을 샌드박스로 전환해 달라고 요청할 수 있습니다. 샌드박스는 시뮬레이션된 번호와 코드를 반환하므로, 지갑 잔액을 쓰지 않고도 +594 흐름, 웹훅 검증, 재시도 로직을 처음부터 끝까지 시험할 수 있습니다. API 관점에서 프랑스령 기아나로의 OTP 라우팅은 다른 시장과 다르지 않습니다. 국가 id만 바뀌고 SMS 인증 API는 그대로입니다.

자주 묻는 질문

현지 SIM 없이 앱의 프랑스령 기아나 가입 흐름을 테스트할 수 있나요?

네. gf용 OTP Gateway 번호를 주문해 가입 양식에 입력하면, 대시보드나 웹훅에서 코드를 읽을 수 있습니다.

프랑스령 기아나 번호는 프랑스 +33 번호와 같은가요?

아니요. 프랑스령 기아나는 프랑스 번호 체계를 따르지만 독자적인 국가 코드 +594를 쓰며, 전화번호 라이브러리도 별도의 지역으로 취급합니다.

+594 코드는 얼마인가요?

코드당 $0.20부터이며 서비스에 따라 다릅니다. 대시보드와 GET /api/v1/prices에서 실시간 가격을 확인할 수 있습니다. 20분 안에 SMS가 오지 않으면 자동으로 환불됩니다.

나중에 로그인할 수 있도록 프랑스령 기아나 번호를 유지할 수 있나요?

셀프서비스 옵션은 없습니다. 장기 Dedicated Numbers는 미국과 캐나다에서만 제공되며, +594에 대해서는 [email protected]으로 문의해 주세요.

코드는 어떤 언어로 오나요?

보통 프랑스어이지만, 서비스마다 템플릿을 정하고 계정의 언어 설정을 따를 수도 있습니다.

지갑을 충전하기 전에 연동을 테스트할 수 있나요?

개발 계정에 샌드박스 모드를 요청하세요. 번호와 코드를 시뮬레이션하므로 비용 없이 전체 흐름을 시험할 수 있습니다.

프랑스령 기아나 코드가 도착하지 않은 이유는 무엇인가요?

서비스가 느리거나, 가상 번호를 거부하거나, 경로가 혼잡할 수 있습니다. 제한 시간을 기다린 뒤 나중에 또는 다른 경로로 다시 시도하세요. 실패한 주문은 환불됩니다.

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