Payment Token Decimals

Overview

What does Payment Token Decimals mean?

Payment Token Decimals is the token precision value used to convert between on-chain integer units and the human-readable amount shown for a payment.

How it works in practice

Token decimals specify how a token's smallest integer accounting unit is presented in user interfaces. A token using six decimals stores 1.5 units as 1,500,000 base units. Payment processing should calculate in integers or exact decimal types rather than binary floating-point, and retrieve verified decimal settings for the approved contract or mint. Rounding rules determine whether a conversion rounds up, down or to an agreed precision; the choice affects acceptance thresholds and ledgers.

Limits and common misunderstandings

Assuming every token uses 18 decimals can over- or understate transfers by orders of magnitude. Some contracts may be unusual or misleading, so decimals alone do not prove authenticity. Wallet display formatting must not silently truncate money owed.

Additional implementation considerations

Boundary tests catch high-impact unit bugs: zero amounts, maximum integer values, amounts with more digits than the token supports, and conversion from fiat prices at awkward exchange rates. Never round an underpayment upward merely for visual convenience; use the exact base units when deciding acceptance. If the quoted human amount cannot be represented precisely, explain the chosen rounding rule before generating the payment instruction.

Related glossary terms

Payment Token Contract; Payment Amount Precision; Payment Amount Rounding