Transactions, settlement, and receipts
Learn what Recuut records after a paid request and when a result may be released.
A transaction records one paid access attempt. It connects the resource, price, payer, reported values, and current payment outcome. Its payment_request_id is an opaque identifier you may use to match your own logs; do not derive meaning from its shape.
| Outcome | Meaning for your application |
|---|---|
succeeded | Payment completed. Return the protected result and use the receipt when you need payment evidence. |
settling or reconciling | Payment is still pending. Keep the protected result private. |
failed | The work or payment did not complete. Do not return the protected result as paid. |
A receipt is the completed payment record. It describes the successful transaction, including the resource, price, parties, payment reference, and environment. Pending and failed transactions do not have receipts.
An application timeout does not prove that payment failed. Check the saved transaction before deciding what to show or retry.
For a pending ID, query Get a transaction after the server-provided Retry-After, or use a short bounded backoff when none is present. Stop polling on succeeded or failed. Keep the protected result private throughout pending, authorized, settling, and reconciling; a receipt appears only with succeeded.