Obter lista de transações

Este endpoint permite obter uma lista com todas as transações feitas em um payout a partir de seu ID. Em caso de sucesso, a requisição retornará uma resposta com o status 200.

GET

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

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
payout_id
string

OBRIGATÓRIO

Identificador do payout que deseja consultar a transação, retornado na resposta à sua criação dentro do campo "id".
Query
status
string
Filtrar transações por seu status operacional.
created: A transação foi criada com sucesso.
pending: A transação está pendente e aguardando processamento adicional.
in_process: A transação está em processamento.
Ver mais
limit
integer
Número máximo de transações a serem retornadas na lista. Limite de 100 transações.
offset
integer
Número de transações a serem omitidas da lista.
Response parameters
paging
object
Objeto que contém as informações de paginação das transações.
transactions
array
Lista de transações feitas no payout.
Erros

400Requisição inválida. Os parâmetros enviados não são válidos.

bad_request

Dados inválidos foram enviados no body da requisição. Tente enviar a solicitação novamente, validando todos os campos.

401Não autorizado. Credenciais inválidas ou ausentes.

unauthorized

O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.

403Proibido. Não tem permissões para acessar este recurso.

forbidden

Sem permissão para acessar o recurso.

404Não encontrado. O recurso solicitado não existe.

not_found

O recurso solicitado não foi encontrado ou o valor enviado para identificá-lo é inexistente. Valide as informações enviadas nos parâmetros e tente realizar a requisição novamente.

500Erro interno do servidor.

internal_server_error

Ocorreu um erro inesperado no servidor. Tente enviar a requisição novamente.

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-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
    
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": "000197",
      "status": "created",
      "status_detail": "accredited",
      "amount": {
        "currency": "MXN",
        "value": "24.50"
      },
      "description": "Payment to seller"
    }
  ]
}