Este endpoint permite crear un lote con una o 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
400Solicitud 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.
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 requisición 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*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-H 'X-Idempotency-Key: 620a96fb-62a2-4298-995f-f40a442369c4' \
-H 'X-signature: true' \
-H 'X-enforce-signature: false' \
-H 'X-test-token: false' \
-d '{
"external_reference": "000197",
"description": "Payout for seller commissions",
"schedule_date": "2026-12-31T10:00:00",
"config": {
"notification_url": "https://link-your-webhook-notification.com"
},
"transactions": [
{
"external_reference": "000197",
"type": "account",
"account": {
"email": "test_user_mx@testuser.com",
"number": "0000003100025957669623",
"owner_type": "CURP",
"owner_value": "95871050",
"bank_id": "003",
"branch": "0001",
"holder": "Miguel Hernández"
},
"amount": {
"currency": "MXN",
"value": 50
},
"description": "Payment to seller Beltrano"
}
]
}'{
"id": "POP01KKYN1QY2SS1MKAY4KP6SSRCT",
"external_reference": "000197",
"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"
}
}