Nhận mã xác minh +966 bằng lập trình cho các đợt ra mắt tại Ả Rập Xê Út

Một lượt kích hoạt +966 qua API trông như thế nào?

Hãy bắt đầu từ các lệnh gọi, vì phần lớn người đọc trang này đang gắn một API xác minh SMS vào bộ kiểm thử hoặc công cụ nội bộ. Mọi endpoint nằm dưới https://otproute.com/api/v1 và yêu cầu khóa Bearer có tiền tố or_live_, tạo trong Developer console.

1. GET /api/v1/countries và GET /api/v1/services cho bạn các id. Ả Rập Xê Út là sa.
2. GET /api/v1/prices?country=sa&service=<id> trả về mức giá hiện tại của cặp đó; hãy ghi lại cùng với lần chạy kiểm thử.
3. POST /api/v1/activations với {"service": "<id>", "country": "sa"} trả về id lượt kích hoạt và một số +966.
4. Bài kiểm thử nhập số vào ứng dụng, và mã đến dưới dạng sự kiện hoặc qua GET /api/v1/activations/{id}.
5. Nếu bài kiểm thử bị bỏ dở, POST /api/v1/activations/{id}/cancel sẽ giải phóng số và hoàn tiền vào ví.

GET /api/v1/balance hữu ích như bước kiểm tra trước khi chạy, để một tác vụ ban đêm thất bại sớm với thông báo rõ ràng thay vì giữa chừng. Các giới hạn cần tính đến: 10 khóa và 5 điểm cuối webhook cho mỗi tài khoản, 300 yêu cầu mỗi phút.

Bộ nhận webhook của chúng tôi nên xử lý sự kiện OTP Ả Rập Xê Út ra sao?

Đăng ký một endpoint và đăng ký nhận activation.sms_received, activation.expired và activation.cancelled. Mỗi yêu cầu đều kèm X-OTPRoute-Signature theo dạng t=<unix>,v1=<hex>.

• Dựng lại chuỗi được ký là <t>.<raw body> và tính HMAC-SHA256 bằng bí mật của endpoint đó.
• So sánh với v1 bằng một hàm có thời gian không đổi, và từ chối mọi yêu cầu có dấu thời gian quá cũ.
• Coi mỗi sự kiện được định danh theo id lượt kích hoạt, để một lần gửi lại không cập nhật hai lần.
• Trả về 2xx nhanh chóng và để công việc chậm cho một tác vụ nền.

Thăm dò vẫn là phương án dự phòng hợp lệ cho các runner không nhận được kết nối đến. Các bài viết của chúng tôi về thu mã OTP bằng webhook và bảo mật webhook OTP bằng HMAC đi sâu hơn.

Vì sao các đội sản phẩm kiểm thử bằng số +966?

Ả Rập Xê Út là một trong những thị trường số lớn hơn của vùng Vịnh, và các đội đến trang này vì những lý do thực tế: một công ty fintech chuẩn bị quy trình tiếp nhận cho cư dân Ả Rập Xê Út, một sàn thương mại thêm người bán vùng Vịnh, một nhà cung cấp SaaS có khách hàng yêu cầu kiểm tra đăng nhập khu vực, hoặc một đội vận hành quản lý tài khoản doanh nghiệp cho văn phòng ở Riyadh hay Jeddah. Trong mọi trường hợp, ai đó phải chứng minh luồng hoạt động với một số xác minh Ả Rập Xê Út thật, và định tuyến OTP qua cổng giúp tiết kiệm việc gửi thẻ SIM tới khu vực này. Trang tiếp nhận fintech mô tả kịch bản đó chi tiết hơn.

Những dịch vụ nào nhận được mã trên các tuyến Ả Rập Xê Út?

Ảnh chụp trực tiếp của Ả Rập Xê Út bao gồm hơn 1,000 dịch vụ. Những dịch vụ được dùng thường xuyên gồm Snapchat, WhatsApp, X (Twitter), Uber, TikTok, Instagram, Google (Gmail & YouTube), Telegram, Amazon, Microsoft & Outlook, LinkedIn, Discord và Netflix. Snapchat và X có lượng người dùng đặc biệt lớn tại Vương quốc này, nên thường có mặt trong danh sách kiểm tra bản địa hóa. Danh mục thay đổi trong ngày, vì vậy hãy truy vấn API tại thời điểm chạy.

Tôi định dạng số +966 và phân tích tin nhắn tiếng Ả Rập thế nào?

