프랑스만 가정한 전화번호 검증이 마르티니크에서 깨지는 이유는?
마르티니크는 프랑스이자 유럽연합의 일부이지만, +33이 아닌 고유한 국가 코드 +596을 가지고 있습니다. 이 조합 때문에 흔한 버그가 생깁니다. 프랑스 제품이 전화번호 입력란을 +33으로 제한하거나 국가 선택기가 마르티니크를 프랑스 아래에 숨기면, 섬의 고객은 가입을 끝낼 수 없습니다.
현지 번호는 트렁크 0이 붙는 프랑스식 열 자리 체계를 따릅니다. 휴대폰 번호는 보통 0696 또는 0697 뒤에 여섯 자리를 쓰고, 유선 번호는 0596으로 시작합니다. E.164에서는 0을 빼고 국가 코드를 붙여 휴대폰이 +596 696 xx xx xx가 됩니다. 유선의 특이점에 주의하세요. +596 596…은 숫자가 반복되는데, 일부 자체 제작 검증기가 이를 오타로 잘못 판단합니다.
+596과 아홉 자리를 저장하고, 공백은 화면에서만 추가합니다.- 섬이 선택된 상태에서 사용자가
0696…을 입력하면 트렁크 0을 제거합니다. - +596, 과들루프(+590), 프랑스령 기아나(+594)가 각각 별개의 코드로 받아들여지는지 테스트합니다.
누가 테스트용 +596 번호를 필요로 하나요?
프랑스어가 공용어이고 마르티니크 크레올어도 널리 쓰이지만, 글로벌 앱의 인증 문자는 계정 로케일에 따라 거의 항상 프랑스어나 영어로 옵니다. 그래서 이미 프랑스를 대상으로 현지화한 팀에게 마르티니크는 유용한 점검 대상입니다.
- 프랑스 및 EU 출시에서 해외 거주자를 국내 고객으로 대우해야 하는 경우.
- 섬에서 사용되는 여행, 배달, 숙박 제품의 카리브해 운영.
- 드물게 쓰이는 국가 코드에 대한 전화번호 파싱, SMS 템플릿, 복구 플로우를 다루는 회귀 테스트 스위트.
이런 점검을 기존 파이프라인에 넣는 방법은 QA 테스트 가이드에 설명되어 있습니다.
마르티니크 번호로 코드를 보낼 수 있는 서비스는?
마르티니크 라우트에서는 600개 넘는 서비스를 사용할 수 있습니다. 현재 스냅샷의 인기 서비스로는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, Amazon, Discord, Snapchat, Airbnb, Uber, Netflix가 있습니다.
가용 여부는 하루 중 달라지므로, 테스트 계획에 고정하지 말고 필요한 시점에 API에서 읽어 오세요.
API로 마르티니크 SMS OTP 코드를 받으려면?
개발자 콘솔에서 Bearer 키(접두어 or_live_)를 만들고 클라이언트를 https://otproute.com/api/v1로 지정하세요. 마르티니크의 국가 ID는 mq입니다.
GET /api/v1/prices?country=mq&service=<id>로 해당 조합의 실시간 가격과 재고를 확인합니다.POST /api/v1/activations에{"service": "airbnb", "country": "mq"}또는 테스트 중인 서비스를 넣어 주문합니다.- 반환된 +596 번호를 자사 앱에 입력하고 코드 발송을 트리거합니다.
activation.sms_received를 구독한 웹훅으로 받거나,GET /api/v1/activations/{id}를 몇 초 간격으로 폴링합니다.- 테스트가 일찍 끝나면
POST /api/v1/activations/{id}/cancel로 액티베이션을 해제합니다.
모든 웹훅은 신뢰하기 전에 검증하세요. X-OTPRoute-Signature 헤더에는 t=<unix>,v1=<hex>가 들어 있으며, v1은 엔드포인트 시크릿을 키로 한 <t>.<raw body>의 HMAC-SHA256입니다. 오래된 타임스탬프를 거부하고 핸들러를 액티베이션 ID 기준으로 멱등하게 만드세요. 전체 레퍼런스는 개발자 문서에 있습니다.
개발자가 아닌 사람을 위한 대시보드 경로가 있나요?
지원 담당자와 그로스 팀은 브라우저에서 같은 OTP 라우팅을 실행할 수 있습니다. 이메일이나 Google로 가입하고 지갑을 충전한 뒤 마르티니크와 서비스를 선택하고, 표시된 가격을 확인하고 확정하세요. +596 번호가 화면에 나타나고, SMS가 도착하면 같은 카드에 코드가 추가됩니다. 윈도우는 20분이며, SMS가 없거나 취소하면 금액이 바로 잔액으로 돌아옵니다.
+596 인증 코드가 늦거나 오지 않으면?
규모가 작은 라우트는 더 조용할 수 있으니 미리 대비하세요.
- 시도가 실패했다고 판단하기 전에 윈도우가 끝날 때까지 기다립니다.
- 서비스가 가상 번호를 거부할 수 있음을 기억하세요. 이 경우 요금은 청구되지 않습니다.
- 잠시 뒤에 다시 시도하거나, 시나리오가 허용한다면 과들루프 같은 인근 라우트를 사용하세요.
- 주문 엔드포인트를 연타하지 말고 재시도 간격을 두세요.
전달 실패 점검 목록에 더 많은 아이디어가 있습니다. 각 서비스의 약관을 따르세요. OTP Route의 이용 정책(Acceptable Use Policy)이 적용됩니다.
마르티니크 영구 번호를 받을 수 있나요? 결제는 어떻게 하나요?
마르티니크에는 셀프서비스 장기 번호가 제공되지 않습니다. 전용 회선은 미국과 캐나다에서만 월 $1.95부터 시작합니다($1.95/month). 마르티니크 회선이 필요하면 [email protected]으로 문의하되, 가능한 범위는 현지 규정에 따라 결정된다는 점을 알아 두세요.
결제는 구독 없는 하나의 선불 USD 지갑으로 이루어집니다. 카드 또는 USDT/USDC로 충전하면 충전할 때마다 PDF 인보이스를 받으며, 연동 작업 중 시뮬레이션된 번호와 코드가 필요하면 개발 계정에 샌드박스 모드를 요청할 수 있습니다.
자주 묻는 질문
마르티니크 번호는 프랑스 +33 번호와 같은가요?
아니요. 마르티니크는 프랑스의 일부이지만 고유한 국가 코드 +596을 사용하므로, 폼이 이를 별도로 받아들여야 합니다.
마르티니크 휴대폰 번호의 E.164 형식은 어떤가요?
앞자리 0을 빼고 국가 코드를 붙입니다. 0696 xx xx xx로 적힌 번호는 +596 696 xx xx xx가 됩니다.
마르티니크에는 어떤 국가 ID를 보내나요?
가격 조회와 액티베이션 요청의 country 값으로 mq를 보내세요.
현지 SIM 없이 예약 앱의 마르티니크 가입을 확인할 수 있나요?
네. OTP Gateway에서 해당 서비스용 +596 번호를 주문하고, 대시보드나 API로 코드를 읽으세요.
SMS를 받지 못한 +596 액티베이션에도 요금을 내나요?
아니요. 만료되거나 취소된 액티베이션은 지갑으로 전액 환불되며, 코드가 도착할 때만 결제됩니다.
OTP Route는 마르티니크 장기 회선을 판매하나요?
셀프서비스로는 판매하지 않습니다. 장기 전용 번호는 미국과 캐나다 제품이며, 마르티니크는 [email protected]으로 문의하세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.