Đưa mã SMS Mercado Pago vào lượt kiểm thử của bạn

Các đội đang giải quyết vấn đề gì ở bước điện thoại của Mercado Pago?

Mercado Pago, nền tảng thanh toán và ví điện tử của Mercado Libre, là một phần của thương mại hằng ngày khắp châu Mỹ Latinh. Như hầu hết các ứng dụng tài chính, nó gắn tài khoản với một số điện thoại: mã SMS xác nhận số khi đăng ký, và ứng dụng có thể yêu cầu mã mới khi ai đó đăng nhập trên thiết bị lạ hoặc khôi phục quyền truy cập. Với các đội xây dựng quanh nó, như người bán tích hợp thanh toán, đại lý vận hành tài khoản người bán của khách hàng, hay kỹ sư QA kiểm thử một sàn có cung cấp Mercado Pago lúc thanh toán, bước SMS đó thường là phần khó chịu. Nhân viên cuối cùng phải gắn số điện thoại cá nhân vào tài khoản doanh nghiệp, hoặc một ca kiểm thử bị đình trệ vì người duy nhất giữ SIM phù hợp đang ngoại tuyến.

OTP Route biến bước đó thành thứ công cụ của bạn xử lý được: một số theo yêu cầu cho thị trường bạn cần, với mã được chuyển tới hệ thống của bạn. Đó là cốt lõi của việc xác minh SMS Mercado Pago để kiểm thử.

Luồng API mã xác minh Mercado Pago hoạt động ra sao?

Mọi yêu cầu gọi tới https://otproute.com/api/v1 với khóa Bearer (tiền tố or_live_) từ Developer console. Mã dịch vụ là mercado_pago; mã quốc gia là giá trị api_country cho thị trường của bạn, ví dụ br cho Brazil hoặc mx cho Mexico.

1. GET /api/v1/prices?country=br&service=mercado_pago trả về giá hiện hành và tình trạng sẵn có cho cặp này.
2. POST /api/v1/activations với {"service": "mercado_pago", "country": "br"} trả về activation id và số.
3. Nhập số vào bước điện thoại của tài khoản bạn đang thiết lập hoặc kiểm thử.
4. Lấy mã khi activation.sms_received tới endpoint của bạn, hoặc bằng cách thăm dò GET /api/v1/activations/{id}.
5. Nếu lượt chạy kết thúc sớm, gọi POST /api/v1/activations/{id}/cancel.

Dùng GET /api/v1/balance làm bước kiểm tra trước. Mỗi tài khoản có 10 khóa, 5 endpoint webhook và 300 yêu cầu mỗi phút; mọi chi tiết khác nằm trong tài liệu.

Trình xử lý webhook nên đối xử với mã Mercado Pago thế nào?

Giao theo kiểu đẩy giúp trình chạy kiểm thử không phải quay vòng thăm dò. Mỗi sự kiện đi kèm X-OTPRoute-Signature: t=<unix>,v1=<hex>; hãy tính HMAC-SHA256 của <t>.<raw body> bằng secret của endpoint, so sánh trong thời gian không đổi và loại các yêu cầu có dấu thời gian cũ. Sau đó làm cho trình xử lý có tính idempotent: lưu activation id và bỏ qua lần gửi thứ hai của cùng sự kiện, vì việc thử lại vẫn xảy ra. Hãy lắng nghe cả activation.expired và activation.cancelled, để trình chạy có thể nhả chỗ của mình và đánh dấu bài kiểm thử để thử lại. Nếu bạn không muốn tự dựng endpoint, thăm dò lượt kích hoạt vài giây một lần vẫn nằm gọn trong giới hạn tốc độ. Bảo mật webhook OTP có danh sách kiểm tra đầy đủ hơn.

Số Mercado Pago nên đến từ quốc gia nào?

Dịch vụ mercado_pago được liệt kê tại 201 quốc gia trên OTP Route, nhưng lựa chọn hữu ích hầu như luôn là thị trường mà tài khoản thuộc về. Mercado Pago nổi tiếng nhất ở Brazil, Argentina, Mexico, Chile, Colombia, Uruguay và Peru, nên đó là nơi hầu hết ca kiểm thử diễn ra. Danh mục còn bao gồm Ecuador, Bolivia, Paraguay, Costa Rica, Panama, Cộng hòa Dominica, Tây Ban Nha, Bồ Đào Nha và Hoa Kỳ, cùng nhiều nơi khác.

Một số thuộc sai quốc gia có thể không qua được bước kiểm tra hoặc kéo theo các bước xác minh bổ sung, và nó không cho bạn biết gì về trải nghiệm thực của người dùng ở thị trường đó. Hãy khớp với ca kiểm thử: luồng đăng ký ở Brazil dùng số Brazil, ở Chile dùng số Chile.

Tôi có thể làm gì từ dashboard thay thế?

