Este endpoint permite consultar el estado y el resumen consolidado de un lote de transacciones ("payout") creado anteriormente en base a su ID, incluyendo cuántas transacciones se completaron con éxito, están pendientes o presentaron error. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
GET
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 GET \
'https://api.mercadopago.com/v1/payouts/{payout_id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
{
"id": "POP01KV681P6SJ38NQHWX3XK162SS",
"status": "completed",
"external_reference": "000197",
"config": {
"notification_url": "https://link-your-webhook-notification.com"
},
"summary": {
"pending": {
"items": 0
},
"canceled": {
"items": 0
},
"success": {
"items": 0
},
"error": {
"items": 2
}
}
}