Mã xác minh SMS Jamaica: danh sách kiểm tra, các bước và cách khắc phục

Cần xác nhận điều gì trước lần kích hoạt Jamaica đầu tiên?

Jamaica nằm trong Kế hoạch đánh số Bắc Mỹ, nên một vài bước kiểm tra khác với hầu hết các quốc gia:

• Bộ kiểm tra hợp lệ của bạn chấp nhận số +1 không phải của Mỹ hay Canada. Rất nhiều biểu mẫu đăng ký ngầm cho rằng mọi số +1 đều là của Mỹ.
• Bộ chọn quốc gia của bạn liệt kê Jamaica riêng, thay vì coi +1 là một khu vực duy nhất.
• Đã có khóa API or_live_ trong Developer console, và một endpoint webhook cùng secret đã được triển khai, hoặc bộ kiểm thử của bạn được đặt để polling.
• Ví đã được nạp tiền, hoặc chế độ sandbox đã được bật để chạy thử.
• Bạn biết mã dịch vụ từ GET /api/v1/services; mã quốc gia của Jamaica là jm.

Sai hai mục đầu sẽ gây ra các lỗi trông giống vấn đề định tuyến nhưng hoàn toàn nằm trong code của chính bạn.

Vì sao số Jamaica +1 cần xử lý đặc biệt?

Số Jamaica dùng mã vùng 876 và mã mới hơn 658, theo sau là số thuê bao bảy chữ số, nên dạng E.164 đầy đủ là +1 cộng mười chữ số. Khi gọi trong nước, người ta quay số 1 ở đầu cho cuộc gọi đường dài, và số này nên được bỏ trước khi lưu.

Điểm quan trọng với kỹ sư là riêng +1 không cho biết gì về quốc gia. Việc nhận diện khu vực phải xét mã vùng, và mọi logic chọn tiền tệ, múi giờ hay mẫu SMS dựa trên mã quay số cũng cần cùng sự cẩn trọng đó. Hãy lưu chuỗi E.164 chuẩn, giữ khu vực được nhận diện trong một trường riêng, và kiểm thử cả đầu vào 876 lẫn 658.

Tiếng Anh là ngôn ngữ chính thức và tin nhắn xác minh gần như luôn đến bằng tiếng Anh, trong khi lời nói hằng ngày thường dùng tiếng Patois Jamaica. Các đội kiểm thử ở đây cho các đợt ra mắt tại Caribe, cho luồng kiều hối và fintech phục vụ cộng đồng người Jamaica ở Mỹ, Anh và Canada, cũng như cho sản phẩm du lịch và khách sạn. Bài định tuyến quốc gia cho OTP nói về cách chọn tuyến theo từng thị trường.

Các bước trong API xác minh SMS Jamaica là gì?

1. Kiểm tra giá trực tiếp bằng GET /api/v1/prices?country=jm&service=<id> trên base URL https://otproute.com/api/v1.
2. Đặt đơn: POST /api/v1/activations với nội dung {"service": "<id>", "country": "jm"}. Ghi lại mã kích hoạt và số.
3. Nhập số vào ứng dụng bạn đang kiểm thử.
4. Nhận mã qua sự kiện activation.sms_received trên webhook của bạn, hoặc bằng cách polling GET /api/v1/activations/{id}.
5. Hủy sớm một lần thử Jamaica bằng cách gửi POST /api/v1/activations/{id}/cancel, thao tác này giải phóng khoản tạm giữ.

Trước khi xử lý bất kỳ sự kiện nào, hãy tính lại HMAC-SHA256 của "<t>.<raw body>" với secret của endpoint, so sánh với giá trị v1 trong X-OTPRoute-Signature, và từ chối các timestamp quá cũ. Hãy xử lý cả activation.expired và activation.cancelled, theo khóa là mã kích hoạt, để các lần thử lại không bao giờ bị xử lý hai lần. Về dung lượng, một tài khoản có thể giữ 10 khóa và 5 endpoint webhook, với trần 300 yêu cầu mỗi phút cho tất cả.

Những ứng dụng nào nhận được mã trên tuyến Jamaica?

Jamaica hiện liệt kê hơn 900 dịch vụ. Các dịch vụ hay dùng gồm WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Snapchat, Amazon, Uber, Netflix, Airbnb và ChatGPT (OpenAI).

Tình trạng khả dụng của từng dịch vụ thay đổi trong ngày, vì vậy hãy đọc endpoint giá ở đầu mỗi lượt chạy thay vì cố định danh sách trong code.

