생바르텔레미(+590) 인증 코드 수신을 위한 체크리스트

+590 번호를 주문하기 전 사전 점검 목록

생바르텔레미는 OTP Route에서 규모가 작은 경로 중 하나이므로, 조금만 준비해도 낭비되는 시도를 줄일 수 있습니다.

• 오늘 해당 서비스가 목록에 있는지 확인하세요. GET /api/v1/countries와 GET /api/v1/services를 호출하거나 대시보드를 열어 보세요. 국가 ID는 bl입니다.
• 가격을 확인하세요. GET /api/v1/prices?country=bl&service=<id>는 해당 조합의 실시간 가격을 반환합니다.
• 지갑을 충전하고, 자동화 작업이라면 먼저 GET /api/v1/balance를 확인하세요.
• 전화번호 입력란이 국가 코드 뒤에 아홉 자리가 오는 +590 번호를 받도록 준비하세요.
• 서비스의 가상 번호 정책을 파악하세요. 일부는 거부합니다.
• 대체 경로를 준비해 두세요. 이곳의 커버리지는 자주 바뀝니다.

이 방식이 처음이라면 OTP 게이트웨이란 무엇인가에서 기본을 설명합니다.

생바르텔레미 번호로 코드를 보낼 수 있는 서비스는 무엇인가요?

이 경로에는 현재 20개 이상의 서비스가 등록되어 있어, 규모가 큰 시장에 비해 목록이 훨씬 짧습니다. 실시간 스냅샷에는 TikTok, Amazon, LinkedIn, AliExpress, Flipkart, Mercado Libre, Mercado Pago, Coinbase, Bumble, Swiggy 등이 포함됩니다.

목록이 짧고 하루 중에도 바뀌므로, 주문 시점에 항상 API에서 가용성을 확인하세요. 필요한 서비스가 없다면 +590 국가 코드를 공유하는 인접한 과들루프 경로나 프랑스어 테스트 케이스에 맞는 프랑스 경로가 적합할 수 있습니다.

단계별 안내: 생바르텔레미 OTP 라우팅의 API 플로우

1. or_live_로 시작하는 Bearer 키로 https://otproute.com/api/v1에 인증합니다(계정당 키 최대 10개, 분당 요청 300건).
2. 주문합니다. POST /api/v1/activations에 {"service": "linkedin", "country": "bl"}를 보냅니다. 반환된 활성화 ID와 번호를 보관하세요.
3. 테스트 중인 앱이나 사이트에 +590 번호를 입력합니다.
4. activation.sms_received 이벤트에서 +590 코드를 받거나, 몇 초마다 GET /api/v1/activations/{id}를 폴링하는 방식으로 대체합니다.
5. t=<unix>,v1=<hex> 형태의 X-OTPRoute-Signature 헤더를 검증합니다. 엔드포인트 시크릿으로 "<t>.<raw body>"의 HMAC-SHA256을 계산하고, 오래된 타임스탬프는 거부합니다.
6. 테스트가 일찍 끝나면 POST /api/v1/activations/{id}/cancel로 취소합니다.

개발자 개요에서 키, 웹훅, 예제를 한곳에서 볼 수 있습니다.

+590 번호는 어떻게 표기하고 저장하나요?

생바르텔레미는 과들루프, 생마르탱의 프랑스령 지역과 함께 +590 국가 코드를 쓰며 프랑스 번호 규칙을 따릅니다. 현지에서는 번호를 트렁크 0이 붙은 열 자리로 쓰며, 유선은 보통 0590, 휴대전화는 0690으로 시작합니다. E.164에서는 0을 빼므로 휴대전화는 +590 690 뒤에 여섯 자리가 붙습니다.

많은 팀이 놓치는 점이 있습니다. 국가 코드만으로는 고객이 어느 영토에 사는지 알 수 없습니다. 제품이 지역별 콘텐츠를 보여 준다면 +590으로 추정하지 말고 영토를 별도로 물어보세요. E.164 문자열은 공백 없이 저장하고 영토는 별도 필드로 유지하세요.

공용어는 프랑스어이므로, 코드 메시지는 발신 서비스가 현지화하는 방식에 따라 프랑스어나 영어로 도착하는 것이 일반적입니다.

