Hosted checkout (API)
LiveDeveloper
Create checkout sessions from your own backend.
Your server creates a session with POST /checkout/hosted/{storeId} and redirects the customer to the returned checkoutUrl. Gully Pay verifies the payment on-chain and sends a signed checkout.session.completed webhook.
Networks
- Base · USDC/USDT
- Ethereum · USDC/USDT
- BNB Smart Chain · USDC/USDT
- Solana · USDC/USDT
Install
Setup
Create a key and a webhook
In Gully Pay- Run the Connect step: it creates a store API key with the checkout:write scope and a webhook endpoint for checkout.session.completed.
- Store the key and the signing secret as server secrets.
Create a session from your server
On your server- POST https://gullypay.xyz/api/checkout/hosted/{storeId} with Authorization: Bearer rk_... and {amount (cents), currency, successUrl, cancelUrl, clientReferenceId}.
- Redirect the customer to checkoutUrl.
Fulfil on the webhook
On your server- Verify X-GullyPay-Signature (hex HMAC-SHA256 of the raw body with the signing secret).
- Re-read the session with GET /checkout/{sessionId} and fulfil once status is completed.