Danh sách kiểm tra trước khi nhận mã xác minh +375 từ Belarus

Cần chuẩn bị gì trước khi yêu cầu một số +375?

Trước khi dùng số +375 để kiểm thử, hãy đánh dấu các mục sau:

• Một tài khoản và một ví có tiền. Tạo tại /signup bằng email và mã email 6 chữ số, hoặc đăng nhập Google, rồi nạp một số dư nhỏ. Bật xác thực hai yếu tố TOTP cho tài khoản giữ các khóa API.
• Một khóa Bearer có tiền tố or_live_, tạo trong Developer console. Cấp khóa riêng cho CI và môi trường phát triển cục bộ; một tài khoản có thể giữ tối đa 10 khóa.
• Hai id bạn sẽ gửi. Belarus là by trong API, và id dịch vụ là giá trị api_service do GET /api/v1/services trả về.
• Một endpoint nhận nếu bạn định dùng webhook, với secret ký của nó được lưu ngoài kho mã.
• Một tài khoản kiểm thử trong sản phẩm của chính bạn được phép đổi hoặc thêm số điện thoại.
• Một thư viện số điện thoại được cấu hình cho vùng BY, để số bạn dán vào biểu mẫu đăng ký được phân tích đúng như cách một người dùng Belarus thật sẽ gõ.

Số Belarus được viết thế nào, và ứng dụng của bạn nên lưu chúng ra sao?

Belarus dùng mã quốc gia +375 theo sau là số quốc gia chín chữ số. Số di động bắt đầu bằng mã nhà mạng như 25, 29, 33 hoặc 44, nên một giá trị được lưu trông như +37529XXXXXXX.

Phần khó là thói quen trong nước. Người dân thường viết số di động với 80 ở đầu, như 8 029 XXX-XX-XX, bắt nguồn từ tiền tố quay số đường dài. 80 đó phải được bỏ trước khi thêm mã quốc gia; một biểu mẫu giữ lại nó sẽ tạo ra chuỗi E.164 không hợp lệ mà một số dịch vụ xác minh âm thầm từ chối. Các ca kiểm thử chuẩn hóa tốt cho một số xác minh Belarus:

• chấp nhận +375 29 ..., 375 29 ... và 8 029 ... và lưu cả ba giống hệt nhau;
• hiển thị số theo cách nhóm thân thiện với người địa phương nhưng chỉ gửi E.164 tới lớp SMS hoặc xác minh của bạn;
• từ chối số vẫn còn 80 sau 375.

Tiếng Belarus và tiếng Nga đều là ngôn ngữ chính thức, và tiếng Nga là thứ phần lớn người dân dùng hằng ngày. Nhiều dịch vụ gửi nội dung mã bằng tiếng Nga hoặc tiếng Anh tùy ngôn ngữ tài khoản, vì vậy hãy kiểm tra ứng dụng của bạn hiển thị đúng chữ Cyrillic trên mọi màn hình phản hồi lại tin nhắn.

Số xác minh Belarus nhận được mã cho những dịch vụ nào?

Định tuyến OTP cho Belarus trên OTP Route hiện bao phủ hơn 1.400 dịch vụ dưới id by. Các tuyến phổ biến trong ảnh chụp hiện tại gồm Telegram, Viber, WhatsApp, Signal, Google (Gmail & YouTube), Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Amazon và AliExpress.

Tình trạng còn hàng trên một tuyến đơn lẻ thay đổi trong ngày, vì vậy hãy coi danh sách như thế này là điểm khởi đầu chứ không phải lời cam kết. Trước mỗi lượt chạy, hãy hỏi GET /api/v1/prices?country=by&service=<id> để biết giá hiện tại và việc tuyến có nhận đơn ngay lúc này hay không. Xem định tuyến theo quốc gia cho OTP khi chọn giữa các quốc gia.

Từng bước: luồng API OTP Belarus từ một tập lệnh kiểm thử

Mọi yêu cầu đều đến https://otproute.com/api/v1 với khóa Bearer của bạn. API xác minh SMS đủ nhỏ để bọc trong một hàm trợ giúp duy nhất:

1. Gọi GET /api/v1/balance và dừng tác vụ sớm nếu ví quá ít cho bộ kiểm thử.
2. Gọi GET /api/v1/prices?country=by&service=telegram (thay bằng id dịch vụ của bạn) và ghi log mức giá bạn sắp trả.
3. Tạo đơn bằng POST /api/v1/activations với nội dung như {"service": "telegram", "country": "by"}. Lưu id kích hoạt và số +375 từ phản hồi.
4. Gửi số đó tới bước điện thoại của ứng dụng của bạn và kích hoạt mã.
5. Thu mã từ sự kiện activation.sms_received, hoặc thăm dò GET /api/v1/activations/{id}. Giới hạn là 300 yêu cầu mỗi phút.
6. Nếu bài kiểm thử bị hủy, hãy gọi POST /api/v1/activations/{id}/cancel để khoản tạm giữ trở lại ví ngay.

Với webhook, hãy đọc header X-OTPRoute-Signature (t=<unix>,v1=<hex>), tính HMAC-SHA256 của <t>.<raw body> bằng secret của endpoint, so sánh bằng thời gian hằng định, và bỏ các lần gửi có dấu thời gian đã cũ. Xử lý theo id kích hoạt để một lần gửi lặp lại là vô hại. Tài liệu API và hướng dẫn bảo vệ webhook OTP bằng HMAC trình bày chi tiết.

