Recursos para IA
Obter informações sobre uma transação

Este endpoint permite obter os detalhes de uma transação de um payout por meio do payout_id e do transaction_id retornados na criação do payout. Em caso de sucesso, a requisição retorna o status 200.

GET

https://api.mercadopago.com/v1/payouts/{payout_id}/transactions/{transaction_id}
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 contém a transação que deseja consultar, retornado no campo id da resposta a POST /v1/payouts.
transaction_id
string

OBRIGATÓRIO

Identificador da transação que deseja consultar, retornado no campo transactions[].id da resposta a POST /v1/payouts.
Response parameters
id
string
Identificador único da transação, gerado automaticamente.
created_date
string
Data de criação da transação.
last_update_date
string
Data de atualização do status da transação.
external_reference
string
Referência externa da transação, gerada pelo integrador na hora da criação.
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.

invalid_account

O objeto `account` foi enviado sem o e-mail obrigatório para identificar a conta Mercado Pago de destino. Informe o e-mail da conta destinatária em `email`.

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/{transaction_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
    
Response
{
  "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": "COP",
    "value": "50.0"
  }
}