Mainnet quickstart: your first paid request

Never send anyone a private key or seed phrase. Step 4 reads a key file for your second wallet, on your own computer only: use a wallet that holds a few cents, not your main wallet, and restrict the file (chmod 600 payer.json). The commands below put your API key on the command line, so it can end up in your shell history: use a terminal you trust, and replace the key on the start page if it may have leaked.

Check that the key works:

curl https://api-mainnet.payzilla.ai/supported \
  -H "x-api-key: <YOUR_KEY>"

You should see: HTTP 200. If you see 401, the key is wrong: send it exactly as shown, in the x-api-key header.

curl -X POST https://api-mainnet.payzilla.ai/v1/services \
  -H "x-api-key: <YOUR_KEY>" \
  -H "content-type: application/json" \
  -d '{"name": "Weather lookup", "price": "2000"}'

You should see: HTTP 201 and your new service with its id. Keep the id.

Then run the small reference seller server. Its code is on the developer hub, so this step continues there: copy it from seller.mjs (step 3 of the hub), save it as seller.mjs, come back here and run:

PAYZILLA_API_KEY=<YOUR_KEY> PAYZILLA_SERVICE_ID=<YOUR_SERVICE_ID> node seller.mjs

It answers HTTP 402 with your price, on port 8080. Keep it running in this terminal and open a second one for step 4. It is reference code: one route, one process. We have not published a run of it on mainnet, so keep the first payment small and read the result yourself. What was tested and what was not is on the developer hub.

npm install @solana/kit@^5.1.0 @x402/core@~2.28.0 @x402/svm@~2.28.0

First look, which signs nothing and opens no file. Use localhost, not 127.0.0.1: the script refuses a challenge whose host differs from the address you typed. An unpaid call like this leaves a payment with the status Created in your list; it is not a failure.

node pay-service.mjs http://localhost:8080

This sends real USDC. A Solana transaction cannot be undone on the blockchain. The key file is your second wallet’s, in Solana CLI format (a JSON array of 64 numbers), and is read on your computer only. The script refuses amounts above 0.1 USDC on mainnet and asks a second time above 0.05 USDC. It asks you to type pay. We have not run this script on mainnet through Payzilla’s own path; if a payment fails for lack of funds, write to us.

node pay-service.mjs http://localhost:8080 --keypair payer.json --network mainnet

You should see: HTTP status 200, your service’s answer, and a transaction with a Solscan link.

Next: you can list your service in the Marketplace from the start app. Payzilla does not vouch for what sellers list.