Invoice Received Amount

Overview

How it works and why it matters

The received amount measures how much payment value has actually been observed for a specific invoice under its supported asset, network and attribution rules. It may be stored in token base units and converted to the invoice currency under a defined pricing policy. This number should not automatically equal the amount requested, confirmed, settled or available after fees. Multiple transfers, underpayments, overpayments and late arrivals must be handled explicitly.

Technical context

It is derived from independently observed transactions after applying asset precision and attribution rules.

It differs from requested amount, which is what the invoice asks for, and from settlement amount, which is what the merchant ultimately receives after conversion or fees.

If an invoice requests 100 USDT and two attributed transfers of 60 and 40 USDT are accepted, the received amount becomes 100 USDT.

Practical checks

Decide whether the metric includes detected but unconfirmed transfers or only confirmed valid contributions. Show the distinction clearly if both are available. Account for network fee paid by the sender versus deductions at the destination; a token balance change and a commercial invoice credit may not be numerically identical.

Related concepts

Invoice Requested Amount; Invoice Settlement Amount