General

Top up via x402 challenge

Discovery call without payment headers returns 402 and does not require auth. Final paid retry requires API key (Authorization, x-api-key, or api_key query param) and supports both payment and payment-signature headers. Method-compatible with POST, PUT, PATCH, and DELETE.

post/api/v1/billing/topups/usdc

Request

  • Base URL: https://botsee.io
  • URL: https://botsee.io/api/v1/billing/topups/usdc
  • Auth: none required

Query parameters

api_keystring

Alternative auth for facilitator-driven final paid retry

Headers

authorizationstring

Required on final paid retry when using Bearer auth. Format: Bearer bts_live_...

x-api-keystring

Alternative to Authorization on final paid retry

paymentstring

Base64-encoded payment payload. Omit for discovery challenge; include on final paid retry.

payment-signaturestring

Alias for payment header

Request body

amount_centsinteger

Amount in USD cents (250-100000, i.e., $2.50-$1000). Optional for discovery-only 402 challenge (defaults to configured discovery amount).

Response

Resource created.

amount_centsinteger
x402Versioninteger

Changes

No recorded changes to this operation across all 1 revision of this API.