Integrations

Downloads & install guides

Plugins for WordPress and PHP stores, a bridge for hosted stores, and tools for developers. Every integration marks an order paid only after a signed webhook and a server-side status check.

Before you start

Create an API key

Dashboard → Developers → API keys. Give it the read and payments permissions. Keep it on the server.

Copy the webhook secret

Dashboard → Developers → Webhook secret. Every plugin needs it to verify Stablora’s signatures.

Allow your webhook URL

Paste the plugin’s webhook URL into Settings → Webhook destination. On a self-hosted Stablora, the operator adds its origin to WEBHOOK_ALLOWED_ORIGINS.

Store plugins currently run in test mode: they accept a qk_test_ key and testnet payments (faucet coins, no value) — see the testing guide. Live store payments are coming; until then take real payments with checkout links from your dashboard or directly through the API with a qk_live_ key.

WordPress

WooCommerce logo

WooCommerce

Crypto checkout for WooCommerce stores — classic and block checkout.

Requires: WordPress 6.5+, WooCommerce 8.2+, PHP 7.4+

Download WooCommerce· 48 KBstablora-woocommerce-0.1.0.zip · sha256 9da34e593f1f0248…
Webhook URL for Stablora
https://your-store.com/?wc-api=stablora

Orders are marked paid only after a signed webhook and a server-side status check.

A reversed payment puts the order back on hold; nothing is refunded automatically.

  1. 1Download the ZIP below.
  2. 2In WordPress go to Plugins → Add New → Upload Plugin, choose the ZIP and click Install Now, then Activate “Stablora for WooCommerce”.
  3. 3Set the store currency to USD in WooCommerce → Settings → General.
  4. 4Open WooCommerce → Settings → Payments → Stablora (Sandbox / Testnet), fill in the settings below, enable the gateway and save.
  5. 5Copy the webhook URL shown there into Stablora Settings → Webhook destination.
  6. 6Place a test order and pay it with faucet coins on the testnet you configured.
API base URLhttp://localhost:3000/api/v1
Secret API keyqk_test_… from Developers → API keys, with the read and payments permissions
Webhook signing secretFrom Developers → Webhook secret in your Stablora dashboard
Network / assetThe testnet coin that settles the USD price, e.g. sepolia / ETH or tron-nile / USDT
Invoice expiration5–1440 minutes, default 60

Full guide: plugins/woocommerce-stablora/README.md

Easy Digital Downloads logo

Easy Digital Downloads

Sell e-books, software and other downloads for crypto.

Requires: WordPress 6.5+, Easy Digital Downloads 3.3+, PHP 7.4+, InnoDB tables

Download Easy Digital Downloads· 17 KBedd-stablora-0.1.0.zip · sha256 71bf856b30b4421e…
Webhook URL for Stablora
https://your-site.com/wp-json/stablora-edd/v1/webhook
  1. 1Download the ZIP below and upload it in Plugins → Add New → Upload Plugin. Activate it after EDD.
  2. 2Under Downloads → Settings → Payments enable Test Mode and the Stablora (Sandbox / Testnet) gateway; set the currency to USD.
  3. 3Open Settings → Stablora - Easy Digital Downloads and fill in the settings below.
  4. 4Copy the webhook URL shown on that page into Stablora Settings → Webhook destination.
API base URLhttp://localhost:3000/api/v1
Secret API keyqk_test_… from Developers → API keys, with the read and payments permissions
Webhook signing secretFrom Developers → Webhook secret in your Stablora dashboard
Network / assetThe testnet coin that settles the USD price, e.g. sepolia / ETH or tron-nile / USDT

Full guide: plugins/wordpress-more/edd-stablora/README.md

PHP e-commerce

PrestaShop logo

PrestaShop

Payment module with “Awaiting Stablora payment” and “Stablora payment reversed” order states.

Requires: PrestaShop 8.0 – 8.x, store currency USD

Download PrestaShop· 17 KBstablora-prestashop-0.1.0.zip · sha256 c92e9b9099c57167…
Webhook URL for Stablora
https://your-shop.com/module/stablora/webhook
  1. 1Download the ZIP below.
  2. 2In the back office open Modules → Module Manager → Upload a module and drop the ZIP.
  3. 3Click Configure and fill in the settings below; switch on Enable sandbox/testnet checkout.
  4. 4Copy the webhook URL shown on the configuration page into Stablora Settings → Webhook destination.
API base URLhttp://localhost:3000/api/v1
Secret API keyqk_test_… from Developers → API keys, with the read and payments permissions
Webhook signing secretFrom Developers → Webhook secret in your Stablora dashboard
Network / assetThe testnet coin that settles the USD price, e.g. sepolia / ETH or tron-nile / USDT

Full guide: plugins/php-carts/prestashop-stablora/README.md

OpenCart logo

OpenCart

Payment extension with per-store settings and dedicated review/reversed statuses.

Requires: OpenCart 4.x, base and checkout currency USD

Download OpenCart· 20 KBstablora.ocmod.zip · sha256 e7de958931cf41db…
Webhook URL for Stablora
https://your-shop.com/index.php?route=extension/stablora/payment/callback
  1. 1Download stablora.ocmod.zip below.
  2. 2In the admin open Extensions → Installer, upload the file, then go to Extensions → Extensions → Payments and click Install on Stablora.
  3. 3Click Edit, choose the store, fill in the settings below and map the four order statuses (awaiting, paid, review, reversed). Create dedicated unpaid statuses for review and reversed.
  4. 4Copy the callback URL shown there into Stablora Settings → Webhook destination.
