Client Overview

Clients are merchants who use surstrom to accept payments. Payments are processed through the Relay network and settled on Solana.

What You Do

  1. Generate an API key from the dashboard
  2. Create payments via the POST /api/payment/init endpoint
  3. Embed the returned relay page URL in an iframe on your site
  4. Receive settlements to your Solana wallet
  5. Configure webhooks for real-time payment notifications

Revenue Flow

For each payment:

  • Customer pays $100
  • Relay takes their fee (e.g., 7%)
  • You receive the remainder: $93.00

Dashboard

Your Client dashboard shows:

  • Overview — Volume charts, status breakdown, wallet balance
  • Transactions — All your payments with status and details
  • New Payment — Quick payment creation form
  • Deposit — Wallet balance and withdrawal management
  • Reviews — Reviews from Relays about your account
  • Settings — API key, webhook URL, 2FA

Payment Flow

Payment Flowtext
Your Backend → POST /api/payment/init → Get relayPage URL + providerId
  ↓
Your Frontend → Embed relayPage in iframe → Customer pays
  ↓
Iframe → postMessage to parent → payment-success with proof token
  ↓
Your Frontend → Verify proof → Payment confirmed → Fulfill order
  ↓
Settlement (async) → USDC sent to your wallet

Webhooks run in parallel and can be used as a backup notification channel or to update your server-side database.