볼리비아(+591) SMS 인증을 위한 사전 점검 체크리스트

+591 번호를 주문하기 전에 체크리스트에 무엇을 넣어야 하나요?

볼리비아 테스트가 실패하는 대부분의 원인은 경로 자체가 아니라 준비되지 않은 어떤 설정입니다. 먼저 다음을 하나씩 확인하세요.

• API 키: 개발자 콘솔에서 만든 or_live_ 접두사 키를 CI나 앱 설정에 시크릿으로 저장합니다. 환경마다 키를 하나씩 두면 로그를 읽기 쉽습니다.
• 웹훅 엔드포인트: HTTPS로 빠르게 응답하고 서명 시크릿이 로드된 상태여야 합니다. 폴링도 가능하지만, 테스트 하네스가 어느 쪽을 쓸지 정해 두세요.
• 지갑 잔액: 실행에 필요한 금액을 충전하거나, 연동 구조만 점검한다면 샌드박스 계정을 사용하세요.
• 서비스 id: 테스트할 앱의 id는 GET /api/v1/services에서 가져오고, 볼리비아의 국가 id는 bo입니다.
• 전화번호 파서: 받은 번호를 실제로 가입 양식에 입력할 수 있도록 제품이 +591 입력을 받아들여야 합니다.

하나라도 빠져 있다면 활성화를 한 번이라도 쓰기 전에 먼저 해결하세요.

현재 볼리비아 경로로 어떤 앱을 이용할 수 있나요?

볼리비아의 실시간 목록에는 1,700개가 넘는 서비스가 있습니다. 팀들이 가장 많이 요청하는 서비스로는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Uber, Microsoft & Outlook, Discord, LinkedIn, Viber, Signal, AliExpress 등이 있습니다.

소비자 앱이 메신저 로그인에 의존하고 배달이나 차량 호출 제품은 자체 휴대폰 확인이 필요한 볼리비아 같은 시장에서는 이런 폭넓은 지원이 중요합니다. 위 목록은 스냅샷으로 보세요. 서비스별 사용 가능 여부는 하루 중에도 바뀌며, 그래서 가격 엔드포인트가 정적인 페이지 대신 실시간으로 이를 알려 줍니다.

볼리비아 OTP API 흐름을 단계별로 실행하려면 어떻게 하나요?

모든 호출은 Bearer 키와 함께 https://otproute.com/api/v1로 보내며, 계정 한도는 분당 300건입니다.

1. GET /api/v1/prices?country=bo&service=<id>로 현재 가격과 재고를 가져옵니다. 지금 경로가 비어 있다면 주문을 건너뜁니다.
2. 활성화를 생성합니다. POST /api/v1/activations에 {"service": "<id>", "country": "bo"}를 보내고, 활성화 id와 반환된 번호를 저장합니다.
3. 테스트 중인 앱의 가입 또는 로그인 화면에 번호를 입력합니다.
4. activation.sms_received 웹훅을 기다리거나 여유 있는 간격으로 GET /api/v1/activations/{id}를 폴링합니다.
5. 테스트를 중단하면 POST /api/v1/activations/{id}/cancel을 호출해 보류된 금액을 즉시 지갑으로 되돌립니다.

신뢰하기 전에 모든 웹훅을 검증하세요. X-OTPRoute-Signature 헤더에는 t=<unix>,v1=<hex>가 들어 있으며, hex는 엔드포인트 시크릿으로 계산한 "<t>.<raw body>"의 HMAC-SHA256입니다. 오래된 타임스탬프는 거부하세요. 전체 핸들러는 OTP API 연동 가이드에서 안내합니다.

볼리비아 번호는 어떻게 저장하고 검증해야 하나요?

볼리비아 휴대폰 번호는 +591 국가 코드 뒤에 8자리가 오며 보통 6 또는 7로 시작합니다. 예를 들어 +591 뒤에 그 8자리를 붙이는 E.164 형식으로 공백 없이 저장하고, 사용자가 현지식 띄어쓰기나 맨 앞 0을 넣어 입력한 값은 저장 전에 정규화하세요.

볼리비아는 케추아어, 아이마라어, 과라니어 등 여러 언어도 공식적으로 인정하지만, 인증 메시지는 대부분 스페인어로 도착합니다. 제품이 원주민 언어 인터페이스를 제공한다면, 자사 백엔드가 보내는 SMS 템플릿이 올바르게 표시되는지 확인하세요. 그 경로는 타사 앱이 보내는 경로와 별개이기 때문입니다.

