Este endpoint permite crear un lote (payout) con una o varias transacciones de salida de dinero desde una cuenta Mercado Pago hacia una o varias cuentas Mercado Pago. 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 el correo electrónico requerido para identificar la cuenta Mercado Pago de destino. Informa el correo electrónico de la cuenta destinataria en `email`.
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-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-H 'X-Idempotency-Key: e66e76ce-5d92-4725-9ede-f1913c14ecc0' \
-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"
},
"amount": {
"currency": "COP",
"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": "COP",
"value": "50.0"
},
"external_reference": "MP0197"
}
]
}