Dashboard

Create QR Code Transaction

⚠️ Important: To use this endpoint, include the header X-Trace-Version with the value 2.

This API allows for creating QR code transactions, with special handling for transactions involving optional amounts.

When initiating a QR code transaction, you can optionally include an amount in your request. The handling of the transaction is influenced by whether an amount is specified and whether the QR code itself specifies an amount.

  • With amount Specified:

    • If the QR code does not specify an amount, the amount from the request is used.
    • If the QR code specifies an amount, it's validated against the request amount. A mismatch triggers an error INCONSISTENT_QRCODE_AMOUNT_VALUE.
  • Without amount Specified:

    • If the QR code lacks a predefined amount, error MISSING_QRCODE_AMOUNT is returned.
    • If the QR code specifies an amount, the transaction uses this amount.

Asynchronous Enrichment
In the response of this request, endToEnd, destination and amount (if not provided in the request) fields will be returned as null. These fields will be asynchronously populated at a later stage of the processing cycle. Additionally, due to the asynchronous nature of this processing, the transaction will initially be returned with REQUESTED status. Once the necessary data has been populated and the transaction has progressed, the status will be updated accordingly in subsequent stages.

Language
Credentials
OAuth2
URL
Click Try It! to start a request and see the response here!