Get started

Testing

Testnet only

Everything runs on Base Sepolia (chain id 84532). Test USDC and test ETH have no value. Live API keys (sk_live_…) are refused with live_mode_disabled.

What you need

  • A test API key (sk_test_…) from ClearGateway staff.
  • A browser wallet (for example MetaMask or Coinbase Wallet) on Base Sepolia. Add the network if your wallet does not list it.
  • Test USDC in that wallet, from a public Base Sepolia USDC test faucet, and a little test ETH for network fees.

A full test run

  1. Create a payment for a small amount, such as "1000000" (1 USDC).
  2. Open its checkout_url. On the Wallet tab connect, approve USDC, then confirm the payment.
  3. Watch the payment go awaiting_payment → confirming → succeeded in the dashboard or with GET /v1/payment_intents/{id}.
  4. Confirm your webhook endpoint received payment_intent.succeeded and that your signature check passed.
  5. Try the Exchange / transfer tab: send the exact amount of test USDC to the deposit address shown.

Things worth testing

  • Retry the same create request with the same Idempotency-Key: you should get the same payment back.
  • Let a payment expire, and cancel one, to see your handling of expired and canceled.
  • Send a webhook test from the dashboard, and check that a tampered body is rejected by your verification code.
  • Make your webhook endpoint return an error once and watch the retry arrive with a higher ClearGateway-Delivery-Attempt.

Card payments

The card option in checkout is not live yet, so you cannot test it end to end.