Record x402 Token Top-Up
Credits a fixed 500-token top-up. Reachable only once app.main's x402 payment middleware has already cryptographically verified a $5.00 payment for this exact route via the configured facilitator - this handler never reads an amount from the request, because there is no amount in the request at all. The on-chain settlement itself completes after this handler returns, so a payment that verifies but later fails to settle (a narrow, accepted window) is still credited; see topup_ledger_x402's own docstring.
Authorization
OAuth2AuthorizationCodeBearer AuthorizationBearer <token>
In: header
Query Parameters
verify_locally?Verify Locally
Default
trueResponse Body
application/json
application/json
curl -X POST "https://example.com/v1/billing/ledger/topup/x402"{ "balance": 0}Empty
{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string" } ]}Empty
Empty