Skip to main content
When a wallet can’t cover a request, the API returns 402 Payment Required with an actionable body:

The pattern

Show top_up_url to your user. An outage becomes a funding prompt — this is the whole “runs while someone keeps it fueled” model:

Watch the gauge before it hits zero

  • Every response includes a TokenGift-Balance header — surface it in your UI.
  • Subscribe to the balance.low webhook to get notified at 20%.