Skip to content

Transactions

Create
client.transactions.create(TransactionCreateParams { account, allocations, amount, 4 more } body, RequestOptionsoptions?): TransactionCreateResponse { data }
POST/transactions
List
client.transactions.list(TransactionListParams { account, reconciliation_status } query?, RequestOptionsoptions?): TransactionListResponse { data }
GET/transactions
List History
client.transactions.listHistory(stringtransactionRef, RequestOptionsoptions?): TransactionListHistoryResponse { data }
GET/transactions/{transaction_ref}/history
Retrieve
client.transactions.retrieve(stringtransactionRef, RequestOptionsoptions?): TransactionRetrieveResponse { data }
GET/transactions/{transaction_ref}
Search
client.transactions.search(TransactionSearchParams { filter } body, RequestOptionsoptions?): TransactionSearchResponse { data }
POST/transactions/search
Search Allocations
client.transactions.searchAllocations(TransactionSearchAllocationsParams { filter } body, RequestOptionsoptions?): TransactionSearchAllocationsResponse { data }
POST/transactions/allocations/search
Update
client.transactions.update(stringtransactionRef, TransactionUpdateParams { current_transaction_version, allocations, tags } body, RequestOptionsoptions?): TransactionUpdateResponse { data }
PATCH/transactions/{transaction_ref}
ModelsExpand Collapse
Transaction { id, account, allocations, 9 more }

Transaction object.

id: string

User-facing encoded transaction ID.

account: Account { id, external_id }

External account reference on transaction responses.

id: string

User-facing encoded account ID.

external_id: string

External account reference ID.

allocations: Array<Allocation>
amount: string

Allocated amount in smallest currency unit as stringified bigint.

invoice_id: string

The invoice this allocation is applied against.

type: "invoice_payin" | "invoice_payout"

The type of allocation.

Accepts one of the following:
"invoice_payin"
"invoice_payout"
user: User { id, external_id }

User reference in API responses: Fragment user id and external_id.

id: string

FRAGMENT generated ID of the user

external_id: string

External ID of the user

amount: string

Amount in smallest currency unit as stringified bigint (can be positive or negative).

created: string

Creation timestamp.

formatdate-time
currency: "ADA" | "BTC" | "DAI" | 176 more

Currency code (ISO 4217 or crypto)

Accepts one of the following:
"ADA"
"BTC"
"DAI"
"ETH"
"SOL"
"USDC"
"USDT"
"USDG"
"EURC"
"CADC"
"CADT"
"XLM"
"UNI"
"BCH"
"LTC"
"AAVE"
"LINK"
"MATIC"
"PTS"
"AED"
"AFN"
"ALL"
"AMD"
"ANG"
"AOA"
"ARS"
"AUD"
"AWG"
"AZN"
"BAM"
"BBD"
"BDT"
"BGN"
"BHD"
"BIF"
"BMD"
"BND"
"BOB"
"BRL"
"BSD"
"BTN"
"BWP"
"BYR"
"BZD"
"CAD"
"CDF"
"CHF"
"CLP"
"CNY"
"COP"
"CRC"
"CUC"
"CUP"
"CVE"
"CZK"
"DJF"
"DKK"
"DOP"
"DZD"
"EGP"
"ERN"
"ETB"
"EUR"
"FJD"
"FKP"
"GBP"
"GEL"
"GGP"
"GHS"
"GIP"
"GMD"
"GNF"
"GTQ"
"GYD"
"HKD"
"HNL"
"HRK"
"HTG"
"HUF"
"IDR"
"ILS"
"IMP"
"INR"
"IQD"
"IRR"
"ISK"
"JMD"
"JOD"
"JPY"
"KES"
"KGS"
"KHR"
"KMF"
"KPW"
"KRW"
"KWD"
"KYD"
"KZT"
"LAK"
"LBP"
"LKR"
"LRD"
"LSL"
"LYD"
"MAD"
"MDL"
"MGA"
"MKD"
"MMK"
"MNT"
"MOP"
"MUR"
"MVR"
"MWK"
"MXN"
"MYR"
"MZN"
"NAD"
"NGN"
"NIO"
"NOK"
"NPR"
"NZD"
"OMR"
"PAB"
"PEN"
"PGK"
"PHP"
"PKR"
"PLN"
"PYG"
"QAR"
"RON"
"RSD"
"RUB"
"RWF"
"SAR"
"SBD"
"SCR"
"SDG"
"SEK"
"SGD"
"SHP"
"SLL"
"SOS"
"SPL"
"SRD"
"SVC"
"SYP"
"STN"
"SZL"
"THB"
"TJS"
"TMT"
"TND"
"TOP"
"TRY"
"TTD"
"TVD"
"TWD"
"TZS"
"UAH"
"UGX"
"USD"
"UYU"
"UZS"
"VEF"
"VND"
"VUV"
"WST"
"XAF"
"XCD"
"XOF"
"XPF"
"YER"
"ZAR"
"ZMW"
"LOGICAL"
"CUSTOM"
external_id: string

External idempotency key provided by the user.

posted: string

Posted timestamp in ISO 8601 format.

formatdate-time
tags: Array<Tag>

Metadata tags associated with this transaction.

key: string

Tag key

value: string

Tag value

unallocated_amount: string

Read-only amount not yet allocated.

version: number

Current version of the transaction, used for optimistic concurrency control.

modified?: string

Last modified timestamp.

formatdate-time