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.

Card & Crypto Self-Custodial Instant Settlement Base Network

WooCommerce Plugin

Download the Crypt2Merchant plugin for WordPress. Requires WooCommerce 7.0+.

Download v1.1.0

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:

How It Works

1

Customer Checks Out

Your customer selects "Pay with Card or Crypto" at checkout. They're redirected to a secure payment page.

2

Customer Pays

They choose their preferred payment method: credit/debit card or direct cryptocurrency payment.

3

You Get Paid

Payment is converted to USDC and settled directly to your wallet on the Base blockchain. No intermediaries holding your funds.

Self-Custodial Funds are sent directly to your wallet. Crypt2Merchant never holds your money.

Getting Started

To start accepting payments with Crypt2Merchant:

  1. Contact us at underwriting@cardinaldelphi.com to set up your merchant account.
  2. Provide your wallet address — a Base network wallet (e.g. MetaMask, Coinbase Wallet) where you want to receive USDC settlements.
  3. Receive your API key — we'll create your account and send you a unique API key.
  4. Integrate — use our WordPress plugin or API to start accepting payments.
Wallet Requirements Your wallet must support USDC on the Base network. MetaMask, Coinbase Wallet, and most EVM-compatible wallets work. Make sure you add the Base network to your wallet.

WordPress Plugin Installation

1

Download the Plugin

Download the latest version of the Crypt2Merchant plugin using the button above, or click here.

2

Upload to WordPress

In your WordPress admin, go to Plugins → Add New → Upload Plugin. Select the downloaded .zip file and click Install Now.

3

Activate the Plugin

After installation, click Activate.

4

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.

Setting Up the Webhook

The webhook allows your WooCommerce store to automatically mark orders as paid when a customer completes payment. This step is required.

1

Log in to Crypt2Merchant

Go to pay.crypt2merchant.net and log in with the credentials provided during onboarding.

2

Navigate to Webhook Settings

Go to Settings → Project → Webhook.

3

Add Your Webhook URL

Enter the following URL, replacing yourstore.com with your actual domain:

https://yourstore.com/wp-json/crypt2merchant/v1/webhook
Important The webhook URL must use HTTPS. Make sure your WordPress site has an SSL certificate installed. The URL must be publicly accessible — it will not work with localhost or private network addresses.

Configuring Redirect URLs

After a customer completes or cancels a payment, they need to be redirected back to your store. Configure these URLs in the Crypt2Merchant dashboard.

1

Open Project Settings

Log in to pay.crypt2merchant.net and go to Settings → Projects → Project Details.

2

Set the Success Redirect URL

Enter your store's order confirmation page. For WooCommerce stores:

https://yourstore.com/checkout/order-received/
3

Set the Cancel Redirect URL

Enter the page customers should return to if they cancel payment. For WooCommerce stores, the cart page works best:

https://yourstore.com/cart/
Non-WooCommerce Sites For custom integrations, set the success URL to your order confirmation or thank-you page, and the cancel URL to your checkout or homepage.
Setup Complete! Once the plugin is configured, the webhook is set up, and the redirect URLs are configured, your WooCommerce store will automatically process payments via Crypt2Merchant.

Testing Your Integration

  1. Add a product to your cart and proceed to checkout.
  2. Select "Pay with Card or Crypto" as the payment method.
  3. Click Place Order — you'll be redirected to the payment page.
  4. Complete the payment using a card or crypto.
  5. 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.

POST https://pay.crypt2merchant.net/api/v1/payment

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:

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

Coming Soon Webhook documentation is being finalized. Webhooks will notify your server in real-time when a payment is completed, expired, or cancelled. Contact us for early access to webhook configuration.

In the meantime, you can poll for payment status using the reference ID:

GET https://pay.crypt2merchant.net/api/v1/payment/reference/{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:

Note Available card payment methods may vary by region and are determined by the onramp provider. Direct crypto payments are available on all supported networks.

Support

Need help integrating Crypt2Merchant? We're here to help.

Merchant Onboarding To get started as a merchant, email us with your business name and we'll set up your account. You'll receive your API key within 24 hours.