Mã xác minh Ba Lan (+48): checklist, các bước API và cách khắc phục

Trước khi bay: tôi cần gì trước khi test đăng ký Ba Lan?

Hãy rà qua danh sách này một lần, và đơn Ba Lan đầu tiên thường diễn ra êm xuôi:

1. Thông tin xác thực. Tạo một khóa Bearer trong Developer console (bắt đầu bằng or_live_). Các khóa riêng cho staging, CI và production giúp việc xoay vòng nhẹ nhàng.
2. Định danh. Ba Lan là pl. Lấy id dịch vụ từ GET /api/v1/services thay vì gắn cứng tên hiển thị.
3. Tiền. Nạp ví; mỗi mức giá đều hiển thị trước khi bạn đặt.
4. Đích nhận. Đăng ký một webhook HTTPS và giữ secret của nó ngoài mã nguồn. Polling cũng được nếu lưu lượng vào bị chặn.
5. Ngân sách tốc độ. API cho phép 300 request mỗi phút cho mỗi tài khoản, nên hãy điều tiết các bộ test song song cho phù hợp.
6. Phạm vi. Chỉ xác minh những tài khoản thuộc sản phẩm, công ty hoặc khách hàng của chính bạn, và tuân thủ điều khoản của từng dịch vụ cùng Chính sách Sử dụng Chấp nhận được của chúng tôi.

Với pipeline nói riêng, xem test SMS OTP trong pipeline CI.

Hiện những dịch vụ nào gửi mã tới số +48?

Về định tuyến OTP, Ba Lan là một trong những mục rộng hơn trong danh mục, với hơn 2.300 dịch vụ. Ảnh chụp hiện tại của các dịch vụ phổ biến gồm Facebook, Instagram, TikTok, WhatsApp, Telegram, Viber, Signal, Snapchat, Discord, X (Twitter), LinkedIn, Google (Gmail & YouTube), Amazon, AliExpress, Uber và Netflix.

Hãy coi danh sách đó là điểm khởi đầu chứ không phải một lời hứa. Tình trạng khả dụng trên bất kỳ tuyến nào cũng thay đổi trong ngày, vì vậy hãy hỏi endpoint giá về cặp cụ thể trước mỗi đơn.

Các bước chính xác cho API OTP Ba Lan là gì?

Dùng API xác minh SMS tại https://otproute.com/api/v1, một bài test tự động thực hiện như sau:

1. GET /api/v1/prices?country=pl&service=<id> xác nhận giá hiện tại cho dịch vụ đó ở Ba Lan.
2. POST /api/v1/activations với {"service": "<id>", "country": "pl"} trả về số +48 và một activation id.
3. Bài test của bạn gõ số vào form đăng ký và yêu cầu SMS.
4. Handler nhận activation.sms_received; nếu thấy activation.expired hoặc activation.cancelled, nó đánh dấu lượt chạy là chưa nhận được.
5. Không có webhook, hãy đọc GET /api/v1/activations/{id} vài giây một lần cho đến khi mã xuất hiện hoặc cửa sổ kết thúc.
6. Gọi POST /api/v1/activations/{id}/cancel khi một bài test bị dỡ bỏ sớm.

Hãy xác thực header X-OTPRoute-Signature trước khi tin bất kỳ payload nào: nó chứa t=<unix>,v1=<hex>, trong đó v1 là HMAC-SHA256 của <t>.<raw body> được ký bằng secret của endpoint. Từ chối mọi thứ có timestamp cũ và làm cho handler idempotent theo activation id. Hướng dẫn bảo mật webhook trình bày chi tiết phép kiểm tra.

Đội vận hành của tôi có thể đặt số Ba Lan mà không dùng API không?

Có. Trong dashboard OTP Route, mở OTP Gateway, chọn Ba Lan, tìm dịch vụ và xác nhận mức giá hiển thị. Sau khi đặt, sao chép số xác minh Ba Lan vào màn hình xác minh của ứng dụng và theo dõi thẻ kích hoạt; nội dung SMS xuất hiện ở đó khi nhận được. Không cần cài đặt gì, và cùng một ví cấp tiền cho cả trình duyệt lẫn API.

Điều gì khiến số và tin nhắn Ba Lan khác biệt khi xử lý?

