Mã xác minh Paraguay (+595), ưu tiên API

Làm sao yêu cầu một số +595 bằng code?

Bắt đầu trong Developer console và tạo một khóa Bearer; khóa bắt đầu bằng or_live_ và bạn có thể giữ tối đa 10 khóa, giúp dễ dàng dùng các khóa riêng cho staging và CI. Mọi lệnh gọi đều đi tới https://otproute.com/api/v1.

1. Lưu đệm danh mục từ GET /api/v1/services và GET /api/v1/countries. Paraguay xuất hiện là py.
2. Trước mỗi đơn, đọc GET /api/v1/prices?country=py&service=<id>. Giá và tình trạng khả dụng là giá trị trực tiếp, không phải hằng số.
3. Đặt đơn bằng POST /api/v1/activations với {"service": "whatsapp", "country": "py"}. Giữ lại activation id từ phản hồi.
4. Nhập số vào luồng bạn đang test.
5. Chờ webhook hoặc kiểm tra GET /api/v1/activations/{id}; gọi POST /api/v1/activations/{id}/cancel nếu bài test dừng sớm.

GET /api/v1/balance hữu ích làm bước kiểm tra trước trong pipeline, để job báo lỗi rõ ràng khi ví trống thay vì chờ đến khi hết thời gian. Hướng dẫn tích hợp đi qua cùng các lệnh gọi với nhiều bối cảnh hơn.

Handler webhook nên làm gì với một mã Paraguay?

Endpoint của bạn nhận activation.sms_received khi tin nhắn đến, activation.expired khi cửa sổ đóng mà không có gì, và activation.cancelled sau một lần hủy. Mỗi sự kiện gắn với activation id.

• Xác minh trước. Tách X-OTPRoute-Signature thành t và v1, tính HMAC-SHA256 của timestamp, một dấu chấm và raw body của request bằng secret của endpoint, rồi so sánh theo thời gian hằng số.
• Từ chối request cũ. Timestamp lệch nhiều so với đồng hồ của bạn nghĩa là bị phát lại hoặc máy chủ bị lệch giờ nghiêm trọng.
• Giữ tính idempotent. Lưu activation id và bỏ qua các lần lặp, để một lần gửi lại không bao giờ xử lý mã hai lần.

Mỗi tài khoản cho phép tối đa 5 endpoint webhook. Nếu bạn thích polling, hãy giữ khoảng cách vừa phải; giới hạn là 300 request mỗi phút trên toàn tài khoản. Hướng dẫn webhook HMAC có danh sách kiểm tra đầy đủ hơn.

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

Paraguay hiện có hơn 1.600 dịch vụ. Trong số được yêu cầu nhiều nhất có WhatsApp, Instagram, Telegram, Uber, Facebook, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, X (Twitter), Discord, LinkedIn, Netflix và ChatGPT (OpenAI). WhatsApp là ứng dụng nhắn tin hằng ngày của nhiều người trong khu vực, nên nó thường là dịch vụ đầu tiên các đội xác minh khi test hỗ trợ khách hàng qua chat.

Số di động +595 được viết và chuẩn hóa ra sao?

Paraguay dùng tiền tố trunk 0 cho quay số trong nước, nên số di động thấy ở địa phương bắt đầu bằng 09. Ở dạng E.164 số 0 đó biến mất: dạng chuẩn là +595 theo sau là chín chữ số, với số di động bắt đầu bằng 9. Hãy chuẩn hóa khi nhập, chỉ lưu dạng E.164 và định dạng để hiển thị ở lớp ngoài cùng. Các quy tắc kiểm tra đòi độ dài cố định của một quốc gia khác là nguyên nhân phổ biến khiến người dùng Paraguay đăng ký thất bại, vì vậy hãy đưa một số +595 vào các ca test kiểm tra của bạn.

Tiếng Tây Ban Nha và tiếng Guaraní đều là ngôn ngữ chính thức. Tin xác minh từ các dịch vụ quốc tế thường đến bằng tiếng Tây Ban Nha hoặc tiếng Anh tùy mẫu tin và cài đặt tài khoản. Hãy phân tích mã bằng mẫu chỉ gồm chữ số và giữ nội dung tin nhắn ở UTF-8 để các ký tự có dấu và ñ không bị mất trong log.

