Skip to main content
PIK maintains a full transaction ledger for every account. You can retrieve transaction history via the API at any time, filter by date range or transaction type, and export data for reconciliation with your internal systems or accounting software.

​
Transaction types

PIK records the following transaction types on every wallet:
  • payment_in — Inbound payment received and settled to the wallet.
  • payment_out — Outbound payout sent from the wallet.
  • fx_conversion — FX conversion between currency balances within the wallet.
  • transfer_in — Funds moved into this wallet from another PIK wallet.
  • transfer_out — Funds moved out of this wallet to another PIK wallet.
  • fee — Platform fee deducted from the wallet.
  • reversal — Returned payout credited back to the wallet.

​
Retrieving transaction history

Call GET /api/v1/accounts//transactions to retrieve the transaction history for an account. Include the x-on-behalf-of header to retrieve history for a connected account. Supported query parameters:
  • currency — Filter by currency, for example AUD or USDT.
  • type — Filter by transaction type, for example payment_in or fx_conversion.
  • from_date — ISO 8601 date. Return transactions on or after this date.
  • to_date — ISO 8601 date. Return transactions on or before this date.
  • limit — Number of results per page. Maximum 100. Defaults to 20.
  • cursor — Pagination cursor from the previous response to fetch the next page.
The response returns a paginated list of transaction objects. Each transaction includes a transaction_id, type, currency, amount, status, timestamp, and a reference field containing any reference string associated with the transaction.

​
Matching payments to internal records

Every payment, payout, and conversion in PIK carries a reference field. When you create a payment request or initiate a payout, include your internal order ID or invoice number as the reference. PIK records this reference on the transaction and returns it in the transaction history and webhook payloads. To reconcile, query your PIK transaction history filtered by date range and match the reference field on each transaction to your internal records. Transactions with a reference matching an open internal order can be marked as settled. For inbound payments received via Virtual Account Numbers, the reference is derived from the transfer description provided by the sender. Instruct senders to include a meaningful reference in their transfer so you can identify the payment.

​
Webhook-based reconciliation

For real-time reconciliation, use the payment.settled webhook. Each webhook payload includes the payment_id, amount, currency, reference, and timestamp. Use the reference field to match the settled payment to your internal order and update your records immediately on receipt.

​
Exporting data

To export a full transaction history for a date range, paginate through GET /api/v1/accounts//transactions using the cursor field until all pages are retrieved. Each page returns up to 100 transactions. Combine all pages into a single dataset for import into your accounting or reconciliation system. PIK does not currently provide a direct CSV export via the API. Data must be retrieved via the API and transformed by your integration.