Genera operaciones de salida de dinero desde una cuenta de Mercado Pago a cuentas Pix, siempre que la cuenta de retiro tenga fondos.
POST
REQUERIDO
REQUERIDO
REQUERIDO
REQUERIDO
400Solicitud inválida. Los parámetros enviados no son válidos.
Invalid external_reference
Valor inválido para el campo "external_reference". Verifica los valores permitidos para este campo.
Invalid type point_of_interaction
Valor inválido para el campo "point_of_interaction.type". Recuerda que es un valor fijo y siempre debe ser {"type":"PSP_TRANSFER"}.
Invalid amount
Valor inválido para el campo "transaction.from.accounts[0].amount". Verifica los montos permitidos para la transacción.
Invalid chave
Valor inválido para el campo "transaction.to.accounts[0].chave.value". Verifica que el valor de la clave Pix sea correcto.
Invalid chave type
Valor inválido para el campo "transaction.to.accounts[0].chave.type". Verifica que el tipo de clave Pix sea correcto.
Invalid identification number
Valor inválido para el campo "transaction.to.accounts[0].identification.number". Verifica los valores permitidos.
Invalid identification type
Valor inválido para el campo "transaction.to.accounts[0].owner.identification.type". Verifica los valores permitidos
Invalid chave pix
La clave Pix es inválida. Verifica el valor ingresado.
Chave not found
La clave Pix no fue hallada. Verifica el valor ingresado.
Unsupported chave
La clave Pix no está registrada en el Bacen.
Chave has a different owner
El valor de la clave Pix no coincide con la información del propietario
Account is disabled
La cuenta de Mercado Pago está desactivada.
Participant is not available
El participante no está habilitado para realizar esta transacción.
Unrecognized key format
El formato de la clave Pix es inválido. Confirma los valores posibles.
Invalid identity source
El header "X-Identity-Source" acepta solo "dict" o "ted".
Flow not specified
El header "X-Flow-id" acepta solo "transfer" o "management".
Compliance not processed
La verificación de conformidad no fue concluída para el usuario.
Key PSP error
Intento de consultar una clave PSP externa que ya está registrada en Mercado Pago.
Invalid Body
El cuerpo de la llamada tiene un formato inválido.
invalid_signature
Error en la encriptación. Verifica si el secret fue generado correctamente y está registrado con Mercado Pago. Verifica también si el body que se está enviando es el que fue encriptado.
Idempotency key is required
El header "X-Idempotency-Key" no fue enviado en la solicitud. Verifica la solicitud y asegúrate de incluir todas las propiedades requeridas según la documentación de la API.
Client not allowed
El "client_id" asociado con las credenciales no tiene permitido realizar la llamada.
Financial identity not found
La institución financiera no fue encontrada. Revisa el campo "to.accounts.bank_id".
Many Requests
Se realizaron demasiadas llamadas. Espera y vuelve a intentarlo.
Rate Limit
El servicio de consulta alcanzó el límite de rpm para no exceder el límite permitido por el Bacen y no recibir multas.
Unauthorized
La llamada no está autorizada.
Invalid Payload
Payload inválido.
401Error. Access Token no autorizado.
invalid_token
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la requisición enviando el valor correcto.
403Prohibido. No tiene permisos para acceder a este recurso.
forbidden
Sin permiso para acceder al recurso.
424Dependencia fallida. Un servicio o dependencia requerida no respondió como se esperaba.
Resource locked
El servicio de rate limit está procesando el consumo que el integrador hace de nuestra API.
500Error interno del servidor.
internal_server_error
Ocurrió un error inesperado en el servidor. Vuelve a intentar la solicitud.
502Error de gateway. Fallo en la integración con un servicio externo.
bad_gateway
Ocurrió un error en la integración con un servicio externo. Vuelve a intentar la solicitud.
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: a2675a98-a675-47d5-a7f2-9092eab97889' \
-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"
}
}