โ€”
๐Ÿ“ก REST API ยท v3.0 ยท JSON

โ‚ฟ API

Accept Bitcoin, Ethereum, USDT and 20+ cryptocurrencies in your app or website via REST API. Simple, fast, and secure.

๐Ÿ“ Base URL: /cv/api/v1/
๐Ÿ”‘ Get API Key ๐Ÿงช Try Sandbox ๐Ÿช Setup Webhooks

๐Ÿ”‘ Authentication

Get your API key from Dashboard โ†’ API Keys โ†’ Create New Key. Include these headers on every request:

# Required on every request: Authorization: Bearer cv_live_yourapikey... X-API-Secret: yoursecretkey... Content-Type: application/json
โš ๏ธ Never expose your API Secret in frontend JavaScript or client-side code.

โšก Rate Limits

PlanRequests/minRequests/day
Free301,000
Basic10010,000
Pro500100,000
EnterpriseUnlimitedUnlimited

๐Ÿ“„ Invoices

POST /invoice.php โ€” Create Invoice

// Request body (JSON): { "order_id": "ORD-001", // Your order ID (optional) "amount": 99.99, // Amount in USD (required) "currency": "USD", // USD, EUR, GBP, INR "title": "Product Name", // Optional "customer_email": "user@email.com", // Optional "callback_url": "https://...", // Webhook URL "redirect_url": "https://...", // After payment "lifetime": 3600 // Seconds (default: 1hr) } // Response: { "success": true, "uuid": "a1b2c3d4-...", "url": "/pay.php?id=a1b2c3d4", "expires_at": "2026-03-20 15:00:00" }

GET /check-invoice.php?id=UUID โ€” Check Status

