Quick start

Register your application

Create a merchant identity and receive the API key once.

curl -X POST https://app.xguardgate.com/v1/register \
  -H 'content-type: application/json' \
  -d '{"name":"my-payment-app"}'

The response contains apiKey, merchant metadata and the XGuard treasury address. Store the key immediately.

Check service balance

curl https://app.xguardgate.com/v1/balance \
  -H 'authorization: Bearer xg_live_YOUR_KEY'

Fund the prepaid balance

Create a top-up intent. The response returns the exact native USDC amount on Base, treasury address, expiry and claim token. After sending that amount, claim it with the transaction hash.

curl -X POST https://app.xguardgate.com/v1/topups/intents \
  -H 'authorization: Bearer xg_live_YOUR_KEY' \
  -H 'content-type: application/json' \
  -d '{"amountUsd":"1.00"}'

curl -X POST https://app.xguardgate.com/v1/topups/claim \
  -H 'authorization: Bearer xg_live_YOUR_KEY' \
  -H 'content-type: application/json' \
  -d '{"claimToken":"TOKEN_FROM_INTENT","transactionHash":"0x..."}'

Verify an x402 v2 payment

Send the canonical x402 v2 facilitator envelope.

curl -X POST https://app.xguardgate.com/verify \
  -H 'authorization: Bearer xg_live_YOUR_KEY' \
  -H 'content-type: application/json' \
  -d @x402-request.json

Settle through XGuard

Use the same canonical x402 v2 envelope. XGuard adds replay protection, concurrency control, routed execution, finality handling and settlement truth metadata.

curl -X POST https://app.xguardgate.com/settle \
  -H 'authorization: Bearer xg_live_YOUR_KEY' \
  -H 'content-type: application/json' \
  -d @x402-request.json

Machine integration