Ba Lan dùng kế hoạch đánh số khép kín không có tiền tố trunk: mọi số, di động hay cố định, đều gồm chín chữ số sau +48. Điều đó làm việc kiểm tra khá chặt chẽ. Hãy từ chối các giá trị không rút gọn được về chín chữ số quốc gia, bỏ khoảng trắng và dấu gạch ngang mà người dùng thêm theo nhóm ba, và lưu +48 cộng chín chữ số thành một chuỗi E.164 duy nhất. Một số 0 đứng đầu thừa là lỗi gõ, không phải tiền tố cần giữ.

Tin xác minh thường đến bằng tiếng Ba Lan khi ngôn ngữ tài khoản là tiếng Ba Lan. Các ký tự như ą, ę, ł và ż nằm ngoài bảng chữ cái GSM 7-bit, nên nếu bạn tự gửi tin OTP tiếng Ba Lan, hãy chờ đợi các đoạn ngắn hơn và test mẫu tin như nó thực sự hiển thị trên điện thoại. Khi phân tích mã đến, hãy dựa vào các chữ số và bỏ qua những từ xung quanh.

Các lý do phổ biến để test ở đây: một sản phẩm gia nhập thị trường Ba Lan, QA bản địa hóa cho các luồng tiếng Ba Lan, các đội khu vực quản lý tài khoản doanh nghiệp khắp Trung Âu, và ứng dụng có khách hàng nói tiếng Ba Lan sống ở nơi khác trong EU.

Xử lý sự cố: vì sao thiếu mã +48?

• Cửa sổ vẫn đang mở. Hãy cho nó đủ 20 phút trước khi kết luận điều gì; bạn chỉ bị tính phí nếu mã đến.
• Dịch vụ có thể từ chối số ảo. Một số nền tảng làm vậy, và khi đó khoản hoàn tiền tự động trả lại toàn bộ số tiền vào ví.
• Tuyến đang bận. Thử lại sau, hoặc test một tuyến dịch vụ khác.
• Bài test đang lặp. Đặt lại cứ vài giây một lần làm cạn ngân sách request của bạn; hãy thêm backoff.

Nhiều mô hình hơn được tập hợp trong giảm số lần gửi OTP thất bại.

Ba Lan có số chuyên dụng không, và thanh toán hoạt động ra sao?

Không phải dưới dạng sản phẩm tự phục vụ. Dedicated Virtual Numbers, từ $1.95/tháng, chỉ được cung cấp tại Hoa Kỳ và Canada. Với một đường dây Ba Lan dài hạn, hãy gửi email tới [email protected] để hỏi; quy định địa phương quyết định điều đó có khả thi không, nên không có lời hứa nào.

Thanh toán đi vào một ví USD trả trước duy nhất: không gói, không phí hằng tháng, nạp bằng thẻ hoặc USDT/USDC, và hóa đơn PDF gửi qua email cho mỗi lần nạp. Lập trình viên có thể yêu cầu chế độ sandbox cho tài khoản phát triển để nhận số và mã mô phỏng trong khi xây dựng tích hợp. Xem bảng giá để biết mức giá hiện tại.

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

Làm sao test luồng đăng ký Ba Lan nếu không ai trong đội có SIM +48?

Đặt một số +48 để test trên OTP Gateway và dùng nó trong luồng. Mã hiện trong dashboard và có thể được gửi tới webhook của bạn.

Mã quốc gia Ba Lan trong các lệnh gọi API OTP Route là gì?

Là pl, dùng cả trong POST /api/v1/activations lẫn trong truy vấn giá.

Số điện thoại Ba Lan có bao nhiêu chữ số?

Chín chữ số quốc gia sau +48, không có số 0 trunk. Độ dài cố định đó làm việc kiểm tra phía máy chủ đơn giản.

Nhận một OTP SMS Ba Lan tốn bao nhiêu?

Giá bắt đầu từ $0.20 mỗi mã và thay đổi theo dịch vụ. Dashboard và endpoint giá hiển thị con số chính xác trước khi bạn đặt.

Tôi có mất tiền nếu một lượt kích hoạt Ba Lan hết hạn mà không có gì không?

Không. Lượt kích hoạt kết thúc mà không có mã, hoặc bị bạn hủy, được hoàn lại đầy đủ vào ví.

Tôi có thể mô phỏng toàn bộ luồng Ba Lan trước khi chạy thật không?

Có. Hãy yêu cầu chế độ sandbox cho tài khoản phát triển để có số và mã mô phỏng mà không tốn tiền trong ví.

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.