Mã xác minh Việt Nam (+84), chuyển thẳng vào bộ kiểm thử của bạn

Vì sao nên kiểm thử Việt Nam trên một tuyến +84 thật?

Việt Nam là thị trường ưu tiên di động, nơi chat, thương mại xã hội và các dịch vụ kiểu super-app nằm ở trung tâm đời sống hằng ngày. Zalo là ứng dụng nhắn tin nội địa được dùng rộng rãi, còn các sàn như Shopee và Lazada là cái tên quen thuộc với mọi nhà. Các đội sản phẩm kiểm thử ở đây khi ra mắt bản tiếng Việt, kiểm tra luồng đăng ký bằng tiếng Việt, hoặc hỗ trợ khách hàng khắp Đông Nam Á từ một trung tâm vận hành khu vực. Trang xác minh ứng dụng di động của chúng tôi mô tả cách việc kiểm thử này thường nằm trong một chu kỳ phát hành.

Số di động Việt Nam được định dạng như thế nào?

Trong nước, số di động được viết với tiền tố trung kế 0 và tổng cộng mười chữ số, bắt đầu bằng các đầu số như 03, 05, 07, 08 hoặc 09. Năm 2018, quốc gia này chuyển các số di động mười một chữ số cũ sang mười chữ số, nên dữ liệu CRM cũ vẫn có thể chứa các đầu số lỗi thời.

Khi lưu trữ, hãy bỏ số 0 và dùng E.164: +84 cộng chín chữ số. Hãy chuẩn hóa khi nhập, còn định dạng hiển thị thì xử lý riêng.

Tiếng Việt có dấu, và bên gửi thường bỏ dấu trong SMS để tin ngắn gọn, nên mã có thể đến dưới dạng tiếng Việt không dấu hoặc bằng tiếng Anh. Hãy kiểm tra rằng trình phân tích của bạn lấy được các chữ số trong cả hai trường hợp.

Tuyến Việt Nam hỗ trợ những dịch vụ nào?

Hiện có hơn 2.800 dịch vụ được liệt kê cho Việt Nam. Các dịch vụ được yêu cầu thường xuyên gồm Zalo, Shopee, Lazada, TikTok, Facebook, Telegram, WhatsApp, Google (Gmail & YouTube), Instagram, Microsoft & Outlook, Amazon, ChatGPT (OpenAI), Discord và Viber. Tình trạng khả dụng thay đổi suốt ngày, vì vậy hãy đọc trực tiếp thay vì mã hóa cứng các giả định.

Một đợt QA tại Việt Nam thực sự cần bao quát những gì?

Ngoài việc nhận mã, một lượt kiểm thử +84 hữu ích sẽ kiểm tra những phần của quy trình đăng ký thường hỏng ở thị trường này:

• ô nhập số điện thoại chấp nhận cả dạng nhập nội địa 09… lẫn dạng quốc tế +84 9…, và lưu cả hai giống hệt nhau;
• bộ chọn quốc gia hiển thị đúng Việt Nam, kể cả dấu, trong bản tiếng Việt của bạn;
• tính năng tự điền OTP trên Android và iOS vẫn lấy được các chữ số khi đoạn văn bản xung quanh không dấu;
• thông báo lỗi khi mã sai hoặc hết hạn đọc tự nhiên bằng tiếng Việt, không phải bản dịch từng chữ;
• nút gửi lại chờ đủ lâu để một lần gửi chậm không bị yêu cầu thứ hai chen ngang.

Chạy các bước này trên một tuyến thật thay vì lớp SMS giả lập giúp phát hiện lỗi định dạng và phân tích trước khi khách hàng ở Hà Nội hay Thành phố Hồ Chí Minh gặp phải.

API OTP Việt Nam hoạt động từ đầu đến cuối ra sao?

Các yêu cầu gửi đến https://otproute.com/api/v1 với khóa Bearer (tiền tố or_live_). Mã quốc gia của Việt Nam là vn.

1. Gọi GET /api/v1/prices?country=vn&service=zalo để xác nhận giá và tình trạng khả dụng.
2. Giữ một số bằng cách gửi POST /api/v1/activations với nội dung {"service": "zalo", "country": "vn"}; hãy giữ lại id của lượt kích hoạt được trả về.
3. Nhập số +84 được trả về vào màn hình xác minh của ứng dụng.
4. Nhận activation.sms_received qua webhook, hoặc polling GET /api/v1/activations/{id} vài giây một lần.
5. Đóng các lượt kích hoạt không cần thiết bằng POST /api/v1/activations/{id}/cancel.

