Obtener lista de transacciones

Este endpoint permite obtener una lista con todas las transacciones hechas en un payout a partir de su ID. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

GET

https://api.mercadopago.com/v1/payouts/{payout_id}/transactions
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Path
payout_id
string

REQUERIDO

Identificador del payout por el que se desea consultar la transacción, devuelto en la respuesta a su creación dentro del campo "id".
Query
status
string
Filtrar transacciones por su estado operacional.
created: La transacción fue creada exitosamente.
pending: La transacción está pendiente y esperando procesamiento adicional.
in_process: La transacción está siendo procesada.
Ver más
limit
integer
Número máximo de transacciones a devolver en la lista. Límite de 100 transacciones.
offset
integer
Número de transacciones a ser omitidas de la lista.
Response parameters
paging
object
Objeto que contiene las informações de paginación de las transacciones.
transactions
array
Lista de transacciones hechas en el payout.
Errores

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.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/payouts/{payout_id}/transactions?status=created&limit=10'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
    
Response
{
  "paging": {
    "limit": 100,
    "offset": 2,
    "total": 1000
  },
  "transactions": [
    {
      "id": "67890",
      "created_date": "2024-01-15T10:30:00Z",
      "last_update_date": "2024-01-15T11:00:00Z",
      "external_reference": "MP0197",
      "status": "created",
      "status_detail": "accredited",
      "amount": {
        "currency": "ARS",
        "value": "24.50"
      },
      "description": "Payment to seller"
    }
  ]
}