Crypto Payments

Overview

Crypto payments accept major stablecoins (USDC and USDT) across multiple EVM blockchains through hosted checkout. After creating a payment via API, redirect the customer to payment_url. On the checkout page the customer picks a network and token, then sees a unique deposit address (with a QR code); they send the stablecoin to it, and the payment completes automatically once the deposit is confirmed on-chain.

Each payment gets its own single-use deposit address for the selected network. Amounts are priced in USD and paid 1:1 in the chosen stablecoin — e.g. a $10.50 payment is settled as 10.50 USDC or 10.50 USDT. There is no exchange-rate conversion.

Supported Networks

The customer selects one of the following at checkout. The exact networks and tokens available for your account are always shown on the checkout page.

Network	Tokens
Base	USDC, USDT
Ethereum	USDC, USDT
Polygon	USDC, USDT
BNB Smart Chain	USDC, USDT

Payment Flow

Create Payment

Call POST /v1/payments (with currency: "usd") to create a payment and obtain payment_url

Redirect Customer

Redirect customer to payment_url

Select Network & Token

On the checkout page the customer picks a network (e.g. Base) and a token (USDC or USDT); a deposit address for that selection is then shown

Customer Sends Stablecoin

The customer sends the stablecoin to the deposit address shown on the checkout page

On-chain Confirmation

The deposit is detected and confirmed on-chain (usually within a minute)

Completion

The payment status becomes succeeded, a webhook is delivered, and the customer is redirected back to your site

Implementation Example

// 1. Create payment via API (crypto is priced in USD)
const response = await fetch('https://api.sandbox.zafapay.com/v1/payments', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 100,
    currency: 'usd',
    external_id: 'order_12345'
  })
});

const payment = await response.json();

// 2. Redirect customer to the hosted checkout page (network/token selection + deposit address + QR)
window.location.href = payment.payment_url;

The network and token are chosen by the customer on the checkout page — you do not pass a chain or token in the API request. Your integration (create payment → redirect to payment_url) is the same regardless of how many networks are enabled.

Routing to the crypto flow

Crypto is served through a payment flow assigned to your account. If crypto is your default flow, no extra parameter is needed. If you accept multiple payment methods, pass flow_id for your crypto flow to route the payment to crypto:

{
  "amount": 100,
  "currency": "usd",
  "flow_id": "flow_xxxxxxxx"
}

Redirect URLs

Once the deposit settles, the customer is sent back to your site. Pass success_url, failure_url, or cancel_url when creating the payment to override your dashboard defaults for that payment — useful when several forms or products share one account. See Redirect URLs for the full behavior.

Webhook Integration

Because the customer pays on-chain, the payment completes asynchronously. Use webhooks to confirm the result reliably:

// Webhook handler
app.post('/webhooks/zafapay', async (req, res) => {
  const { event, external_id } = req.body;

  if (event === 'payment.succeeded') {
    // Update order status
    await updateOrder(external_id, 'paid');
  }

  res.json({ received: true });
});

If a customer sends less than the requested amount, the payment does not succeed. The deposit is automatically returned to the recovery address and the payment is marked canceled (a payment.canceled webhook is delivered). Contact support if you need to reconcile a partial deposit.

For complete API parameters and response details, see the Create Payment API reference.

Getting Started

Dashboard

Integration

Overview

Supported Networks

Payment Flow

Implementation Example

Routing to the crypto flow

Redirect URLs

Webhook Integration

​Overview

​Supported Networks

​Payment Flow

​Implementation Example

​Routing to the crypto flow

​Redirect URLs

​Webhook Integration

Overview

Supported Networks

Payment Flow

Implementation Example

Routing to the crypto flow

Redirect URLs

Webhook Integration