Ở trong nước, số di động Ả Rập Xê Út được viết với số 0 đầu mạng, thường là 05 theo sau là tám chữ số. Dạng quốc tế bỏ số 0 đó: +966 5 và tám chữ số còn lại. Hãy chuẩn hóa mọi thứ về E.164 ngay lúc nhập, và bỏ số 0 nếu người dùng gõ nó sau mã quốc gia.

Tiếng Ả Rập là ngôn ngữ chính thức, nên tin nhắn xác minh có thể đến bằng tiếng Ả Rập, tiếng Anh, hoặc cả hai. Tiếng Ả Rập viết từ phải sang trái, và một số mẫu có thể dùng chữ số Ả Rập-Ấn Độ thay vì chữ số phương Tây. Một trình phân tích chuyển các chữ số đó sang ASCII trước khi so khớp, và ghi nhật ký UTF-8 thô, sẽ tránh được một loạt lỗi giả gây khó chịu.

Có cách dùng bảng điều khiển cho người không viết mã không?

Có. Đăng nhập vào OTP Route, mở OTP Gateway, chọn Ả Rập Xê Út và dịch vụ, xem giá rồi xác nhận. Số xuất hiện ngay và mã hiển thị bên cạnh khi đến. Nhân viên hỗ trợ có thể dùng cách này để tái hiện sự cố đăng ký của khách hàng chỉ trong vài phút.

Nếu mã không bao giờ đến thì sao, còn số dài hạn và thanh toán thì thế nào?

Nếu không có SMS nào đến trong 20 phút, hoặc bạn hủy, toàn bộ số tiền sẽ tự động quay về ví. Hãy để cửa sổ chạy hết, thử lại sau hoặc qua một tuyến dịch vụ khác, xác nhận dịch vụ chấp nhận số ảo, và tránh đặt lại đơn trong vòng lặp dày.

Không có số dài hạn Ả Rập Xê Út tự phục vụ. Dedicated Virtual Number chỉ được cung cấp tại Hoa Kỳ và Canada, từ $1.95/tháng; với một đường dây +966 dài hạn, hãy gửi email tới [email protected], lưu ý rằng quy định địa phương quyết định liệu có khả thi hay không.

Nguồn tiền là một ví USD trả trước, trả theo mức dùng, không có phí hàng tháng. Cả thanh toán bằng thẻ lẫn USDT/USDC đều dùng được để nạp tiền, và mỗi lần nạp tạo ra một hóa đơn PDF gửi qua email. Một tài khoản phát triển có thể được chuyển sang sandbox khi có yêu cầu để nhận số và mã mô phỏng. Xem trang bảng giá để biết mức giá hiện tại.

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

Làm sao nhận SMS OTP Ả Rập Xê Út qua API?

Tạo một lượt kích hoạt với quốc gia sa và id dịch vụ của bạn, rồi lấy mã từ webhook activation.sms_received hoặc bằng cách thăm dò lượt kích hoạt.

Số +966 để kiểm thử có bị tính phí nếu mã không đến không?

Không. Mã không đến nghĩa là toàn bộ số tiền được trả về ví khi cửa sổ 20 phút kết thúc hoặc khi bạn hủy.

Tôi có thể kiểm thử luồng đăng ký Ả Rập Xê Út của ứng dụng mà không cần SIM địa phương không?

Có. OTP Gateway cấp một số +966 cho một mã, bạn nhập vào ứng dụng và đọc lại qua bảng điều khiển hoặc API.

Tôi nên lưu số di động Ả Rập Xê Út nhập dưới dạng 05XXXXXXXX như thế nào?

Bỏ số 0 đầu mạng và lưu thành +966 5 cộng tám chữ số còn lại theo E.164.

Chúng tôi có thể giữ cùng một số Ả Rập Xê Út cho các lần đăng nhập sau không?

Không với sản phẩm tự phục vụ, vì Dedicated Number dài hạn chỉ áp dụng cho Hoa Kỳ và Canada. Hãy gửi email cho nhóm nếu bạn cần một đường dây Ả Rập Xê Út, không có đảm bảo sẽ cung cấp được.

Có cách nào chạy thử luồng Ả Rập Xê Út trước khi dùng tiền thật không?

Có. Hãy yêu cầu chế độ sandbox trên tài khoản phát triển để nhận số và mã mô phỏng, kể cả webhook.

OTP Route cho phép cách sử dụng nào?

Kiểm thử và vận hành các sản phẩm và tài khoản hợp pháp của chính bạn. Hãy tuân thủ điều khoản của mọi dịch vụ; Chính sách Sử dụng Chấp nhận được của OTP Route được áp dụ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.