Lộ trình dành cho lập trình viên để nhận mã dùng một lần của Lào (+856)

Đường ngắn nhất từ khóa API tới mã +856 là gì?

Bắt đầu trong Developer console: tạo một khóa Bearer (khóa sẽ bắt đầu bằng or_live_) và giữ mỗi môi trường một khóa, vì một tài khoản cho phép mười khóa. Mọi yêu cầu đều gửi tới https://otproute.com/api/v1, và mã quốc gia của Lào là la. Một lượt chạy tối giản như sau:

1. Tra id dịch vụ từ GET /api/v1/services; id quốc gia lấy từ GET /api/v1/countries.
2. Gọi GET /api/v1/prices?country=la&service=<id> để biết đơn hàng giá bao nhiêu và cặp này có đang mở vào lúc này không.
3. Tạo activation bằng POST /api/v1/activations với phần thân như {"service": "telegram", "country": "la"}. Phản hồi chứa id activation và số điện thoại Lào.
4. Nhập số vào ứng dụng đang kiểm thử, rồi chờ mã.
5. Nếu bài kiểm thử bị dừng sớm, POST /api/v1/activations/{id}/cancel sẽ giải phóng khoản giữ tiền.

Đó là toàn bộ bề mặt API OTP Lào mà một bài kiểm thử cơ bản cần. Tổng quan cho nhà phát triển và tài liệu đầy đủ trình bày chi tiết phản hồi và mã lỗi.

Polling hay webhook: cái nào hợp với bộ kiểm thử Lào?

Với một script chạy một lần, polling GET /api/v1/activations/{id} vài giây một lần là hoàn toàn hợp lý; ở mức 300 yêu cầu mỗi phút cho mỗi tài khoản, nhiều job chạy song song vẫn dư sức. Các bộ kiểm thử lớn hơn sẽ được lợi từ việc nhận đẩy. Thêm tối đa năm endpoint webhook và lắng nghe activation.sms_received, activation.expired và activation.cancelled.

Trình xử lý nhận có ba nhiệm vụ. Thứ nhất, xác minh X-OTPRoute-Signature (t=<unix>,v1=<hex>) bằng cách tính HMAC-SHA256 trên <t>.<raw body> với secret của endpoint. Thứ hai, từ chối các timestamp đã cũ. Thứ ba, giữ tính idempotent bằng cách ghi lại id activation, để sự kiện được gửi lại trở thành thao tác không làm gì. Thêm các mẫu khác có trong bài về bắt OTP bằng webhook.

Số điện thoại Lào được viết thế nào và mã đến bằng ngôn ngữ nào?

Trong nước, số điện thoại Lào được quay với số 0 trunk, và số không đó biến mất ở định dạng quốc tế. Số di động nhìn chung bắt đầu bằng 20 sau mã quốc gia, nên một số nội địa 020 trở thành +856 20 theo sau là các chữ số thuê bao ở dạng E.164. Hãy lưu dạng E.164 đó và loại bỏ số 0 trunk khi chuẩn hóa; nếu không, việc tra cứu trong bảng người dùng sẽ bỏ sót các bản trùng được viết theo cả hai cách.

Tiếng Lào là ngôn ngữ chính thức và có chữ viết riêng. Nếu sản phẩm của bạn gửi mẫu OTP đã bản địa hóa, hãy xác nhận rằng các ký tự Lào không bị hỏng khi mã hóa SMS và các chữ số vẫn dễ nhận ra, vì một tin Unicode dài có thể bị tách thành nhiều phần. Nhiều dịch vụ quốc tế vẫn để nội dung xác minh bằng tiếng Anh cho thị trường này, nên bộ phân tích của bạn cần xử lý được cả hai.

Vì sao các nhóm sản phẩm kiểm thử tại Lào?

Lào giáp Thái Lan, Việt Nam, Trung Quốc, Campuchia và Myanmar, và nhiều ứng dụng trong khu vực coi đây là một phần của đợt triển khai rộng hơn ở vùng Mê Kông. Các nhóm thường cần một số +856 để kiểm thử khi thêm tiếng Lào vào bản bản địa hóa, khi ra mắt sản phẩm ví hoặc giao hàng xuyên biên giới, hoặc khi hỗ trợ người dùng di chuyển giữa Lào và các thị trường lân cận. Chạy luồng đăng ký qua một tuyến Lào thực giúp phát hiện các lỗi về định dạng, giới hạn tần suất và mẫu tin nhắn trước khi khách hàng báo lỗi. Bài hướng dẫn định tuyến theo quốc gia giải thích cách đưa ra quyết định định tuyến OTP cho từng thị trường.

