베트남(+84) 인증 코드를 테스트 스위트로 곧바로 전달하세요

베트남을 실제 +84 경로로 테스트할 만한 이유는 무엇인가요?

베트남은 모바일 중심 시장으로, 채팅, 소셜 커머스, 슈퍼앱 형태의 서비스가 일상의 중심에 있습니다. 현지에서 널리 쓰이는 메신저는 Zalo이고, Shopee와 Lazada 같은 마켓플레이스는 누구나 아는 이름입니다. 제품 팀은 베트남어 빌드를 출시하거나, 베트남어 온보딩을 검증하거나, 동남아 지역 운영 허브에서 고객을 지원할 때 이곳에서 테스트합니다. 이런 테스트가 보통 릴리스 주기에서 어떻게 자리 잡는지는 모바일 앱 인증 페이지에서 설명합니다.

베트남 휴대전화 번호는 어떤 형식인가요?

국내에서는 휴대전화 번호를 트렁크 0과 총 열 자리로 표기하며, 03, 05, 07, 08, 09 같은 접두사로 시작합니다. 2018년에 기존 열한 자리 휴대전화 번호가 열 자리로 바뀌었으므로, 오래된 CRM 데이터에는 지금은 쓰지 않는 접두사가 남아 있을 수 있습니다.

저장할 때는 0을 빼고 E.164 형식, 즉 +84 뒤에 아홉 자리를 사용하세요. 입력 시점에 정규화하고, 표시용 서식은 별도로 적용합니다.

베트남어는 성조 기호를 쓰는데, 발신자가 메시지를 짧게 하려고 SMS에서 이를 제거하는 경우가 많아 코드가 기호 없는 베트남어나 영어로 도착할 수도 있습니다. 어느 쪽이든 파서가 숫자를 추출하는지 테스트하세요.

베트남 경로에서는 어떤 서비스를 이용할 수 있나요?

현재 베트남에는 2,800개가 넘는 서비스가 나열되어 있습니다. 자주 요청되는 서비스로는 Zalo, Shopee, Lazada, TikTok, Facebook, Telegram, WhatsApp, Google(Gmail & YouTube), Instagram, Microsoft & Outlook, Amazon, ChatGPT(OpenAI), Discord, Viber가 있습니다. 가용 여부는 하루 동안 바뀌므로, 가정을 코드에 고정하지 말고 실시간으로 조회하세요.

베트남 QA 점검에서는 실제로 무엇을 다뤄야 하나요?

코드를 받는 것 외에도, 유용한 +84 테스트에서는 이 시장에서 온보딩 중 자주 깨지는 부분을 확인합니다.

• 전화번호 필드가 09… 형태의 국내 입력과 +84 9… 형태의 국제 입력을 모두 받고, 둘을 동일하게 저장하는지
• 베트남어 빌드의 국가 선택기에 성조 기호를 포함해 Việt Nam이 올바르게 표시되는지
• 주변 문구에 성조 기호가 없어도 Android와 iOS의 OTP 자동 완성이 숫자를 계속 인식하는지
• 틀렸거나 만료된 코드에 대한 오류 문구가 직역이 아니라 베트남어로 자연스럽게 읽히는지
• 재전송 버튼이 충분히 오래 대기해서, 느린 전달이 두 번째 요청에 추월당하지 않는지

모의 SMS 계층이 아니라 실제 경로로 이런 점검을 실행하면, 하노이나 호치민 시의 고객이 발견하기 전에 서식과 파싱 버그를 잡을 수 있습니다.

베트남 OTP API는 처음부터 끝까지 어떻게 동작하나요?

요청은 or_live_ 접두사가 붙은 Bearer 키와 함께 https://otproute.com/api/v1로 보냅니다. 베트남의 국가 id는 vn입니다.

1. GET /api/v1/prices?country=vn&service=zalo로 가격과 제공 여부를 확인합니다.
2. POST /api/v1/activations에 {"service": "zalo", "country": "vn"} 본문을 보내 번호를 예약하고, 반환된 활성화 id를 보관합니다.
3. 반환된 +84 번호를 앱의 인증 화면에 입력합니다.
4. 웹훅으로 activation.sms_received를 받거나, GET /api/v1/activations/{id}를 몇 초마다 폴링합니다.
5. 필요 없어진 활성화는 POST /api/v1/activations/{id}/cancel로 정리합니다.

