Probar la integración
Antes de salir a producción, recomendamos probar el correcto funcionamiento de tu integración y del procesamiento de las transacciones. Esto te permitirá verificar si la integración se realizó correctamente y si las transacciones se están procesando sin errores. A continuación se detalla cómo realizar la prueba de integración.
Para probar tu integración con Payouts, crea transacciones enviando un POST, con tu Access Token de prueba y el header X-test-token:true al endpoint /v1/payoutsAPI para que la solicitud se realice en un entorno de pruebas.
curl
curl --location 'https://api.mercadopago.com/v1/payouts' \ --header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \ --header 'X-enforce-signature: false' \ --header 'X-test-token: true' \ --header 'X-signature: true' \ --data-raw '{ "external_reference": "000197", "config": { "notification_url": "https://link-your-webhook-notification.com" }, "description": "Payout for seller commissions", "schedule_date": "2026-12-31T14:30:00", "transactions": [ { "type": "account", "description": "Payment to seller Beltrano", "account": { "email": "test_user_mx@testuser.com" }, "amount": { "currency": "MXN", "value": 1 }, "external_reference": "000197" } ] }'
Si la ejecución fue exitosa, recibirás como respuesta un status code 202, indicando que la transacción fue aceptada, como en el siguiente ejemplo.
json
{ "id": "POP01KM145R903TZ06BWK6204DGG1", "external_reference": "000197", "description": "Payout for seller commissions", "idempotency_key": "1773859430", "created_date": "2026-03-18T14:43:50-04:00", "status": "created", "schedule_date": "2026-12-31T14:30:00", "config": { "notification_url": "https://link-your-webhook-notification.com" } }
¡Listo! Una vez finalizado este paso, la integración estará completa y podrás salir a producción.
