Integrations / Payment plugins

WooCommerce

Live · version 1.0.0

A WooCommerce payment gateway. Customers pay through the Gully Pay hosted checkout and each payment settles on-chain straight to your settlement wallet. Works with the classic checkout and the Cart & Checkout blocks, and with High-Performance Order Storage. Store currency must be USD.

Install

• Download the plugin (.zip): gullypay-woocommerce-1.0.0.zip. Requires WordPress 6.0+, WooCommerce 7.6+, PHP 7.4+, Store currency USD. Built from packages/plugins/woocommerce-php/gullypay-woocommerce with node packages/plugins/woocommerce-php/build.mjs.

Setup

1. Install the plugin (On your platform)
   • Download gullypay-woocommerce-1.0.0.zip from the Install step.
   • In WordPress go to Plugins > Add New > Upload Plugin, choose the zip and press Install Now.
   • Activate the plugin.
2. Create your API key and webhook (In the Gully Pay dashboard)
   • In the Connect step enter your shop URL. Gully Pay creates a store API key with the checkout:write scope and a webhook to https://YOUR-SHOP/wp-json/gullypay/v1/webhook for checkout.session.completed.
   • The key and the signing secret are shown once. Copy them now.
3. Paste the credentials into WooCommerce (On your platform)
   • Go to WooCommerce > Settings > Payments > Gully Pay.
   • Environment: Production. Paste the Secret API key, the Store ID and the Webhook signing secret.
   • Choose the settlement assets you accept, tick Enable and save.
4. Place a test order (On your platform)
   • Run the Test step, or place a $1 order in your shop and pay it from a wallet.
   • When the payment is confirmed the order moves to Processing (Completed for virtual items) and the order notes show the network and transaction hash.

What the setup wizard creates

• A store API key (rk_…) pinned to your merchant, with exactly the scope checkout:write.
• A webhook endpoint (required) for checkout.session.completed at https://YOUR-SITE/wp-json/gullypay/v1/webhook, with its own signing secret.
• The key and signing secret are shown once. Running Connect again revokes the old key and disables the old endpoint.

The Test step opens a real hosted checkout (default $1.00) for your store. It completes when the signed checkout.session.completed webhook reaches your endpoint with a 2xx answer, or, without an endpoint, when the payment shows in the dashboard event viewer.

Networks

Scopes and events

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

Version reporting

The plugin sends its version on every API call, so the dashboard can show it and warn when an update is available:

X-GullyPay-Plugin: woocommerce/1.0.0

Builds that do not send the header yet are recognised by their User-Agent GullyPay-WooCommerce/<version>.

Changelog