팀에 보스니아 SIM이 없어도 +387 가입 인증하기

릴리스에 +387 테스트가 필요한데 SIM은 사라예보의 서랍 속에 있습니다. 어떻게 하죠?

서부 발칸 지역에 제품을 출시하는 팀이 흔히 겪는 난관입니다. 프로덕트 매니저는 보스니아 사용자가 가입할 수 있다는 증거를 원하고, QA 리드의 체크리스트에는 "현지 번호로 인증"이라는 항목이 있는데, 실물 +387 SIM은 지난봄에 퇴사한 동료의 것뿐입니다.

팀이 이런 상황에 놓이는 일반적인 이유는 다음과 같습니다.

• 지역 출시: 보스니아 헤르체고비나를 크로아티아, 세르비아, 몬테네그로와 함께 다루는 경우로, 시장마다 가입 경로를 따로 점검해야 합니다.
• 디아스포라 고객: 독일, 오스트리아, 스웨덴 등에 사는 많은 사람이 여전히 +387 번호를 유지하므로, 핀테크나 통신 인접 제품은 온보딩 중 한 번도 보스니아에 발을 들이지 않은 사용자의 보스니아 번호를 만날 수 있습니다.
• 현지화 QA: 보스니아어, 크로아티아어, 세르비아어가 모두 공용어이고 라틴 문자와 키릴 문자가 일상적으로 함께 쓰이므로, 문구와 양식 검증은 실제 종단 간 점검을 받을 가치가 있습니다.

SIM 카드를 우편으로 돌리는 대신 OTP Route가 OTP 라우팅을 처리합니다. OTP Gateway가 한 번의 인증을 위한 +387 번호를 내주고, 수신된 SMS를 테스트 하네스가 호출할 수 있는 SMS 인증 API로 전달합니다.

어떤 앱과 플랫폼이 보스니아 인증 번호로 코드를 보낼 수 있나요?

제공 현황은 실시간 스냅샷이므로 고정된 메뉴가 아니라 출발점으로 보세요. 작성 시점에 보스니아 헤르체고비나 경로에는 Viber, WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, Microsoft & Outlook, LinkedIn, Discord, Uber, Amazon, eBay 등이 포함되어 있습니다.

이 나라에서 이용할 수 있는 서비스는 모두 1,600개가 넘습니다. 여기에 없는 서비스를 위한 보스니아 헤르체고비나 인증 번호가 필요하다면 먼저 실시간 목록을 확인하세요. 발칸 지역에서는 Viber가 다른 많은 지역보다 중요하므로, 자사 제품이 SMS뿐 아니라 메신저 채널로도 코드를 보낸다면 기억해 둘 만합니다. 사용 가능 여부는 하루 중에도 바뀌므로 테스트 스위트에 목록을 하드코딩하지 말고 API에서 현재 옵션을 조회하세요.

보스니아 헤르체고비나 OTP API 흐름은 호출별로 어떻게 진행되나요?

보스니아 테스트에서는 클라이언트를 https://otproute.com/api/v1로 지정하고 or_live_ 키를 Bearer 토큰으로 전달하세요. 키는 개발자 콘솔에서 만들며, 계정당 키 최대 10개와 웹훅 엔드포인트 최대 5개를 보유할 수 있고 분당 300건까지 요청할 수 있습니다.

1. GET /api/v1/services와 GET /api/v1/countries를 한 번 호출해 id를 캐시하고 ba가 목록에 있는지 확인합니다.
2. GET /api/v1/prices?country=ba&service=<id>로 비용을 확인해, 비용을 쓰기 전에 작업 로그에 정확한 금액을 남깁니다.
3. POST /api/v1/activations에 {"service": "<id>", "country": "ba"}를 보냅니다. 응답에는 활성화 id와 테스트 중인 앱에 입력할 +387 번호가 들어 있습니다.
4. activation.sms_received 웹훅을 기다리거나, 러너가 인바운드 트래픽을 받을 수 없다면 GET /api/v1/activations/{id}를 적당한 간격으로 폴링합니다.
5. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel로 번호를 해제해 자금이 곧바로 돌아오게 합니다.

웹훅은 X-OTPRoute-Signature 헤더(t=<unix>,v1=<hex>)를 읽고, 엔드포인트 시크릿으로 <t>.<raw body>에 대한 HMAC-SHA256을 계산해 상수 시간으로 비교하며, 오래된 타임스탬프는 버리세요. 이벤트는 활성화 id를 기준으로 하므로 두 번 전달된 +387 코드는 한 번만 기록해야 합니다. 재시도와 오류 처리는 OTP API 연동 가이드에서 더 자세히 안내합니다.

지원팀이나 운영팀을 위한 노코드 방법이 있나요?

네. API 권한이 없는 사람도 브라우저에서 같은 일을 할 수 있습니다. 로그인하여 OTP Gateway를 열고 보스니아 헤르체고비나와 서비스를 선택한 뒤 가격을 확인하고 확정하면 됩니다. 번호가 화면에 나타나고, SMS가 수신되면 그 옆에 코드가 표시됩니다. 고객의 가입 문제를 재현하는 지원 담당자나, 전화번호 변경 후 파트너 포털을 점검하는 운영 책임자에게 알맞은 방법입니다.

