Recursos para IA
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
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.
status
string
Filtrar transações por seu status operacional.
approved: Uma transação foi criada, mas ainda não foi processada. É um status intermediário.
created: A transação foi criada com sucesso.
error: Ocorreu um erro no processo da transação e não foi possível creditar o valor na conta de destino.
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.

invalid_payout_id

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

invalid_transaction_id

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

invalid_signature

Dados inválidos foram enviados no body da requisição. Verifique se a secret foi gerada corretamente e está registrada com o Mercado Pago. Verifique também se o body que está enviando é o que foi criptografado.

idempotency_key_required

Dados inválidos foram enviados no body da requisição. A chave de idempotência ("idempotency_key") está ausente. Tente enviar a solicitação novamente, validando todos os campos.

401Erro. Access Token não autorizado.

invalid_token

O Access Token enviado está incorreto. Revise o valor e tente enviar a requisição novamente com a informação correta.

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

forbidden

Sem permissão para acessar o recurso.

404Erro. Payout não encontrado.

not_found

Payout não encontrado. Verifique se o ID enviado está correto.

500Erro interno do servidor.

internal_server_error

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

502Erro de gateway. Falha na integração com um serviço externo.

bad_gateway

Ocorreu um erro na integração com um serviço externo. Tente enviar a requisição novamente.

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-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
    
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": "MP0197",
      "status": "created",
      "status_detail": "accredited",
      "type": "TRANSACTION",
      "amount": {
        "currency": "ARS",
        "value": "50.0"
      }
    }
  ]
}