NayoriNayori
Commerce

Settlement and delivery

Distinguish validation, broadcast, confirmation, receipt and resource delivery.

StateMeaningMay deliver?
QuotedServer issued a signed, bounded offerNo
ValidatedSubmitted transaction matches the intentNo
BroadcastNetwork accepted the transaction submissionNo
PendingTransaction has no canonical terminal result yetNo
ConfirmedCanonical execution succeededNot until receipt exists
ReceiptedDurable signed settlement receipt existsYes
DeliveredStable delivery record and response digest existYes, idempotently
FailedTransaction aborted, dropped or violated policyNo

The settlement identifier is stable across polling. Retrying a confirmed request returns the same delivery rather than broadcasting or charging again.

Application rule

Treat 202 as an instruction to poll the supplied same-origin Location. Never interpret it as success. Treat 409 as terminal for that settlement identifier and obtain a fresh challenge before trying another payment.

On this page