Docs
Dashboard
API v1 · now available

Gully Pay Developer
Documentation

Accept payments, monetize APIs with x402, power AI commerce, and build merchant storefronts. Everything you need to integrate GullyPay into your platform.

Getting Started

Create your merchant account, configure API keys, and process your first payment in under five minutes.

API Reference

Complete REST API documentation for Payments, Merchants, Orders, Checkout, Wallets, and more.

Payments & Checkout

Create payment intents, refunds, payouts, hosted checkout sessions, and reusable payment links.

Wallets & glUSD

Stablecoin wallets, sends and swaps, the Financial OS ledger, and the glUSD programmable stablecoin.

x402 Protocol

Monetize any API with pay-per-request billing using HTTP 402 Payment Required responses.

SDKs

Official SDKs for TypeScript, Python, Go, and React Native with full type support.

Webhooks

Receive real-time event notifications for payments, orders, payouts, and refunds.

Mobile SDKs

Build native merchant and consumer experiences with React Native and Expo.

Quick Integration

Install the SDK and create your first payment in a few lines of code.

$npm install @gullypay/sdk
payment-example.ts
1import { GullyPay } from '@gullypay/sdk';
2
3const gullypay = new GullyPay({
4  apiKey: 'rk_live_your_api_key',
5  environment: 'production',
6});
7
8// Create a payment intent
9const payment = await gullypay.payments.create({
10  amount: 2499,
11  currency: 'USD',
12  storeId: 'store_abc123',
13  merchantId: 'merch_xyz789',
14  customerEmail: '[email protected]',
15});
16
17// Create a hosted checkout session
18const checkout = await gullypay.checkout.createHosted({
19  amount: 2499,
20  currency: 'USD',
21  storeId: 'store_abc123',
22  successUrl: 'https://yoursite.com/success',
23  cancelUrl: 'https://yoursite.com/cancel',
24});
25
26console.log(checkout.url);
27// https://checkout.gullypay.xyz/cs_abc123

Base URLs

APIhttps://gullypay.xyz/api
x402 Facilitatorhttps://gullypay.xyz/api (paths under /x402)
Checkouthttps://gullypay.xyz/checkout/<sessionId>
Sandboxhttps://gullypay.xyz/api