Invoice Payment Attempt

Overview

Meaning in plain language

An invoice payment attempt is one identifiable effort by a payer or payment client to satisfy an invoice, whether the attempt succeeds, fails, expires, or remains pending. An attempt can be represented by a transaction, a checkout initialization, or a provider-side record that later receives blockchain evidence.

How it works

An attempt can be represented by a transaction, a checkout initialization, or a provider-side record that later receives blockchain evidence. An invoice may have multiple attempts because users retry, change assets, replace transactions, or send partial payments.

Systems should assign attempt identifiers, preserve status history, prevent double credit across attempts, and distinguish retries from additional payments. Matching logic should not assume the first observed transaction is the only relevant attempt.

A payment attempt is narrower than the invoice payment session. A session is the checkout context and instructions; one session may contain several attempts or transactions.

A payer may submit a low-fee transaction, replace it, and then create another transaction; the invoice records the attempts but credits only the transfer that satisfies the acceptance rule.

Where people get it wrong

One invoice can have no attempt, one attempt, or several; one attempt can also generate more than one network observation. Never infer order completion from the number of transaction hashes alone.

Related concepts

Invoice Rate Lock, Invoice Paid Time, Crypto Invoice.