Wallet

Receive into your own wallet

POST/api/v2/wallet/receive

An invoice payable to the merchant's own wallet, without leaving the dashboard. Convenience only — it is not a deposit and it is not a sale.

Dashboard-only (merchant JWT).
Nothing arrives at Trevi and nothing is credited to a Trevi balance — there is none. The sats land in the merchant's wallet exactly as they would had they opened their wallet app and tapped receive.
Deliberately NOT the sale flow. No payment record is written, so no cashback decision is made — otherwise a merchant topping up their own float would be paid cashback out of their own wallet, and charged a fee on it.
502 if the wallet refused or could not be reached.

Authentication

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

Body parameters

amount_satsnumber (integer)required

whole satoshis, minimum 1

descriptionstringoptional

defaults to "Top up"

POST/api/v2/wallet/receive

curl --request POST "https://api.trevi.cash/api/v2/wallet/receive" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $TREVI_JWT" \
  --data '{ "amount_sats": 50000 }'

200Sample response

{
  "success": true,
  "invoice": "lnbc500u1p…",
  "payment_hash": "4d7e…",
  "amount_sats": 50000,
  "expires_at": "2026-08-13T12:15:00.000Z"
}

Was this page helpful?

Disconnect a wallet

Check a receive invoice