Xử lý mã dùng một lần của Maldives (+960) trong QA và vận hành

Tình huống: sản phẩm du lịch hoặc lưu trú phải hoạt động với người dùng +960

Hãy hình dung một nền tảng đặt phòng, một công cụ vận hành khu nghỉ dưỡng hay một ứng dụng giao hàng sắp hỗ trợ khách và đối tác ở Malé cùng các đảo san hô vòng khác. Các kỹ sư sống ở nơi khác, màn hình xác minh được thiết kế cho những số dài hơn nhiều, và không ai trong đội có SIM Maldives. Phải có người chứng minh bước xác minh điện thoại hoạt động trước khi ra mắt.

Đó chính là khoảng trống mà OTP Gateway lấp đầy. Nó trao cho bài test của bạn một số +960 thật cho đúng một lần xác minh, để bạn nhận SMS OTP Maldives trên luồng đăng ký staging hoặc production của chính mình mà không phải đi xa, dùng chuyển vùng hay mượn điện thoại của đồng nghiệp.

Các đội thường tìm đến đây vì một trong ba lý do: QA bản địa hóa cho thị trường phụ thuộc nhiều vào du lịch, một đợt mở rộng khu vực qua Nam Á và Ấn Độ Dương, hoặc đội vận hành muốn xác minh tài khoản công ty mà không gắn với số cá nhân của ai. Trang kiểm thử QA mô tả quy trình rộng hơn.

Vì sao số Maldives bảy chữ số làm hỏng mã kiểm tra hợp lệ?

Maldives dùng kế hoạch đánh số đóng: +960 theo sau là bảy chữ số, không có tiền tố trung kế để thêm hay bỏ. Chính độ dài ngắn đó khiến nhiều biểu mẫu vấp ngã. Một regex yêu cầu tối thiểu chín chữ số quốc nội, hoặc một thư viện được cấu hình vùng mặc định khác, sẽ từ chối một số hoàn toàn hợp lệ.

Một vài kiểm tra đáng đưa vào bộ test của bạn:

• chấp nhận cả +960 kèm bảy chữ số lẫn dạng nội địa bảy chữ số trần, rồi chuẩn hóa về E.164 trước khi lưu;
• xác nhận không có đường code nào chèn thêm số không, vì không có tiền tố trung kế để khôi phục;
• hiển thị đúng số trên màn hình xác nhận và biên nhận.

Tiếng Dhivehi, ngôn ngữ quốc gia, được viết bằng chữ Thaana từ phải sang trái, trong khi tiếng Anh được dùng rộng rãi trong kinh doanh và du lịch. Hãy kỳ vọng phần lớn tin nhắn xác minh từ các ứng dụng quốc tế tới bằng tiếng Anh, nhưng hãy trích xuất chữ số thay vì so khớp theo câu chữ, để một mẫu tin bản địa hóa không làm hỏng bộ phân tích của bạn.

Một số +960 hiện xác minh được những gì?

Hiện tại tuyến Maldives bao phủ hơn 1,700 dịch vụ. Các tên trong bản chụp hiện tại gồm WhatsApp, Telegram, Viber, Instagram, Facebook, Airbnb, Uber, Google (Gmail & YouTube), LinkedIn, Microsoft & Outlook, Snapchat, TikTok, Claude và Netflix.

Với một sản phẩm du lịch, cặp đôi hữu ích thường là một dịch vụ đặt chỗ hoặc nhắn tin cộng với ứng dụng của chính bạn, để kiểm tra số của khách hoạt động ra sao trên cả hai. Tình trạng khả dụng thay đổi trong ngày, đó là lý do API trả dữ liệu trực tiếp thay vì một danh sách cố định. Danh mục đầy đủ nằm ở mục dịch vụ.

Gắn API OTP Maldives vào một bài test tự động

Hãy tạo khóa API trong Developer console; khóa bắt đầu bằng or_live_ và được gửi dưới dạng Bearer token tới https://otproute.com/api/v1. Country id của Maldives là mv.

1. Gọi GET /api/v1/prices?country=mv&service=airbnb để biết đơn hàng sẽ tốn bao nhiêu và còn hàng hay không.
2. Gửi POST /api/v1/activations với {"service": "airbnb", "country": "mv"} để nhận activation id và số +960.
3. Đưa số vào luồng đang được kiểm thử.
4. Lấy mã +960 khi activation.sms_received gửi tới endpoint của bạn, hoặc thay vào đó polling GET /api/v1/activations/{id}.
5. Khi một bài test Maldives dừng giữa chừng, hãy gửi POST /api/v1/activations/{id}/cancel và ví sẽ được hoàn tiền ngay lập tức.

