팀에 +32 SIM이 하나도 없을 때 벨기에 가입 흐름 테스트하기

릴리스 대상은 벨기에인데 테스트 기기는 모두 외국 것입니다

흔한 장면입니다. 제품은 본국 시장에서 잘 동작하고, 벨기에가 다음 로드맵인데, QA 리드가 모든 테스트 폰에 외국 SIM이 꽂혀 있다는 사실을 깨닫습니다. 브뤼셀에 있는 동료의 폰을 빌리면 한 번은 되지만, 그 개인 번호가 스테이징 계정에 묶여 버리고 회귀 테스트는 여전히 사람 없이 돌릴 수 없습니다.

OTP Route는 OTP Gateway로 이 병목을 없앱니다. 서비스와 벨기에를 선택하면 인증 코드 정확히 하나를 위한 +32 번호를 받고, 코드는 대시보드나 직접 작성한 코드에서 읽습니다. 누구의 개인 번호도 테스트 로그인에 붙지 않으며, 같은 단계를 밤에 파이프라인에서 실행할 수도 있습니다. QA 테스트 가이드에서 팀들이 이를 기존 테스트 계획에 끼워 넣는 방법을 볼 수 있습니다.

지금 +32 번호로 코드를 전달하는 서비스는 무엇인가요?