팀은 왜 생바르텔레미에서 테스트하거나 운영하나요?

섬의 경제는 관광을 중심으로 하므로 여행, 빌라 임대, 컨시어지, 보트 차터, 숙박 앱이 대표적인 이유입니다. 팀은 +590 번호를 가진 투숙객이나 현지 직원이 가입을 마칠 수 있는지 확인하고 싶어 하고, 호텔의 카리브해 캠페인을 운영하는 에이전시가 현지 고객의 비즈니스 프로필을 인증하기도 합니다. 카리브해 프랑스어 플로우의 현지화 QA도 또 다른 이유이며, 이 용도는 운영팀 페이지에서 다룹니다.

문제 해결: 코드가 도착하지 않았을 때

모든 활성화는 20분간 열려 있으며, 코드가 도착한 경우에만 요금을 냅니다. 유효 시간이 비어 있는 채로 끝나거나 주문을 취소하면 전액이 지갑으로 자동 환불되고, 웹훅으로 activation.expired 또는 activation.cancelled가 전달됩니다.

• 포기하기 전에 유효 시간을 끝까지 두세요.
• 서비스가 가상 번호를 허용하는지 확인하세요.
• 나중에 다시 시도하거나 다른 서비스 경로 또는 인접 국가로 바꾸세요.
• 짧은 간격으로 재주문하지 말고 시도 사이에 간격을 두세요.

코드 없이 쓰는 경로는 이렇습니다. 이메일과 6자리 이메일 코드 또는 Google 로그인으로 가입하고, TOTP를 켜고, 충전한 뒤, 생바르텔레미와 서비스를 선택해 표시된 가격을 수락하고 대시보드에서 코드를 확인하세요.

장기 회선, 요금 청구, 샌드박스

생바르텔레미에는 셀프서비스 장기 번호가 없습니다. 전용 회선은 월 $1.95부터인 미국·캐나다 제품이며, 지속적인 +590 회선이 필요하면 [email protected]으로 문의하세요. 다만 제공 여부는 현지 규정에 따르며 보장되지 않습니다.

결제는 선불 USD 지갑 하나에서 사용한 만큼 내며 월 요금이나 요금제는 없습니다. 카드 또는 USDT/USDC로 충전하고, 충전마다 PDF 인보이스를 이메일로 받습니다. 개발 계정은 샌드박스 모드를 요청할 수 있으며, 모의 번호와 코드가 반환되어 비용 없이 연동을 처음부터 끝까지 테스트할 수 있습니다.

+590 번호는 자신의 제품과 계정에만 사용하고, 각 서비스의 약관을 따르며, OTP Route 이용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요.

자주 묻는 질문

현지 SIM 없이 생바르텔레미 인증 코드를 받을 수 있나요?

그 시점에 해당 서비스가 경로에 있다면 가능합니다. OTP Gateway에서 +590 번호를 주문하고 대시보드나 API에서 코드를 확인하세요.

생바르텔레미의 API 국가 ID는 무엇인가요?

bl이며, 주문 본문은 {"service": "tiktok", "country": "bl"}처럼 작성합니다.

생바르텔레미의 서비스 목록은 왜 이렇게 짧나요?

규모가 작은 경로이고 커버리지가 자주 바뀝니다. GET /api/v1/countries나 대시보드에서 현재 목록을 확인하고, 대안으로 과들루프나 프랑스를 고려해 보세요.

+590이면 항상 고객이 생바르텔레미에 있다는 뜻인가요?

아니요. 과들루프와 생마르탱의 프랑스령 지역도 +590을 공유하므로, 제품에 중요하다면 영토를 별도로 수집하세요.

테스트용 +590 번호는 얼마인가요?

코드당 $0.20부터이며, 정확한 금액은 서비스에 따라 정해지고 주문 전에 API가 실시간으로 반환합니다.

코드가 오지 않으면 돈을 잃나요?

아니요. SMS 없이 20분이 지나거나 취소하면 전액이 지갑으로 돌아갑니다.

반복 로그인을 위해 생바르텔레미 번호를 계속 보유할 수 있나요?

셀프서비스로는 불가능합니다. Dedicated Numbers는 미국과 캐나다에서만 제공되며, 다른 옵션은 [email protected]으로 문의하세요.

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