API OTP Samoa: kiểm thử đăng ký +685 trên khắp Thái Bình Dương

Samoa nhìn nhanh dành cho đội sản phẩm và QA

Samoa là một quốc gia độc lập ở Thái Bình Dương, với tiếng Samoa và tiếng Anh là ngôn ngữ chính thức. Cộng đồng người Samoa khá đông sống ở New Zealand, Úc và Hoa Kỳ, nên các ứng dụng chuyển tiền, nhắn tin và du lịch thường phải hoạt động tốt cho những người di chuyển qua lại giữa các nước đó và quê nhà.

Có hai điểm đặc biệt đáng biết. Thứ nhất, Samoa (+685) là một quốc gia khác với Samoa thuộc Mỹ (American Samoa), vốn nằm trong kế hoạch đánh số Bắc Mỹ với mã +1 684; nếu nhầm hai nơi này trong bộ chọn quốc gia, mã sẽ bị gửi sai chỗ. Thứ hai, năm 2011 Samoa chuyển sang phía tây của Đường đổi ngày quốc tế và có đồng hồ sớm hơn UTC rất nhiều, nên đây là một trường hợp tiện lợi để kiểm thử các mốc ngày trong logic hết hạn.

Với một đội sản phẩm, Samoa hiếm khi là thị trường ra mắt độc lập. Nơi này thường xuất hiện trong một đợt triển khai ở Thái Bình Dương, theo yêu cầu của ứng dụng hướng đến kiều bào, hoặc vì một tổ chức đối tác ở Apia cần xác nhận tài khoản doanh nghiệp. Trong mọi trường hợp, công việc đều giống nhau: chứng minh rằng người dùng +685 có thể hoàn tất luồng đăng ký của bạn.

Nên xử lý số +685 trong mã như thế nào?

Số quốc gia của Samoa ngắn hơn so với phần lớn thị trường, nên các bộ kiểm tra được chỉnh cho số chín hoặc mười chữ số có thể từ chối nhầm một số hợp lệ. Hãy lưu số dưới dạng +685 cộng các chữ số quốc gia, không có dấu phân tách, và bỏ số 0 mà người dùng thêm vào theo thói quen. Vì dấu thời gian của webhook tính bằng giây Unix, hãy so sánh theo UTC thay vì giờ địa phương; cách này tránh những bất ngờ khi máy chủ của bạn và người kiểm thử ở Samoa nằm ở hai ngày lịch khác nhau.

Nếu sản phẩm cho phép người dùng chuyển giữa số New Zealand và số Samoa trên cùng một hồ sơ, hãy thêm một ca kiểm thử đổi mã quốc gia và xác nhận trạng thái xác minh cũ đã bị xóa, để mã gửi tới số này không bao giờ được chấp nhận cho số kia.

Những dịch vụ nào có sẵn trên tuyến Samoa?

Danh mục Samoa hiện liệt kê hơn 600 dịch vụ. Trong số những dịch vụ được yêu cầu nhiều có WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), Viber, Signal, TikTok, Microsoft & Outlook, Amazon và Discord. Độ phủ ở đây mỏng hơn so với các thị trường lớn và thay đổi suốt trong ngày, vì vậy hãy kiểm tra GET /api/v1/services và GET /api/v1/countries trước mỗi lần chạy. Nếu thiếu một dịch vụ, một tuyến lân cận như Fiji hoặc Tonga có thể phù hợp với bài kiểm thử của bạn.

Danh mục nhẹ hơn là lý do tốt để làm bộ kiểm thử của bạn dễ dung sai: nếu dịch vụ ưu tiên không có mặt vào lúc chạy, hãy đánh dấu ca đó là bỏ qua thay vì thất bại, và ghi lại để ai đó thử lại sau.

Yêu cầu mã Samoa qua API

