Boxcoin Crypto Payment

🪙 Boxcoin Crypto Payment — Botble CMS Plugin

Accept Bitcoin, Ethereum, Dogecoin, USDT, and 100+ cryptocurrencies on your Botble CMS store using a self-hosted Boxcoin installation. Completely decentralized — no KYC, no fees, full control.

📋 Requirements

• Botble CMS v7.3.0+
• Botble Payment plugin active
• Boxcoin PHP (self-hosted — you own this) → boxcoin.dev
• A working Boxcoin installation on a publicly accessible URL

🚀 Installation

1. Upload the Plugin

Copy the sh-boxcoin folder to your Botble CMS server:

/platform/plugins/sh-boxcoin/

2. Activate the Plugin

1. Log into Botble Admin Panel
2. Go to Plugins in the sidebar
3. Find Boxcoin Crypto Payment → click Activate

⚙️ Configuration

Step 1 — Botble Admin Panel

Go to Settings → Payment → Boxcoin and fill in:

Click Update and toggle the method Active.

Step 2 — Boxcoin Admin Panel

In your Boxcoin installation (https://your-domain.com/admin.php):

1. Settings → Webhook URL → set it to:

   https://your-botble-site.com/payments/boxcoin/webhook
   

2. Settings → Webhook Secret → set a secret password (same as above)
3. Accepted Cryptocurrencies → enable the coins you want to accept
4. Optionally set your default currency (USD is safest for max compatibility)

💳 Payment Flow

1. Customer selects Boxcoin at checkout
2. Botble calls POST your-boxcoin-domain.com/boxcoin/api.php with create-transaction
3. Boxcoin returns a payment URL (e.g. pay.php?id=ENCRYPTED_TX)
4. Customer is redirected to the Boxcoin payment page to choose a crypto and pay
5. After payment, Boxcoin:
   • Redirects customer back to your site (/payments/boxcoin/callback)
   • Fires a webhook to your site (/payments/boxcoin/webhook) with status C
6. Order is marked as Completed automatically

🔐 Security Notes

• Always set a Webhook Secret — prevents fake payment notifications
• Webhook endpoint (/payments/boxcoin/webhook) is intentionally exempt from CSRF protection
• BDT and other non-standard currencies are auto-converted to USD before sending to Boxcoin

🐛 Troubleshooting

Author: Shakib Hossain · shakib.me