Settle Usage-Based Payments

Use x402 upto when you know the maximum price before work but calculate the final charge afterward. It is the agentic counterpart to a capped variable checkout.

Demo

The demo above is mock only. If you want to see onchain demos on Vibenet, head to Base chain demos.

Advertise the Maximum and Set the Actual Charge

app.use(paymentMiddleware({
  "GET /metered": {
    accepts: [{ scheme: "upto", price: "$0.10", network, payTo }],
    description: "Usage-priced inference",
    mimeType: "application/json",
  },
}, resourceServer));
app.get("/metered", (_request, response) => {
  setSettlementOverrides(response, { amount: "$0.04" });
  response.json({ tokens: 812, result: "Generated response" });
});

routes["GET /metered"] = x402http.RouteConfig{
	Accepts: x402http.PaymentOptions{{Scheme: "upto", Price: "$0.10", Network: network, PayTo: payTo}},
	Description: "Usage-priced inference", MimeType: "application/json",
}
mux.HandleFunc("GET /metered", func(w http.ResponseWriter, _ *http.Request) {
	nethttpmw.SetSettlementOverrides(w, &x402.SettlementOverrides{Amount: "40000"})
	_ = json.NewEncoder(w).Encode(map[string]any{"tokens": 812, "result": "Generated response"})
})

routes["GET /metered"] = RouteConfig(
    accepts=[PaymentOption(scheme="upto", price="$0.10", network=network, pay_to=pay_to)],
    description="Usage-priced inference",
    mime_type="application/json",
)


@app.get("/metered")
async def metered(response: Response) -> dict[str, object]:
    set_settlement_overrides(response, {"amount": "$0.04"})
    return {"tokens": 812, "result": "Generated response"}

Set the settlement override only after you have computed successful usage. Keep the charged amount at or below the maximum advertised in the 402 requirements.

The buyer authorizes up to

0.10, the successful response records

0.04 of actual usage, and settlement charges $0.04.

Do not return billable output before middleware has verified the authorization. Define how failures, timeouts, and partial work map to a charge before you expose the endpoint.

Charge for an API

Use exact when price is known before work.

Capture a Partial Amount

Build the wallet-checkout version with a constrained permit.

Overview

Integrate DeFi

Tokenize Assets

Issue Stablecoins

Accept Payments

Demo

Advertise the Maximum and Set the Actual Charge

See Also

Charge for an API

Capture a Partial Amount

​Demo

​Advertise the Maximum and Set the Actual Charge

​See Also

Charge for an API

Capture a Partial Amount

Demo

Advertise the Maximum and Set the Actual Charge

See Also