Vì sao các đội xác minh tài khoản ở Paraguay?

Paraguay là thành viên Mercosur và nằm giữa Argentina, Brazil và Bolivia, vì vậy các công ty đã hoạt động trong khu vực thường thêm nó vào kế hoạch triển khai Nam Mỹ. Các lý do test điển hình ở đó gồm QA bản địa hóa tiếng Tây Ban Nha cho đối tượng Paraguay, xác nhận luồng onboarding khu vực chấp nhận số +595, đội vận hành xác minh hồ sơ doanh nghiệp cho khách hàng địa phương, và hỗ trợ người Paraguay ở nước ngoài đăng ký bằng số trong nước. Trang xác minh ứng dụng di động mô tả cách những kiểm tra này khớp vào quá trình test phát hành.

Có cách nào không cần code để lấy số xác minh Paraguay không?

Có. Trong dashboard, mở OTP Gateway, chọn Paraguay và một dịch vụ, xem lại giá rồi xác nhận. Sao chép số vào ứng dụng, sau đó để lượt kích hoạt mở cho đến khi mã xuất hiện cạnh nó. Đơn từ trình duyệt và đơn từ API dùng chung ví và lịch sử.

Điều gì giúp được khi mã +595 không xuất hiện?

Hãy cho lượt kích hoạt đủ cửa sổ 20 phút trước khi kết luận. Nếu nó đóng mà không có gì, khoản phí tự động được hoàn lại. Sau đó rà soát các nguyên nhân thường gặp: dịch vụ có thể từ chối số ảo, tuyến có thể nghẽn vào giờ đó, hoặc một tuyến dịch vụ khác có thể thành công sau. Đừng bắn liên tục các đơn trong vòng lặp dày đặc; hãy thêm backoff giữa các lần thử và ghi lại các activation id để nhận ra quy luật theo từng dịch vụ.

Tôi có thể giữ số Paraguay lâu dài không, và thanh toán được xử lý thế nào?

Đường dây dài hạn không được bán tự phục vụ cho Paraguay. Dedicated Virtual Numbers chỉ có ở Hoa Kỳ và Canada, từ $1.95/tháng, nên một tài khoản phải đăng nhập lại về sau thường được gắn vào một trong các số đó. Để hỏi về đường dây dài hạn Paraguay, hãy gửi email tới [email protected]; câu trả lời phụ thuộc vào quy định địa phương.

Thanh toán dùng một ví USD trả trước: nạp bằng thẻ hoặc USDT/USDC, nhận hóa đơn PDF qua email, và chỉ trả cho những mã thực sự đến. Tài khoản phát triển có thể được chuyển sang sandbox theo yêu cầu để dùng số và mã mô phỏng. OTP Route dành cho việc test và vận hành sản phẩm hợp pháp của chính bạn; hãy 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âu hỏi thường gặp

Country id của Paraguay trong API OTP Route là gì?

Là py. Hãy dùng nó trong truy vấn giá và trong body của POST /api/v1/activations.

Tôi có lưu số Paraguay với đầu số 09 không?

Không. Bỏ số 0 nội địa và lưu +595 theo sau là số quốc gia chín chữ số.

Một số +595 để test giá bao nhiêu?

Một lượt kích hoạt Paraguay có giá từ $0.20 mỗi mã tùy dịch vụ, và ví chỉ bị trừ cho mã thực sự đến.

Tôi có thể test luồng đăng ký tiếng Tây Ban Nha cho Paraguay mà không cần SIM địa phương không?

Được. Đặt một số xác minh Paraguay trên OTP Gateway và đọc mã trong dashboard hoặc qua API.

Mã có đến bằng tiếng Guaraní không?

Hiếm khi, nếu có. Các dịch vụ quốc tế thường gửi văn bản tiếng Tây Ban Nha hoặc tiếng Anh, vì vậy chỉ cần phân tích các chữ số.

Tiền của tôi ra sao nếu lượt kích hoạt hết hạn?

Khi không có SMS nào đến trong cửa sổ 20 phút, toàn bộ số tiền tự động quay lại ví của bạ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.