eCommerce Plugins

Accept crypto payments from any wallet and get paid in your local currency, crypto, or both. This page covers what an integration involves end to end: how money moves, which build path fits your team, and what to expect from kickoff to launch.

How a payment works

Whichever way you integrate, every payment follows the same five steps. Your integration is responsible for steps 1 and 4.

1. You create an invoice (your system): from your checkout via API, SDK or plugin, from the Dashboard, or by sending a Bill.
2. Customer pays: they open the invoice and pay from any supported wallet or exchange app.
3. BitPay confirms & notifies: we watch the blockchain and send a webhook to your server when the invoice status changes.
4. You fulfill (your system): ship the order, credit the balance or mark the bill paid when the status you've chosen arrives.
5. You get settled: funds land in your merchant ledger and settle to your bank or wallet in fiat, crypto or a split.

The data flow behind it

Which systems talk to each other, and in what order. Your integration makes the calls from Your system; the customer and BitPay handle the rest.

sequenceDiagram
    participant C as Customer
    participant M as Your system
    participant B as BitPay
    participant K as Your bank / wallet
    C->>M: Checks out or tops up
    M->>B: Creates invoice (API)
    B-->>M: Returns invoice URL
    M->>C: Shows the invoice
    C->>B: Pays from any wallet
    B-->>M: Webhook: status update
    M->>B: Fetches invoice to verify
    M->>C: Ships or credits balance
    B->>K: Settles funds

Invoice statuses

new → paid → confirmed → complete · or ended: expired, invalid

By default, webhooks are sent for paid, confirmed and complete. Most businesses fulfill on confirmed. You control how fast an invoice reaches it with transactionSpeed, trading speed against risk. See Invoice states and Invoice webhooks.

Choose your integration path

Four ways in, from no code to full control. Everything except the Dashboard runs on the same REST API, so you can start simple and move down this list later.

How teams put it to work

The flow is the same for everyone; the decisions along it change with what you sell and who pays you. Here's how it plays out for a few of the businesses we work with.

Planning something different? Talk to our sales team →

Your integration journey

For partner integrations, a BitPay integration manager works with you through four phases. Before kickoff, name your team: an engineering lead, a product or business owner, and someone from finance.

Quick start in sandbox

Get your first test invoice working before kickoff. Sandbox uses test networks, so no real money moves.

1. Create a sandbox account. Sign up at test.bitpay.com and generate an API token.
2. Set up a test wallet. Any wallet that supports testnet coins, so you can pay your own invoices.
3. Install an SDK and create an invoice. Point notifications at a URL your server can receive.
4. Pay it and watch the webhooks. Confirm each status arrives and your system reacts.

const client = Client.createPosClient('yourPosToken');

const invoice = new Invoice(25.0, 'USD');
invoice.orderId = 'order-1234';
invoice.notificationURL = 'https://example.com/webhooks/bitpay';
invoice.redirectURL = 'https://example.com/orders/1234';

const createdInvoice = await client.createInvoice(invoice);

// Send the customer here to pay
console.log(createdInvoice.url);

See the Node.js SDK reference for the merchant facade and the other languages.

Common questions

Ready to build?

Start in sandbox today, or talk to our integrations team about a partner integration.