Người không phải lập trình viên làm theo cùng danh sách kiểm tra trong bảng điều khiển thế nào?

Tạo tài khoản tại /signup bằng mã gửi qua email hoặc Google, bật TOTP, rồi nạp tiền. Sau đó mở OTP Gateway, chọn dịch vụ, chọn Jamaica và xác nhận giá hiện tại. Dán số vào ứng dụng, và mã sẽ xuất hiện trong bảng điều khiển khi tin nhắn đến. Nhân viên hỗ trợ thường dùng cách này để tái hiện sự cố đăng ký của khách hàng trên một số Jamaica.

Xử lý sự cố: mã Jamaica đến muộn, bị thiếu hoặc bị từ chối

• Bị từ chối ngay khi nhập? Hãy kiểm tra biểu mẫu của chính bạn trước; bộ kiểm tra chỉ dành cho Mỹ là thủ phạm thường gặp. Nếu bản thân ứng dụng bên thứ ba từ chối số, có thể nó không chấp nhận số ảo.
• Chưa thấy gì? Hãy để lượt kích hoạt mở đủ 20 phút thay vì hủy rồi đặt lại.
• Vẫn không có gì? Thử lại sau hoặc với một tuyến dịch vụ khác. Tránh dồn dập gọi cùng một đơn trong vòng lặp.

Khi không có SMS nào đến số trước khi hết khung, toàn bộ khoản phí được hoàn về ví tự động. Hướng dẫn giảm tỷ lệ gửi OTP thất bại có danh sách kiểm tra dài hơn.

Đường dây chuyên dụng, ví và sandbox có áp dụng cho Jamaica không?

Dùng chung mã +1 không biến Jamaica thành một phần của sản phẩm chuyên dụng. Dedicated Virtual Number chỉ bán cho Hoa Kỳ và Canada, từ $1.95/tháng, và không có số Jamaica dùng lâu dài tự phục vụ. Nếu cần, hãy gửi email đến [email protected] để hỏi; quy định địa phương quyết định và không có gì được cam kết.

Mọi thứ khác hoạt động như ở bất kỳ nơi nào: ví USD trả trước, không phí hằng tháng, nạp bằng thẻ hoặc USDT/USDC, và mỗi lần nạp có hóa đơn PDF gửi qua email. Chế độ sandbox, có sẵn theo yêu cầu, trả về số và mã mô phỏng cho các bài kiểm thử tích hợp. Xem /pricing để biết cách tính phí.

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

Tôi có thể kiểm thử xác minh điện thoại Jamaica của ứng dụng mà không cần ở Kingston không?

Có. Hãy đặt một số +1 876 hoặc +1 658 cho dịch vụ của bạn qua OTP Route và đọc mã trong bảng điều khiển hoặc API, dù đội của bạn ở đâu.

Tôi gửi mã quốc gia nào cho Jamaica?

Hãy gửi jm. Mã quay số là +1, nhưng API xác định quốc gia bằng chính mã đó.

Số Jamaica có được coi là số Mỹ không?

Không. Nó dùng chung mã +1 nhưng là một quốc gia riêng với mã vùng riêng, và nhiều ứng dụng coi nó là Jamaica.

Tiền của tôi sẽ ra sao nếu mã Jamaica không đến?

Nếu không có SMS nào đến trong vòng 20 phút, hoặc bạn hủy, toàn bộ số tiền được trả về ví.

Tôi có thể mua số Jamaica dùng lâu dài từ OTP Route không?

Không theo hình thức tự phục vụ. Dedicated Number dùng lâu dài chỉ bao gồm Mỹ và Canada; hãy gửi email cho bộ phận hỗ trợ để hỏi về Jamaica.

Có cách nào kiểm thử luồng webhook mà không phải trả tiền không?

Hãy yêu cầu chế độ sandbox cho tài khoản phát triển. Nó trả về số và mã mô phỏng, và bài thu thập OTP bằng webhook giải thích phần xử lý phía bạn.

Những cách dùng số Jamaica +1 nào để kiểm thử là được phép?

Kiểm thử sản phẩm của chính bạn, tự động hóa QA và vận hành các tài khoản doanh nghiệp hợp pháp. Tuyến Caribe bị ràng buộc bởi điều khoản của từng ứng dụng cũng như Chính sách sử dụng chấp nhận được của OTP Route.

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.