Paycryptohost API

Install in 4 steps

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

WooCommerce order status mapping

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

On first on-chain detection the order moves to Processing so you can start fulfilment, and it flips to Completed once the required confirmations are reached. Version 1.6.0 also checks status from WordPress every minute, so a blocked webhook cannot leave a confirmed order stuck as Pending.

Verify it works

1. In PayCryptoHost → Settings click Test connection — you should see a green Connected badge.
2. Open PayCryptoHost → xPub Manager, paste your Bitcoin receiving address (bc1…, 1…, or 3…) or your xPub and click Save & verify. PayCryptoHost validates the format and registers it for direct deposits.
3. Place a test order on your store — Pay with Bitcoin (PayCryptoHost) 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.

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 (PayCryptoHost) 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 PayCryptoHost adds support.

Order status mapping

Webhook

The app auto-registers its callback URL with PayCryptoHost 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 PayCryptoHost to generate a unique address:

curl -X POST https://paycryptohost.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] }),
});