Lộ trình dành cho lập trình viên để nhận mã xác minh Jordan (+962)

Chuỗi yêu cầu cho một số +962 trông như thế nào?

API xác minh SMS là REST thuần túy tại https://otproute.com/api/v1, với khóa Bearer có tiền tố or_live_ do bạn tạo trong Developer console. Đây là thứ tự mà hầu hết các tích hợp theo cho Jordan:

1. Khám phá: GET /api/v1/services và GET /api/v1/countries trả về các mã định danh. Jordan là jo; một dịch vụ như Telegram là telegram.
2. Kiểm tra giá: GET /api/v1/prices?country=jo&service=telegram trả về chi phí hiện tại của cặp đó và liệu có thể đặt hay không.
3. Đặt đơn: POST /api/v1/activations với {"service": "telegram", "country": "jo"} giữ một số và trả về mã kích hoạt của nó.
4. Thu mã: polling GET /api/v1/activations/{id} vài giây một lần, hoặc để webhook đẩy kết quả đến bạn.
5. Dọn dẹp: POST /api/v1/activations/{id}/cancel giải phóng lượt kích hoạt bạn không còn cần và hoàn tiền.

GET /api/v1/balance hữu ích làm chốt chặn ở đầu lượt chạy kiểm thử, để job thất bại sớm với thông báo rõ ràng khi ví sắp hết. Tài liệu tham chiếu đầy đủ nằm trong tài liệu.

Làm sao xác nhận một webhook thật sự đến từ OTP Route?

Mỗi sự kiện (ví dụ activation.sms_received hoặc activation.expired) đến cùng header X-OTPRoute-Signature có dạng t=<unix>,v1=<hex>. Máy chủ của bạn tính HMAC-SHA256 trên "<t>.<raw body>" bằng secret của endpoint đó và so sánh kết quả với v1. Hãy từ chối yêu cầu nếu các giá trị khác nhau hoặc nếu t quá xa trong quá khứ; điều đó chặn tấn công phát lại.

Vì việc thử lại có thể gửi cùng một sự kiện hai lần, hãy định danh quá trình xử lý theo mã kích hoạt và coi bản sao thứ hai là thao tác không làm gì. Polling vẫn là phương án dự phòng vững chắc cho phát triển cục bộ, nơi URL webhook công khai khó thiết lập. Bài thu thập OTP bằng webhook trình bày hàng đợi và cơ chế thử lại.

Những ứng dụng nào có thể xác minh trên tuyến Jordan?

Có hơn 1,700 dịch vụ được liệt kê cho Jordan. Các dịch vụ phổ biến gồm WhatsApp, Telegram, Facebook, Instagram, Snapchat, TikTok, X (Twitter), Discord, Claude, Microsoft & Outlook, Amazon, Viber, imo, Signal và LinkedIn.

Danh sách là một bản chụp, không phải lời hứa. Dung lượng nhà mạng thay đổi trong ngày, nên API báo tình trạng khả dụng trực tiếp và code của bạn nên đọc nó trước khi đặt số.

Định dạng số Jordan: số 0 trung kế, E.164 và văn bản tiếng Ả Rập

Mã quốc gia của Jordan là +962 và tiền tố trung kế là 0. Ở địa phương, số di động được viết bắt đầu bằng 07; ở dạng quốc tế số 0 biến mất, còn lại +962 theo sau là chín chữ số bắt đầu bằng 7. Hãy lưu dạng E.164, và khi người dùng dán số nội địa, hãy bỏ số 0 ở đầu trước khi thêm mã quốc gia. So sánh 07… với +9627… như chuỗi là nguyên nhân kinh điển gây lỗi trùng tài khoản.

Tiếng Ả Rập là ngôn ngữ chính thức, và nhiều người đặt điện thoại và ứng dụng sang ngôn ngữ này. Tùy ứng dụng và cài đặt ngôn ngữ của tài khoản, mã có thể đến bằng văn bản tiếng Ả Rập hoặc tiếng Anh. Tin nhắn tiếng Ả Rập được gửi bằng Unicode, và các chữ số có thể nằm trong văn bản phải-sang-trái, vì vậy hãy trích mã bằng một mẫu và kiểm thử cả hai ngôn ngữ.

