Probar la integración
El proceso de prueba permite verificar si las configuraciones realizadas durante tu integración funcionan correctamente antes de recibir pagos reales. Con Wallet Connect, la prueba reproduce el flujo completo: la creación de la vinculación, la aprobación por parte del comprador, la generación del token de pago y el procesamiento de un pago utilizando Orders API.
Antes de iniciar, asegúrate de que los puntos a continuación estén configurados.
| Requisito previo | Descripción |
| Cuentas de prueba | Debes contar con dos cuentas de prueba diferentes, y ambas son obligatorias: una de vendedor, para configurar la aplicación y realizar los cobros, y una de comprador, para aprobar la vinculación y simular la compra. |
| Saldo en la cuenta del comprador | La cuenta de prueba del comprador necesita tener saldo suficiente, ya que el pago se debita directamente de la billetera. Define el monto al crear la cuenta de prueba. |
| Credenciales de prueba | El Access Token de prueba del vendedor es entregado por el equipo responsable de tu integración y también puede consultarse en la sección Credenciales. |
En esta etapa, validas si tu aplicación está apta para generar enlaces de autorización.
Para ello, envía una solicitud al endpoint /v2/wallet_connect/agreementsPOST, incluyendo el Access Token de pruebaClave privada utilizada en el backend para autenticar las solicitudes. En Wallet Connect, el Access Token y la Public Key de prueba y producción son proporcionados por el equipo responsable de crear tu aplicación. También puedes consultarlos en Tus integraciones > Datos de integración > Pruebas > Credenciales de prueba. El Access Token de prueba comienza con el prefijo `APP_USR`. de la cuenta de prueba del vendedor.
curlcurl -X POST \ 'https://api.mercadopago.com/v2/wallet_connect/agreements' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ -d '{ "return_uri": "https://www.mercadopago.com/", "external_flow_id": "test_flow_001", "external_user": { "id": "test_user_001", "description": "Usuario de prueba" }, "agreement_data": { "validation_amount": 10.00, "description": "Prueba de vinculación" } }'
Si la solicitud es exitosa, la respuesta devolverá el estado 201 con el identificador de la vinculación creada y la URI de autorización que se utilizará en la etapa siguiente.
json{ "agreement_id": "22abcd1235ed497f945f755fcaba3c6c", "agreement_uri": "{{wc_agreement_uri_example}}" }
En esta etapa, validas la experiencia de autorización desde el punto de vista del comprador.
Accede a la agreement_uri devuelta en la etapa anterior utilizando la cuenta de prueba del comprador y concluye el flujo de autorización. Al finalizar, serás redirigido a la return_uri informada en la creación, con el resultado de la operación en los query parameters.
Inicia sesión con el Usuario y la Contraseña disponibles en Tus integraciones > Tu aplicación > Pruebas > Cuentas de prueba. Si se solicita la verificación por correo electrónico, ingresa el Código de verificación disponible para esa cuenta en la misma página.
{return_uri}?agreement_id={agreement_id}&code={code}&flow=agreement&external_flow_id={external_flow_id}&code_type=validation_code
Guarda el valor del parámetro code, ya que se utilizará en la etapa siguiente para generar el token de pago.
code tiene validez limitada y puede utilizarse solo una vez. Si la ventana expira, será necesario crear una nueva vinculación de prueba y repetir la aprobación.En esta etapa, validas el intercambio del código de autorización por la credencial que permite ejecutar cobros.
Para ello, envía una solicitud al endpoint /v2/wallet_connect/agreements/{agreement_id}/payer_tokenPOST, informando el agreement_id obtenido en la primera etapa y el code obtenido en la aprobación.
curlcurl -X POST \ 'https://api.mercadopago.com/v2/wallet_connect/agreements/{{AGREEMENT_ID}}/payer_token' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ -d '{ "code": "{{AUTHORIZATION_CODE}}" }'
Si la solicitud es exitosa, la respuesta devolverá el estado 201 con el payer_token asociado a la vinculación de prueba.
json{ "payer_token": "abcdef1e23f4567d8e9123eb6591ff68df74c57930551ed980239f4538a7e530" }
En esta etapa, validas el cobro de punta a punta, debitando el monto de la billetera de la cuenta de prueba del comprador.
Para ello, envía una solicitud al endpoint /v1/ordersPOST, utilizando el payer_token obtenido en la etapa anterior.
curlcurl -X POST \ 'https://api.mercadopago.com/v1/orders' \ -H 'Content-Type: application/json' \ -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ -d '{ "type": "online", "external_reference": "test_order_001", "total_amount": "10.00", "description": "Pedido de prueba", "capture_mode": "automatic", "transactions": { "payments": [ { "amount": "10.00", "payment_method": { "type": "wallet", "id": "wallet", "token": "{{PAYER_TOKEN}}", "statement_descriptor": "Prueba" } } ] } }'
Si la solicitud es exitosa, la respuesta devolverá el estado 201 con la order procesada. Verifica si los campos status y status_detail devolvieron, respectivamente, processed y accredited, lo que confirma que el monto fue debitado de la billetera del comprador de prueba.
json{ "id": "ORDBTA01KJZ06DEJX3DMY26FAB44BXNN", "type": "online", "external_reference": "test_order_001", "total_amount": "10.00", "total_paid_amount": "10.00", "status": "processed", "status_detail": "accredited", "transactions": { "payments": [ { "id": "PAY01KJZ06DEJX3DMXXXXXXXXXXXX", "amount": "10.00", "paid_amount": "10.00", "status": "processed", "status_detail": "accredited" } ] } }
insufficient_amount, verifica si la cuenta de prueba del comprador posee saldo suficiente. Para los demás escenarios de error, consulta la sección Posibles errores.Después de validar el funcionamiento correcto de la integración en el entorno de prueba, sustituye las credenciales de prueba por las de producción y avanza para ir a producción.