Xây dựng bài kiểm thử xác minh +592 xoay quanh webhook và polling

Thiết kế luồng API OTP Guyana ưu tiên webhook như thế nào?

Với bất cứ việc gì vượt quá một lần kiểm tra đơn lẻ, hãy để nền tảng đẩy mã tới bạn thay vì hỏi đi hỏi lại. Trong bảng điều khiển Developer, thêm một endpoint HTTPS (một tài khoản có thể giữ 5) và đăng ký nó với activation.sms_received, cùng với activation.expired và activation.cancelled, để bộ chạy kiểm thử biết về các ngõ cụt nhanh như biết về các lần thành công.

Hãy coi mọi yêu cầu đến là không đáng tin cho tới khi nó qua bước xác minh:

• Đọc header X-OTPRoute-Signature, có dạng t=<unix>,v1=<hex>.
• Ghép timestamp, một dấu chấm và phần thân yêu cầu nguyên bản, rồi tính HMAC-SHA256 trên chuỗi đó bằng secret của endpoint.
• So sánh digest của bạn với v1 theo thời gian không đổi, và loại bỏ yêu cầu nếu timestamp đã cũ.
• Tìm id kích hoạt trong sự kiện; nếu bạn đã xử lý rồi, trả về thành công và không làm gì thêm.

Quy tắc cuối cùng đó giữ cho handler có tính idempotent, nên một lần gửi lại sau sự cố mạng sẽ không làm rối bài kiểm thử. Phần trình bày dài hơn nằm ở nhận OTP qua webhook.

Một đơn +592 dùng những endpoint và id nào?

Xác thực bằng khóa Bearer từ bảng điều khiển Developer; khóa live bắt đầu bằng or_live_ và mỗi tài khoản được giữ tối đa 10 khóa. URL gốc là https://otproute.com/api/v1, và id quốc gia của Guyana là gy.

Một lượt chạy điển hình đọc GET /api/v1/prices?country=gy&service=<id> trước, vì giá và tình trạng sẵn có trên tuyến này là giá trị trực tiếp chứ không phải hằng số. Sau đó nó gửi POST /api/v1/activations với {"service": "<id>", "country": "gy"} và nhận lại một số +592 cùng id kích hoạt. Nếu không có webhook, bộ chạy polling GET /api/v1/activations/{id} vài giây một lần, thấp hơn nhiều so với mức trần 300 yêu cầu mỗi phút. Bước dọn dẹp gọi POST /api/v1/activations/{id}/cancel khi bài kiểm thử bị hủy, và một lệnh gọi kiểm tra trước GET /api/v1/balance dừng bộ kiểm thử sớm nếu ví sắp hết tiền. Id dịch vụ lấy từ GET /api/v1/services; trung tâm nhà phát triển có ví dụ client cho API xác minh SMS này.

Số +592 được định dạng để lưu trữ như thế nào?

Guyana dùng mã quốc gia 592 và số quốc gia bảy chữ số, không có tiền tố trung kế cần bỏ, nên dạng E.164 chỉ đơn giản là +592 theo sau bởi bảy chữ số đó. Người ta thường viết các chữ số thành một nhóm ba và một nhóm bốn.

Vì không có số 0 đứng đầu để loại bỏ, việc chuẩn hóa chỉ gồm xóa dấu cách và dấu gạch ngang, rồi thêm mã quốc gia khi người dùng chỉ gõ các chữ số nội địa. Một lỗi hay gặp là biểu mẫu giả định mọi số điện thoại Nam Mỹ đều có mã vùng, hoặc đặt độ dài tối thiểu trên bảy chữ số, và do đó từ chối các số Guyana hợp lệ. Một số +592 để kiểm thử sẽ phát hiện ra điều này rất nhanh. Hãy lưu chuỗi E.164 và chỉ áp dụng định dạng địa phương khi hiển thị.

Những dịch vụ nào nhận được mã SMS OTP Guyana, và tôi có thể đặt thủ công không?

Tuyến Guyana liệt kê hơn 900 dịch vụ. Những dịch vụ được yêu cầu thường xuyên gồm WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft & Outlook, Discord, Netflix và Claude. Danh sách đó là ảnh chụp nhanh của danh mục trực tiếp, vì vậy hãy xác nhận qua API hoặc dashboard trước khi lên kế hoạch kiểm thử xoay quanh một nơi gửi cụ thể.

Với đồng nghiệp không viết code, dashboard làm đúng việc đó. Đăng nhập, mở OTP Gateway, chọn Guyana và một dịch vụ, xem giá rồi đặt. Số xác minh Guyana xuất hiện cùng đồng hồ đếm ngược 20 phút, và mã được hiển thị ngay cạnh khi đến.

Bài kiểm thử nên làm gì khi mã +592 đến muộn hoặc không đến?

