Recursos para IA

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.

Si lo deseas, antes de probar tu integración puedes cifrar tus datos para realizar tus transacciones de prueba. Para saber cómo crear este cifrado, accede a Cifrado de seguridad. Recuerda que este cifrado solo es obligatorio para salir a producción con tu integración, es decir, para tus transacciones reales.

Para probar tu integración con Payouts, crea transacciones enviando un POST, con tu Access Token de pruebaClave privada de la aplicación creada en Mercado Pago y que se utiliza en el backend. Puedes acceder a ella a través de Tus integraciones > Datos de la integración > Pruebas > Credenciales 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"
        }
    ]
}'
Para conocer en detalle todos los parámetros enviados y retornados en esta solicitud, consulta nuestra Referencia de API. Además, si recibes un error al enviar el pago, consulta nuestra lista de errores para más información.

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"
   }
}
Ten en cuenta que esta respuesta puede tardar unos minutos y que, en caso de que su status sea pending, debes ejecutar la llamada para obtener lista de transacciones o obtener información sobre una transacción para verificar su actualización.

¡Listo! Una vez finalizado este paso, la integración estará completa y podrás salir a producción.