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
OBRIGATÓRIO
OBRIGATÓRIO
id da resposta a POST /v1/payouts.object que contém as informações de paginação das transações.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.
invalid_account
O objeto `account` foi enviado sem os dados obrigatórios para identificar a conta de destino. Informe `email` para uma conta Mercado Pago ou os dados bancários obrigatórios de uma conta externa, incluindo `number` e `bank_id`. Para uma transferência via Pix, defina `transactions.type` como `pix` e envie os dados da chave em `transactions.pix` em vez de `account`.
invalid_account_type
O campo account_type foi enviado com um valor não suportado. Os valores aceitos são checking_account ou savings.
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.
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-8*********88776-122*********fc20dede6*********a497d7225*********64' \
{
"external_reference": "MP0197",
"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": "MP0197",
"status": "created",
"status_detail": "accredited",
"type": "TRANSACTION",
"amount": {
"currency": "BRL",
"value": "50.0"
}
}
]
}