Intelligent search powered by OpenAI
Create transaction via Pix
POST
Products that use it:
Request's parameters
HEADER
X-Idempotency-Key
This feature allows you to safely retry requests without the risk of accidentally performing the same action more than once. This is useful for avoiding errors, such as creating two identical transactions, for example. T...View morestring
REQUIRED
x-Signature
Request signature with the encrypted body in base 64 with the public and private keys of the integrator. It is required only in a productive environment.boolean
REQUIRED
x-enforce-signature
Boolean to indicate whether the integrator will or will not send the signature. It must be "false" for test environements, and "true" for production environments, when the signature is mandatory. boolean
BODY
external_reference
Reference to identify the transaction. It is generated by the integrator and it can be any value that allows transactions to be tracked as long as it does not have special characters (“”, [ ], (), @) and does not exceed ...View morestring
point_of_interaction
Fix value. It must always be {"type":"PSP_TRANSFER"}object
REQUIRED
seller_configuration
Object containing settings of the user performing the transaction.object
transaction
Object that contains information about the transaction.object
Response parameters
created_date
Transaction creation datestring
external_reference
Transaction external reference, generated by the integrator when it was created.string
id
Unique transaction identifier, automatically generated.string
last_updated_date
Transaction's status update date.string
Errors
400Bad Request
424Failed Dependency
500Internal server error.
502Bad Gateway
Request
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
}
}'Sample answer
{
"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"
}
}