Invoice Paid Time

Overview

Invoice paid time is the authoritative timestamp at which the payment system changed an invoice into its paid or accepted payment state. Its practical value comes from making the payment lifecycle deterministic for the payer, merchant, support team, and accounting system.

It is usually set after the observed transfer satisfies amount, asset, network, attribution, and confirmation requirements. The timestamp may therefore occur later than the transaction broadcast time or block inclusion time. In practice, the system should preserve the original request, the observed blockchain or checkout evidence, and every status change that affects this value. This makes support investigations and financial reconciliation possible without reconstructing the payment from screenshots or mutable client data.

The system should record the exact status transition, source event, transaction evidence, and time zone. Replayed webhooks must not create a different paid time, and later reversals or refunds should be represented as separate events. The implementation should use exact asset precision, authenticated server-side updates, and idempotent processing wherever repeated API calls, blockchain observations, or webhook deliveries can occur.

Paid time is not necessarily the time the payer clicked send, the time the transaction entered a block, or the time funds settled to the merchant’s preferred asset. It should be interpreted alongside Invoice Confirmation Threshold, Invoice Settlement Amount, Invoice Status Callback. These concepts belong to the same workflow, but each answers a different operational question and should not be collapsed into one ambiguous field.

A transaction broadcast at 10:00 and confirmed at 10:05 may produce an invoice paid time of 10:15 when the required confirmation threshold is reached. The practical test is whether a merchant can explain how the value was produced, verify it independently, and apply the same rule consistently when the payment is delayed, duplicated, partially paid, refunded, or reviewed manually.