Gera operações de saída de dinheiro desde uma conta do Mercado Pago a outras contas (internas ou externas), desde que a conta de retirada tenha fundos. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Bad Request
Invalid external_reference
Valor inválido para o campo "external_reference". Verifique os valores permitidos para esse campo.
Invalid type point_of_interaction
Valor inválido para o campo "point_of_interaction.type". Lembre-se que é um um valor fixo, sempre {"type":"PSP_TRANSFER"}.
Invalid amount
Valor inválido para o campo "transaction.from.accounts[0].amount". Verifique os valores permitidos para a transação.
Invalid identification number
Valor inválido para o campo "transaction.to.accounts[0].identification.number". Verifique os valores permitidos.
Invalid identification type
Valor inválido para o campo "transaction.to.accounts[0].owner.identification.type". Verifique os valores permitidos.
Account is disabled
A conta do Mercado Pago está desativada
Participant is not available
O participante não está habilitado para o fluxo transacional.
Flow not specified
O header X-Flow-id suporta apenas "transfer" ou "management"
Compliance not processed
A verificação de conformidade não foi concluída para o usuário.
Key PSP error
Tentativa de consultar uma chave PSP externa que já está cadastrada no MercadoPago
Invalid Body
O body da requisição tem um formato inválido
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 Banco Central e não receber multas.
Unauthorized
A requisição não está autorizada.
Invalid Payload
Payload inválido.
424Failed Dependency
Resource locked
O serviço de rate limit está processando o consumo de nossa API pelo integrador.
500Erro interno do servidor.
internal_server_error
Houve um erro na comunicação com transaction_intent
502Bad Gateway
bad_gateway
Erro de processamento na requisição
curl -X POST \
'https://api.mercadopago.com/v1/transaction-intents/process'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
-H 'X-Idempotency-Key: 82c10c49-9043-451b-bf35-6d5f763859ce' \
-H 'X-signature: true' \
-H 'X-Enforce-Signature: false' \
-H 'X-Test-Token: false' \
-d '{
"external_reference": "MP0001",
"seller_configuration": {
"notification_info": {
"notification_url": "http://example.com.br/notification"
}
},
"transaction": {
"from": {
"accounts": [
{
"amount": 24.5
}
]
},
"to": {
"accounts": [
{
"type": "current",
"amount": 24.5,
"bank_id": "99999004",
"branch": "0001",
"holder": "João Silva",
"provider_id": "spi",
"currency_id": "BRL",
"number": "10266732",
"owner": {
"identification": {
"type": "CPF",
"number": "1234567890"
}
}
}
]
},
"total_amount": 50
}
}'{
"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": "http://example.com.br/notification"
}
},
"status": "approved",
"transaction": {
"from": {
"accounts": [
{
"amount": "24.50"
}
]
},
"paid_amount": "50.00",
"payer": {
"id": 123456543
},
"refunded_amount": "24.50",
"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"
}
}