Thu mã xác minh SMS Panama bằng code, từng bước một

Tôi gọi những endpoint nào để lấy mã +507?

Mọi thứ nằm dưới https://otproute.com/api/v1 và xác thực bằng khóa Bearer bắt đầu bằng or_live_. Country id của Panama là pa. Một lượt chạy điển hình cho một ca test trông như sau:

1. GET /api/v1/prices?country=pa&service=whatsapp trả về mức giá hiện tại của cặp này, để runner của bạn dừng lại nếu vượt ngân sách bạn đặt.
2. POST /api/v1/activations với {"service": "whatsapp", "country": "pa"} giữ một số và trả về activation id.
3. Bài test nhập số vào màn hình đăng ký và kích hoạt SMS.
4. Mã đến với bạn qua sự kiện webhook hoặc qua GET /api/v1/activations/{id}.
5. POST /api/v1/activations/{id}/cancel kết thúc sớm một lượt chạy và hoàn tiền.

Hãy dùng GET /api/v1/balance trước một bộ test lớn để ví cạn tiền không hiện ra thành một loạt lỗi giả. Tổng quan dành cho lập trình viên và tài liệu tham chiếu API đầy đủ liệt kê chi tiết request và response.

Tôi nên dựa vào webhook hay polling cho các tuyến Panama?

Webhook là lựa chọn gọn gàng hơn cho tích hợp API OTP Panama. Đăng ký một endpoint (tối đa 5 cho mỗi tài khoản) và đăng ký nhận activation.sms_received, activation.expired và activation.cancelled. Mỗi request mang X-OTPRoute-Signature: t=<unix>,v1=<hex>; hãy dựng lại HMAC-SHA256 của "<t>.<raw body>" bằng secret của endpoint, so sánh theo thời gian hằng số và bỏ mọi thứ có timestamp cũ. Hãy xử lý dựa trên activation id để một lần gửi lại không bao giờ xử lý cùng một mã hai lần.

Polling phù hợp với script ngắn hoặc mạng không nhận được lệnh gọi vào. Hãy giãn các request ra; giới hạn tài khoản là 300 request mỗi phút dùng chung cho tối đa 10 khóa, và một vòng lặp dồn dập trên một lượt kích hoạt sẽ lãng phí ngân sách đó. Nhiều mô hình hơn có trong bài của chúng tôi về thu OTP dựa trên webhook.

Code của tôi nên biết gì về số điện thoại Panama?

Panama không có tiền tố trunk, nên các chữ số quốc gia đi sau +507 nguyên vẹn. Số di động có tám chữ số và bắt đầu bằng 6, trong khi số cố định có bảy chữ số, điều này quan trọng nếu bộ kiểm tra của bạn áp một độ dài duy nhất cho cả nước.

• Lưu số ở dạng E.164, ví dụ +5076 theo sau là bảy chữ số nữa với số di động.
• Chấp nhận dấu gạch ngang sau chữ số thứ tư khi nhập, vì đó là cách viết số di động phổ biến ở địa phương, rồi bỏ nó đi trước khi lưu.
• Từ chối giá trị bảy chữ số trong các luồng chỉ dùng SMS, vì gần như chắc chắn đó là số cố định không nhận được mã.

Tiếng Tây Ban Nha là ngôn ngữ chính thức, nên tin xác minh thường đến bằng tiếng Tây Ban Nha khi ứng dụng bản địa hóa theo khu vực hoặc ngôn ngữ tài khoản. Hãy kiểm tra rằng mẫu tin, số ký tự và mọi regex trích mã của chính bạn xử lý được các ký tự có dấu.

Vì sao các đội test hoặc vận hành ở Panama ngay từ đầu?

Kênh đào, ngành vận tải biển và logistics, cùng lĩnh vực dịch vụ quốc tế lớn khiến Panama thường là nơi đặt trụ sở khu vực cho Trung Mỹ và Caribe. Các đội sản phẩm ra mắt ứng dụng tiếng Tây Ban Nha trong khu vực thường bắt đầu QA bản địa hóa tại đây, còn các đội vận hành đặt ở nơi khác vẫn cần chứng minh rằng khách hàng có số +507 hoàn tất được onboarding.

