Transactions are created for every order that results in an exchange of money.

{{ '/api/reference/transaction.png' | image }}

There are five types of transactions:

Authorization: An amount reserved against the cardholder's funding source. Money does not change hands until the authorization is captured.
Sale: An authorization and capture performed together in a single step.
Capture: A transfer of the money that was reserved during the authorization stage.
Void: A cancellation of a pending authorization or capture.
Refund: A partial or full return of captured funds to the cardholder. A refund can happen only after a capture is processed.

Refund transactions must be created by using the Refund resource.

Note

An order can have more than one authorization transaction associated with it. This might happen when an order is edited or when a post-purchase upsell is added to the order. To be notified when an order is edited subscribe to the OrderEdit webhook.

If your app captures payments, you should make a GET request to the /admin/api/{version}/orders/{order_id}/transactions.json endpoint to retrieve the authorization transactions associated with an order. Then, to complete the full order payment capture, you should use the authorization or parent_id properties in separate capture POST requests to the same endpoint for each authorization transaction.

Note

An order can have no more than 100 transactions associated with it.