Este endpoint permite crear un lote (payout) con una o varias transacciones de salida de dinero desde una cuenta Mercado Pago hacia uno o varios destinatarios. Las transacciones pueden ser transferencias entre cuentas Mercado Pago o hacia cuentas bancarias externas de tipo corriente. La cuenta de origen debe tener fondos suficientes. Un payout puede contener hasta 1000 transacciones, que se crean y envían para procesamiento en una sola solicitud. En caso de éxito, la solicitud devuelve el estado 202.
POST
REQUERIDO
REQUERIDO
REQUERIDO CONDICIONAL
REQUERIDO CONDICIONAL
boolean que indica si el integrador enviará o no la firma. Debe ser false en ambiente de pruebas y true en ambiente productivo, que es cuando es obligatorio enviar la firma.REQUERIDO
-), guiones bajos (_) y espacios; no uses puntuación.YYYY-MM-DDTHH:MM:SS), sin huso horario. El huso horario se infiere automáticamen400Solicitud inválida. Los parámetros enviados no son válidos.
invalid_payout_id
Se enviaron datos inválidos en el body de la solicitud. No se encontró el payout. Vuelve a intentar enviar la solicitud, validando todos los campos.
invalid_transaction_id
Se enviaron datos inválidos en el body de la solicitud. No se encontró la transacción. Vuelve a intentar enviar la solicitud, validando todos los campos.
invalid_signature
Se enviaron datos inválidos en el body de la solicitud. Verifica si la secret fue generada correctamente y está registrada con Mercado Pago. Verifica también si el body que estás enviando es el que fue cifrado.
idempotency_key_required
Se enviaron datos inválidos en el body de la solicitud. La clave de idempotencia (idempotency_key) está ausente. Vuelve a intentar enviar la solicitud, validando todos los campos.
invalid_account
El objeto `account` se envió sin los datos requeridos para identificar la cuenta de destino. Informa `email` para una cuenta Mercado Pago o los datos bancarios obligatorios de una cuenta externa, incluidos `number` y `bank_id`.
401Error. Access Token no autorizado.
invalid_token
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la solicitud enviando el valor correcto.
403Prohibido. No tiene permisos para acceder a este recurso.
forbidden
Sin permiso para acceder al recurso.
404Error. Payout no encontrado.
not_found
Payout no encontrado. Comprueba si enviaste el ID correcto.
500Error interno del servidor.
internal_server_error
Ocurrió un error inesperado en el servidor. Vuelve a intentar la solicitud.
502Error de gateway. Fallo en la integración con un servicio externo.
bad_gateway
Ocurrió un error en la integración con un servicio externo. 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: bc20cabc-d1ce-4449-ae53-9d6b19e49273' \
-H 'X-signature: true' \
-H 'X-enforce-signature: false' \
-H 'X-test-token: false' \
-d '{
"external_reference": "MP0197",
"description": "Payout for seller commissions",
"schedule_date": "2026-12-31T10:00:00",
"config": {
"notification_url": "https://link-your-webhook-notification.com"
},
"transactions": [
{
"external_reference": "MP0197",
"type": "account",
"account": {
"email": "test@testuser.com",
"number": "0000001234567876543210",
"owner_type": "DNI",
"owner_value": "12345678",
"bank_id": "015",
"branch": "0001",
"holder": "María González"
},
"amount": {
"currency": "ARS",
"value": 50
},
"description": "Payment to seller Beltrano"
}
]
}'{
"id": "POP01KKYN1QY2SS1MKAY4KP6SSRCT",
"external_reference": "MP0197",
"idempotency_key": "0d5020ed-1af6-469c-ae06-c3bec19954bb",
"created_date": "2024-01-15T10:30:00Z",
"status": "created",
"schedule_date": "2026-12-31T10:00:00",
"description": "Payout for seller commissions",
"config": {
"notification_url": "https://link-your-webhook-notification.com"
},
"transactions": [
{
"id": "TOP01KV681P6SJ38NQHWX3SF2WM22",
"amount": {
"currency": "ARS",
"value": "50.0"
},
"external_reference": "MP0197"
}
]
}