Mã xác minh El Salvador (+503) cho đội QA và đội ra mắt

Mã dùng một lần hay đường dây dài hạn: bài test El Salvador cần loại nào?

Hãy bắt đầu từ hình dạng của bài test, vì nó quyết định sản phẩm.

• Một bước xác minh đơn lẻ (đăng ký, đổi số điện thoại, kiểm tra nâng cấp bảo mật) tương ứng với OTP Gateway. Bạn đặt một số +503 cho một dịch vụ, mã đến một lần, và số đó xong việc.
• Một tài khoản phải liên tục đăng nhập trong nhiều tuần cần một đường dây do bạn sở hữu. Số chuyên dụng (Dedicated Numbers) là sản phẩm của Hoa Kỳ/Canada, từ $1.95/tháng, mua tức thì từ bảng điều khiển với SMS đến, SMS đi và cuộc gọi trên trình duyệt.

Với El Salvador không có Dedicated Number tự phục vụ. Nếu nhóm bạn thật sự cần một đường dây El Salvador dài hạn, hãy email [email protected]; việc có sắp xếp được hay không phụ thuộc quy định địa phương và không được đảm bảo. Nhiều đội giải quyết trường hợp "đăng nhập lặp lại" bằng một đường dây Mỹ, khi dịch vụ đang kiểm thử chấp nhận. Với việc triển khai tại El Salvador, hãy cân nhắc cả hai hướng với các ghi chú trong số tạm thời so với số chuyên dụng.

Nên lưu và kiểm tra số +503 như thế nào?

El Salvador dùng kế hoạch đánh số khép kín 8 chữ số không có tiền tố nội hạt. Số mà người địa phương viết trên biểu mẫu chính là 8 chữ số theo sau +503 khi quốc tế, nên chuẩn hóa chủ yếu là bỏ dấu câu: người dân thường viết số di động thành hai khối bốn chữ số cách nhau bằng dấu gạch nối.

• Lưu dạng E.164, +503 theo sau là tám chữ số, trong một cột duy nhất.
• Số di động thường bắt đầu bằng 6 hoặc 7; số cố định thường bắt đầu bằng 2. Một bộ kiểm tra chỉ chấp nhận các chữ số đầu đó bắt được hầu hết lỗi gõ.
• Từ chối số 0 dư ở đầu. Người dùng quen với các kế hoạch đánh số khác ở Mỹ Latinh đôi khi thêm một số 0, và một số nền tảng SMS lặng lẽ bỏ tin nhắn.

Mẫu SMS của ứng dụng bạn cho thị trường này thường là tiếng Tây Ban Nha. Các ký tự như á, í hay ó nằm ngoài bảng chữ cái GSM cơ bản, nên một mẫu dùng chúng có thể chuyển sang mã hóa UCS-2 và làm mỗi đoạn ngắn lại. Hãy đặt mã gần đầu tin nhắn để nó sống sót nếu bị tách đoạn.

Vì sao các đội kiểm thử luồng đăng ký ở El Salvador?

Vài mô hình lặp đi lặp lại:

• Ra mắt ở Trung Mỹ. Một sản phẩm triển khai qua Guatemala, Honduras và El Salvador muốn kiểm tra bước điện thoại của từng nước trước khi quảng cáo lên sóng.
• Khách hàng kiều bào. Nhiều người El Salvador sống ở Hoa Kỳ và giữ số +503 để liên lạc với gia đình, nên các sản phẩm chuyển tiền, thanh toán và nhắn tin thấy số El Salvador ngay cả khi địa chỉ người dùng là ở Mỹ. Xem onboarding fintech cho luồng đó.
• QA bản địa hóa. Nội dung tiếng Tây Ban Nha, bộ chọn quốc gia và mặt nạ nhập số đều cần một mã El Salvador thật để xác nhận màn hình chạy từ đầu đến cuối.
• Định giá bằng đô la Mỹ. Đô la Mỹ là tiền tệ chính thức của El Salvador, nên thị trường này là nơi tiện để kiểm thử thanh toán và onboarding cùng nhau.

Chuỗi gọi API OTP El Salvador trông như thế nào?

Mọi yêu cầu đi tới https://otproute.com/api/v1 với khóa Bearer có tiền tố or_live_, tạo trong Developer console (tối đa 10 khóa, 300 yêu cầu mỗi phút). Id quốc gia của El Salvador là sv.