팀들은 보통 안데스 국가 전역에 걸친 지역 출시, 스페인어 흐름의 현지화 QA, 또는 해외에 살면서 볼리비아 번호로 가입한 고객 지원을 위해 볼리비아를 찾습니다.

코드를 작성하지 않는 사람을 위한 대시보드 경로가 있나요?

네, 같은 체크리스트 논리를 따릅니다. 운영 또는 지원 담당자는 다음과 같이 진행할 수 있습니다.

1. /signup에서 이메일 코드 또는 Google로 로그인하고 TOTP 2단계 인증을 켭니다.
2. OTP Gateway를 열고 서비스를 고른 뒤 볼리비아를 선택합니다. 요금이 부과되기 전에 실시간 가격이 표시됩니다.
3. 번호를 앱에 복사하고 대시보드 탭을 열어 둡니다. SMS가 도착하면 그곳에 코드가 나타납니다.

연동을 건드리지 않고 운영 중인 로그인 화면을 한 번 확인할 때 유용합니다.

볼리비아 코드가 나타나지 않으면 무엇을 점검해야 하나요?

다음을 순서대로 확인하세요.

• 활성화 시간을 끝까지 두세요. 활성화는 20분 동안 열려 있으며, 일찍 닫으면 시도가 낭비됩니다.
• 앱 자체의 규칙을 확인하세요. 일부 서비스는 가상 번호를 아예 거부하며, 환불은 바로 그런 경우를 위해 있습니다.
• 나중에 재시도하거나 다른 경로를 사용하세요. 재고는 하루 중에 바뀌므로 한 시간 뒤의 두 번째 시도는 다르게 동작할 수 있습니다.
• 짧은 간격으로 반복 주문하지 마세요. 한 서비스에 빠르게 반복하면 오히려 상황이 나빠지고 로그만 어지러워지기 쉽습니다.

활성화 시간이 끝나기 전에 SMS가 도착하지 않으면 전액이 지갑으로 자동 환불됩니다. 더 많은 방법은 OTP 인증 실패 줄이기에 있습니다.

볼리비아 장기 회선을 유지할 수 있나요? 결제는 어떻게 처리되나요?

볼리비아에는 셀프 서비스 장기 번호가 없습니다. OTP Route는 Dedicated Virtual Numbers를 미국과 캐나다에서만 월 $1.95부터 판매합니다. 팀에 볼리비아 회선이 필요하다면 [email protected]으로 이메일을 보내 주세요. 현지 규정상 가능한지 안내해 드리지만 제공을 약속하지는 않습니다.

결제는 월 요금과 선택할 요금제가 없는 하나의 선불 USD 지갑으로 이루어집니다. 카드 또는 USDT/USDC로 충전하며, 충전할 때마다 PDF 인보이스가 이메일로 도착합니다. 연동 작업에는 자금을 쓰지 않고 모의 번호와 코드를 반환하는 샌드박스 모드를 요청하세요. 전체 요금은 /pricing에 있습니다.

자주 묻는 질문

현지 SIM 없이 내 앱의 볼리비아 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 서비스용 +591 번호를 주문해 앱에 입력하고, 대시보드나 API에서 코드를 확인하세요.

OTP Route API에서 볼리비아의 국가 id는 무엇인가요?

가격 조회 쿼리와 활성화 본문 모두에서 bo를 사용하세요.

볼리비아 SMS가 도착하지 않으면 요금을 내야 하나요?

아니요. 20분 안에 아무것도 도착하지 않거나 먼저 취소하면 금액이 지갑으로 자동 환불됩니다.

볼리비아 인증 문자는 어떤 언어로 오나요?

보통 스페인어이지만, 문구는 각 앱이 정하며 계정이나 기기의 언어를 따를 수 있습니다.

QA 파이프라인에서 이 +591 번호를 매일 밤 테스트에 쓸 수 있나요?

활성화 하나는 코드 한 번만 처리하므로, 야간 작업은 실행마다 새 번호를 주문합니다. 패턴은 CI 파이프라인의 SMS OTP 테스트를 참고하세요.

몇 달 뒤 다시 로그인해야 하는 계정에 볼리비아 번호를 써도 되나요?

권장하지 않습니다. 일회용 번호는 보관되지 않기 때문입니다. 오래 유지할 계정에는 미국 또는 캐나다 Dedicated Number가 더 적합합니다.

볼리비아 인증 번호로 인증할 수 있는 대상에 규칙이 있나요?

네. 본인의 제품과 정당한 비즈니스 계정에만 사용하고, 각 서비스의 약관을 따르며, OTP Route의 이용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요.

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