+387 번호는 어떻게 저장하고 보스니아 SMS 문구는 어떻게 파싱해야 하나요?

보스니아 국내에서는 트렁크 접두사 0을 붙여 전화를 걸고, 휴대폰 번호는 보통 06으로 시작합니다. E.164에서는 그 0이 사라집니다. 국내 표기로 061 뒤에 6자리인 번호는 +387 61에 그 6자리를 붙인 형태가 됩니다. E.164 형식으로만 저장하고, 입력 시 공백, 대시, 슬래시를 제거하며, 국가 코드 뒤에 맨 앞 0이 남아 있는 값은 거부하세요.

인증 문자는 영어 또는 현지 언어 중 하나로 도착할 수 있고, 키릴 문자로 쓰인 메시지도 충분히 가능합니다. 특정 단어를 찾는 대신 숫자 패턴으로 코드를 추출하고, 실패한 실행을 디버깅할 때 č, ć, š, ž 같은 발음 기호가 깨지지 않도록 로그가 UTF-8을 유지하는지 확인하세요.

테스트 실행에서 코드가 오지 않으면 어떻게 하나요?

코드가 도착하지 않으면 요금은 부과되지 않습니다. 20분 안에 SMS가 도착하지 않거나 먼저 취소하면 전액이 지갑으로 자동 환불됩니다. 이런 경우에는 다음과 같이 하세요.

• 곧바로 다시 주문하지 말고 활성화 시간이 끝까지 진행되도록 두세요. 늦게 도착한 SMS도 정상 처리됩니다.
• 잠시 후 다시 시도하거나, 같은 시나리오에 다른 서비스 경로를 선택하세요.
• 대상 서비스가 가상 번호를 받는지 확인하세요. 일부는 거부하며, 환불은 바로 그 때문에 있습니다.
• CI에서 짧은 간격으로 반복 주문하지 마세요. 성공 확률은 높이지 못하고 요청 한도만 소모됩니다.

OTP 인증 실패 줄이기에서 도움이 되는 패턴을 다룹니다.

보스니아 회선을 장기간 유지할 수 있나요? 결제는 어떻게 이루어지나요?

셀프 서비스 상품으로는 불가능합니다. 지갑에서 갱신되며 월 $1.95부터 시작하는 Dedicated Virtual Numbers는 미국과 캐나다에서만 즉시 판매됩니다. 팀에 정말로 장기 +387 회선이 필요하다면 [email protected]으로 이메일을 보내 주세요. 가능 여부는 현지 규정에 따르며 마련해 드린다는 약속은 없습니다.

게이트웨이 결제는 월 요금이나 선택할 요금제가 없는 하나의 선불 USD 지갑입니다. 카드 또는 USDT/USDC 스테이블코인으로 충전할 수 있고, 입금할 때마다 PDF 인보이스가 받은편지함으로 도착합니다. 연동 작업의 경우 요청하면 개발 계정을 샌드박스로 전환해 주며, 모의 번호와 코드를 반환하므로 지갑 자금을 쓰지 않고 파이프라인을 실행할 수 있습니다. 현재 요금은 요금제 페이지에 있으며, 이메일 코드 또는 Google 로그인으로 계정을 만들 수 있습니다.

자주 묻는 질문

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

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

OTP Route는 보스니아 헤르체고비나에 어떤 국가 id를 사용하나요?

id는 ba입니다. 활성화를 생성할 때는 country 필드로, 가격을 조회할 때는 country 쿼리 매개변수로 전달하세요.

+387 코드가 도착하지 않으면 요금을 내야 하나요?

아니요. 20분 활성화 시간 안에 아무것도 도착하지 않거나 취소하면 전액이 지갑으로 자동 환불됩니다.

보스니아 휴대폰 번호를 저장할 때 맨 앞 0을 유지해야 하나요?

아니요. 국내 트렁크 0을 뺀 번호에 +387을 붙인 E.164 형식으로 저장하세요.

다음 달에 다시 로그인해야 하는 계정에 테스트용 +387 번호를 써도 되나요?

권장하지 않습니다. 게이트웨이 번호 하나는 인증 한 번에만 사용되기 때문입니다. 반복 로그인에는 미국 또는 캐나다 Dedicated Number가 셀프 서비스 선택지이며, 보스니아 장기 회선은 팀에 이메일로 문의하세요.

비용을 쓰지 않고 CI에서 보스니아 OTP 테스트를 실행할 수 있나요?

네, 개발 계정에 샌드박스 모드를 요청하면 됩니다. 모의 번호와 코드가 반환되므로 웹훅을 포함한 전체 흐름을 무료로 점검할 수 있습니다.

이 번호의 사용 방법에 규칙이 있나요?

네. 각 서비스의 약관을 따르고, 본인의 정당한 제품과 계정에만 번호를 사용하며, 모든 주문에 OTP Route 이용 정책(Acceptable Use Policy)이 적용된다는 점에 유의하세요.

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