Skip to main content
A transaction records an attempt to move an amount with a payment method. It contains the amount, the method, the customer, and the current state.

Payment and transaction

Use payment to talk about the complete experience offered to the buyer. Use transaction to talk about the resource returned by the API. A checkout session can guide the buyer through that experience. The transaction records the result of the chosen method.

Lifecycle

The available states may vary by method. Implement only the states published in the reference for the flow you use.

How to track

Use the status query to update the interface. On the backend, process webhook events as the source of truth.

Next steps

Check status

Query a transaction by its identifier.

List transactions

Retrieve the project’s transactions.

Configure webhooks

Receive state changes automatically.

Avoid duplication

Retry creation operations safely.