Hãy xác thực X-OTPRoute-Signature của từng webhook trước khi tin tưởng nó. Để thiết lập CI đầy đủ, xem kiểm thử SMS OTP trong pipeline CI.

Người không phải lập trình viên có đặt được số +84 không?

Có. Trong dashboard, chọn Việt Nam và dịch vụ, kiểm tra giá hiển thị, xác nhận, rồi dán số vào ứng dụng. Mã sẽ xuất hiện trên thẻ kích hoạt. Khi không có gì về trong 20 phút, hoặc bạn hủy, số tiền sẽ được hoàn về ví của bạn.

OTP Route có bán số Việt Nam dùng lâu dài không?

Không. Dedicated Virtual Numbers tự phục vụ chỉ có ở Hoa Kỳ và Canada, từ $1.95/month. Với Việt Nam, mỗi số OTP Gateway chỉ nhận một mã. Các đội muốn có đường dây +84 cố định có thể gửi email đến [email protected], tuy nhiên quy định địa phương quyết định việc đó có khả thi hay không. So sánh cả hai mô hình tại trang số ảo.

Kiểm thử +84 được thanh toán như thế nào?

Các lượt kích hoạt Việt Nam trừ vào cùng một ví USD trả trước như mọi tuyến khác, không có phí hằng tháng hay gói nào phải chọn. Có thể nạp tiền bằng thẻ và USDT/USDC, và mỗi lần nạp đều tạo hóa đơn PDF gửi qua email cho bộ phận kế toán của bạn. Hãy yêu cầu chế độ sandbox cho tài khoản phát triển để chạy số và mã mô phỏng qua phần tích hợp của bạn mà không tốn tiền trong ví.

Câu hỏi thường gặp

Tôi có thể kiểm thử đăng ký tại Việt Nam của ứng dụng mà không cần mua SIM địa phương không?

Có. Hãy đặt một số +84 từ OTP Gateway, nhập vào luồng đăng ký của chính bạn, và đọc mã trong dashboard hoặc qua API.

Tôi có nên lưu số Việt Nam kèm số 0 ở đầu không?

Không. Hãy lưu dưới dạng +84 theo sau là chín chữ số, và chỉ thêm lại số 0 khi hiển thị số theo định dạng trong nước.

Vì sao dữ liệu khách hàng cũ của tôi có số di động Việt Nam mười một chữ số?

Việt Nam đã chuyển số di động mười một chữ số sang mười chữ số vào năm 2018. Các bản ghi thu thập trước thay đổi đó có thể cần được chuyển sang các đầu số hiện hành.

Tin nhắn xác minh tại Việt Nam có dấu không?

Thường là không, vì nhiều bên gửi bỏ dấu trong SMS. Hãy đảm bảo trình phân tích mã dựa vào các chữ số, không dựa vào những từ xung quanh.

Nếu mã Zalo hoặc Shopee không bao giờ đến số +84 thì sao?

Hãy để lượt kích hoạt mở đủ 20 phút để nó tự động hoàn tiền, rồi thử lại sau hoặc chuyển sang tuyến khác. Một số dịch vụ từ chối số ảo, và đặt liên tục trong thời gian ngắn khó có tác dụng.

Tuyến Việt Nam hỗ trợ bao nhiêu dịch vụ?

Hiện có hơn 2.800. Danh sách trực tiếp lấy từ GET /api/v1/services cùng với GET /api/v1/prices cho mã quốc gia vn.

Số +84 từ OTP Route có được mọi ứng dụng chấp nhận không?

Không, việc chấp nhận không được đảm bảo, vì mỗi dịch vụ tự đặt chính sách về số ảo. Bạn chỉ trả tiền khi mã được gửi đến.

Những quy tắc sử dụng nào áp dụng cho số Việt Nam?

Chỉ xác minh các sản phẩm và tài khoản doanh nghiệp của chính bạn, tuân thủ điều khoản của từng dịch vụ, và nằm trong Chính sách Sử dụng Chấp nhận được của OTP Route. Không cho phép tạo tài khoản hàng loạt hoặc trùng lặp.

Tên dịch vụ là nhãn hiệu của chủ sở hữu tương ứng. OTP Route không liên kết với họ. Hãy sử dụng số hợp pháp, tuân thủ điều khoản của từng dịch vụ và Chính sách sử dụng chấp nhận được của chúng tôi.