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/payouts/{id}/transactionsAPI para que la solicitud se realice en un entorno de pruebas.

Transferencias entre cuentas Mercado Pago:

curl
curl --location 'https://api.mercadopago.com/v1/payouts' \
--header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \
--header 'Content-Type: application/json' \
--header 'X-Enforce-Signature: false' \
--header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
--header 'X-Test-Token: true' \
--data-raw '{
    "external_reference": "global_111",
    "config": {
        "notification_url": "https://your-webhook-endpoint.com/notifications"
    },
    "description": "description_root",
    "schedule_date": "2026-11-13T15:00:00",
    "transactions": [
        {
            "type": "account",
            "description": "description_transaction",
            "account": {
                "email": "test_user_7016385811392037126@testuser.com"
            },
            "amount": {
                "currency": "ARS",
                "value": 1
            },
            "external_reference": "test_mp-mp"
        }
    ]
}'

Transferencias para otros bancos a partir del Mercado Pago:

curl
curl --location 'https://api.mercadopago.com/v1/payouts' \
--header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \
--header 'Content-Type: application/json' \
--header 'X-Enforce-Signature: false' \
--header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
--header 'X-Test-Token: true' \
--data '{
    "external_reference": "global_111",
    "config": {
        "notification_url": "https://your-webhook-endpoint.com/notifications"
    },
    "description": "description_root",
    "schedule_date": "2026-11-13T15:00:00",
    "transactions": [
        {
            "description": "description_transaction",
            "type": "account",
            "account": {
                "holder": "Test payout",
                "number": "646016230131277849",
                "bank_id": "646"
            },
            "amount": {
                "currency": "ARS",
                "value": 10
            },
            "external_reference": "12344"
        }
    ]
}'

Para saber cómo enviar los campos restantes para ejecutar esta solicitud, consulta Configuración de la integración.

¡Listo! Una vez finalizados estos pasos, la integración estará completa y podrás salir a producción.

Configurar notificaciones

Configura la recepción de notificaciones de Mercado Pago para mantener actualizadas las transferencias en tu sistema.

Salir a producción

Conoce las recomendaciones para llevar tu integración con Payouts a producción de manera eficaz y segura.