Các lần gửi có chữ ký kèm X-OTPRoute-Signature theo dạng t=<unix>,v1=<hex>. Tính HMAC-SHA256 của timestamp, một dấu chấm và nội dung thô bằng secret của endpoint, so sánh, và từ chối timestamp cũ. Bạn có thể đăng ký tối đa 5 endpoint webhook và dùng tối đa 300 request mỗi phút. Chi tiết từng trường của API OTP Maldives này nằm trong tài liệu dành cho nhà phát triển.

Mở số +960 từ dashboard thay vì dùng API

Không phải ai trong dự án cũng viết code, và dashboard đáp ứng đúng nhu cầu đó. Chọn Maldives làm quốc gia, chọn dịch vụ, xác nhận giá hiện tại, và số sẽ hiện trên màn hình. Dán nó vào ứng dụng, rồi theo dõi đơn hàng: mã sẽ xuất hiện trong cùng một dòng khi dịch vụ gửi đi.

Đơn hàng kéo dài 20 phút. Bạn chỉ trả tiền nếu mã về; đơn bị hủy hoặc hết hạn sẽ được hoàn tiền tự động, nên một nhân viên hỗ trợ kiểm tra luồng dành cho khách không cần tài chính phê duyệt cho từng lần thử.

Khi mã bị chậm: quy trình khắc phục ngắn gọn

Thời gian gửi phụ thuộc vào dịch vụ và tuyến, nên phút đầu yên ắng là điều bình thường. Nếu chưa có gì:

1. Tiếp tục chờ cho đến khi khung thời gian sắp đóng.
2. Thử lại vào lúc khác trong ngày, hoặc test với một tuyến dịch vụ khác.
3. Kiểm tra xem dịch vụ đích có chấp nhận số ảo không; một số dịch vụ từ chối theo chính sách.
4. Tránh đặt đơn mới liên tục trong một vòng lặp nhanh, vì chỉ làm lãng phí giới hạn tốc độ.

Bài viết về định tuyến OTP theo quốc gia giải thích cách chuyển dự phòng giữa các tuyến khi một quốc gia có ít nguồn.

Đường dây dài hạn, ví và chế độ sandbox

OTP Route không có số dài hạn tự phục vụ tại Maldives. Nếu bạn cần một đường dây để đội giữ lâu, hãy viết tới [email protected]; liệu có thực hiện được hay không phụ thuộc vào quy định địa phương. Dedicated Numbers gia hạn theo tháng chỉ có ở Hoa Kỳ và Canada, từ $1.95/month.

Thanh toán chạy từ một ví USD trả trước duy nhất: không đăng ký, không bậc gói. Nạp bằng thẻ hoặc USDT/USDC, và mỗi lần nạp sẽ có hóa đơn PDF gửi qua email. Nhà phát triển có thể yêu cầu chế độ sandbox cho tài khoản phát triển để kiểm thử tích hợp với số và mã mô phỏng.

Hãy sử dụng đúng mục đích: kiểm thử sản phẩm của chính bạn, tuân thủ điều khoản của từng dịch vụ, và lưu ý rằng Chính sách Sử dụng Chấp nhận được của OTP Route áp dụng cho mọi đơn hàng.

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

Số điện thoại Maldives có bao nhiêu chữ số?

Bảy chữ số sau mã quốc gia +960, không có tiền tố trung kế. Phần kiểm tra hợp lệ của bạn nên chấp nhận độ dài ngắn hơn này.

Country id API của Maldives là gì?

Là mv. Hãy truyền nó vào GET /api/v1/prices và trong phần body của POST /api/v1/activations.

Tôi có thể kiểm tra luồng đăng ký +960 của ứng dụng đặt phòng mà không cần ở Maldives không?

Có. Hãy đặt một số Maldives dùng một lần từ OTP Gateway, nhập vào ứng dụng của bạn và đọc mã trên dashboard hoặc qua API.

Tiền của tôi sẽ ra sao nếu không có mã Maldives nào về?

Bạn không bị tính phí. Khi khung 20 phút kết thúc mà không có SMS, hoặc bạn hủy đơn, toàn bộ số tiền sẽ quay về ví.

Tin nhắn xác minh có bằng tiếng Dhivehi không?

Phần lớn dịch vụ quốc tế gửi bằng tiếng Anh, tuy nhiên câu chữ phụ thuộc vào từng ứng dụng. Hãy phân tích chữ số thay vì câu văn để cả hai ngôn ngữ đều hoạt động.

Tôi có thể giữ số +960 cho tài khoản nhân viên không?

Không phải dạng tự phục vụ. Đường dây giữ lâu là sản phẩm dành cho Mỹ và Canada; với Maldives, hãy gửi email tới [email protected] để hỏi các phương án.

Tôi có cần gói hằng tháng để dùng OTP Route không?

Không. Bạn trả theo mức dùng từ một ví USD trả trước, nạp bằng thẻ hoặc USDT/USDC, kèm hóa đơn PDF cho mỗi lần nạ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.