https://github.com/coinbase/coinbase-business-whmcs
Coinbase Commerce module for WHMCS
https://github.com/coinbase/coinbase-business-whmcs
Last synced: 3 months ago
JSON representation
Coinbase Commerce module for WHMCS
- Host: GitHub
- URL: https://github.com/coinbase/coinbase-business-whmcs
- Owner: coinbase
- Created: 2018-09-11T20:23:59.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2026-01-21T02:37:15.000Z (4 months ago)
- Last Synced: 2026-01-21T13:51:51.185Z (4 months ago)
- Language: PHP
- Homepage: https://commerce.coinbase.com/integrate
- Size: 45.9 KB
- Stars: 20
- Watchers: 12
- Forks: 13
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Coinbase Business Payment Gateway for WHMCS
Accept USDC payments on Base network through Coinbase Business Payment Links.
### About
This module integrates the [Coinbase Business Payment Link API](https://docs.cdp.coinbase.com/coinbase-business/payment-link-apis/overview) with WHMCS, allowing merchants to accept cryptocurrency payments directly to their Coinbase Business account.
**Note:** This gateway accepts **USDC on Base network** only.
### Requirements
- WHMCS installation
- PHP 7.4+ with OpenSSL extension
- Coinbase Business account with CDP API access
### Installation
1. Clone this repository and run `composer install`, or download the build from the [releases page](https://github.com/coinbase/coinbase-commerce-whmcs/releases)
2. Copy the `modules` folder to the root of your WHMCS installation
3. Activate the gateway in WHMCS admin:
- Go to **Setup > Payments > Payment Gateways > All Payment Gateways**
- Click **Coinbase Business**
### Configuration
#### 1. Create CDP API Key
1. Log into the [Coinbase Developer Platform](https://portal.cdp.coinbase.com/)
2. Navigate to **API Keys** and create a new key
3. Copy the **Key Name** and **Private Key** (EC PEM format)
#### 2. Set Up Webhook
1. In the Coinbase Developer Platform, create a webhook subscription
2. Set the endpoint URL to your WHMCS callback (shown in the gateway settings)
3. Subscribe to Payment Link events
4. Copy the **Webhook Secret** from the subscription
#### 3. Configure WHMCS
In the gateway settings, enter:
| Field | Value |
|-------|-------|
| CDP API Key Name | Your API key name/identifier |
| CDP Private Key | EC Private Key in PEM format |
| Webhook Secret | Secret from webhook subscription |
### How It Works
1. Customer clicks "Pay Now" on an invoice
2. A Payment Link is created via the Coinbase API
3. Customer is redirected to the Coinbase payment page
4. Customer pays with USDC on Base network
5. Webhook notifies WHMCS when payment completes
6. Invoice is automatically marked as paid
### Support
- [Payment Link API Documentation](https://docs.cdp.coinbase.com/coinbase-business/payment-link-apis/overview)
- [Coinbase Developer Platform](https://portal.cdp.coinbase.com/)