TokenCashFlow Docs

Appearance

Quickstart Guide ​

Get your first crypto payment running in under 10 minutes.

What you can do with TokenCashFlow ​

TokenCashFlow is a multi-chain crypto payment service provider. With a single API integration you can accept any supported cryptocurrency from your customers, automatically convert it to USDT if desired, and receive real-time webhook notifications on every payment event — all without touching a blockchain yourself.

Prerequisites ​

  • A registered TokenCashFlow merchant account with at least Basic KYC approved
  • An API key (see Step 1)
  • A public HTTPS URL to receive webhooks (optional for testing)

Step 1 — Create an API key ​

  1. Log in to the TokenCashFlow Client Portal
  2. Navigate to Dashboard → API Keys
  3. Click New API Key, enter a label (e.g. production-server), and click Create
  4. Copy the full key immediately — it is shown only once

Your key format: tcf_live_ followed by 32 random characters (total ~44 chars).

Step 2 — Create your first payment ​

Send a POST request to /v1/payments with your API key:

bash
curl -X POST https://api.tokencashflow.com/v1/payments \
  -H "X-API-Key: tcf_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_usd": 50.00,
    "description": "Order #1001",
    "redirect_url": "https://yourstore.com/thank-you"
  }'

Response:

json
{
  "success": true,
  "data": {
    "payment_id": "9f1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "status": "AWAITING_SELECTION",
    "amount_usd": "50.00",
    "pay_url": "https://app.tokencashflow.com/pay/9f1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "expires_at": "2026-05-16T13:00:00Z",
    "created_at": "2026-05-16T12:00:00Z"
  },
  "error": null
}

The pay_url is the payment page your customer visits.

Redirect your customer to the pay_url from Step 2. TokenCashFlow handles everything on that page:

  • Crypto selector (only cryptos you've enabled for your account)
  • Live exchange rate display (refreshed every 10 seconds)
  • Rate lock when customer confirms
  • QR code and wallet address display
  • Real-time payment status updates
  • Automatic redirect to your redirect_url after payment completes

Step 4 — Receive the webhook ​

When the payment reaches COMPLETED status, TokenCashFlow sends an HTTP POST to your configured webhook URL:

json
{
  "event": "payment.completed",
  "timestamp": "2026-05-16T12:05:00Z",
  "data": {
    "payment_id": "9f1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "status": "COMPLETED",
    "amount_usd": 50.00,
    "net_amount_usd": 48.50,
    "received_crypto": "0.025000000",
    "crypto_symbol": "ETH",
    "chain": "ethereum",
    "locked_rate": 2000.00
  }
}

Always verify the signature on every webhook. See the Signature Verification guide.

Next steps ​

TokenCashFlow Documentation