Với khóa Bearer (or_live_…) gọi tới https://otproute.com/api/v1, hãy tra giá qua GET /api/v1/prices?country=ws&service=<id>, rồi gửi {"service": "<id>", "country": "ws"} tới POST /api/v1/activations. Theo dõi id lượt kích hoạt bằng cách thăm dò GET /api/v1/activations/{id} hoặc lắng nghe activation.sms_received. Hãy xác minh chữ ký HMAC X-OTPRoute-Signature trên mỗi webhook, từ chối dấu thời gian đã cũ, và làm cho trình xử lý an toàn khi chạy hai lần với cùng một lượt kích hoạt. Hướng dẫn tích hợp trình bày đầy đủ cấu trúc.

Giới hạn tốc độ khá rộng rãi cho một thị trường cỡ này: mỗi tài khoản có tối đa 10 khóa, 5 điểm cuối webhook và 300 yêu cầu mỗi phút. Nếu bạn thăm dò, cách nhau vài giây giữa các lần kiểm tra là quá đủ.

Làm thủ công trong bảng điều khiển

1. Đăng nhập và mở OTP Gateway.
2. Chọn dịch vụ, rồi chọn Samoa.
3. Xem giá hiện tại và xác nhận.
4. Dán số +685 vào ứng dụng đang kiểm thử và yêu cầu mã.
5. Đọc mã trên màn hình, hoặc hủy nếu bạn không cần nữa.

Khi mã +685 chậm hoặc không đến

Hãy giữ lượt kích hoạt mở đủ 20 phút trước khi bỏ cuộc. Một số ứng dụng từ chối hoàn toàn số ảo, và đó chính là lý do các đơn không có phản hồi được hoàn tiền. Nếu một tuyến vẫn im lặng, hãy thử lại sau hoặc chọn tuyến dịch vụ khác; đặt đơn mới liên tục trong vòng lặp dày hiếm khi giúp ích mà còn làm tiêu hao giới hạn tốc độ của bạn.

Hãy ghi id lượt kích hoạt cùng với mỗi lần thử để biết sự im lặng đến từ một ứng dụng cụ thể hay từ cả tuyến.

Số dùng lâu dài và thanh toán khi sử dụng

OTP Route không bán số dài hạn Samoa theo hình thức tự phục vụ. Dedicated Number bắt đầu từ $1.95/tháng và chỉ giới hạn ở Hoa Kỳ và Canada; với một đường dây Samoa, hãy hỏi [email protected], không có cam kết rằng sẽ sắp xếp được. Ví USD trả trước nhận thẻ và USDT/USDC, gửi hóa đơn PDF cho mỗi lần nạp tiền và không có phí hàng tháng. Hãy yêu cầu chế độ sandbox trên tài khoản phát triển để chạy thử luồng ws mà không tốn tiền.

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

Samoa có giống Samoa thuộc Mỹ về số điện thoại không?

Không. Samoa dùng +685, còn Samoa thuộc Mỹ dùng +1 684. Hãy chọn đúng nơi trong bộ chọn quốc gia và trong API.

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

Hãy dùng ws trong truy vấn giá và trong yêu cầu kích hoạt.

Một mã xác minh Samoa giá bao nhiêu?

Từ $0.20 mỗi mã; giá chính xác phụ thuộc vào dịch vụ và được hiển thị trước khi bạn đặt đơn.

Tôi có thể kiểm thử đăng ký của người dùng Samoa từ New Zealand hoặc Úc không?

Có. Số +685 nhận SMS và OTP Route hiển thị tin cho bạn dù nhóm của bạn làm việc ở đâu.

Tôi có phải trả tiền khi không có tin nhắn nào đến không?

Không. Các lượt kích hoạt hết hạn hoặc bị hủy sẽ tự động được hoàn lại vào ví.

Mã của Samoa đến bằng ngôn ngữ nào?

Thường là tiếng Anh, ngôn ngữ chính thức cùng với tiếng Samoa. Hãy phân tích các chữ số chứ không phải phần văn bản xung quanh.

Tôi có thể dùng các số này để mở hàng loạt tài khoản không?

Không. Hãy tuân thủ điều khoản của từng dịch vụ; Chính sách Sử dụng Chấp nhận được giới hạn OTP Route ở việc kiểm thử và vận hành các tài khoản, sản phẩm hợp pháp của chính bạn.

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.