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.
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