API ReferenceWooCommerceSDKssoonWebhookssoon

Wallet

Wallet activity

GET/api/v2/wallet/activity

Recent sales, cashback payouts, or outstanding reservations. Every row is an observed fact — a sale that settled between two other wallets, or a payout Trevi instructed.

  • Dashboard-only (merchant JWT).
  • Default (no type) returns sales: { id, type: "payment", status, amount_sats, order_id, created_at, completed_at }.
  • type=cashback_payout returns cashback actually sent: { id, type, status, amount_sats, fee_sats, destination, created_at }.
  • type=reserved returns cashback promised but not yet sent, each with the sale it was earned on (payment_id, sale_amount_sats) and expires_at for claim-path reservations.
  • A reservation is not a balance. It is a promise Trevi has made against the merchant's own wallet; if it expires unclaimed it is simply released, because nothing ever left that wallet.

Authentication

Requires a dashboard session JWT in the Authorization: Bearer … header.

Query parameters

typereservedcashback_payoutoptional

omit for sales (payments)

limitnumberoptional

default 100, capped at 200

GET/api/v2/wallet/activity
curl "https://api.trevi.cash/api/v2/wallet/activity?type=cashback_payout&limit=50" \
  --header "Authorization: Bearer $TREVI_JWT"