Phanith NY
← EMV QR Reader guides

How to read a payment QR amount and currency

By Phanith NY ·

In an EMV merchant-presented QR payload, root field 53 holds the numeric transaction currency and root field 54 holds the amount if the QR includes one. Read them together. When field 54 is absent, the payload leaves the amount unspecified.

How to read a payment QR amount and currency | EMV QR Reader guide

Find the two fields at the top level

EMV QR payloads express fields as an ID, a length and a value. Read complete fields in sequence at the top level. Searching the raw text for 53 or 54 can also find those digits inside a different value.

For example, the fragment 5303840 breaks into ID 53, length 03 and value 840. The value 840 is the numeric currency code for USD.

Read the amount alongside the currency

In the same fictional example, 540512.50 breaks into ID 54, length 05 and value 12.50. Together the two fields describe a transaction amount of USD 12.50. The fragments show two fields from a payload and are insufficient to form a complete code.

If the currency appears and the amount field is absent, record the currency and the fact that the amount was omitted. In the merchant-presented specification an absent amount lets the mobile payment app prompt the customer for it. The record of the decoded payload should still show that field 54 was absent.

Inspect a supported code in EMV QR Reader

Scan a supported code or open a saved QR image in EMV QR Reader. Check the displayed currency. Open the raw content when you need to confirm which values appeared in the original code.

When writing a test report, record the field ID, raw value and what the parser displayed. Any resulting payment confirmation comes from the payment application.

If the displayed amount and the raw value differ, include both in the report. Keeping the payload value separate from the app display makes a parser issue easier to reproduce.

Questions

Does an omitted amount mean zero?

No. An omitted field means the amount was unspecified in this QR payload.

Does field 54 tell me which currency applies?

Read field 53 in the same root payload for the currency. Field 54 gives the amount only.

Sources

Download EMV QR Reader