Crypt2Merchant Docs
Accept card and cryptocurrency payments in your store or app. Customers pay with credit/debit cards or direct crypto. You receive instant settlement in USDC on Base.
Overview
Crypt2Merchant lets you accept payments from customers worldwide using credit/debit cards or cryptocurrency. Payments are settled instantly to your wallet in USDC on the Base blockchain.
There are two ways to integrate:
- WordPress/WooCommerce Plugin — Install our plugin, enter your API key, and start accepting payments in minutes.
- API Integration — Use our REST API to create payment links from any website, app, or platform.
How It Works
Customer Checks Out
Your customer selects "Pay with Card or Crypto" at checkout. They're redirected to a secure payment page.
Customer Pays
They choose their preferred payment method: credit/debit card or direct cryptocurrency payment.
You Get Paid
Payment is converted to USDC and settled directly to your wallet on the Base blockchain. No intermediaries holding your funds.
Getting Started
To start accepting payments with Crypt2Merchant:
- Contact us at underwriting@cardinaldelphi.com to set up your merchant account.
- Provide your wallet address — a Base network wallet (e.g. MetaMask, Coinbase Wallet) where you want to receive USDC settlements.
- Receive your API key — we'll create your account and send you a unique API key.
- Integrate — use our WordPress plugin or API to start accepting payments.
WordPress Plugin Installation
Download the Plugin
Download the latest version of the Crypt2Merchant plugin using the button above, or click here.
Upload to WordPress
In your WordPress admin, go to Plugins → Add New → Upload Plugin. Select the downloaded .zip file and click Install Now.
Activate the Plugin
After installation, click Activate.
Configure the Plugin
Go to WooCommerce → Settings → Payments. Find Crypt2Merchant and click Set up or Manage.
Configuration
| Setting | Description |
|---|---|
| Enable/Disable | Toggle the payment method on or off. |
| Title | The name shown to customers at checkout (default: "Pay with Card or Crypto"). |
| Description | Text shown below the payment method at checkout. |
| API URL | Leave as the default: https://pay.crypt2merchant.net |
| API Key | Your unique API key provided during onboarding. This links payments to your merchant account. |
Testing Your Integration
- Add a product to your cart and proceed to checkout.
- Select "Pay with Card or Crypto" as the payment method.
- Click Place Order — you'll be redirected to the payment page.
- Complete the payment using a card or crypto.
- After payment, your WooCommerce order will be marked as complete.
API Authentication
All API requests require your API key in the API-Key header.
API-Key: your_api_key_here| Header | Value | Required |
|---|---|---|
API-Key |
Your unique API key | Yes |
Content-Type |
application/json |
Yes (for POST requests) |
Create Payment
Create a payment link that you can redirect your customer to.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
customerEmail |
string | Yes | Customer's email address |
customerID |
string | Yes | Unique identifier for the customer or order (e.g. your order ID) |
amountInUSD |
number | Yes | Payment amount in US dollars |
Example Request
curl -X POST https://pay.crypt2merchant.net/api/v1/payment \
-H "API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"customerEmail": "customer@example.com",
"customerID": "order_12345",
"amountInUSD": 49.99
}'Response
{
"host": "https://pay.crypt2merchant.net:8443",
"reference_id": "c80f5363-0397-4761-aa1a-3155c3a21470",
"url": "https://pay.crypt2merchant.net/payments?reference_id=c80f5363-0397-4761-aa1a-3155c3a21470&host=https://pay.crypt2merchant.net:8443"
}| Field | Description |
|---|---|
reference_id |
Unique payment identifier. Save this to track the payment. |
url |
The payment page URL. Redirect your customer here to complete payment. |
host |
The API host (used internally by the payment page). |
Payment Page
After creating a payment, redirect your customer to the url from the response. The payment page handles everything:
- Displays available payment methods (cards, Apple Pay, Google Pay, crypto)
- Processes the payment securely
- Shows confirmation to the customer
Basic Integration Flow
// 1. Your server creates the payment
const response = await fetch('https://pay.crypt2merchant.net/api/v1/payment', {
method: 'POST',
headers: {
'API-Key': 'your_api_key_here',
'Content-Type': 'application/json',
},
body: JSON.stringify({
customerEmail: 'customer@example.com',
customerID: 'order_12345',
amountInUSD: 49.99,
}),
});
const { url, reference_id } = await response.json();
// 2. Save reference_id to your database for tracking
await saveToDatabase(orderId, reference_id);
// 3. Redirect customer to the payment page
window.location.href = url;Webhooks
In the meantime, you can poll for payment status using the reference ID:
curl https://pay.crypt2merchant.net/api/v1/payment/reference/c80f5363-0397-4761-aa1a-3155c3a21470 \
-H "API-Key: your_api_key_here"Supported Currencies & Networks
Card Payments (Fiat Onramp)
Card payments are processed through a third-party onramp provider and settled on the Base network only.
| Network | Card Payments | Direct Crypto |
|---|---|---|
| Base | Supported | Supported |
| Ethereum | — | Supported |
| Polygon | — | Supported |
| Bitcoin | — | Supported |
| Tron | — | Supported |
Settlement Currency
All payments are settled in USDC on the Base network to your merchant wallet.
Customer Payment Methods
Payment methods available depend on the onramp provider and the customer's region. Typically supported:
- Credit & debit cards (Visa, Mastercard, etc.)
- Direct cryptocurrency (USDC, ETH, BTC)
Support
Need help integrating Crypt2Merchant? We're here to help.
- Email: underwriting@cardinaldelphi.com
- Website: cardinaldelphi.com