Wallet

Check a receive invoice

GET/api/v2/wallet/receive/:paymentHash

Ask the merchant's own wallet whether a top-up invoice has been paid yet.

Dashboard-only (merchant JWT).
found: false means the wallet has no record of the invoice. That is a real answer, not an error — and not "settled".
Settlement is decided by settled_at. A wallet that cannot be asked right now responds 502 with settled: null, meaning UNKNOWN — never treat that as "not paid".

Authentication

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

paymentHashstringrequired

from POST /api/v2/wallet/receive

GET/api/v2/wallet/receive/:paymentHash

curl "https://api.trevi.cash/api/v2/wallet/receive/PAYMENT_HASH" \
  --header "Authorization: Bearer $TREVI_JWT"

Was this page helpful?