CryptoixCryptoix

How to Integrate Crypto Payments into Your E-Commerce Store

Mar 20, 2026 09:00

How to Integrate Crypto Payments into Your E-Commerce Store

Adding cryptocurrency payment options to your online store has never been easier. Whether you're running WooCommerce, Shopify, OpenCart, PrestaShop, Magento, or a custom-built platform, this guide walks you through the entire integration process.

Before You Begin

You'll need:

  1. A CryptoIX account — Sign up for free
  2. An API Gateway created in your dashboard
  3. Your API Key (starts with sk_) and Secret Key
  4. Your store's callback URL for receiving payment notifications

Method 1: Plugin Installation (Recommended)

The fastest way to accept crypto payments is using our pre-built plugins. No coding required.

WooCommerce (WordPress)

1. Download the CryptoIX WooCommerce plugin from /plugins

    

  1. Go to WordPress Admin → Plugins → Add New → Upload Plugin
    2. 

  2. Upload and activate the plugin
    3. 

  3. Navigate to WooCommerce → Settings → Payments → CryptoIX
    4. 

  4. Enter your API Key and configure settings
    5. 


6. Save and test with a small payment

Shopify

1. Download the CryptoIX Shopify integration

    

  1. Install Node.js dependencies: npm install
    2. 

  2. Configure environment variables with your API credentials
    3. 

  3. Deploy to your preferred hosting (Heroku, Vercel, etc.)
    4. 


5. Add as a custom payment method in Shopify admin

OpenCart

1. Download and extract the OpenCart extension

    

  1. Upload the contents to your OpenCart root directory
    2. 

  2. Go to Admin → Extensions → Payments → CryptoIX
    3. 

  3. Enable and configure with your API credentials
    4. 


5. Set the sort order and geo zone

All plugins are available on our Plugins page.

Method 2: Custom API Integration

For custom-built stores or platforms not covered by our plugins, use the CryptoIX REST API directly.

Creating a Payment

curl -X POST https://cryptoix.io/api/v1/payment/create \

  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_your_api_key_here" \
  -d '{
    "amount": 49.99,
    "currency_id": 1,
    "order_id": "ORD-12345",
    "customer_email": "[email protected]",
    "callback_url": "https://yourstore.com/webhook/cryptoix",
    "return_url": "https://yourstore.com/order/success"

  }'

The API returns a payment_url — redirect your customer to this URL to complete the payment.

Handling Webhooks

When a payment is completed, CryptoIX sends a webhook to your callback_url:

{

  "uuid": "pay_abc123...",
  "status": "completed",
  "merchant_order_id": "ORD-12345",
  "amount_fiat": 49.99,
  "amount_crypto": 0.00125,
  "currency": "BTC",
  "tx_hash": "0xabc...",
  "paid_at": "2026-04-19T10:30:00Z"

}

Always verify the webhook signature using the X-Gateway-Signature header with HMAC-SHA256.

Testing Your Integration

Before going live:

  1. Create a test payment with a small amount
  2. Verify the payment flow — from checkout to blockchain confirmation
  3. Check webhook delivery — ensure your callback URL receives and processes notifications correctly
  4. Test error scenarios — expired payments, network issues, etc.

Best Practices

  • Always validate webhook signatures — Never trust unverified webhook data
  • Store transaction references — Save the payment UUID and transaction hash for reconciliation
  • Handle payment expiration — Crypto payments have a time window; handle expired payments gracefully
  • Display clear instructions — Show the customer the exact amount, wallet address, and time remaining
  • Enable logging — Keep logs of all payment events for debugging and auditing

Ready to start? Download our plugins or read the API documentation for custom integration.

← Back to Blog