Các đội làm việc với Jordan khi bản địa hóa sản phẩm cho người nói tiếng Ả Rập, vận hành hỗ trợ từ Amman cho cả khu vực, hoặc kiểm tra luồng cùng các thị trường lân cận như Ả Rập Xê Út và Các Tiểu vương quốc Ả Rập Thống nhất.

Đặt mã Jordan từ bảng điều khiển

Nhân viên vận hành có thể làm điều tương tự mà không cần viết code. Tạo tài khoản bằng email và mã sáu chữ số hoặc đăng nhập Google, nạp tiền, chọn Jordan và dịch vụ trong OTP Gateway, xác nhận giá hiển thị rồi đặt đơn. Số +962 xuất hiện ngay, và mã hiện bên cạnh khi SMS đến.

Lượt kích hoạt mở trong 20 phút. Bạn chỉ trả tiền nếu mã đến; nếu khung đóng mà trống hoặc bạn hủy, số tiền được hoàn về ví tự động.

Thứ tự gỡ lỗi khi mã không đến

Bắt đầu từ lời giải thích ít tốn kém nhất rồi mở rộng dần:

• Khung thời gian còn mở không? Việc gửi phụ thuộc vào dịch vụ và tuyến. Hãy để đủ 20 phút trôi qua trước khi kết luận là thất bại.
• Dịch vụ có chấp nhận số ảo không? Một số không chấp nhận, đó là lý do các lượt kích hoạt không dùng được hoàn tiền.
• Thử tuyến khác. Đặt lại sau, hoặc dùng tuyến dịch vụ khác cho cùng tính năng nếu sản phẩm của bạn cho phép.
• Giảm tốc độ thử lại. Vòng lặp đặt lại mỗi vài giây chủ yếu chỉ đốt số lần thử; hãy giãn cách ra.

Chỉ kiểm thử các tài khoản bạn sở hữu hoặc vận hành, tuân thủ quy định 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 việc sử dụng.

Đường dây dùng lâu dài, ví và sandbox

OTP Route không có số dùng lâu dài tự phục vụ tại Jordan. Dedicated Number, từ $1.95/tháng, chỉ được cung cấp ngay lập tức ở Hoa Kỳ và Canada. Nếu đội của bạn cần đường dây +962 lâu dài, hãy viết đến [email protected]; việc có thể sắp xếp được hay không phụ thuộc vào quy định địa phương.

Ví được nạp trước bằng USD, không phí hằng tháng và không có gói để chọn. Nạp bằng thẻ hoặc USDT/USDC, và nhận hóa đơn PDF qua email cho mỗi lần nạp. Trong lúc tích hợp, hãy yêu cầu chế độ sandbox cho tài khoản phát triển để nhận số và mã mô phỏng mà không tốn tiền. Xem bảng giá để biết mức giá hiện tại.

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

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

Dùng jo làm giá trị country trong API OTP Route, ví dụ trong GET /api/v1/prices?country=jo&service=whatsapp.

Tôi có nên bỏ số 0 khỏi số di động Jordan không?

Có, cho định dạng quốc tế. Số 07 nội địa trở thành +962 theo sau là chín chữ số bắt đầu bằng 7.

Mã xác minh Jordan có đến bằng tiếng Ả Rập không?

Có thể. Ngôn ngữ thường theo ứng dụng và cài đặt tài khoản, vì vậy hãy phân tích chữ số theo mẫu và kiểm thử cả tin nhắn tiếng Ả Rập lẫn tiếng Anh.

Số +962 được giữ bao lâu để nhận mã của tôi?

Mỗi lượt kích hoạt kéo dài 20 phút. Nếu không có SMS nào đến trong thời gian đó, khoản phí được hoàn về ví của bạn.

Tôi có thể có số Jordan chuyên dụng để giữ lâu dài không?

Không theo hình thức tự phục vụ. Dedicated Number là sản phẩm dành cho Mỹ và Canada; với Jordan, bạn có thể gửi email đến [email protected] để hỏi.

Có cách nào nhận SMS OTP Jordan trong các bài kiểm thử tự động không?

Có. Đặt đơn bằng POST /api/v1/activations, rồi polling lượt kích hoạt hoặc xử lý webhook có chữ ký; tài khoản sandbox cho phép bạn diễn tập việc này bằng mã mô phỏ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.