Operations and recovery

Investigate a missing fee or settlement receipt

Look up a workspace receipt by transaction ID, trace its recorded evidence and close a month using verified fees grouped by network and token.

Workflow

  1. Find the transaction or exception

    If you have a transaction hash or execution ID, use businessFindReceipt in the workspace that submitted it. For a monthly review, start with businessExceptions and send nextCursor as before to fetch the next page. Its UTC month follows first submission. The example filters for unverified fees. You can also inspect missing output, pending settlement or a fee awaiting a claim.

  2. Trace changes to the record

    Use businessReceiptHistory with the execution ID and follow the event cursor to see the observations Bitpont has recorded. Match the network, token and recipient to your original quote. For a supported swap, refresh swapReceipt for chain evidence. For a direct bridge, use bridgeFeeFollow to inspect the affiliate payment independently of destination delivery.

  3. Reconcile in the received token

    Call businessFeeTotals for the month. Keep each network and token separate and store integer base units as strings or arbitrary-precision integers. Inspect unidentifiedRows and conflictingGroups for records excluded from the sums. Record a quoted or claimable fee under its own state until verified receipt evidence exists. To identify a referral reward, inspect the eligible member ledger with the referring wallet’s signed authorization.

List unverified fees for a UTC reporting month

curl -fsS "https://www.bitpont.com/api/v1/agent/business/exceptions" \
  -H 'Content-Type: application/json' \
  -H "X-Bitpont-Workspace: ${BITPONT_WORKSPACE:?Set your original workspace}" \
  -d '{"month":"2026-11","category":"unverified-fee","limit":10}'

Tools in this guide

Open tool explorer

Related links