Pontoon Docs

Payouts

App-fee balances are withdrawn with a signature and settled in USDC on Base.

Claim flow

  1. Create a claim: POST /api/commercial/claims — reserves the amount atomically.
  2. Sign the returned EIP-191 message with the recipient’s private key.
  3. Authorize: POST /api/commercial/claims/{id}/authorize.
  4. The payout worker broadcasts the USDC transfer and confirms on-chain; the claim ends completed with a txHash.

Safety

  • Only the recipient address’s signature releases funds — dashboard login alone cannot.
  • Failures retry with backoff; 5 failed attempts park the claim in manual_review.