API ReferenceWooCommerceSDKssoonWebhookssoon

Wallet

Create deposit

POST/api/merchants/deposit/lightning

Generate a Lightning invoice or on-chain BTC address to fund your merchant wallet.

Authentication

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

Body parameters

amount_satsnumberrequired
descriptionstringoptional
POST/api/merchants/deposit/lightning
curl --request POST "https://api.trevi.cash/api/merchants/deposit/lightning" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $BTPAY_API_KEY" \
  --data '{ "amount_sats": 50000 }'