{ "success": true, "uuid": "a1b2c3d4-...", "status": "paid", // pending|paid|expired|cancelled "amount_usd": 99.99, "paid_at": "2026-03-20 14:32:00" }

๐Ÿ’ฐ Wallet Balance

GET /balance.php โ€” All wallets

GET /balance.php?coin=BTC โ€” Specific coin

{ "success": true, "total_usd": 4521.34, "wallets": [ { "coin": "BTC", "balance": "0.12345", "balance_usd": "7463.21" }, { "coin": "USDT", "balance": "500.0", "balance_usd": "500.00" } ] }

๐Ÿ“ˆ Live Prices

GET /prices.php โ€” All prices (public, no auth needed)

{ "success": true, "prices": { "BTC": { "price_usd": 60420, "change_24h": 2.4 }, "ETH": { "price_usd": 2831, "change_24h": 1.1 }, "USDT": { "price_usd": 1, "change_24h": 0.01 } } }

๐Ÿ’ธ Withdraw

POST /withdraw.php โ€” Send crypto

// Request: { "coin": "USDT", "network": "TRC20", "address": "TYour...Address", "amount": 50.00 } // Response: { "success": true, "tx_id": "abc123...", "status": "processing" }

๐Ÿช Webhooks

Setup webhooks from Dashboard โ†’ Webhooks. We send a POST request with JSON payload to your URL.

EventDescription
invoice.paidInvoice successfully paid
invoice.expiredInvoice expired without payment
withdraw.completedWithdrawal processed
withdraw.failedWithdrawal failed
// PHP webhook verification: $payload = file_get_contents('php://input'); $sig = $_SERVER['HTTP_X_CV_SIGNATURE']; $expected = hash_hmac('sha256', $payload, 'YOUR_SECRET'); if(!hash_equals($expected, $sig)) die('Invalid signature'); $data = json_decode($payload, true); if($data['event'] === 'invoice.paid'){ // Process order... }

๐Ÿ”˜ Embed Pay Button

Add a crypto payment button to any website in 2 lines of code.

<!-- Step 1: Add script once per page --> <script src="/assets/js/payment-button.js"></script> <!-- Step 2: Add button anywhere --> <button class="cv-pay-btn" data-uuid="YOUR_BUTTON_UUID" data-amount="29.99" data-currency="USD"> Pay $29.99 in Crypto </button>

๐Ÿ”Œ Platform Integrations

Install on your platform in minutes. Download the plugin and follow steps below.

๐Ÿ”ต
WordPress

Accept crypto payments on any WordPress site.

โœ… WordPress 5.0+  |  WooCommerce 4.0+  |  PHP 7.4+
โฌ‡๏ธ Download Plugin
๐Ÿ“‹ Installation Steps
  1. Download crypvox-wordpress.zip
  2. WordPress Admin โ†’ Plugins โ†’ Add New โ†’ Upload Plugin
  3. Select the zip file โ†’ Install Now โ†’ Activate
  4. Go to Settings โ†’ โ†’ Enter API Key & Secret
  5. Set Gateway URL:
๐Ÿ›’
WooCommerce

Add crypto checkout to your WooCommerce store.

โœ… WooCommerce 4.0+  |  WordPress 5.0+  |  PHP 7.4+
โฌ‡๏ธ Download Plugin
๐Ÿ“‹ Installation Steps
  1. Download crypvox-woocommerce.zip
  2. WordPress โ†’ Plugins โ†’ Upload โ†’ Activate
  3. WooCommerce โ†’ Settings โ†’ Payments โ†’ โ†’ Enable
  4. Enter API Key, API Secret, and Gateway URL
  5. Save โ†’ Test with sandbox mode first
โš™๏ธ
WHMCS

Integrate with your WHMCS hosting billing panel.

โœ… WHMCS 8.x  |  PHP 7.4+
โฌ‡๏ธ Download Module
๐Ÿ“‹ Installation Steps
  1. Download crypvox_whmcs.php
  2. Upload to /modules/gateways/ in WHMCS root
  3. WHMCS Admin โ†’ Setup โ†’ Payment Gateways โ†’ All Gateways
  4. Find โ†’ Click Activate
  5. Enter API Key, API Secret, Gateway URL โ†’ Save
๐ŸŸ 
OpenCart

Accept crypto on your OpenCart store.

โœ… OpenCart 3.x / 4.x  |  PHP 7.4+
โฌ‡๏ธ Download Extension
๐Ÿ“‹ Installation Steps
  1. Download crypvox-opencart.ocmod.zip
  2. OpenCart Admin โ†’ Extensions โ†’ Installer โ†’ Upload
  3. Extensions โ†’ Extensions โ†’ Payments โ†’ โ†’ Install
  4. Click Edit โ†’ Enter API Key, Secret, Gateway URL
  5. Set Status โ†’ Enabled โ†’ Save
๐ŸŸฃ
PrestaShop

Crypto payments for your PrestaShop store.

โœ… PrestaShop 1.7.x / 8.x  |  PHP 7.4+
โฌ‡๏ธ Download Module
๐Ÿ“‹ Installation Steps
  1. Download crypvox-prestashop.zip
  2. PrestaShop Admin โ†’ Modules โ†’ Module Manager โ†’ Upload
  3. Find โ†’ Install โ†’ Configure
  4. Enter API Key, API Secret, Gateway URL
  5. Enable โ†’ Save โ†’ Test payment
๐ŸŸข
Shopify

Add crypto checkout to your Shopify store.

โœ… Shopify Basic / Shopify / Advanced  |  Manual setup
โฌ‡๏ธ Download App
๐Ÿ“‹ Installation Steps
  1. Download the Shopify app package
  2. Shopify Admin โ†’ Settings โ†’ Payments โ†’ Add Payment Method
  3. Search for or install manually
  4. Enter API Key, API Secret from your dashboard
  5. Enable โ†’ Save โ†’ Test with a test order

โŒ Error Codes

CodeMeaningSolution
200Successโ€”
400Bad RequestCheck required parameters
401UnauthorizedCheck API key & secret
403ForbiddenIP not whitelisted or insufficient permissions
404Not FoundCheck endpoint URL
429Rate LimitedSlow down requests or upgrade plan
500Server ErrorContact support

๐Ÿ“ฆ SDKs & Libraries

๐Ÿงช Sandbox / Testing

โœ… Use sandbox mode to test without real payments. Enable it from Dashboard โ†’ Sandbox.
Test API Keycv_test_sandbox_key
Sandbox Base URL/cv/sandbox/v1/
Test CardsNo cards needed โ€” all payments auto-approve in sandbox