Transactions

A transaction is the record of a successful (or failed) payment. You don't create transactions directly: they're created automatically when a customer completes a checkout session.

List transactions

GET /v1/transactions

Query parameters

Field	Type	Description
`page`	integer	Page number, starting at 1. Default: 1.
`limit`	integer	Results per page. Max 100. Default: 20.
`status`	string	Filter by status. One of `pending`, `processing`, `completed`, `failed`, `refunded`.
`from`	string	ISO 8601 date. Returns transactions created after this date.
`to`	string	ISO 8601 date. Returns transactions created before this date.

Example

const result = await skiro.transactions.list({
  status: 'completed',
  limit: 50
})

console.log(result.data.length) // up to 50 transactions
console.log(result.pagination.total) // total matching the filter

Retrieve a transaction

GET /v1/transactions/{id}

const txn = await skiro.transactions.retrieve('txn_abc123')

The transaction object

Field	Type	Description
`id`	string	Unique identifier (`txn_...`).
`amount`	number	Gross amount charged to the customer's card.
`currency`	string	Fiat currency.
`payout_amount`	number	Net amount paid out to your wallet, after fees and conversion. Null until `completed`.
`payout_currency`	string	The crypto sent to your wallet.
`fee_amount`	number	Total fee deducted, in the original fiat currency.
`status`	string	`pending`, `processing`, `completed`, `failed`, `refunded`.
`customer_email`	string	Email captured at checkout, if any.
`card_brand`	string	e.g. `Visa`, `Mastercard`, `Amex`.
`card_last_four`	string	Last 4 digits of the card. We never store full PAN.
`metadata`	object	The metadata you attached when creating the session.
`paid_out_at`	string	ISO 8601 timestamp when the crypto landed in your wallet.
`created_at`	string	ISO 8601 timestamp.