Những dịch vụ nào đang mở trên tuyến +856?

Danh mục hiện tại cho la liệt kê hơn 1,700 dịch vụ. Những dịch vụ phổ biến tại thời điểm viết bài gồm WhatsApp, Facebook, LINE, WeChat, TikTok, Telegram, Google (Gmail & YouTube), imo, Shopee, Lazada, Zalo, Instagram và ChatGPT (OpenAI). Tình trạng khả dụng thay đổi theo năng lực của đối tác, nên hãy để endpoint giá trả lời câu hỏi đó ở mỗi lần chạy.

Nếu không dùng code, luồng dashboard rất ngắn: chọn dịch vụ, chọn Lào, kiểm tra giá hiển thị, đặt hàng và theo dõi thẻ activation để thấy mã.

Tôi nên làm gì khi mã Lào không xuất hiện?

Mỗi activation giữ số trong 20 phút. Bạn chỉ trả tiền nếu mã đến; khi hết hạn hoặc khi hủy, tiền được hoàn về ví tự động.

• Hãy để cửa sổ chạy hết thời gian trước khi kết luận tuyến bị lỗi.
• Đừng đặt lại liên tục trong vòng lặp dày; hãy giãn cách các lần thử lại hoặc quay lại sau.
• Chuyển sang tuyến dịch vụ khác cho cùng ca kiểm thử nếu một tuyến liên tục hết thời gian.
• Kiểm tra xem ứng dụng có chấp nhận số ảo không, vì một số từ chối thẳng.
• Xác nhận biểu mẫu của bạn đã gửi +856 mà không còn dính số 0 trunk.

Đường dây dùng lâu dài, thanh toán và sandbox cho Lào

OTP Route không có số Lào dùng lâu dài tự phục vụ. Dedicated Numbers là sản phẩm của Hoa Kỳ và Canada, từ $1.95/month; với đường dây +856, hãy gửi email tới [email protected] và đội ngũ sẽ cho biết quy định địa phương có cho phép hay không, không kèm bất kỳ cam kết nào.

Thanh toán theo kiểu dùng bao nhiêu trả bấy nhiêu từ ví USD trả trước: không đăng ký gói, nạp tiền bằng thẻ hoặc USDT/USDC, và mỗi lần nạp có hóa đơn PDF gửi qua email. Cho công việc CI, hãy yêu cầu chuyển tài khoản phát triển sang sandbox để số và mã giả lập chạy qua cùng các endpoint mà không tốn phí. Trang bảng giá có thêm chi tiết.

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

Tôi có thể xác minh luồng đăng ký Lào của ứng dụng mà không có SIM Lào không?

Có. Đặt một số +856 trên OTP Gateway, dùng nó ở màn hình đăng ký và nhận mã qua API, webhook hoặc dashboard.

OTP Route dùng mã quốc gia nào cho Lào?

Đó là la. Dùng nó trong truy vấn giá và trong phần thân yêu cầu activation.

Có nên giữ số 0 ở đầu số điện thoại Lào không?

Chỉ khi quay số trong nước. Ở dạng E.164 và trong cơ sở dữ liệu của bạn, hãy bỏ nó và lưu +856 theo sau là số quốc gia.

Một số xác minh Lào có 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 GET /api/v1/prices trả về trước khi bạn đặt hàng.

Việc hoàn tiền có tự động nếu mã không bao giờ đến không?

Có. 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 được hoàn về ví của bạn.

Thế nào là sử dụng chấp nhận được đối với số +856?

Kiểm thử các luồng đăng ký Lào của chính bạn và vận hành các tài khoản mà doanh nghiệp của bạn sở hữu hợp pháp. OTP Route yêu cầu bạn 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 (Acceptable Use Policy), tức là mỗi người thật hoặc mỗi doanh nghiệp chỉ một tài khoả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.