Skip to main content

Getting started with Axios

Make x402 payments with an Axios client in 2 minutes.
You can find the full code for this example here.

Step 1: Create a new client from the starter template

Use your favorite package manager.
npm (npx)
pnpm
bun
The starter mirrors the upstream example and bootstraps a ready-to-run Axios client.

Step 2: Set your environment variables

Open your generated project’s .env and set the following:
  • RESOURCE_SERVER_URL: Base URL of the server to call (e.g., http://localhost:4021)
  • ENDPOINT_PATH: Path to a paid endpoint (e.g., /weather)
  • PRIVATE_KEY: Hex EVM private key of the paying account

Step 3: Preview the client code

This is the index.ts the starter generates. It loads your env, attaches the x402 payment interceptor to an Axios instance, calls your endpoint, and logs both the JSON body and the decoded x-payment-response headers.

Step 4: Run the client

Your client is now making x402 payments!

Step 5: Test the client

You can test your client against a local server by running the express example or the hono example. You can also test your client against a live merchant for free. You will receive a full refund of any tokens that you send, and PayAI will pay for the network fees.

Need help?

Join our Community

Have questions or want to connect with other developers? Join our Discord server.