Top up USD balance with crypto (min $30, max $2000)

Creates a crypto deposit invoice. On confirmation (push from the payment orchestrator), the user's USD balance is credited with amount + bonus. Bonus tiers in GET /api/v1/topup/bonus. Bearer optional — if absent, a new account is created and the token is returned in the response (STORE IT, it cannot be recovered).

post/api/v1/topup

Request

  • Base URL: https://servghost.com
  • URL: https://servghost.com/api/v1/topup
  • Auth: none declared

Headers

X-Payment-Mode'x402'

Set to 'x402' to pay via the x402 protocol (scheme 'exact', USDC on Base, EIP-3009 transferWithAuthorization). The first request returns HTTP 402 with an 'accepts' block; retry with the signed 'X-Payment' header to settle and credit the balance.

Response

Top-up invoice created

Changes

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