Một lượt kích hoạt giữ mở trong 20 phút. Bạn chỉ trả tiền nếu mã đến trong khung đó; nếu hết hạn hoặc bạn hủy, toàn bộ số tiền quay về ví mà không cần phiếu hỗ trợ nào.

Cách xử lý hợp lý trong một lượt chạy tự động:

1. Chờ hết cửa sổ rồi mới kết luận thất bại, trừ khi bài kiểm thử của bạn có giới hạn thời gian cứng, khi đó hãy hủy một cách tường minh.
2. Thử lại sau, hoặc chuyển sang một tuyến dịch vụ khác nếu API cung cấp.
3. Kiểm tra xem dịch vụ đích có chấp nhận số ảo không; một số từ chối, và khoản hoàn tiền bao phủ đúng trường hợp đó.
4. Giãn các lần thử lại bằng backoff thay vì đặt lại đơn trong một vòng lặp chặt.

Hướng dẫn về định tuyến quốc gia cho OTP giải thích cách chọn các tuyến dự phòng.

Vì sao các đội kiểm thử luồng đăng ký của Guyana?

Guyana là quốc gia Nam Mỹ duy nhất có tiếng Anh là ngôn ngữ chính thức, và Georgetown là nơi đặt Ban Thư ký CARICOM, nên nước này thường xuất hiện trong các đợt triển khai coi Cộng đồng Caribe như một thị trường duy nhất. Ngành năng lượng ngoài khơi tăng trưởng nhanh đã thu hút các nhà thầu và nhà cung cấp quốc tế, trong khi cộng đồng kiều dân lớn ở Hoa Kỳ, Canada và Vương quốc Anh khiến các ứng dụng chuyển tiền, nhắn tin và du lịch luôn bận rộn với số +592. Tiếng Creole Guyana được nói rộng rãi hằng ngày, nhưng tin nhắn xác minh nhìn chung đến bằng tiếng Anh. Với QA, điều đó hướng công sức vào việc nhập số, bộ chọn quốc gia và câu chữ đồng ý nhận SMS hơn là nội dung đã dịch. Hãy giữ mọi lần kiểm tra trên các tài khoản mà tổ chức của bạn sở hữu, tuân theo điều khoản của từng dịch vụ, và nhớ 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.

Tôi có thể giữ một số Guyana không, và việc sử dụng được tính phí thế nào?

Guyana không có số dài hạn tự phục vụ. Dedicated Numbers của OTP Route chỉ phủ Hoa Kỳ và Canada, từ $1.95/tháng. Với đường dây +592, hãy gửi email tới [email protected] và đội ngũ sẽ kiểm tra những gì quy định địa phương cho phép, không kèm bất kỳ lời hứa nào.

Thanh toán chạy qua một ví USD trả trước: không phí hàng tháng, không gói, nạp bằng thẻ hoặc USDT/USDC, và mỗi lần nạp có hóa đơn PDF qua email. Tài khoản phát triển có thể được chuyển sang sandbox theo yêu cầu, để các bài kiểm thử tích hợp chạy với số và mã mô phỏng mà không đụng đến số dư. Giá từng dịch vụ hiển thị trên trang bảng giá.

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

Tôi có thể kiểm tra luồng đăng ký Guyana của ứng dụng mà không cần SIM của nhà mạng Guyana không?

Có. Đặt một số +592 từ OTP Gateway cho dịch vụ của bạn, nhập vào luồng của bạn, và mã sẽ hiện trong dashboard hoặc đến webhook của bạn. Giá bắt đầu từ $0.20 mỗi mã.

API dùng id quốc gia nào cho Guyana?

Là gy, dùng cả trong truy vấn giá lẫn nội dung yêu cầu kích hoạt.

Tôi có cần bỏ số 0 đứng đầu của số Guyana không?

Không. Guyana không có tiền tố trung kế, nên dạng E.164 là +592 theo sau bởi số bảy chữ số.

Tin nhắn xác minh +592 đến bằng ngôn ngữ nào?

Thường là tiếng Anh, ngôn ngữ chính thức. Tuy nhiên người gửi quyết định câu chữ và có thể theo cài đặt ngôn ngữ của ứng dụng.

Có hoàn tiền nếu dịch vụ không bao giờ gửi SMS không?

Có, và là tự động. Nếu 20 phút trôi qua mà không có mã, hoặc bạn hủy, toàn bộ số tiền quay về ví của bạn.

Tôi có thể kiểm thử toàn bộ tích hợp mà không tốn tiền không?

Hãy nhờ bộ phận hỗ trợ chuyển tài khoản phát triển của bạn sang sandbox. Nó trả về số và mã mô phỏng, nên các lệnh gọi API và webhook có thể được chạy từ đầu đến cuối.

Có số +592 dài hạn không?

Không phải dưới dạng sản phẩm tự phục vụ. Dedicated Numbers chỉ bán ở Hoa Kỳ và Canada; hãy gửi email tới [email protected] để hỏi về Guyana.

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.