벨기에 경로에는 현재 1,700개가 넘는 서비스가 있습니다. 최신 스냅샷에서 인기 있는 서비스는 WhatsApp, Telegram, Google(Gmail 및 YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, Uber, Signal, Viber, Netflix, Airbnb, eBay 등입니다.

재고는 하루 중에도 바뀌므로 웹 페이지의 어떤 목록이든 스냅샷으로 보세요. 연동은 픽스처에 서비스 목록을 하드코딩하지 말고, 번호가 필요한 순간 API에 무엇이 이용 가능한지 물어야 합니다.

벨기에 OTP 라우팅을 자동화 테스트에 연결하려면 어떻게 하나요?

모든 것은 개발자 콘솔에서 생성한 or_live_ 접두사의 Bearer 키와 함께 https://otproute.com/api/v1을 통해 이루어집니다. 계정당 키를 최대 10개까지 둘 수 있어 스테이징, CI, 로컬 노트북에 각각 별도의 자격 증명을 쉽게 줄 수 있고, 요청 한도는 분당 300건입니다.

1. GET /api/v1/services와 GET /api/v1/countries를 가져와 캐시합니다. 벨기에의 ID는 be입니다.
2. 실행에서 비용이 발생하기 전에 GET /api/v1/prices?country=be&service=linkedin으로 현재 가격을 읽습니다.
3. 본문 {"service": "linkedin", "country": "be"}로 POST /api/v1/activations를 호출해 주문을 생성합니다. 응답에는 활성화 ID와 가입 양식에 입력할 +32 번호가 들어 있습니다.
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을 계산하고, 상수 시간으로 비교하며, 타임스탬프가 오래된 요청은 버리세요. 모든 필드는 API 레퍼런스에 나와 있습니다.

서식 때문에 테스트가 깨지지 않도록 +32 번호는 어떻게 저장해야 하나요?

벨기에 국내에서 휴대폰 번호는 앞에 트렁크 0을 붙여 보통 04xx 뒤에 6자리를 더해 쓰고, 사람들은 공백, 슬래시, 점으로 묶어 표기합니다. 국제 형식에서는 0이 사라지고 +32가 대신 오므로 04xx는 +32 4xx가 됩니다. 일부 사용자는 유럽에서 해외로 전화할 때 쓰는 0032 접두사를 입력하기도 합니다.

구분 기호 없는 표준 E.164 문자열 하나를 저장하고, 세 가지 입력 방식을 전화번호 입력란에 넣어 같은 저장 값이 나오는지 확인하는 테스트를 작성하세요. 이 하나의 점검만으로도 벨기에 고객이 보기 전에 놀랄 만큼 많은 온보딩 버그를 잡아낼 수 있습니다.

언어도 중요합니다. 네덜란드어, 프랑스어, 독일어가 공식 언어이며, SMS 코드는 보통 발신 서비스가 고르는 언어로 도착합니다. 앱이나 기기 설정에 따라 정해지는 경우가 많습니다. 네덜란드어 인터페이스로 한 번, 프랑스어로 한 번 흐름을 실행하면 파서가 영어 문구에 의존하지 않는다는 것을 확인할 수 있습니다.

벨기에 코드가 도착하지 않았어요. 이제 어떻게 하나요?

모든 활성화는 20분 동안 열려 있으며 SMS가 도착한 경우에만 요금을 냅니다. 시간 창이 빈 채로 끝나거나 그 전에 취소하면 전체 금액이 지갑으로 자동 환불되고 웹훅으로 activation.expired 또는 activation.cancelled가 전달됩니다.

코드가 없을 때는 다음을 확인하세요.

• 몇 초 만에 취소하지 말고 시간 창이 끝날 때까지 기다리세요. 일부 서비스는 늦게 보냅니다.
• 서비스가 가상 번호를 허용하는지 확인하세요. 일부는 거부하며, 환불이 존재하는 이유가 바로 이것입니다.
• 나중에 다시 시도하거나, 테스트 케이스에 맞는 다른 서비스 경로로 시도하세요.
• 짧은 간격으로 반복 주문하지 마세요. 백오프와 재시도 상한을 추가하세요.

OTP 전달 실패 줄이기 글에서 재시도 설계를 더 깊이 다룹니다.

지원이나 운영팀이 코드 없이 +32 번호를 주문할 수 있나요?

예. 대시보드가 API를 쓰지 않는 사람을 위해 같은 흐름을 제공합니다.

1. 이메일 주소와 6자리 이메일 코드 또는 Google 로그인으로 가입한 다음 TOTP 2단계 인증을 켭니다.
2. 지갑에 자금을 충전합니다.
3. 벨기에와 서비스를 선택하고, 화면에 표시된 가격을 확인한 뒤 확정합니다.
4. 인증하려는 앱에 +32 번호를 입력하고 대시보드에서 코드를 확인합니다.

고객사의 벨기에 비즈니스 프로필을 온보딩하는 에이전시나, 엔지니어링에 티켓을 올리지 않고 인증 한 번이 필요한 운영 리드에게 적합합니다.

벨기에 영구 회선이 있나요? 결제는 어떻게 이루어지나요?

벨기에에는 셀프서비스 장기 번호가 없습니다. 전용 번호는 미국과 캐나다 전용 상품으로 월 $1.95부터입니다. 팀에 지속적인 벨기에 회선이 필요하면 [email protected]으로 이메일을 보내 문의하세요. 이용 가능 여부는 현지 규정에 따라 달라지며 보장되지 않습니다.

결제는 월 요금도, 선택할 요금제도 없는 사용한 만큼 결제하는 선불 USD 지갑 하나로 이루어집니다. 벨기에 테스트 비용은 카드 또는 USDT/USDC로 충전할 수 있고, 충전할 때마다 재무팀을 위한 PDF 인보이스가 이메일로 발송됩니다. 연동 작업에는 요청 시 개발 계정을 샌드박스로 전환해, 지갑 자금을 건드리지 않고 시뮬레이션된 번호와 코드로 코드를 실행해 볼 수 있습니다. 자세한 내용은 가격 페이지에 있습니다.

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

자주 묻는 질문

현지 SIM을 사지 않고 벨기에 온보딩 흐름을 확인할 수 있나요?

예. 테스트하려는 서비스용 +32 번호를 주문해 가입 양식에 입력하고, 대시보드나 API로 코드를 읽으세요.

API에서 벨기에는 어떤 국가 ID를 사용하나요?

벨기에는 be이므로 일반적인 요청은 {"service": "whatsapp", "country": "be"}를 담은 POST /api/v1/activations입니다.

벨기에 인증 번호는 비용이 얼마인가요?

+32 코드는 코드당 $0.20부터이며 선택한 서비스에 따라 달라집니다. 주문 전에 GET /api/v1/prices를 호출하거나 대시보드에서 정확한 금액을 확인하세요.

+32 코드가 도착하지 않으면 요금이 청구되나요?

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

데이터베이스에 벨기에 휴대폰 번호의 앞자리 0을 남겨야 하나요?

대신 트렁크 0을 빼고 +32로 시작하는 E.164 형식을 저장하세요. 사용자가 입력한 값은 저장하기 전에 그 형식으로 정규화하세요.

나중 로그인을 위해 같은 벨기에 번호를 유지할 수 있나요?

아니요. OTP Gateway 번호 하나는 코드 하나만 처리합니다. 장기 전용 번호는 미국과 캐나다에서만 제공되며, 벨기에는 [email protected]으로 문의하세요.

지갑 자금을 쓰지 않고 연동을 구축할 방법이 있나요?

개발 계정을 샌드박스로 전환해 달라고 요청하세요. 시뮬레이션된 번호와 코드를 반환하므로 전 과정을 테스트할 수 있습니다.

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