Từng bước: cùng công việc đó từ dashboard

Nhân viên hỗ trợ thỉnh thoảng cần một mã có thể bỏ qua API:

1. Mở OTP Gateway trong dashboard và chọn Belarus.
2. Chọn dịch vụ; giá của tuyến đó hiển thị trước khi bạn xác nhận.
3. Sao chép số +375 và nhập vào ứng dụng bạn đang kiểm thử.
4. Theo dõi thẻ đơn. Mã xuất hiện ở đó ngay khi đến.

Nếu không có gì đến trong 20 phút, đơn đóng lại và toàn bộ số tiền được hoàn trả. Bạn chỉ trả tiền khi có mã được gửi.

Xử lý sự cố: mã +375 không đến

Các nguyên nhân thường gặp và bước tiếp theo cho từng trường hợp:

• Dịch vụ từ chối số. Một số nền tảng từ chối số ảo. Quy tắc hoàn tiền tồn tại đúng cho trường hợp này; hãy thử một tuyến dịch vụ khác hoặc quốc gia khác nếu bài kiểm thử cho phép.
• Số được nhập ở dạng nội địa. Kiểm tra lại rằng biểu mẫu của bạn đã gửi +375 cộng chín chữ số, không có 80.
• Tuyến đang bận. Hãy để cửa sổ chạy hết thay vì hủy sau một phút, rồi thử lại sau.
• Tập lệnh của bạn đặt lại liên tục trong vòng lặp dày. Thêm back-off giữa các lần thử; các đơn lặp nhanh trên một dịch vụ hiếm khi giúp được và có thể trông giống lạm dụng với nền tảng đích.

Các kiểu lỗi khác của đơn +375 được trình bày trong giảm số lần gửi OTP thất bại.

Có đường dây Belarus dùng lâu dài không, và thanh toán hoạt động ra sao?

Không. OTP Route không có số dùng lâu dài tự phục vụ cho Belarus. Nếu nhóm bạn cần một số cho trường hợp vận hành hoặc hỗ trợ, hãy gửi email tới [email protected] và mô tả; việc có thể cung cấp gì còn tùy quy định địa phương và không có gì được hứa chắc. Số ảo chuyên dụng là sản phẩm của Hoa Kỳ và Canada, từ $1.95/tháng, có nhận SMS, gửi SMS và gọi điện trên trình duyệt.

Các đơn Belarus dùng cùng ví USD trả trước như mọi tuyến khác, không tính phí hằng tháng và không có bậc nào để chọn. Nạp tiền bằng thẻ hoặc stablecoin USDT/USDC; hóa đơn PDF cho mỗi lần nạp được gửi vào hộp thư của bạn. Lập trình viên có thể yêu cầu một tài khoản sandbox trả về số và mã mô phỏng, đó là cách rẻ nhất để chứng minh một tích hợp trước khi đặt đơn thật. Chỉ dùng mỗi số cho sản phẩm của chính bạn hoặc các tài khoản hợp pháp của bạn, tuân thủ điều khoản của từng dịch vụ, và lưu ý rằng Chính sách Sử dụng Chấp nhận được của OTP Route được áp dụng. Các con số hiện hành có trên bảng giá.

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

Tôi có thể kiểm thử luồng đăng ký Belarus của ứng dụng mà không cần SIM địa phương không?

Có. Hãy đặt một số +375 cho dịch vụ của bạn từ OTP Gateway, gửi nó trong biểu mẫu đăng ký và đọc mã trong dashboard hoặc qua API.

Id quốc gia của Belarus trong API OTP Route là gì?

Đó là by. Hãy dùng nó trong GET /api/v1/prices và trong nội dung của POST /api/v1/activations.

Tôi có nên lưu số Belarus với tiền tố 80 không?

Không. Hãy lưu theo E.164 dưới dạng +375 theo sau là chín chữ số và bỏ 80 nội địa, nếu không nhiều dịch vụ sẽ coi số đó là không hợp lệ.

Tiền của tôi ra sao nếu số +375 không bao giờ nhận được mã?

Khi cửa sổ 20 phút kết thúc mà không có SMS, hoặc bạn hủy, toàn bộ khoản phí tự động trở lại ví của bạn.

Tin nhắn SMS xác minh sẽ bằng ngôn ngữ nào?

Điều đó do dịch vụ gửi quyết định. Với số Belarus, thường là tiếng Nga hoặc tiếng Anh, dựa theo ngôn ngữ tài khoản hoặc thiết bị.

Tôi có thể giữ một số +375 cho các lần đăng nhập sau không?

Không qua tự phục vụ. Số chuyên dụng dùng lâu dài chỉ có cho Hoa Kỳ và Canada; với Belarus, bạn có thể gửi email tới [email protected] để hỏi, không có cam kết về khả năng cung cấp.

Có cách nào kiểm thử tích hợp mà không tốn tiền trong ví không?

Có. Một tài khoản phát triển có thể được chuyển sang sandbox theo yêu cầu, và nó trả về số cùng mã mô phỏng cho các bài kiểm thử đầu cuối.

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.