⚠️ 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.
- If the QR code lacks a predefined amount, error
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.