This endpoint creates a new Instant Payment transaction.
You must provide a valid quotation ID and the operation nature.
When the transaction is created, the API returns a PIX QR Code, a copy-and-paste code, and a transaction ID.
QR Code Expiration Rules
Default Duration: 1800 seconds (30 minutes)
Minimum Allowed: 30 seconds
Maximum Allowed: 7200 seconds (2 hours)
After the expiration time, the transaction becomes invalid and can no longer be paid
Note: The transaction will automatically expire and become invalid after the specified TTL has elapsed.
Note2: Upon a successful response, the QR Code is available via the transaction.qrCodeUrl path, and the Pix copy/paste code is provided via transaction.dynamicPixCode. This data is also included in the transaction.pending webhook event notification
POST{{Environment_URL}}/vendors/v1/charges
Headers
Name
Value
Authorization
Bearer <token>
Body
Key
Description
Required
Data Type
Example
quotationId
Quotation ID obtained from Get Quotation or Get Quotation with Dynamic Fees
true
String
Quotation id obtained from quotation
d59bb3c086159465a0baef009281bbfca76b2214
Object that accepts configurable details per Transaction.
false
Object
{
"expire": 1800,
"document": "12345678901"
}
paymentMethodDetails.document
Payer document.
Optional; required if the transaction amount exceeds BRL 120.000,00
false
String
12345678901
paymentMethodDetails.expire
Time in seconds before the Transaction expires.
Minimum: 30 seconds
Default: 1800 seconds (30 minutes)
Maximum: 7200 seconds (2 hours)
This value defines the Time to Live (TTL) for the charge, with a default duration of 2 hours
false
Number
1800
metadata
A flexible field for attaching additional context or tracking information.
Common uses include Storing monitoring/analytics IDs
