Cashback

Update cashback config

PUT/api/merchants/cashback/config

Inspect or change your cashback rules. Changes apply to all future orders immediately.

Authentication

Accepts either an API key (X-API-Key) or a dashboard JWT (Authorization: Bearer …).

Body parameters

cashback_percentagenumberoptional

1–10

enabledbooleanoptional

max_per_transactionnumber (sats)optional

PUT/api/merchants/cashback/config

curl --request PUT "https://api.trevi.cash/api/merchants/cashback/config" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $BTPAY_API_KEY" \
  --data '{ "cashback_percentage": 3.5, "enabled": true }'

Was this page helpful?

Create BTC deposit address

Read cashback reserves