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
external_reference
string
Referência externa do payout, gerada pelo integrador no momento da criação.
config
object
Objeto contendo configurações do usuário que realiza a transação.
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-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
    
Response
{
  "external_reference": "000197",
  "config": {
    "notification_url": "https://link-your-webhook-notification.com"
  },
  "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"
      }
    }
  ]
}