API Documentation

Flow

Step 1 — Create session

const res = await fetch('https://api.payzap.cc/v1/payments/session', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    productId: 'prod_abc123',
    chain: 'evm',
    asset: 'USDT',
    network: 'base',          // optional: specific EVM network
    amount: 49.00,             // optional: override product price
    customerRef: 'order_789',  // optional: your internal reference
  }),
});

const { data: session } = await res.json();
// session.id              — session ID (for polling)
// session.merchantWallet  — send tokens here
// session.amount          — amount to send (string, e.g. "49.00")
// session.asset           — token symbol (e.g. "USDT")
// session.expiresAt       — session expires (30 min)

Step 2 — Send tokens (EVM example with viem)

import { parseUnits } from 'viem';

// ERC-20 transfer to merchant wallet
const tx = await walletClient.writeContract({
  address: USDT_CONTRACT,       // token contract on chosen network
  abi: [{
    name: 'transfer',
    type: 'function',
    inputs: [
      { name: 'to', type: 'address' },
      { name: 'amount', type: 'uint256' },
    ],
    outputs: [{ type: 'bool' }],
  }],
  functionName: 'transfer',
  args: [
    session.merchantWallet,
    parseUnits(session.amount, 6),  // 6 decimals for USDT/USDC
  ],
});

Step 3 — Poll for confirmation

async function waitForPayment(sessionId) {
  while (true) {
    const res = await fetch(
      `https://api.payzap.cc/v1/payments/session/${sessionId}`
    );
    const { data } = await res.json();

    if (data.status === 'completed') {
      return { txHash: data.txHash, explorerUrl: data.txExplorerUrl };
    }
    if (data.status === 'expired' || data.status === 'failed') {
      throw new Error(`Payment ${data.status}`);
    }

    await new Promise(r => setTimeout(r, 3000)); // poll every 3s
  }
}

Session statuses