Skip to main content

Pay QRCode

Simulates the payment of a QRCode, in approval.

When the QRCode is paid, the notification message will be sent by registered webhook.

Attention

Not available in production

Making Request​

The call must be sent using the POST method

POST/v1/pix/qrcodes/{reference_id}/pay

Success​

In case of success, an HTTP 200 – OK message will be returned, as shown below:

HTTP 200 Response Body - Example
  {
    "message": "Operation succeeded"
  }

Notified Events​

  • The system will send notifications for all available transaction statuses.
  • This applies to Checkout, PixQrCode, and Card transactions.
  • Any status change (Creation, confirmation, cancellation, etc.) will result in a call to the webhook configured during the transaction's creation.
  • The notifications will follow the exact same data pattern already used by the existing webhook, ensuring compatibility and consistency in the integration.

For more details on the notification attributes, please refer to the Webhook Notification for qrcode documentation.

Errors​

In case of errors, a json will be returned with the error attribute specifying the reason for the operation being invalidated.

HTTP 406 Response Body - Example
  {
    "error": "Qrcode not found"
  }
HTTP 422 Response Body - Example
  {
    "error": "Qrcode canceled"
  }