Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.unseen.finance/llms.txt

Use this file to discover all available pages before exploring further.

The package dependency is pinned; configure UnseenProvider so every hook knows your baseUrl, then mount UnseenPayButton—ideally feeding createPaymentSession wired to @unseen_fi/sdk as described under architecture.

​
UnseenProvider

Wrap any subtree that consumes Unseen hooks or components. Props (see UnseenProviderConfig):
PropPurpose
apiKeyOptional bearer key for browser-created sessions. Omit in production storefronts — use createPaymentSession instead.
baseUrlHTTP origin used for REST calls (defaults to https://unseen.finance).
import { UnseenProvider, UnseenPayButton } from "@unseen_fi/ui";

export function App() {
  return (
    <UnseenProvider baseUrl="https://unseen.finance">
      <UnseenPayButton
        amount={50_000_000}
        reference="order_123"
        description="Premium plan"
      />
    </UnseenProvider>
  );
}

​
UnseenPayButton

Opens a modal workflow: create payment → wallet picker (Phantom / Solflare / Backpack) → QR / deeplink → user confirms → polling verify loop. Important props (UnseenPayButtonProps):
PropDescription
amountAmount in smallest token units
referenceStable internal order identifier
descriptionShown during checkout creation
mint, expiresInOptional overrides
createPaymentSessionasync (input) => PaymentResult — recommended hook to server-side @unseen_fi/sdk
Callbacks onCreated, onSuccess, onError, onDismiss
Presentation: label, className, disabled

​
Server-driven session creation

<UnseenPayButton
  amount={price}
  reference={orderId}
  createPaymentSession={async (payload) => {
    const res = await fetch("/api/unseen/session", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(payload),
    });
    if (!res.ok) throw new Error("Could not create session");
    return res.json();
  }}
/>
The returned payload must expose at least { id, checkoutUrl, paymentToken?, ...fields used by callbacks }.

​
Wallet logos

Bundled picker references /wallets/phantom-logo.jpg, /wallets/solflare-logo.svg, and /wallets/backpack-logo.svg. Host copies under your app’s public/ directory or adjust asset URLs in release notes for your fork. Next: Hooks & wallets