신뢰하기 전에 모든 웹훅의 X-OTPRoute-Signature를 검증하세요. 전체 CI 구성은 CI 파이프라인에서의 SMS OTP 테스트를 참고하세요.

개발자가 아니어도 +84 번호를 주문할 수 있나요?

네. 대시보드에서 베트남과 서비스를 선택하고, 표시된 가격을 확인한 뒤 주문을 확정하고, 번호를 앱에 붙여 넣으면 됩니다. 코드는 활성화 카드에 나타납니다. 20분 안에 아무것도 도착하지 않거나 취소하면 해당 금액이 지갑으로 환불됩니다.

OTP Route는 장기 베트남 번호를 판매하나요?

아니요. 셀프 서비스 전용 가상 번호(Dedicated Virtual Numbers)는 미국과 캐나다에만 있으며 월 $1.95부터입니다. 베트남에서는 OTP Gateway 번호 하나가 코드 하나만 받습니다. 지속적으로 유지되는 +84 회선이 필요한 팀은 [email protected]으로 문의할 수 있지만, 가능 여부는 현지 규정에 달려 있습니다. 두 방식은 가상 번호 페이지에서 비교해 보세요.

+84 테스트 비용은 어떻게 결제하나요?

베트남 활성화도 다른 경로와 같은 선불 USD 지갑에서 차감되며, 월 사용료나 선택할 요금제는 없습니다. 충전은 카드와 USDT/USDC 모두 가능하고, 충전할 때마다 경리 담당 팀을 위한 PDF 인보이스가 이메일로 발송됩니다. 개발 계정에서 샌드박스 모드를 요청하면 지갑 비용 없이 모의 번호와 코드를 통합 테스트에 흘려 볼 수 있습니다.

자주 묻는 질문

현지 SIM을 구입하지 않고 앱의 베트남 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 +84 번호를 주문해 자사 가입 흐름에 입력하면, 대시보드나 API에서 코드를 읽을 수 있습니다.

베트남 번호를 맨 앞의 0과 함께 저장해야 하나요?

아니요. +84 뒤에 아홉 자리를 붙여 저장하고, 국내 형식으로 번호를 보여 줄 때만 0을 다시 붙이세요.

예전 고객 데이터에 열한 자리 베트남 휴대전화 번호가 있는 이유는 무엇인가요?

베트남은 2018년에 열한 자리 휴대전화 번호를 열 자리로 바꿨습니다. 변경 전에 수집된 기록은 현재 접두사로 마이그레이션해야 할 수 있습니다.

베트남 인증 메시지에는 성조 기호가 포함되나요?

많은 발신자가 SMS에서 성조 기호를 제거하기 때문에 포함되지 않는 경우가 많습니다. 코드 파서가 주변 단어가 아니라 숫자에 의존하도록 만드세요.

Zalo나 Shopee 코드가 +84 번호로 오지 않으면 어떻게 하나요?

자동 환불되도록 활성화를 20분 전체 동안 열어 둔 다음, 나중에 다시 시도하거나 다른 경로로 바꿔 보세요. 일부 서비스는 가상 번호를 거부하며, 짧은 간격으로 계속 주문해도 도움이 되기 어렵습니다.

베트남 경로는 몇 개의 서비스를 지원하나요?

현재 2,800개가 넘습니다. 실시간 목록은 GET /api/v1/services와, 국가 id vn에 대한 GET /api/v1/prices로 확인할 수 있습니다.

OTP Route의 +84 번호는 모든 앱에서 받아들여지나요?

아니요. 각 서비스가 가상 번호에 대한 자체 정책을 정하므로 수락이 보장되지 않습니다. 코드가 전달될 때만 결제합니다.

베트남 번호에는 어떤 이용 규칙이 적용되나요?

자사 제품과 비즈니스 계정만 인증하고, 각 서비스의 약관을 따르며, OTP Route 이용 정책(Acceptable Use Policy)을 지키세요. 대량 또는 중복 계정 생성은 허용되지 않습니다.

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