Recursos para IA
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
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.
status
string
Filtrar transacciones por su estado operacional.
approved: Se creó una transacción, pero aún no se ha procesado. Es un estado intermedio.
created: La transacción fue creada exitosamente.
error: Ocurrió un error en el proceso de la transacción y no se logró acreditar el valor en la cuenta de destino.
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.
Errors

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.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/payouts/{payout_id}/transactions?limit=10&status=created'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
    
Response
{
  "paging": {
    "limit": 100,
    "offset": 2,
    "total": 1000
  },
  "transactions": [
    {
      "id": "TOP01KKYN1QY2SS1MKAY4G9DV5NK9",
      "created_date": "2024-01-15T10:30:00Z",
      "last_update_date": "2024-01-15T11:00:00Z",
      "external_reference": "000197",
      "status": "created",
      "status_detail": "accredited",
      "type": "TRANSACTION",
      "amount": {
        "currency": "MXN",
        "value": "50.0"
      }
    }
  ]
}