Get started

ClearGateway documentation

ClearGateway lets your website accept USDC (a dollar-pegged stablecoin) and receive it directly in your own wallet. A smart contract splits each payment in a single atomic step: your share goes to your wallet and our fee to ours. We never hold your funds.

Testnet preview

Everything runs on Base Sepolia, a test network. Test USDC has no monetary value. Live payments are not enabled yet, and live API keys are refused.

How it fits together

  • Your server calls the API with a secret API key to create a payment.
  • Your customer opens the payment's checkout link and pays.
  • ClearGateway watches the blockchain, confirms the payment and sends your server a signed webhook.
  • You fulfil the order when you receive payment_intent.succeeded. The money is already in your wallet.

Where to go next

Quickstart→

Create your first payment and receive a webhook in about ten minutes.

Payments→

How a payment moves through its statuses, and how fees are calculated.

Hosted checkout→

Send customers to a ready-made page: wallet, exchange transfer or card.

Webhooks→

Signed events for every change, with signature verification code.

Refunds→

Request and track refunds.

API reference→

Every endpoint, generated from the API itself.

Key ideas

  • Amounts are integer strings in USDC base units. USDC has 6 decimals, so "25500000" is 25.50 USDC. Never use floating-point numbers for money.
  • The blockchain is the source of truth. A payment is marked paid only after on-chain confirmation. Do not fulfil orders based on a redirect alone.
  • Every money-moving request needs an Idempotency-Key, so retries can never create duplicates.