Wallet
Wallet activity
GET
/api/v2/wallet/activityRecent 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_payoutreturns cashback actually sent:{ id, type, status, amount_sats, fee_sats, destination, created_at }.type=reservedreturns cashback promised but not yet sent, each with the sale it was earned on (payment_id,sale_amount_sats) andexpires_atfor 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_payoutoptionalomit for sales (payments)
limitnumberoptionaldefault 100, capped at 200
GET
/api/v2/wallet/activitycurl "https://api.trevi.cash/api/v2/wallet/activity?type=cashback_payout&limit=50" \
--header "Authorization: Bearer $TREVI_JWT"Was this page helpful?
