---
updatedAt: 2026-03-18T11:54:48.000Z
agentTools:
  projectIndex: https://docs.shuttleglobal.com/llms.txt
---

# Transactions

Transactions are the overall ledger of payment activity. A transaction is created for every attempt to instruct a payment gateway — whether it's a payment, authorisation, capture, void, or refund.

## Read-Only Ledger

The transaction API is read-only. Each transaction type has its own dedicated API for actions:

* **Payments**: [Create Payment](/reference/inst-createpayment), [Get Payment](/reference/inst-getpayment)
* **Captures**: [Capture an Authorisation](/reference/inst-capturepayment), [Get Capture](/reference/inst-getcapture)
* **Voids**: [Void an Authorisation](/reference/inst-voidpayment), [Get Void](/reference/inst-getvoid)
* **Refunds**: [Refund a Payment](/reference/inst-refundpayment), [Get Refund](/reference/inst-getrefund)

The transaction list provides a unified view across all these types, useful for reporting and reconciliation.

## Action Types

The `action` field identifies the transaction type:

| Action    | Description                               |
| --------- | ----------------------------------------- |
| `PAYMENT` | A direct payment (funds collected)        |
| `AUTH`    | An authorisation (funds reserved)         |
| `CAPTURE` | A capture of a previous authorisation     |
| `VOID`    | A void of a previous authorisation        |
| `REFUND`  | A refund of a previous payment or capture |

## Status

Transaction statuses are consistent across all action types. See [Payments](/reference/payments) for the full status and gateway\_status reference.