Jamesinvoicing API

Install in 4 steps

Generate your key under Dashboard → API Keys. The plugin only needs the API Key — no secret, no merchant ID.

No WooCommerce? Use the built-in checkout

On a plain WordPress site — a page builder, a custom theme or a simple order form — add this shortcode to any page. The customer fills in their email, clicks the button and goes straight to the payment page with the amount, wallet address and QR code. A copy of the invoice is emailed to them too. No WooCommerce required.

[jamesinvoicing_checkout amount="9.50" item="Unlimited Entertainment" title="Checkout"]

// leave amount out to let the customer type their own amount
[jamesinvoicing_checkout item="Support the project"]

// keep the payment page on your own site instead of jamesinvoicing.com
[jamesinvoicing_checkout amount="25" mode="onsite" invoice_page="https://example.com/pay/"]
// the page at invoice_page must contain: [jamesinvoicing_invoice]

Any existing order link can also be turned into a payment link: https://yoursite.com/?pch_pay=PAYMENT_ID redirects to that invoice's payment page.

Still landing on a "thanks for your order" page right after Place Order? From v2.0.0 the default is Send the customer to the Jamesinvoicing payment page (WooCommerce → Settings → Payments → Pay with Jamesinvoicing.com → After checkout), and funnel checkouts always use it. Older installs that saved the on-site option can switch it back there.

Seeing "There are no payment methods available" at checkout? Your store uses the WooCommerce block-based Checkout page. Update to WordPress Plugin v2.0.2 or later, which supports both the block Checkout and the Classic Checkout. Then check that Pay with Jamesinvoicing.com is enabled under WooCommerce → Settings → Payments and that your API key is saved in the plugin settings.

Payment method appears, but Place Order does not open the payment page? Update to WordPress Plugin v2.0.2. It safely reuses an existing invoice for a retried order and redirects the buyer to the complete hosted payment page instead of trying to create a duplicate invoice.

CartFlows checkout flow (v2.0.0)

CartFlows, FunnelKit/WooFunnels, LaunchFlows and WPFunnels are detected automatically and keep their own funnel steps. Pressing Place Order no longer lands the buyer on the thank-you page before paying:

CartFlows checkout → Place Order
  → WooCommerce creates the order (pending)
  → plugin sends the final WooCommerce total to Jamesinvoicing
  → buyer is redirected to the Jamesinvoicing payment page (amount, address, QR)
  → buyer pays; Jamesinvoicing verifies on-chain
  → payment detected → confirming → confirmed
  → WooCommerce order updated (on-hold → processing)
  → buyer returns to the CartFlows / WooCommerce thank-you page

• The invoiced amount is the final WooCommerce order total, so order bumps, upsells, coupons, tax, shipping and fees are included.
• The store's own thank-you URL is recorded server to server at checkout; the return link is never taken from the browser.
• Orders stay pending or on-hold until the blockchain confirmations are verified. Nothing is marked paid from a URL parameter.
• Upsell and downsell steps keep running: the buyer re-enters the funnel at the merchant's configured thank-you step.

WooCommerce order status mapping

The plugin automatically flips each WooCommerce order as Jamesinvoicing reports back:

Detected, confirming and underpaid orders remain on hold. After server verification, the plugin calls WooCommerce's normal payment completion method; physical orders usually move to Processing, while WooCommerce may complete eligible virtual orders. The plugin never forces every order to Completed.

Verify it works

1. Open Jamesinvoicing → Add API, save the API key, and confirm that you see a green Connected badge.
2. Open Jamesinvoicing → xPub Manager, paste your Bitcoin receiving address (bc1…, 1…, or 3…) or your xPub and click Save & verify. Jamesinvoicing validates the format and registers it for direct deposits.
3. Place a test order on your store — Pay with Bitcoin (Jamesinvoicing) must appear at checkout. Payment confirmations arrive by email/push, not inside the plugin.

Troubleshooting

Install in 5 steps

Grab credentials under Dashboard → API Keys. Use pch_test_* keys for Sandbox mode.

Step-by-step: install on cPanel with screenshots

Follow these screens to add the Jamesinvoicing Bitcoin & crypto gateway to WHMCS through cPanel File Manager.

What it does on the invoice page

• Adds a Pay with Bitcoin button to every unpaid WHMCS invoice.
• Generates an invoice routed to your registered Bitcoin receiving address.
• Shows a QR code, countdown, and live confirmation progress (Awaiting → Detected → Confirming → Paid).
• Marks the invoice Paid automatically when confirmations reach your threshold, records the TXID, and emails the customer.

Troubleshooting

Install in 5 steps

Generate your key under Dashboard → API Keys. Use pch_test_* keys against a development store.

What it does at checkout

• Adds Pay with crypto (Jamesinvoicing) as a payment option on every Shopify checkout.
• Lets the customer pick a coin — BTC, ETH, LTC, USDT (TRC20) or USDT (ERC20).
• Shows the exact amount, a unique address, a QR code and a live countdown.
• Verifies the on-chain TXID, amount, confirmation count and order number on the webhook.
• Marks the order Paid, records the TXID in order notes, and emails the customer.
• Rejects duplicate TXIDs, reused addresses, underpayments and overpayments.

Supported currencies

Bitcoin (BTC), Ethereum (ETH), Litecoin (LTC), USDT (TRC20), USDT (ERC20), and additional coins as Jamesinvoicing adds support.

Order status mapping

Webhook

The app auto-registers its callback URL with Jamesinvoicing on install. Each webhook is HMAC-signed with the X-Paycrypto-Signature header — invalid signatures are rejected with a 401 before any order is touched.

{
  "event": "invoice.confirmed",
  "data": {
    "payment_id": "a1b2c3d4",
    "order_number": "#1042",
    "currency": "BTC",
    "amount": 0.00298507,
    "tx_hash": "9f3a…",
    "confirmations": 2
  }
}

Troubleshooting

Install in 5 steps

Order status mapping

Create the crypto invoice

When a BigCommerce order is placed, call Jamesinvoicing to generate a unique address:

curl -X POST https://jamesinvoicing.com/api/public/v1/merchant/generate-address \
  -H "Authorization: Bearer pch_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_number": "1042",
    "amount_usd": 129.00,
    "customer_email": "buyer@example.com",
    "coin": "BTC"
  }'

Verify the webhook + update BigCommerce

import crypto from "node:crypto";

// In your webhook handler
const sig = req.headers["x-paycrypto-signature"];
const expected = crypto.createHmac("sha256", PCH_WEBHOOK_SECRET)
  .update(rawBody).digest("hex");
if (sig !== expected) return res.status(401).end();

const { event, invoice } = JSON.parse(rawBody);
const map = { "payment.detected": 11, "payment.confirming": 11, "payment.confirmed": 10, "payment.expired": 5 };

await fetch(`https://api.bigcommerce.com/stores/${STORE_HASH}/v2/orders/${invoice.order_number}`, {
  method: "PUT",
  headers: {
    "X-Auth-Token": BC_ACCESS_TOKEN,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ status_id: map[event] }),
});