This feature allows you to delay the conversion of a Pix deposit into DePix after the payment is completed.Instead of processing the deposit immediately, the system will wait for the defined period on your request (parameter delayDepixInHours) before executing the conversion.If your account is configured with a minimum QR delay, delayDepixInHours is required. A deposit request that omits it is rejected, and so is a value below that minimum — in both cases the error message states the minimum in hours. This applies to every deposit you create through this endpoint, including the ones you did not intend to delay.
Use Cases#
Fraud prevention / risk analysis window
Controlling MED (Mecanismo Especial de Devolução) exposure in merchant payments
How it works#
Create a deposit using the standard /api/deposit endpoint.
Include the delayDepixInHours parameter in your request.
The value represents the delay (in hours) before the Pix payment is converted into DePix.
It must be a whole number from 1 to 720 (30 days). A value outside that range is rejected, and the error message states the accepted range.
The Pix QR code is generated and can be paid normally by the end user.
After the payment is confirmed, the system will wait the specified time before processing the conversion.
The deposit will remain in the delayed status until processing (see Possible Statuses). The exact time the delay ends is returned in the delayUntil field, both by /api/deposit-status and in the deposit webhook. After the delay, the system converts the funds into DePix and completes the deposit: the status moves to approved, and then to depix_sent once the DePix has been sent.
Considerations#
The delay only affects the conversion to DePix, not the Pix payment itself.
Once the delay is configured, it cannot be changed after QR generation.
The deposit will only be finalized after the delay period has fully elapsed.
Ensure your application logic accounts for the delayed settlement state when querying /api/deposit-status.
Example#
Below is an example of creating a deposit with a delay of 48 hours for sending the DePix.{
"amountInCents": 100,
"delayDepixInHours": 48
}
