Agreements and payments
Use payment language that reflects what actually happened
Editorial team · Reviewed
Payment status is operational information people act on. Distinguish a requested payment, a checkout attempt, provider confirmation, settlement and any later refund instead of compressing them into a single reassuring label.
A practical sequence
- Use a verified provider event or a reviewed manual record to confirm payment.
- Keep the amount, currency, invoice and provider reference connected.
- Show uncertain attempts so the team can reconcile before retrying.
- Record refunds and reversals without erasing the original payment history.
Work through an example
A client closes the checkout tab after submitting a card. The planner does not immediately know whether payment completed. The invoice remains pending until the provider result is reconciled; the team avoids creating a duplicate charge or sending a premature overdue notice.
Where judgement matters
A return URL is not payment evidence. Nor does a bank payout always equal one invoice payment. Follow the provider's documented process and your accounting workflow, and keep the client informed with precise language when the result is uncertain.
Make it usable
Open the working tool and work through the decision with your own inputs. Adapt the structured template to preserve the choices and responsibilities. Keep an original copy so later changes remain understandable.
Work the decision
A practice case
An original fictional scenario. Numbers are illustrative inputs; this is not a customer result or a provider performance claim.
A client clicks Pay, the provider begins processing and the browser loses connection. Calling the invoice paid immediately would confuse an attempt with a settled receipt. Calling it failed could prompt a duplicate attempt while the first is still processing. The interface needs to describe what is known and what remains unresolved.
| Decision | Why it matters |
|---|---|
| Separate requested, processing and confirmed states. | A submitted form is not proof that money has arrived. |
| Give ambiguous outcomes a recovery path. | Look up the existing provider attempt before inviting a fresh charge. |
| Show refunds and recording corrections distinctly. | An internal correction does not return money to the customer. |
Make one usable artifact
Write status messages for a successful payment, processing payment, declined attempt and uncertain response. Include the next safe action for the customer and the business.
Then test the difficult case
The confirmation webhook arrives twice after the browser times out. Confirm there is one receipt and the balance changes once, without a second charge or misleading retry prompt.
Use the linked tool or structured template below to record the result. Confirm it against the actual people, agreements and permissions before using it for an event.