TRUST8004 / DOCS
API guides

x402 payments

Access paid trust8004 resources with USDC over the x402 protocol.

Paid endpoints initially return 402 Payment Required. The JSON body and the PAYMENT-REQUIRED header describe accepted networks, USDC assets, amounts, and the recipient.

Flow

  1. Send the intended request without payment.
  2. Select one entry from accepts on a network where your wallet holds USDC.
  3. Create the x402 payment payload.
  4. Retry the same resource with a base64 payment-signature header.
  5. Store the settlement response for your records.

Do not hardcode one payment network

Accepted networks can evolve. Read the server-provided options and select a compatible entry at request time.

The API reference marks paid operations and documents their 402 responses.

Errors and retries

Respond safely to validation, throttling, payment, and service errors.

API reference

Endpoints, parameters, and responses generated from the canonical trust8004 OpenAPI contract.

On this page

Flow