Đưa mã xác minh Argentina (+54) vào hệ thống tích hợp của bạn

Bốn lệnh gọi API đứng sau một kích hoạt +54 là gì?

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_. Khóa được cấp trong Developer console; một tài khoản có thể giữ tối đa 10 khóa và đăng ký 5 endpoint webhook, với mức trần 300 yêu cầu mỗi phút.

1. Báo giá. Gọi GET /api/v1/prices?country=ar&service=<id> để mã của bạn biết chi phí trực tiếp trước khi dùng tiền trong ví. Id quốc gia của Argentina là ar.
2. Đặt số. Gửi POST /api/v1/activations với nội dung JSON {"service": "whatsapp", "country": "ar"}, thay bằng id dịch vụ mà bài kiểm thử của bạn cần. Phản hồi chứa id kích hoạt và số +54 để nhập vào ứng dụng đang kiểm thử.
3. Chờ mã. Hoặc đọc GET /api/v1/activations/{id} theo một khoảng thời gian hợp lý, hoặc để webhook activation.sms_received báo cho bạn biết mã đã về.
4. Giải phóng sớm nếu cần. POST /api/v1/activations/{id}/cancel kết thúc một kích hoạt bạn không còn muốn và trả tiền về ví.

Nếu muốn xem các id trước khi viết cứng, GET /api/v1/services và GET /api/v1/countries liệt kê những gì nền tảng đang cung cấp. Tài liệu tham chiếu đầy đủ nằm trong tài liệu.

Làm sao để trình nhận webhook đáng tin cậy với mã Argentina?

Mỗi lần gửi đều có header X-OTPRoute-Signature dạng t=<unix>,v1=<hex>. Hãy dựng lại chuỗi "<t>.<raw body>", tính HMAC-SHA256 trên nó bằng secret của endpoint đó, và so sánh kết quả với v1 bằng hàm thời gian hằng định. Bỏ mọi yêu cầu có dấu thời gian đã cũ, vì một chữ ký cũ nhưng hợp lệ chính là dáng vẻ của một cuộc phát lại.

Ngoài activation.sms_received, hãy đăng ký activation.expired và activation.cancelled để trình chạy kiểm thử không bao giờ bị treo chờ một số đã đóng. Xử lý mọi sự kiện theo id kích hoạt và viết trình xử lý sao cho lần gửi thứ hai của cùng một sự kiện không thay đổi gì. Bài viết về ký và xác minh webhook OTP trình bày logic so sánh sâu hơn.

Tôi có thể xác minh những ứng dụng nào bằng số Argentina?

Ảnh chụp trực tiếp của Argentina liệt kê hơn 2.000 dịch vụ. Những dịch vụ mà các nhóm sản phẩm và QA Argentina thường dùng gồm:

• Nhắn tin: WhatsApp, Telegram, Signal, Discord
• Tài khoản và năng suất: Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI)
• Mạng xã hội và video: Instagram, TikTok
• Thương mại và di chuyển: Amazon, Uber, Airbnb, Netflix

Danh sách này thay đổi trong ngày, vì vậy API báo cáo tình trạng còn hàng trực tiếp thay vì một bảng tĩnh. Hãy truy vấn GET /api/v1/services với quốc gia ar trước khi một tác vụ CI theo lịch bắt đầu, và thất bại nhanh với thông báo rõ ràng nếu dịch vụ đích tạm thời không có.

Vì sao số di động Argentina làm hỏng bước kiểm tra số điện thoại?

Argentina có một trong những kế hoạch đánh số khác thường nhất trong khu vực. Trong nước, người ta viết tiền tố trung kế 0 trước mã vùng và, với di động, thêm 15 trước các chữ số thuê bao, nên một số di động ở Buenos Aires có thể xuất hiện là 011 15 theo sau là tám chữ số. Ở dạng E.164 quốc tế, cả hai đều biến mất và một số 9 được chèn ngay sau mã quốc gia: +54 9 11 rồi đến số thuê bao tám chữ số.

Sự khác biệt đó quan trọng với bất kỳ ai lưu số điện thoại. Hãy chuẩn hóa mọi thứ về E.164 trước khi lưu, bỏ số 0 và 15 khi nhập, và thêm số 9 cho số di động. Một trình xác thực chỉ kiểm tra độ dài sẽ vui vẻ chấp nhận giá trị kiểu điện thoại bàn +54 11 không thể nhận SMS. Hãy dùng số đúng như API trả về thay vì tự định dạng lại.

Mã gửi tới số Argentina thường đến bằng tiếng Tây Ban Nha, thường kèm cụm như "Tu código es" quanh các chữ số. Hãy phân tích mã bằng một mẫu thay vì khớp lời văn, vì mẫu tin nhắn thay đổi. Các nhóm kiểm thử ở đây khi ra mắt tại Mỹ Latinh, kiểm tra nội dung tiếng Tây Ban Nha vùng Río de la Plata (các dạng vos địa phương khác với tiếng Tây Ban Nha trong sách giáo khoa), chạy vận hành khu vực, hoặc phục vụ người Argentina sống ở nước ngoài vẫn đăng ký bằng SIM +54.

