Top up an existing wallet-owned active card directly with x402

Public agent marketplace entrypoint. The Base USDC payer must own an active card. The server selects that card; funding is asynchronous and the current load fee applies.

post/api/card/topup

Request

  • Base URL: https://api.x402card.org
  • URL: https://api.x402card.org/api/card/topup
  • Auth: none declared

Request body

amountUsdCentsinteger

Gross USDC payment in integer USD cents. Omit to use the current configured default.

idempotencyKeystring required

Stable caller-generated key. Reuse it after an ambiguous response.

Response

Settled funding order with queued asynchronous card top-up

Changes

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