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

Permite obter informações sobre uma transação de Payouts gerada anteriormente com base no seu "id". Ou seja, você poderá consultar informação sobre uma transação de saída de dinheiro, fornecendo o número de identificação que lhe foi atribuído na resposta à sua criação.

GET

https://api.mercadopago.com/v1/transaction-intents/{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
id
string

OBRIGATÓRIO

Identificador da transação que deseja consultar, retornado na resposta à sua criação dentro do campo "id".
Response parameters
created_date
string
Data de criação da transação.
external_reference
string
Referência externa da transação, gerada pelo integrador na hora da criação.
id
string
Identificador único da transação, gerado automaticamente.
last_updated_date
string
Data de atualização do status da transação.
Erros

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

ID format invalid

O formato do ID no path da requisição é inválido.

invalid_payout_id

O payout não foi encontrado. Verifique se o ID informado está correto.

invalid_transaction_id

A transação não foi encontrada. Verifique se o ID informado está correto.

Client not allowed

O client ID associado às credenciais não tem permissão para fazer a requisição.

Financial identity not found

A instituição financeira não foi localizada. Verifique o campo "to.accounts.bank_id"

Many Requests

Muitas requisições foram feitas. Espere e tente novamente.

Rate Limit

O serviço de consulta atingiu o limite de rpm para não ultrapassar o limite permitido pelo Bacen e não receber multas.

Unauthorized

A requisição não está autorizada.

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. Transação não encontrada.

not_found

Transação não encontrada. Verifique se o ID enviado está correto.

424Dependência com falha. Um serviço ou dependência necessário não respondeu conforme esperado.

Resource locked

O serviço de rate limit está processando o consumo de nossa API pelo integrador.

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/transaction-intents/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
    
Response
{
  "created_date": "2021-01-01T00:00:00.000Z",
  "external_reference": "123456",
  "id": "0d5020ed",
  "last_updated_date": "2021-01-01T00:00:00.000Z",
  "point_of_interaction": {
    "type": "{\"type\":\"PSP_TRANSFER\"}"
  },
  "seller_configuration": {
    "notification_info": {
      "notification_url": "https://link-your-webhook-notification.com"
    }
  },
  "status": "approved",
  "transaction": {
    "from": {
      "accounts": [
        {
          "amount": "24.50"
        }
      ]
    },
    "paid_amount": "50.00",
    "payer": {
      "id": 123456543
    },
    "refunded_amount": 1,
    "to": {
      "accounts": [
        {
          "amount": "24.50",
          "origin_id": "01AAAM001A1AY43FBR8WCM9CES",
          "status_details": "approved",
          "owner": {
            "identification": {
              "number": "1234567890",
              "type": "CPF"
            }
          },
          "bank_id": "0000014",
          "type": "current",
          "number": "123456"
        }
      ]
    },
    "total_amount": "50.00",
    "statement_descriptor": "test"
  }
}