Este endpoint permite crear un lote con múltiples transacciones de salida de dinero desde una cuenta de Mercado Pago a otras cuentas (internas o externas), siempre que la cuenta de retirada tenga fondos. Un payout puede contener hasta 1000 transacciones que se crean y procesan en una sola solicitud. En caso de éxito, la solicitud devolverá una respuesta con el estado 202.
POST
REQUERIDO
REQUERIDO
REQUERIDO
REQUERIDO
REQUERIDO
400Solicitud inválida. Los parámetros enviados no son válidos.
bad_request
Se enviaron datos inválidos en el body de la solicitud. Vuelve a intentar enviar la solicitud, validando todos los campos.
401No autorizado. Credenciales inválidas o faltantes.
unauthorized
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a realizar la solicitud enviando el valor correcto.
403Prohibido. No tiene permisos para acceder a este recurso.
forbidden
Sin permiso para acceder al recurso.
404No encontrado. El recurso solicitado no existe.
not_found
El recurso solicitado no fue encontrado o el valor enviado para identificarlo es inexistente. Valida la información enviada en los parámetros y vuelve a intentarlo.
500Error interno del servidor.
internal_server_error
Ocurrió un error inesperado en el servidor. Vuelve a intentar la solicitud.
curl -X POST \
'https://api.mercadopago.com/v1/payouts'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-H 'X-Idempotency-Key: 98e1ee3c-3cf0-473e-b1d1-65b162d8add9' \
-H 'X-signature: true' \
-H 'X-Enforce-Signature: undefined' \
-H 'X-Test-Token: false' \
-d '{
"external_reference": "MP0197",
"description": "Payout for seller commissions",
"schedule_date": "2025-12-25T10:00:00",
"config": {
"notification_url": "http://example.ar/notification"
},
"transactions": [
{
"external_reference": "MP0197",
"type": "account",
"account": {
"email": "test_user_ar@testuser.com",
"number": "0000003100025957669623",
"owner_type": "DNI",
"owner_value": "95871050",
"bank_name": "Mercado Pago",
"bank_id": "003",
"branch": "0001",
"holder": "María González",
"account_type": "account"
},
"amount": {
"currency": "ARS",
"value": 24.5
},
"description": "Payment to seller Beltrano"
}
]
}'{
"id": "123456",
"idempotency_key": "0d5020ed-1af6-469c-ae06-c3bec19954bb",
"created_date": "2024-01-15T10:30:00Z",
"status": "created",
"schedule_date": "2025-12-25T10:00:00",
"description": "Payout for seller commissions",
"config": {
"notification_url": "http://example.ar/notification"
}
}