Documentation

Everything you need to start accepting Bitcoin payments.

Quick Start

1

Create your PayMohawk account

Fill out the application form. We'll set up your merchant store within 24 hours.

2

Receive your credentials

You'll get a Store ID, API Key, and Webhook Secret via encrypted email.

3

Install the plugin or connect via API

Choose your integration method below based on your platform.

4

Start accepting payments

Customers pay via Bitcoin or Lightning. Funds arrive directly in your wallet.

WooCommerce Integration

The fastest way to accept crypto on your WooCommerce store. Install the official BTCPay for WooCommerce plugin and connect it to your PayMohawk merchant account.

Installation

# From your WordPress admin panel:
Plugins → Add New → Search “BTCPay for WooCommerce”
Install & Activate

Configuration

# WooCommerce → Settings → Payments → BTCPay Server
BTCPay Server URL: https://btc.paymohawk.com
API Key: your-api-key-here
Store ID: your-store-id-here
Webhook Secret: your-webhook-secret-here
WordPress 6.0+WooCommerce 8.0+PHP 8.0+SSL Required

Shopify Integration

Accept Bitcoin on your Shopify store using PayMohawk's hosted checkout page. No app installation required — works with Shopify's alternative payment method feature.

Setup Steps

  1. 1.Go to Shopify Admin → Settings → Payments
  2. 2.Scroll to "Manual payment methods" → Add manual payment method
  3. 3.Name it "Pay with Bitcoin" and add instructions with your PayMohawk checkout link
  4. 4.Customers will be redirected to your BTCPay checkout page to complete payment

Coming Soon: Native Shopify app for seamless checkout integration. Contact us to join the beta.

Custom API Integration

Build a custom integration using the BTCPay Server Greenfield API. Full control over invoices, webhooks, and payment flows.

Create an Invoice

curl -X POST https://btc.paymohawk.com/api/v1/stores/{storeId}/invoices \
  -H "Authorization: token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "49.99",
    "currency": "CAD",
    "metadata": {
      "orderNumber": "ORD-1234",
      "buyerEmail": "customer@example.com"
    },
    "checkout": {
      "redirectURL": "https://yourstore.com/thank-you",
      "redirectAutomatically": true
    }
  }'

Webhook Events

InvoiceCreatedInvoice generated, awaiting payment
InvoiceProcessingPayment received, confirming on blockchain
InvoiceSettledPayment confirmed — ship the order
InvoiceExpiredCustomer didn't pay within the time window
InvoiceInvalidPayment was invalid or double-spend detected

Verify Webhook Signature

// Node.js example
const crypto = require('crypto');

function verifyWebhook(body, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(body)
    .digest('hex');
  const sig = signature.replace('sha256=', '');
  return crypto.timingSafeEqual(
    Buffer.from(expected, 'hex'),
    Buffer.from(sig, 'hex')
  );
}

Full API Reference

PayMohawk is powered by BTCPay Server's Greenfield API. For the complete API reference including all endpoints, authentication methods, and response schemas:

BTCPay Greenfield API Docs →

Environment Variables

These are the credentials you'll receive when your merchant account is set up:

# PayMohawk Configuration
BTCPAY_URL=https://btc.paymohawk.com
BTCPAY_API_KEY=your-api-key
BTCPAY_STORE_ID=your-store-id
BTCPAY_WEBHOOK_SECRET=your-webhook-secret

Need Help?

Stuck on integration? Our team will walk you through it.

Contact Support