Skip to main content
After Quickstart, every component here should correspond to something you touched. This page freezes the vocabulary—browser, your backend, Unseen gateway, Solana—used in later sections (Environments, Lifecycle, SDK pages).

​
Components

LayerRole
Browser (@unseen_fi/ui)Checkout modal, wallet deeplinks/QR, verification polling. May call your backend to create sessions or the public verify endpoint when given paymentToken.
Your backendHolds the API key; creates/cancels/lists payments; fulfills orders; verifies webhooks. Uses @unseen_fi/sdk.
Unseen APIPayment sessions, merchant profile, verify endpoints, webhook delivery.
SolanaOn-chain settlement; verify checks transaction state.

​
Security boundaries

  • Never expose usk_live_* in client bundles. Use createPaymentSession from the UI to hit your own API.
  • Webhook bodies must be verified with HMAC before trusting payment.confirmed-style events (@unseen_fi/sdk → unseen.webhooks.verify).

​
UI package API paths

The UI uses your provider baseUrl and appends paths such as:
  • POST /api/v1/payments (when creating from the browser with apiKey)
  • POST /api/v1/payments/:id/verify (merchant verify, Bearer)
  • POST /api/public/payments/:id/verify (checkout verify, x-unseen-payment-token)
See Hooks and wallets for details. Next: Environments