Chọn tuyến phù hợp cho mã xác minh Ukraine (+380)

Các ca kiểm thử Ukraine cần số dùng một lần hay đường dây dài hạn?

Hãy bắt đầu với câu hỏi này, vì nó quyết định mọi thứ còn lại. Một số OTP Gateway dùng một lần nhận một mã xác minh rồi đóng lại. Một đường dây dài hạn là thứ bạn giữ và đăng nhập lại nhiều tháng sau.

Với Ukraine, câu trả lời đơn giản: OTP Gateway là lựa chọn tự phục vụ. Không có số Ukraine chuyên dụng tự phục vụ. Dedicated Numbers dài hạn chỉ có tại Hoa Kỳ và Canada, từ $1.95/tháng, và phù hợp với các tài khoản staging phải tiếp tục đăng nhập hoặc một đường dây khôi phục dùng chung của nhóm. Nếu bạn thực sự cần một đường dây +380 lâu dài, hãy gửi email tới [email protected]; khả năng cung cấp phụ thuộc vào quy định địa phương và không được hứa trước.

Vì vậy cách chia thực tế là: dùng số +380 dùng một lần cho QA đăng ký và bước xác minh điện thoại, và nếu một tài khoản kiểm thử phải sống sót qua các lần xác minh lại, hãy cân nhắc xem một đường dây Hoa Kỳ hoặc Canada có phù hợp với bài kiểm thử không. Bài so sánh số tạm thời so với số chuyên dụng đi qua các đánh đổi.

Vì sao các đội kỹ thuật kiểm thử với số +380?

Ukraine có một cộng đồng kỹ sư phần mềm lớn, và nhiều đội sản phẩm quốc tế có nhà phát triển và người kiểm thử người Ukraine. Ngoài ra, có vài tình huống lặp đi lặp lại:

• QA tiếng Ukraine: tiếng Ukraine là ngôn ngữ quốc gia, và các đội bản địa hóa onboarding muốn thấy bước điện thoại thật với chữ Cyrillic xung quanh.
• Người dùng kiều bào: những người có số +380 hiện sống ở Ba Lan, Đức và các nước châu Âu khác, nên một ứng dụng ra mắt ở nơi khác vẫn gặp số Ukraine khi đăng ký.
• Luồng thiên về nhắn tin: Telegram và Viber được dùng rộng rãi ở Ukraine, khiến chúng trở thành mục tiêu kiểm thử phổ biến cho các sản phẩm tích hợp với một trong hai.

Bản thân tin nhắn xác minh có thể đến bằng tiếng Ukraine, tiếng Anh hoặc ngôn ngữ khác tùy dịch vụ và cài đặt tài khoản, vì vậy hãy trích các chữ số bằng một mẫu thay vì so khớp các từ cố định.

Nên chuẩn hóa số +380 như thế nào?

Trong nước, số Ukraine được viết với trunk 0 theo sau là chín chữ số, ví dụ theo dạng 0XX XXX XX XX. Ở dạng quốc tế, số 0 bị bỏ: +380 cộng số quốc gia chín chữ số. Lưu ý rằng bản thân mã quốc gia kết thúc bằng 0, điều này gây nhầm lẫn cho một số bộ kiểm tra tự viết.

Hướng dẫn:

• Chỉ lưu chuỗi E.164; định dạng bằng khoảng trắng hoặc số 0 trunk khi hiển thị.
• Nếu người dùng gõ 0… sau khi chọn +380, hãy bỏ đúng một số 0 ở đầu.
• Cẩn thận với +3800…, dấu hiệu cho thấy tiền tố trunk chưa được bỏ.
• Kiểm tra độ dài bằng một thư viện được bảo trì thay vì các regex sao chép từ nơi khác.

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

Ảnh chụp trực tiếp ghi nhận hơn 1.500 dịch vụ cho Ukraine. Trong số những dịch vụ phổ biến có Telegram, Viber, WhatsApp, Signal, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Discord, LinkedIn, Microsoft & Outlook, Uber, ChatGPT (OpenAI) và Claude.

Những gì được cung cấp thay đổi trong ngày, vì vậy hãy coi đây là ví dụ và để API cho bạn biết hiện đang có gì.

Các lệnh gọi API OTP Ukraine kết hợp với nhau ra sao?

