Nhận mã SMS OTP New Zealand qua API hoặc dashboard

Số +64 tạm thời hay số dùng lâu dài: tôi cần loại nào?

Chọn đúng sản phẩm ngay từ đầu sẽ đỡ phải làm lại về sau.

Chọn OTP Gateway khi một bước kiểm thử hoặc onboarding chỉ cần đúng một mã: một tài khoản QA mới, một lần smoke test màn hình đăng ký tại New Zealand, hay kiểm tra luồng của khách hàng Kiwi từ đầu đến cuối. Bạn nhận một số, một mã, rồi phiên kết thúc.

Chọn Dedicated Number khi cùng một tài khoản phải đăng nhập lại sau nhiều tuần hoặc cả nhóm dùng chung một số khôi phục. Các số dùng lâu dài này chỉ có tại Hoa Kỳ và Canada, từ $1.95/tháng, với SMS đến được chuyển tiếp dưới dạng sự kiện number.sms_received.

Riêng New Zealand thì không có số dùng lâu dài tự phục vụ. Hãy gửi email tới [email protected] nếu trường hợp của bạn cần; câu trả lời phụ thuộc quy định địa phương và có thể là không. Cuộc gọi, SMS gửi đi và điều khoản gia hạn của các số Bắc Mỹ đó có trên trang số ảo.

Vì sao các nhóm sản phẩm kiểm thử đăng ký tại New Zealand?

New Zealand là thị trường soft-launch quen thuộc cho các ứng dụng tiếng Anh: lượng người dùng nhỏ hơn, ngôn ngữ quen thuộc và múi giờ đi sớm khiến đây là nơi thực tế để quan sát onboarding thật trước khi phát hành rộng hơn. Điều đó có nghĩa bước xác minh +64 thường là luồng production đầu tiên mà một thị trường mới gặp, và nó xứng đáng có bộ test case riêng.

Có vài điểm đáng kiểm tra:

• Ngôn ngữ. Tiếng Anh, tiếng Māori (te reo) và Ngôn ngữ Ký hiệu New Zealand đều là ngôn ngữ chính thức. Hầu hết dịch vụ gửi mã bằng tiếng Anh, nhưng nếu mẫu tin của bạn dùng từ Māori có dấu macron (ā, ō, ū), những ký tự này nằm ngoài GSM-7 và đẩy SMS sang UCS-2, làm mỗi đoạn tin ngắn đi.
• Biên thời gian. New Zealand thuộc nhóm những nơi sang ngày mới sớm nhất, nên logic hết hạn và giới hạn tần suất dựa vào ngày có thể hoạt động khác với người dùng địa phương.
• Độ phù hợp thị trường. Một tài khoản QA được xác minh bằng số địa phương sẽ chạy đúng logic theo quốc gia mà người dùng Kiwi của bạn gặp.

Về mẫu chốt chặn trước khi phát hành dựa trên những kiểm tra như vậy, xem ghi chú kiểm thử QA của chúng tôi.

Nên lưu và chuẩn hóa số di động +64 như thế nào?

New Zealand dùng tiền tố trung kế là 0. Một số di động viết theo kiểu nội địa là 021 123 4567 sẽ thành +64211234567 ở dạng E.164: bỏ số 0 đứng đầu, rồi thêm +64. Dải số di động bắt đầu bằng 2 sau khi bỏ số 0, và độ dài thay đổi, nên đừng bao giờ cứng hóa một số chữ số cố định.

Các quy tắc thực tế cho schema của bạn:

• Lưu một chuỗi E.164 chuẩn duy nhất; chỉ định dạng lại khi hiển thị.
• Chấp nhận đầu vào có dấu cách, dấu gạch ngang hoặc số 0 trung kế, rồi chuẩn hóa bằng một thư viện phân tích số điện thoại được bảo trì.
• Thêm test fixture cho cả cách viết nội địa lẫn quốc tế, cùng một số mà người dùng dán vào có cả +64 và số 0 còn sót.

Những ứng dụng nào gửi mã tới số New Zealand trên OTP Route?

Tuyến +64 hỗ trợ hơn 800 dịch vụ. Theo bản chụp hiện tại, các dịch vụ hay dùng gồm Google (Gmail & YouTube), WhatsApp, Telegram, Facebook, Instagram, TikTok, ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Discord, Snapchat, LinkedIn, Uber và Netflix.