Một số xác minh Panama từ OTP Gateway cho phép họ làm điều đó từ bất kỳ văn phòng nào. Khi một bài test không nhất thiết cần Panama, các tuyến lân cận như Costa Rica hoặc Colombia có thể là phép so sánh hữu ích về hành vi định tuyến theo quốc gia.

Dịch vụ nào có thể nhận mã trên tuyến Panama?

Ảnh chụp hôm nay liệt kê WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Uber, eBay, Airbnb và Netflix. Tổng cộng tuyến này hiện có hơn 1.000 dịch vụ. Nguồn số thay đổi trong ngày, vì vậy hãy luôn đọc GET /api/v1/services hoặc dashboard thay vì gắn cứng một danh sách.

Người không phải lập trình viên có cùng phạm vi này trong trình duyệt: đăng ký, nạp tiền, chọn dịch vụ và Panama, xác nhận giá hiển thị, sao chép số vào ứng dụng và chờ mã xuất hiện cạnh đơn hàng.

Tôi xử lý một số Panama không nhận được gì thế nào?

Cửa sổ 20 phút là tấm lưới an toàn của bạn: bạn chỉ bị tính tiền khi mã đến, và một lượt kích hoạt hết hạn hoặc bị hủy sẽ hoàn lại toàn bộ số tiền tự động. Khi một số vẫn im lặng:

• Hãy để nó chạy đến khi hết hạn thay vì hủy rồi đặt lại trong vài giây; các vòng lặp dày đặc trông đáng ngờ với dịch vụ gửi tin.
• Thử lại sau một khoảng nghỉ, hoặc thử một tuyến dịch vụ khác.
• Xác nhận dịch vụ chấp nhận số ảo; một số từ chối thẳng, và khoản hoàn tiền tồn tại cho trường hợp đó.
• Ghi log sự kiện activation.expired để các lượt chạy chập chờn hiện rõ thay vì lặng lẽ.

Các số này dành cho việc test và vận hành 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ụ gửi tin, và nhớ rằng Chính sách Sử dụng Chấp nhận được của OTP Route chi phối mỗi đơn hàng.

Còn số Panama dài hạn, thanh toán và test sandbox thì sao?

OTP Route không bán số Panama dài hạn tự phục vụ. Dedicated Numbers chỉ giới hạn ở Hoa Kỳ và Canada, từ $1.95/tháng; với một đường dây Panama, 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 gì không.

Thanh toán đi qua một ví USD trả trước, không có phí hằng tháng hay gói, nạp bằng thẻ hoặc USDT/USDC, với hóa đơn PDF gửi email cho mỗi lần nạp. Tài khoản phát triển có thể được chuyển sang sandbox theo yêu cầu, trả về số và mã mô phỏng để toàn bộ luồng được test mà không đụng đến tiền trong ví. Xem bảng giá để biết mức giá hiện tại.

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

Tôi có thể tự động hóa xác minh SMS Panama trong pipeline CI không?

Được. Tạo lượt kích hoạt với country pa qua REST API và lấy mã từ webhook có chữ ký hoặc bằng cách polling lượt kích hoạt.

Số di động Panama dài bao nhiêu?

Số di động có tám chữ số bắt đầu bằng 6, viết sau +507, và không có tiền tố trunk nào cần bỏ.

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

Từ $0.20 mỗi mã; endpoint giá của API trả về mức chính xác cho từng dịch vụ trước khi bạn đặt.

Ví của tôi có bị trừ tiền nếu mã không đến không?

Không. Nếu không có SMS trong cửa sổ 20 phút, hoặc sau khi hủy, số tiền được hoàn lại tự động.

Tin nhắn xác minh Panama có bằng tiếng Tây Ban Nha không?

Thường là có, nếu ứng dụng bản địa hóa theo khu vực hoặc ngôn ngữ tài khoản, vì vậy hãy chắc rằng logic phân tích của bạn xử lý được văn bản tiếng Tây Ban Nha.

Tôi có thể test luồng đăng ký Panama mà không cần SIM địa phương không?

Được. Một số +507 từ OTP Gateway nhận một mã mỗi lần, nên đội của bạn không bao giờ cần một chiếc điện thoại Panama.

Tôi có thể mua một số +507 cố định không?

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

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.