Integrations / Developer
x402 payments
Live
Register an endpoint and price, return 402 Payment Required with the requirements, and let agents and clients pay on-chain before they get the response. Gully Pay verifies and settles. Gully Chain Testnet is available when the server runs with GULLY_CHAIN_ENABLED.
Install
- x402 API: reference
- Register endpoints (dashboard
/x402)
Setup
- Register a paid endpoint (In the Gully Pay dashboard)
- Open x402 & API in the dashboard and register the resource, price, asset and network.
- Return 402 from your API (On your server)
- Serve GET /x402/requirements/{resource} (or your own 402 response) to unpaid callers.
- Verify the payment with POST /x402/verify before returning the resource.
Networks
| Network | Assets | Notes |
|---|---|---|
| Base | USDC, USDT | mainnet |
| Ethereum | USDC, USDT | mainnet |
| BNB Smart Chain | USDC, USDT | mainnet |
| Solana | USDC, USDT | mainnet |
| Gully Chain Testnet | ETH, WETH | Only when the API runs with GULLY_CHAIN_ENABLED=true (testnet). |
Scopes and events
- Webhook events:
x402.payment.received(see Webhooks) - API base URL:
https://gullypay.xyz/api