API base URLhttp://localhost:3000/api/v1
Secret API keyqk_test_… from Developers → API keys, with the read and payments permissions
Webhook signing secretFrom Developers → Webhook secret in your Stablora dashboard
Network / assetThe testnet coin that settles the USD price, e.g. sepolia / ETH or tron-nile / USDT

Full guide: plugins/php-carts/opencart-stablora/README.md

Hosted stores

Shopify logo

Shopify

A “Crypto (Stablora)” payment method with a pay link in the order email; orders are marked paid automatically.

Requires: Stablora Commerce Bridge (Node.js 20+) on a server with HTTPS, Shopify Admin API app

Download Commerce Bridge· 50 KBstablora-commerce-bridge-0.1.0.zip · sha256 0151271b682e8dd2…
Webhook URL for Stablora
https://your-bridge.com/webhooks/stablora

A native crypto option inside Shopify checkout needs Shopify’s payments-partner approval; the manual method works without it.

  1. 1Download the Commerce Bridge below, unzip it on your server, copy .env.example to .env and set PLATFORMS=shopify, your Stablora test key and webhook secret. Start it with npm start.
  2. 2In Shopify Settings → Payments add a manual payment method named exactly Crypto (Stablora).
  3. 3Create an Admin API app with read_orders and write_orders; put SHOPIFY_SHOP, SHOPIFY_ACCESS_TOKEN and SHOPIFY_WEBHOOK_SECRET in .env.
  4. 4Subscribe the orders/create webhook to https://your-bridge.com/shopify/webhooks/orders-create.
  5. 5Add the Liquid snippet from shopify/README.md to the order confirmation email so buyers get their pay link.
  6. 6Paste the bridge’s Stablora webhook URL (below) into Stablora Settings → Webhook destination.

Full guide: plugins/saas-bridge/shopify/README.md

Ecwid logo

Ecwid

An Ecwid payment application: buyers are redirected to Stablora and back to the store.

Requires: Stablora Commerce Bridge (Node.js 20+) on a public HTTPS URL, Ecwid payment app

Download Commerce Bridge· 50 KBstablora-commerce-bridge-0.1.0.zip · sha256 0151271b682e8dd2…
Webhook URL for Stablora
https://your-bridge.com/webhooks/stablora
  1. 1Download the Commerce Bridge below, set PLATFORMS=ecwid in .env and start it with npm start.
  2. 2Register an Ecwid payment application with add_payment_method, read_orders and update_orders.
  3. 3Set the app’s payment URL to https://your-bridge.com/ecwid/payment.
  4. 4Put ECWID_STORE_ID, ECWID_CLIENT_SECRET and ECWID_ACCESS_TOKEN in .env.
  5. 5Paste the bridge’s Stablora webhook URL (below) into Stablora Settings → Webhook destination.

Full guide: plugins/saas-bridge/ecwid/README.md

BigCommerce logo

BigCommerce

An offline “Crypto (Stablora)” method; the bridge creates the invoice and updates the order.

Requires: Stablora Commerce Bridge (Node.js 20+) on a public HTTPS URL, BigCommerce API account

Download Commerce Bridge· 50 KBstablora-commerce-bridge-0.1.0.zip · sha256 0151271b682e8dd2…
Webhook URL for Stablora
https://your-bridge.com/webhooks/stablora
  1. 1Download the Commerce Bridge below, set PLATFORMS=bigcommerce in .env and start it with npm start.
  2. 2Add an offline payment method shown as Crypto (Stablora).
  3. 3Create a store API account with Orders modify; set BIGCOMMERCE_STORE_HASH, BIGCOMMERCE_ACCESS_TOKEN and a random BIGCOMMERCE_WEBHOOK_SECRET.
  4. 4Register the store/order/created webhook as described in bigcommerce/README.md.
  5. 5Paste the bridge’s Stablora webhook URL (below) into Stablora Settings → Webhook destination.

Full guide: plugins/saas-bridge/bigcommerce/README.md

Developer tools

Node.js SDK logo

Node.js SDK

Typed client for every endpoint, automatic retries, pagination and webhook verification.

Requires: Node.js 20+, zero dependencies

Download Node.js SDK· 43 KBstablora-node-sdk-0.1.0.zip · sha256 cf69134b195e4511…
  1. 1Download and unzip, then run npm install ./stablora-node in your project.
  2. 2Create the client with your secret key and start with stablora.payments.create(...). See the API reference.

Full guide: sdk/node/README.md

MCP server logo

MCP server

Let Claude and other AI agents create invoices and check payments — never send funds.

Requires: Node.js 20+, an MCP client (Claude Code, Claude Desktop…)

Download MCP server· 10 KBstablora-mcp-0.1.0.zip · sha256 429aa9bbe0709978…
  1. 1Download and unzip.
  2. 2Add it to your client, e.g. claude mcp add stablora --env STABLORA_API_KEY=qk_test_... -- node ./stablora-mcp/bin/stablora-mcp.js. Details in the API reference.

Full guide: sdk/mcp/README.md