1. Lấy GET /api/v1/countries và GET /api/v1/services và lưu bộ nhớ đệm các id.
2. Đọc giá hiện tại bằng GET /api/v1/prices?country=sv&service=<id>; nó cũng cho biết một tuyến có khả dụng ngay lúc này không.
3. Tạo đơn bằng POST /api/v1/activations với phần thân như {"service": "telegram", "country": "sv"}. Lưu id kích hoạt và số.
4. Cho bản dựng El Salvador của ứng dụng gửi SMS xác minh tới số đó.
5. Chờ sự kiện activation.sms_received tại endpoint của bạn; nếu không có, thăm dò GET /api/v1/activations/{id} vài giây một lần.
6. Nếu luồng bị bỏ dở, gọi POST /api/v1/activations/{id}/cancel để tiền quay về ngay.

Mỗi webhook mang X-OTPRoute-Signature: t=<unix>,v1=<hex>, là HMAC-SHA256 của dấu thời gian, một dấu chấm và phần thân thô bằng bí mật endpoint của bạn. Hãy xác minh nó và bỏ các dấu thời gian cũ; bảo mật webhook OTP đi qua từng bước. Người không phải lập trình viên có thể làm điều tương tự từ bảng điều khiển: chọn El Salvador, chọn dịch vụ, xác nhận giá hiện tại, và xem mã xuất hiện trên thẻ kích hoạt.

Có thể xác minh những dịch vụ nào trên số El Salvador?

Bản chụp trực tiếp cho thấy hơn 900 dịch vụ có tuyến El Salvador. Những dịch vụ phổ biến gồm WhatsApp, Facebook, Instagram, TikTok, Uber, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Telegram, Signal, LinkedIn và ChatGPT (OpenAI). Tình trạng khả dụng thay đổi trong ngày, đó là lý do endpoint giá, chứ không phải một danh sách cố định, nên điều khiển bộ chạy test của bạn.

Một số dịch vụ từ chối những số mà họ phân loại là số ảo. Điều đó nằm ngoài tầm kiểm soát của chúng tôi, và là lý do quy tắc hoàn tiền tồn tại.

Nếu mã El Salvador không bao giờ về thì sao?

Một mã +503 chậm chưa phải đã thất bại, nên hãy để đơn mở đủ 20 phút. Nếu không có gì tới, đơn hết hạn, activation.expired được kích hoạt và toàn bộ số tiền quay về ví của bạn tự động. Sau đó:

• xác nhận dịch vụ có chấp nhận số ảo cho loại bước này không;
• thử lại sau, hoặc chọn tuyến dịch vụ khác, thay vì đặt lại liên tục trong vòng lặp ngắn;
• kiểm tra xem ứng dụng của bạn có thật sự gửi SMS tới đúng số được trả về, ở dạng E.164 hay không.

Thêm các cách xử lý sự cố thân thiện với Trung Mỹ nằm trong giảm tỷ lệ gửi OTP thất bại.

Thanh toán cho các đơn El Salvador được xử lý ra sao?

OTP Route dùng một ví USD trả trước, trả theo mức dùng, không phí hằng tháng và không phải chọn gói. Nạp tiền bằng thẻ hoặc stablecoin USDT/USDC, và hóa đơn PDF về hộp thư của bạn sau mỗi lần nạp hoặc mua số. Với công việc tích hợ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ộ vòng lặp chạy mà không tiêu tiền trong ví. Mức giá hiện hành nằm trên trang giá.

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

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

Được. Đặt một số +503 từ OTP Gateway cho dịch vụ bạn đang kiểm thử, kích hoạt SMS, và đọc mã trong bảng điều khiển hoặc qua API.

Số điện thoại El Salvador có tiền tố nội hạt như 0 không?

Không. Số El Salvador gồm tám chữ số và không có tiền tố nội hạt, nên dạng quốc tế đơn giản là +503 cộng tám chữ số đó.

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

Dùng sv trong các truy vấn giá và trong phần thân kích hoạt, ví dụ GET /api/v1/prices?country=sv&service=<id>.

Tôi có bị tính phí nếu số +503 không nhận được mã nào không?

Không. Nếu không có SMS nào về trong cửa sổ 20 phút, hoặc bạn hủy trước, toàn bộ số tiền được hoàn về ví của bạn tự động.

Tôi có giữ được một số El Salvador để đăng nhập lặp lại không?

Không theo dạng sản phẩm tự phục vụ. Số Dedicated lâu dài được cung cấp ở Hoa Kỳ và Canada; với El Salvador, bạn có thể email [email protected] để hỏi, và không có cam kết về khả năng đáp ứng.

OTP Route có dành cho việc tạo nhiều tài khoản không?

Không. Nó dành cho việc kiểm thử và vận hành sản phẩm cùng tài khoản hợp pháp của chính bạn, trong phạm vi đ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 OTP Route.

Tôi có thể chạy luồng El Salvador trong CI mà không tốn tiền không?

Được. 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 để pipeline của bạn chạy trọn đường API.

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.