Docs
Dashboard

Integrations / Developer

JavaScript / TypeScript SDK

Beta · version 0.0.1

Typed JavaScript / TypeScript client for the Gully Pay REST API: checkout sessions, payments, x402 and wallets. Source: packages/x402-sdk. Not on the public package registry yet; build or vendor it from source.

Beta
Not published to the public package registry yet. Install from source.

Install

  • JavaScript / TypeScript package: npm install @gullypay/x402-sdk (not on the public registry yet; use the source in packages/x402-sdk)

Setup

  1. Add the SDK to your project (On your server)
    • Install from source: packages/x402-sdk (see its README).
    • Once published: npm install @gullypay/x402-sdk
  2. Create a store API key (In the Gully Pay dashboard)
    • Run the Hosted checkout wizard, or create a key with the checkout:write scope under Developer.

Networks

NetworkAssetsNotes
BaseUSDC, USDTmainnet
EthereumUSDC, USDTmainnet
BNB Smart ChainUSDC, USDTmainnet
SolanaUSDC, USDTmainnet
Gully Chain TestnetETH, WETHOnly when the API runs with GULLY_CHAIN_ENABLED=true (testnet).

Scopes and events

  • API key scopes: checkout:write
  • Webhook events: checkout.session.completed (see Webhooks)
  • API base URL: https://gullypay.xyz/api

Changelog

0.0.1 (2026-10-01)

  • First release from the monorepo.