Người không viết code vẫn đạt cùng kết quả. Mở OTP Gateway, chọn Mercado Pago làm dịch vụ, chọn quốc gia và kiểm tra giá hiển thị trước khi đặt. Sao chép số vào ứng dụng, yêu cầu SMS, và mã sẽ hiện trên thẻ kích hoạt ngay khi được gửi tới. Số được giữ trong 20 phút; nếu không có gì về, bạn không bị tính phí, vì số tiền được tự động trả về ví.

Vì sao mã Mercado Pago có thể không về?

Các nền tảng thanh toán rất cẩn trọng với số điện thoại, và một số ảo cho Mercado Pago có thể bị từ chối ở một số hoặc mọi luồng. Các tuyến cũng thay đổi trong ngày. Nếu mã không xuất hiện:

• Để hết khung thời gian 20 phút; việc hoàn tiền là tự động.
• Tránh đặt lại số theo vòng lặp dày. Giãn cách các lần thử hoặc quay lại sau.
• Thử tuyến khác cho cùng thị trường nếu một tuyến cứ hết hạn.
• Kiểm tra trường điện thoại đã nhận số đúng định dạng mà ứng dụng mong đợi chưa.

Khi một luồng liên tục từ chối số ảo, hãy chấp nhận kết quả đó và dùng đường dây thật cho tài khoản này. Giảm thiểu việc gửi OTP thất bại bàn về cách chẩn đoán rộng hơn.

Khi nào số chuyên dụng hợp lý hơn?

Một số dùng một lần chỉ xử lý một mã. Một tài khoản doanh nghiệp sẽ cần mã mới sau nhiều tháng thì cần một số mà bạn vẫn kiểm soát. Số chuyên dụng (Dedicated Numbers) của OTP Route đảm nhiệm vai trò đó ở Hoa Kỳ và Canada, từ $1.95/month: SMS đến trong dashboard và trên webhook của bạn (number.sms_received), SMS đi và gọi điện từ trình duyệt, gia hạn từ ví cho đến khi bạn trả lại đường dây. Ngoài hai quốc gia này không có đường dây dài hạn tự phục vụ; hãy gửi email tới [email protected] để hỏi, tùy thuộc vào quy định địa phương. Xem số ảo để biết thêm chi tiết.

Những quy tắc nào áp dụng khi dùng các số này với Mercado Pago?

Mercado Pago xử lý tiền thật, và các bước kiểm tra danh tính của nó tồn tại có lý do chính đáng. Một số điện thoại từ OTP Route không thay thế các bước kiểm tra đó và tuyệt đối không được dùng để lách chúng: hãy hoàn tất xác minh danh tính bằng thông tin thật, giữ mỗi người thật hoặc doanh nghiệp một tài khoản, và tuân thủ điều khoản của Mercado Pago cùng Chính sách Sử dụng Chấp nhận được của OTP Route. Nền tảng này dành cho việc kiểm thử sản phẩm của chính bạn và vận hành các tài khoản hợp pháp, không phải để mở tài khoản hàng loạt hay nhận khuyến mãi. Thanh toán theo kiểu dùng bao nhiêu trả bấy nhiêu từ ví USD trả trước (thẻ hoặc USDT/USDC, kèm hóa đơn PDF cho mỗi lần nạp), và có thể yêu cầu sandbox với mã mô phỏng để kiểm thử tích hợp. Mercado Pago là nhãn hiệu của chủ sở hữu, và OTP Route không liên kết với họ.

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

Tôi có thể nhận OTP Mercado Pago mà không cần SIM địa phương ở Brazil hoặc Mexico không?

Có, khi bạn kiểm thử hoặc vận hành tài khoản của chính mình. Hãy đặt số mercado_pago cho đúng quốc gia và đọc mã từ dashboard, API hoặc webhook.

Mã dịch vụ của Mercado Pago trong API là gì?

Là mercado_pago. Kết hợp nó với mã quốc gia trong phần body của POST /api/v1/activations.

Mercado Pago có chấp nhận số ảo không?

Không phải lúc nào cũng vậy. Nó có thể từ chối ở một số luồng, vì thế toàn bộ số tiền được hoàn lại khi không có mã nào về trong 20 phút.

Số điện thoại để xác minh Mercado Pago giá bao nhiêu?

Từ $0.20 mỗi mã. Giá chính xác tùy theo quốc gia và được API cũng như dashboard hiển thị trước khi bạn đặt số.

Tôi có thể dùng cùng số dùng một lần để đăng nhập lại vào tháng sau không?

Không. Số dùng một lần chỉ nhận một mã. Các tài khoản cần đăng nhập lặp lại phù hợp hơn với số chuyên dụng ở Hoa Kỳ hoặc Canada.

Pipeline CI của tôi có thể chạy luồng Mercado Pago mà không bị tính phí thật không?

Có. Hãy yêu cầu chế độ sandbox cho tài khoản phát triển; nó trả về số và mã mô phỏng qua cùng các endpoint.

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.