SH BoxCoin

🪙 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 is active
• Boxcoin PHP (self-hosted) → 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:

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
4. Optionally set your default currency (USD recommended)

💳 Payment Flow

1. Customer selects Boxcoin at checkout
2. Botble calls API with create-transaction
3. Boxcoin returns a payment URL
4. Customer completes crypto payment
5. After payment, Boxcoin:
   • Redirects customer back (/payments/boxcoin/callback)
   • Sends webhook (/payments/boxcoin/webhook) with status C
6. Order is marked as Completed

🔐 Security Notes

• Always set a Webhook Secret to prevent fake notifications
• Webhook endpoint is exempt from CSRF protection intentionally
• Non-standard currencies (like BDT) are auto-converted to USD

🐛 Troubleshooting

Author

Shakib Hossain · shakib.me