Gera operações de saída de dinheiro desde uma conta do Mercado Pago a contas Pix, desde que a conta de retirada tenha fundos.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Requisição inválida. Os parâmetros enviados não são válidos.
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 chave
Valor inválido para o campo "transaction.to.accounts[0].chave.value". Verifique se o valor da chave Pix é correto.
Invalid chave type
Valor inválido para o campo "transaction.to.accounts[0].chave.type". Verifique se o tipo de chave Pix é correto.
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.
Invalid chave pix
A chave Pix é inválida. Verifique o valor digitado.
Chave not found
A chave Pix não foi encontrada. Verifique o valor digitado.
Unsupported chave
A chave Pix não está cadastrada no Bacen.
Chave has a different owner
O valor da chave Pix não corresponde às informações do proprietário
Account is disabled
A conta do Mercado Pago está desativada.
Participant is not available
O participante não está habilitado para o fluxo transacional.
Unrecognized key format
O formato da chave Pix é inválido. Confirme os valores possíveis.
Invalid identity source
O header "X-Identity-Source" suporta apenas "dict" ou "ted".
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.
invalid_signature
Erro na criptografia. Verifique se a secret foi gerada corretamente e está registrada com o Mercado Pago. Verifique também se o body que se está enviando é o que foi criptografado.
Idempotency key is required
O header "X-Idempotency-Key não foi enviado na requisição. Verifique a solicitação e assegure-se de incluir todas as propriedades requeridas conforme a documentação da API.
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.
Invalid Payload
Payload inválido.
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.
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.
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: 661ec1a7-bde2-4081-81b9-e5725510756d' \
-H 'X-signature: true' \
-H 'X-enforce-signature: false' \
-H 'X-test-token: false' \
-d '{
"external_reference": "MP0001",
"seller_configuration": {
"notification_info": {
"notification_url": "https://link-your-webhook-notification.com"
}
},
"transaction": {
"from": {
"accounts": [
{
"amount": 24.5
}
]
},
"to": {
"accounts": [
{
"type": "current",
"amount": 24.5,
"chave": {
"type": "CPF",
"value": "1234567890"
},
"owner": {
"identification": {
"type": "CPF",
"number": "1234567890"
}
}
}
]
},
"total_amount": 24.5
}
}'{
"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": "24.50",
"to": {
"accounts": [
{
"amount": "24.50",
"origin_id": "01AAAM001A1AY43FBR8WCM9CES",
"status_details": "approved",
"owner": {
"identification": {
"number": "1234567890",
"type": "CPF"
}
}
}
]
},
"total_amount": "50.00",
"statement_descriptor": "test"
}
}