Crear transacción vía Pix
POST
Productos que lo utilizan:
Parámetros para la solicitud
HEADER
X-Idempotency-Key
Esta función permite repetir solicitudes de manera segura, sin el riesgo de realizar la misma acción más de una vez por error. Esto es útil para evitar errores, como la creación de dos transacciones idénticas, por ejempl...Ver másstring
REQUERIDO
x-Signature
Firma de la solicitud con el cuerpo cifrado en base 64 con las claves pública y privada del integrador. Es obligatorio sólo en el ambiente de producción.boolean
REQUERIDO
x-enforce-signature
Booleano para indicar si el integrador enviará o no la firma. Debe ser "false" en ambiente de pruebas y "true" en ambiente productivo, que es cuando es obligatorio enviar la firma.boolean
BODY
external_reference
Referencia para identificar la transacción. Es generada por el integrador y puede ser cualquier valor que permita hacer un seguimiento de las transacciones siempre que no tenga caracteres especiales (“”, [ ], (), @) y no...Ver másstring
point_of_interaction
Valor fijo. Siempre debe ser {"type":"PSP_TRANSFER"}object
REQUERIDO
seller_configuration
Objeto que contiene configuraciones del usuario que realiza la transacción. object
transaction
Objeto que contiene la información sobre la transacción.object
Parámetros de respuesta
created_date
Fecha de creación de la transacciónstring
external_reference
Referencia externa de la transacción, que fue generada por el integrador al momento de crearla.string
id
Identificador único de la transacción, generado automáticamente.string
last_updated_date
Fecha de última actualización del estado de la transacción.string
Errores
400Bad Request
424Failed Dependency
500Error interno del servidor.
502Bad Gateway
Solicitud
curl -X POST \
'https://api.mercadopago.com/v1/transaction-intents/process'\
-H 'Content-Type: application/json' \
-H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
-H 'x-Signature: true' \
-H 'x-enforce-signature: false' \
-H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
-d '{
"external_reference": "MP0001",
"point_of_interaction": {},
"seller_configuration": {
"notification_info": {
"notification_url": "http://example.com.br/notification"
}
},
"transaction": {
"from": {
"accounts": [
{
"amount": 100
}
]
},
"to": {
"accounts": [
{
"type": "current",
"amount": 100,
"chave": {
"type": "CPF",
"value": "1234567890"
},
"owner": {
"identification": {
"type": "CPF",
"number": "1234567890"
}
}
}
]
},
"total_amount": 100
}
}'Respuesta de ejemplo
{
"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": "100,00"
}
]
},
"paid_amount": 100,
"payer": {
"id": 123456543
},
"refunded_amount": 1,
"to": {
"accounts": [
{
"amount": "100,00",
"origin_id": "01AAAM001A1AY43FBR8WCM9CES",
"status_details": [
{}
],
"owner": {
"identification": {
"number": "1234567890",
"type": "CPF"
}
}
}
]
},
"total_amount": 100,
"statement_descriptor": "test"
}
}