Multi-Transaction Payment

Overview

A multi-transaction payment is an invoice payment satisfied by two or more blockchain transactions rather than one transfer. A robust implementation treats the concept as structured payment data rather than as a label shown only on the checkout page.

It can occur when a payer sends partial amounts, retries after a failed or replaced transaction, pays from several wallets, or deliberately splits a large obligation. The system aggregates only transactions validly attributed to the invoice. 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.

Matching must prevent duplicate counting, define confirmation requirements per transaction, handle mixed timing and late transfers, calculate the remaining amount consistently, and determine what happens when the aggregate exceeds the invoice total. 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.

It differs from a payment with several attempts when only one attempt is ultimately credited; in a multi-transaction payment, multiple accepted transactions contribute value. It should be interpreted alongside Invoice Payment Attempt, Invoice Received Amount, Invoice Remaining Amount. These concepts belong to the same workflow, but each answers a different operational question and should not be collapsed into one ambiguous field.

An invoice requesting 500 USDC can be satisfied by accepted transactions of 300 and 200 USDC, each recorded with its own transaction ID and confirmation state. 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.