CoinSub for WooCommerce

Accept cryptocurrency payments in your WooCommerce store.

🚀 Quick Start

Installation

1. Download coinsub-commerce.zip
2. Go to WordPress Admin → Plugins → Add New → Upload Plugin
3. Upload the zip file and activate
4. Go to WooCommerce → Settings → Payments → CoinSub
5. Enter your Merchant ID and API Key
6. Copy the Webhook URL to your CoinSub dashboard
7. Enable the payment method

Done! ✅

⚙️ Configuration

Required Settings:

• Merchant ID - From your CoinSub dashboard
• API Key - From your CoinSub dashboard
• Webhook URL - Auto-generated, copy to CoinSub dashboard

Optional:

• Test Mode - Use dev API for testing
• Title - What customers see at checkout (default: "CoinSub")
• Description - Payment method description

💰 How It Works

Customer Flow:

1. Customer adds products to cart
2. Proceeds to checkout
3. Selects "CoinSub" payment method
4. Clicks "Place Order"
5. Redirected to crypto checkout page
6. Pays with crypto wallet
7. Payment confirmed automatically

Merchant Flow:

1. Receive "Payment Complete" notification
2. See order in WooCommerce admin
3. View transaction hash on blockchain
4. Ship the order
5. Mark as completed

📊 What Gets Paid in Crypto

Total amount includes:

• ✅ Product prices
• ✅ Shipping costs
• ✅ Taxes

Customer pays the full total in cryptocurrency.

Example:

Products:  $100.00
Shipping:  $15.00
Tax:       $8.25
─────────────────
TOTAL:     $123.25  ← Customer pays this in crypto

🔔 Webhooks

The plugin automatically receives payment confirmations from CoinSub.

Webhook URL: https://yoursite.com/wp-json/coinsub/v1/webhook

Events handled:

• payment - Payment successful → Order status: "Processing"
• failed_payment - Payment failed → Order status: "Failed"
• cancellation - Customer cancelled → Order status: "Cancelled"

When payment succeeds:

• Order status changes to "Processing"
• Transaction hash stored in order meta
• You and customer receive email notifications
• You can now ship the order

📦 Shipping

Shipping is calculated by WooCommerce:

• Use WooCommerce's built-in shipping zones
• Or install USPS/FedEx/UPS plugins
• Or use flat rate shipping
• Or use ShipStation/Shippo

The CoinSub plugin just reads the shipping cost and includes it in the crypto payment.

🧪 Testing

Test Without WordPress:

php test-complete-order.php

This creates a test order with products, shipping, and tax.

Test With WordPress:

1. Create a test product
2. Add to cart
3. Checkout with CoinSub
4. Use test crypto wallet
5. Verify webhook updates order

📁 File Structure

coinsub-commerce/
├── coinsub-commerce.php                    ← Main plugin file
├── includes/
│   ├── class-coinsub-api-client.php        ← API communication
│   ├── class-coinsub-payment-gateway.php   ← Payment logic
│   ├── class-coinsub-webhook-handler.php   ← Webhook receiver
│   └── class-coinsub-order-manager.php     ← Admin UI
├── test-complete-order.php                 ← Test script
└── README.md                               ← This file

See QUICK-REFERENCE.md for technical details.

🔧 Troubleshooting

Order not updating after payment?

• Check webhook URL is correct in CoinSub dashboard
• Check WordPress error logs

Checkout URL not opening?

• Disable popup blocker
• Check browser console for errors

Wrong shipping/tax amount?

• Check WooCommerce tax settings
• Check WooCommerce shipping zones

Products not syncing?

• Check API credentials
• Check merchant ID matches

🆘 Support

• Documentation: QUICK-REFERENCE.md
• Test Script: test-complete-order.php
• Logs: WordPress → Tools → Site Health → Info → Server

📝 Requirements

• WordPress 5.0+
• WooCommerce 5.0+
• PHP 7.4+
• SSL certificate (HTTPS)
• CoinSub merchant account

🎯 What This Plugin Does

IN:

• Reads WooCommerce order data (products, shipping, tax)
• Creates CoinSub checkout session
• Generates crypto payment URL

OUT:

• Receives webhook when payment succeeds
• Updates WooCommerce order status
• Stores transaction hash

That's it! Simple payments plugin. WooCommerce handles everything else (cart, shipping, taxes, inventory, emails).

Version: 1.0.0
Last Updated: October 2025