Generate money out operations from a Mercado Pago account to other accounts (internal or external), as long as the withdrawal account has funds. In case of success, the request will return a response with status 200.
POST
REQUIRED
REQUIRED
REQUIRED
REQUIRED
400Bad request. The parameters sent are not valid.
Invalid external_reference
Invalid type for field "external_reference". Verify the available values for this field.
Invalid type point_of_interaction
Invalid value for field "point_of_interaction.type". Remember that it is a fix value, always {"type":"PSP_TRANSFER"}.
Invalid amount
Invalid value for field "transaction.from.accounts[0].amount". Verify the amounts allowed for the transaction.
Invalid identification number
Invalid value for field "transaction.to.accounts[0].identification.number". Verify the allowed values.
Invalid identification type
Invalid value for field "transaction.to.accounts[0].owner.identification.type". Verify the allowed values.
Account is disabled
The Mercado Pago account is disabled.
Participant is not available
Participant is not available to make this transaction.
Flow not specified
The header "X-Flow-id" only supports "transfer" or "management".
Compliance not processed
The conformity check was not completed for the user.
Key PSP error
Attempt to consult an external PSP key that is already registered in Mercado Pago.
Invalid Body
The request body has an invalid format.
invalid_signature
Error in encryption. Check if the secret was generated correctly and is registered with Mercado Pago. Also check if the body being sent is what was encrypted.
Idempotency key is required
The "X-Idempotency-Key" header was not sent in the request. Check the request and make sure to include all required properties as per the API documentation.
Client not allowed
The "client_id"associated with the credentials is not allowed to make the request.
Financial identity not found
Financial identity not found. Check the "to.accounts.bank_id" field.
Many Requests
Too many requests has been made. Wait and try again.
Rate Limit
The consultation service reached the rpm limit in order not to exceed the limit allowed by Banco Central and not receive fines.
Unauthorized
The request is unauthorized.
Invalid Payload
Invalid request payload.
401Error. Access Token not authorized.
invalid_token
The value sent as Access Token is incorrect. Please check and try again with the correct value.
403Forbidden. You don't have permissions to access this resource.
forbidden
No permission to access the resource.
424Failed dependency. A required upstream service or dependency did not respond as expected.
Resource locked
The rate limit service is processing the integrator's consumption of our API.
500Internal server error.
internal_server_error
An unexpected error occurred on the server. Try the request again.
502Bad gateway. Integration failure with an external service.
bad_gateway
An error occurred in the integration with an external service. Try the request again.
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: 43612640-6d36-4b88-9e5a-216feada014a' \
-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,
"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": "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"
}
},
"bank_id": "0000014",
"type": "current",
"number": "123456"
}
]
},
"total_amount": "50.00",
"statement_descriptor": "test"
}
}