guide

Quick Start

Get your first cryptocurrency payment in under 5 minutes.

Updated: 3/9/2026

Get your first cryptocurrency payment in under 5 minutes.

Prerequisites

  • A QuantaPay account at cloud.quantapay.app
  • At least one cryptocurrency wallet address (e.g., a Bitcoin or Ethereum address)

Step 1: Sign Up and Log In

  1. Go to cloud.quantapay.app and create your account.
  2. After logging in, you'll see the Hub dashboard — your central command center for managing payments.
Hub dashboard overview - Transaction list
Hub dashboard overview - Transaction list

Step 2: Add Your Wallet Addresses

Navigate to Settings → Payments. You'll see the Cryptocurrency Addresses section at the top.

Enter the wallet addresses where you want to receive payments. Only cryptocurrencies with a configured address will appear as payment options for your customers.

Most common setup:

  • Bitcoin (BTC)bc1... or 1... or 3... format
  • USDT (TRC-20)T... format (low fees, popular for stablecoin payments)
  • Ethereum (ETH)0x... format
Cryptocurrency address configuration
Cryptocurrency address configuration

You can add more cryptocurrencies later. See Cryptocurrency Addresses for the full list.

Still in Settings → Payments, scroll down to the Webhook section.

  1. Enter your Webhook URL — this is the endpoint on your server that will receive payment notifications.
  2. A Webhook Secret Key is auto-generated. Keep this safe — you'll use it to verify incoming webhooks by checking the key field in the JSON payload.
Webhook URL: https://yoursite.com/webhook/quantapay
Webhook Secret: (auto-generated alphanumeric string)

Without a webhook, you can still check payment status via the API, but webhooks provide real-time notifications.

Step 4: Get Your API Key

Go to Settings → Account. Your API Key is displayed here. Copy it — you'll need it for all API calls.

Developer Tools - API Key and Webhook Secret
Developer Tools - API Key and Webhook Secret

Step 5: Create Your First Payment

Make a simple API call to create a checkout session:

curl -X POST https://cloud.quantapay.app/api.php \
  -d "function=create-checkout-session" \
  -d "api-key=YOUR_API_KEY" \
  -d "price=10.00" \
  -d "currency=USD"

Response:

{
  "success": true,
  "response": {
    "session_id": "cs_a1b2c3d4e5f6a1b2c3d4",
    "payment_url": "https://cloud.quantapay.app/pay.php?session=cs_a1b2c3d4e5f6a1b2c3d4",
    "expires_at": "2026-03-08T11:00:00+00:00"
  }
}

Redirect your customer to the payment_url. They will:

  1. See the available cryptocurrencies
  2. Select their preferred coin
  3. Scan the QR code or copy the address
  4. Send the payment
  5. Wait for blockchain confirmation
Customer payment page - Select cryptocurrency
Customer payment page - Select cryptocurrency

Step 6: Receive Payment Notification

When the payment is confirmed on the blockchain, QuantaPay will:

  1. Send a webhook to your configured URL (if set up)
  2. Update the transaction status in your dashboard
  3. Redirect the customer to your success URL (if configured)

You can also check the status programmatically:

curl -X POST https://cloud.quantapay.app/api.php \
  -d "function=get-checkout-session" \
  -d "api-key=YOUR_API_KEY" \
  -d "session_id=cs_a1b2c3d4e5f6a1b2c3d4"

What's Next?

  • [Cryptocurrency Addresses](/docs/getting-started/payment-settings/cryptocurrency-addresses/) — Add more coins
  • [Webhook Configuration](../02-payment-settings/02-webhook-configuration.md) — Set up payment notifications
  • [API Reference: Transactions](..//docs/api-reference/transactions-api/) — Full API documentation
  • [WordPress / WooCommerce](..//docs/integrations/wordpress-plugin/) — Use our WordPress plugin

How It Works: Non-Custodial Model

QuantaPay is non-custodial — we never hold your funds. When a customer pays:

  1. The customer sends cryptocurrency directly to your wallet address
  2. QuantaPay monitors the blockchain for the incoming transaction
  3. Once confirmed, QuantaPay notifies you via webhook

Your funds go straight to your wallet. No intermediaries, no withdrawal delays.