Người không biết lập trình có đặt được số +54 không?

Có. Nhân viên hỗ trợ, tăng trưởng và agency có thể làm toàn bộ từ trình duyệt:

1. Tạo tài khoản tại trang đăng ký bằng email và mã 6 chữ số, hoặc bằng đăng nhập Google.
2. Nạp tiền vào ví.
3. Mở OTP Gateway, chọn Argentina, rồi chọn dịch vụ bạn đang kiểm thử.
4. Kiểm tra giá hiển thị, xác nhận, và sao chép số +54 vào màn hình xác minh của ứng dụng.
5. Theo dõi kích hoạt; mã sẽ xuất hiện ở đó ngay khi nhận được.

Dashboard và API dùng chung một ví và cùng các kích hoạt, nên một lập trình viên có thể tiếp nhận số mà đồng nghiệp đã đặt thông qua id kích hoạt của nó.

Mã Argentina không xuất hiện. Làm gì tiếp?

Mỗi kích hoạt mở trong 20 phút. Nếu không có gì đến, hoặc bạn hủy trước, toàn bộ số tiền tự động trở lại ví, nên một tuyến im lặng chỉ tốn thời gian của bạn chứ không tốn tiền. Tốc độ gửi phụ thuộc vào dịch vụ và tuyến, vì vậy hãy cho cửa sổ một cơ hội công bằng trước khi kết luận nó đã thất bại.

Sau đó hãy xem qua danh sách ngắn này:

• Yêu cầu gửi lại mã từ bên trong ứng dụng một lần, rồi để cửa sổ chạy hết.
• Thử vào lúc khác trong ngày, hoặc đặt qua một tuyến khác cho cùng dịch vụ.
• Xác nhận dịch vụ có chấp nhận số ảo hay không; một số từ chối, và đó là lý do hoàn tiền tự động tồn tại.
• Tránh đặt lại liên tục trong vòng lặp dày từ CI. Thêm back-off và giới hạn số lần thử.

Bài viết về giảm số lần gửi OTP thất bại trình bày thêm các mẫu cho tuyến Argentina. Hãy giữ mọi bài kiểm thử trong điều khoản của từng dịch vụ; Chính sách Sử dụng Chấp nhận được của OTP Route cũng được áp dụng.

Chúng tôi có thể giữ một đường dây Argentina không, và thanh toán thế nào?

Hiện không có số dùng lâu dài tự phục vụ cho Argentina. Nếu nhóm bạn cần một đường dây +54 bền vững, hãy gửi email tới [email protected] và mô tả trường hợp sử dụng; việc có thể sắp xếp hay không còn tùy quy định địa phương và không được đảm bảo. Số ảo chuyên dụng, được giữ trong khi còn gia hạn và chuyển tiếp SMS đến vào webhook của bạn, là sản phẩm dành cho Hoa Kỳ và Canada từ $1.95/tháng.

Thanh toán chạy qua một ví USD trả trước, 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 USDT/USDC, và mỗi lần nạp tạo một hóa đơn PDF qua email. Chi tiết nằm ở trang bảng giá. Trước khi dùng tiền thật, hãy yêu cầu chuyển tài khoản phát triển của bạn sang sandbox, trả về số và mã mô phỏng để bạn diễn tập toàn bộ luồng Argentina từ đầu đến cuối.

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

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

Đó là ar. Hãy truyền nó trong trường country của POST /api/v1/activations và trong chuỗi truy vấn của GET /api/v1/prices.

Tôi có cần thêm số 9 khi nhập số +54 vào ứng dụng không?

Hãy dùng số đúng như OTP Route trả về. Trong cơ sở dữ liệu của bạn, hãy lưu số di động Argentina theo dạng E.164, gồm số 9 sau +54 và bỏ số 0 và 15 dùng trong nước.

Nhận một SMS OTP Argentina có giá bao nhiêu?

Từ $0.20 mỗi mã, thay đổi theo dịch vụ. Con số chính xác được GET /api/v1/prices trả về và hiển thị trước khi bạn xác nhận đơn.

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

Có. Hãy đặt một kích hoạt Argentina cho ứng dụng của bạn hoặc cho dịch vụ bên thứ ba trong bài kiểm thử, nhập số +54, và đọc mã trong dashboard hoặc từ webhook của bạn.

Cùng một số +54 có dùng lại được cho lần đăng nhập tháng sau không?

Không. Một số của gateway chỉ phục vụ một mã trong 20 phút. Với các tài khoản phải tiếp tục nhận mã, Số chuyên dụng tại Hoa Kỳ hoặc Canada là lựa chọn phù hợp.

Tin nhắn xác minh Argentina sẽ bằng ngôn ngữ nào?

Thường là tiếng Tây Ban Nha, tuy phụ thuộc vào đơn vị gửi và cài đặt ngôn ngữ của tài khoản. Hãy trích xuất các chữ số thay vì dựa vào các từ xung quanh.

Có thể thăm dò thay cho webhook không?

Có. Hãy thăm dò GET /api/v1/activations/{id} ở khoảng thời gian vừa phải và giữ thấp hơn nhiều so với giới hạn 300 yêu cầu mỗi phút cho mỗi tài khoả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.