Các yêu cầu cho số +380 được gửi tới https://otproute.com/api/v1, ký bằng khóa Bearer or_live_ tạo trong Developer console. Id quốc gia của Ukraine là ua.

Một trình tự gọn gàng: tra id bằng GET /api/v1/services và GET /api/v1/countries; đọc chi phí và tình trạng khả dụng từ GET /api/v1/prices?country=ua&service=<id>; xác nhận số dư bằng GET /api/v1/balance; rồi gửi POST /api/v1/activations với {"service": "viber", "country": "ua"}. Phản hồi chứa số +380 và id kích hoạt.

Về việc nhận mã, hãy chọn giữa polling GET /api/v1/activations/{id} và một webhook đăng ký activation.sms_received, activation.expired và activation.cancelled. Mỗi webhook mang theo X-OTPRoute-Signature: t=<unix>,v1=<hex>; hãy xác minh nó dưới dạng HMAC-SHA256 trên <t>.<raw body> với secret của endpoint, từ chối dấu thời gian cũ và xử lý mỗi id kích hoạt đúng một lần. Một tài khoản cho phép 10 khóa, 5 endpoint và 300 yêu cầu mỗi phút. Chi tiết đầy đủ nằm trong tài liệu.

Đường đi qua dashboard cho người không phải nhà phát triển là gì?

Nhân viên hỗ trợ và tăng trưởng có thể bỏ qua hoàn toàn API. Mở OTP Gateway trong dashboard, chọn Ukraine và dịch vụ, kiểm tra giá hiển thị rồi đặt. Nhập số +380 vào ứng dụng, yêu cầu SMS, và mã sẽ hiện trên trang kích hoạt khi nó đến.

Nếu mã không đến thì sao, và thanh toán được xử lý thế nào?

Một lượt kích hoạt mở trong 20 phút, và bạn chỉ trả tiền khi có mã đến. Nếu cửa sổ đóng mà trống, hoặc bạn gọi POST /api/v1/activations/{id}/cancel, toàn bộ số tiền sẽ quay về ví.

Nếu thiếu mã, hãy chờ cửa sổ kết thúc, rồi thử lại sau hoặc với một tuyến dịch vụ khác. Kiểm tra xem dịch vụ có từ chối số ảo không, và đừng bắn các đơn lặp lại trong vòng lặp dồn dập.

Tiền lấy từ một ví USD trả trước, không có phí hàng tháng. Cả thanh toán thẻ và USDT/USDC đều dùng được để nạp, và một hóa đơn PDF sẽ đến hộp thư của bạn sau mỗi lần nạp. Theo yêu cầu, một tài khoản phát triển có thể chạy ở chế độ sandbox với số và mã mô phỏng, hữu ích khi thiết lập pipeline CI. OTP Route dành cho 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 theo đ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âu hỏi thường gặp

Tôi có thể nhận mã SMS OTP của Ukraine mà không cần SIM Ukraine không?

Có. Hãy đặt một số +380 từ OTP Gateway và đọc mã trong dashboard hoặc qua API.

OTP Route dùng id quốc gia nào cho Ukraine?

Dùng ua trong các truy vấn giá và trong nội dung của POST /api/v1/activations.

Số 0 trunk có thuộc về số +380 không?

Chỉ khi quay số trong nước. Trong E.164, bạn lưu +380 theo sau là chín chữ số, không có số 0 thừa.

Một số xác minh Ukraine có giá bao nhiêu?

Giá bắt đầu từ $0.20 mỗi mã, và API trả về con số trực tiếp chính xác cho từng dịch vụ.

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

Không có đường dây Ukraine dài hạn tự phục vụ. Dedicated Numbers là sản phẩm của Hoa Kỳ và Canada; hãy gửi email tới [email protected] để hỏi về các trường hợp khác.

Tôi có mất tiền nếu Telegram không bao giờ gửi mã không?

Không. Nếu không có mã trong cửa sổ 20 phút, khoản phí sẽ tự động quay về ví của bạn.

Tôi có thể kiểm thử toàn bộ onboarding tiếng Ukraine trong CI không?

Có, bằng cách gọi API từ bộ kiểm thử của bạn, và một tài khoản sandbox cho phép bạn diễn tập luồng trước với 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.