Brick API Documentation
Dynamic QR Code

QR Code Testing in Sandbox

Use this sandbox-only endpoint to simulate QR Code status changes during integration testing.

The endpoint lets you move a sandbox QR Code transaction into a target status so your team can verify callback handling, reconciliation, and user-facing payment status updates without real payment activity.

Before You Test

  1. Generate a QR Code transaction in Sandbox.
  2. Store the referenceId from your original request.
  3. Call this endpoint with the target status you want to simulate.
  4. Confirm that your callback endpoint receives and processes the update correctly.

Important Notes

  • This endpoint is only for Sandbox testing.
  • Do not use it as part of a production payment flow.
  • Your callback handler should process simulated callbacks with the same validation and idempotency rules used for production callbacks.

Request Parameters

Key ParametersData TypeDescription
publicAccessTokenStringOne time access-token generated using the auth token API
referenceIdStringUnique reference of Transactions from client side
statusStringStatus of QR Code, the value options are processing, paid, expired, completed.

Response Parameters

Key parametersData typeDescription
dataStringProviding information about whether the status has successfully changed or not.
Last modified on