Vì tình trạng khả dụng thay đổi theo thời gian thực, hãy truy vấn GET /api/v1/countries và GET /api/v1/services ở đầu mỗi lần chạy thay vì lưu đệm danh sách hàng tuần. Nếu một dịch vụ ít khả dụng trên +64, tuyến Australia lân cận thường là phương án dự phòng để so sánh bằng tiếng Anh.

Chuỗi gọi API OTP New Zealand trông như thế nào?

Mọi lệnh gọi +64 đều gửi tới https://otproute.com/api/v1 với khóa Bearer or_live_ được cấp trong Developer console. Trình tự như sau:

1. Đọc giá hiện hành bằng GET /api/v1/prices?country=nz&service=uber.
2. Tạo activation bằng POST /api/v1/activations với nội dung {"service": "uber", "country": "nz"}.
3. Lấy mã bằng cách polling GET /api/v1/activations/{id}, hoặc để activation.sms_received gửi tới webhook của bạn. activation.expired và activation.cancelled cho bạn biết khi nào cần dọn dẹp.
4. Hủy các đơn không dùng bằng POST /api/v1/activations/{id}/cancel, và theo dõi số dư bằng GET /api/v1/balance.

Với webhook, hãy xác minh X-OTPRoute-Signature bằng cách tính HMAC-SHA256 của <t>.<raw body> với secret của endpoint, từ chối timestamp cũ, và làm cho handler idempotent theo activation id để một lần gửi lại không gây hại. Hướng dẫn tích hợp có phần hướng dẫn đầy đủ hơn; giới hạn là 300 yêu cầu mỗi phút cho mỗi tài khoản.

Người không phải lập trình viên có đặt được số xác minh New Zealand không?

Hoàn toàn được. Trong dashboard, chọn New Zealand, chọn dịch vụ, kiểm tra giá hiển thị rồi xác nhận. Số +64 xuất hiện trên đơn; nhập nó vào ứng dụng, yêu cầu gửi SMS, và mã sẽ hiện trên cùng thẻ đó khi về tới. Mọi thứ diễn ra trong khung 20 phút, nên hãy mở sẵn ứng dụng đích trước khi đặt đơn.

Nếu mã +64 không bao giờ xuất hiện thì sao?

Trước hết hãy để đủ 20 phút của khung, vì một số bên gửi trì hoãn hoặc gộp SMS. Nếu vẫn trống, dịch vụ có thể từ chối số ảo, hoặc tuyến đó đang bận; hãy thử lại sau hoặc kiểm thử qua tuyến dịch vụ khác thay vì liên tục đặt đơn mới. Các đơn không có phản hồi, và đơn bạn hủy, được hoàn về ví tự động. Thanh toán theo kiểu trả theo mức dùng từ ví USD trả trước: nạp bằng thẻ hoặc USDT/USDC, có hóa đơn PDF cho mỗi lần nạp, không phí hàng tháng, và chế độ sandbox theo yêu cầu để chạy thử. OTP Route dành cho các tài khoản và sản phẩm hợp pháp của chính bạn, theo đ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.

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

Tôi có thể kiểm thử luồng đăng ký New Zealand của ứng dụng mà không cần SIM địa phương không?

Có. Đặt một số +64 trên OTP Gateway, dùng nó trong biểu mẫu đăng ký và đọc mã trong dashboard hoặc qua API.

Có giữ số 0 khi lưu số di động New Zealand không?

Không. Số 0 trung kế bị bỏ ở dạng E.164, nên 021 123 4567 được lưu thành +64211234567.

Mã quốc gia của New Zealand trong API là gì?

Là nz, dùng trong truy vấn giá và trong nội dung yêu cầu activation.

Mã xác minh New Zealand giá bao nhiêu?

Giá bắt đầu từ $0.20 mỗi mã và phụ thuộc vào dịch vụ; dashboard và GET /api/v1/prices hiển thị con số chính xác trước khi bạn đặt đơn.

Tôi có thể thuê số New Zealand trong vài tháng không?

Không có số +64 dùng lâu dài tự phục vụ. Dedicated Number là sản phẩm của Mỹ và Canada, và bạn có thể gửi email tới [email protected] để hỏi về các quốc gia khác.

Nên dùng polling hay webhook để lấy mã +64?

Polling đơn giản hơn cho một script đơn lẻ; webhook có chữ ký mở rộng tốt hơn khi nhiều job kiểm thử chạy song song. Cả hai đều trả về cùng một mã.

Mọi ứng dụng đều chấp nhận số New Zealand của OTP Route chứ?

Không nhất thiết. Một số dịch vụ từ chối số ảo, vì vậy đơn không có SMS sẽ được hoàn tiền tự động.

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.