Skip to main content
ArcenPayProvider is the root component that initializes the React SDK. Wrap your application with it to make hooks and components available.

Props

ArcenPayProvider must render on the client. In Next.js App Router, add "use client" to the file and import it from your server-rendered root layout.

useArcenPay hook

Access the provider context to get the current session and call identify():

identify() parameters

The identify() call upserts company and user records and establishes the current session. It skips the call if the wallet is already set to avoid unnecessary network requests.

Session object

Integration with wallet providers

If your app uses wagmi or RainbowKit, wrap ArcenPayProvider inside your wallet provider:

Solana wallets

When the active chain is Solana (9100000/9100001), ArcenEmbed uses the standard Solana wallet-adapter stack (Phantom, Solflare) instead of wagmi. The SDK exposes useSolanaEmbedWallet and the Solana wallet adapter; no extra provider is required.

Smart account gas sponsorship

ArcenPay supports ERC-7579 smart account flows so customers can complete on-chain actions without holding native gas tokens. When the platform configuration provides bundler and paymaster endpoints, the React SDK fetches them automatically from GET /api/v1/public/smart-account-config and wires them into the embed. No extra environment variable is required for standard integrations.

Next steps

Last modified on October 4, 2026