Cancel a PIX QRCode


  • Only dynamic QR Codes that have not been paid or expired can be canceled, and once a QR Code is canceled, it cannot be reactivated for payment.

How to Cancel a PIX QRCode

Cancelling a dynamic PIX QR Code is straightforward with our Invalidate Dynamic QR Code API endpoint. Use the following cURL command to cancel a QR Code:

curl --request POST \
     --url{qrCodeId}/invalidate \
     --header 'accept: application/json' \
     --header 'authorization: Bearer {accessToken}'


  • {qrCodeId}: The ID of the PIX QR Code you wish to cancel.

Resulting Status:

  • On successful cancelation, the status of the PIX QR Code changes to INVALIDATED, indicating it's no longer valid for receiving payments.


To keep you informed about the cancelation process, a webhook event QR_CODE_INVALIDATED is sent out once the operation is processed.