SDKs - Ionic Docs

Use the server SDK for API requests and a browser SDK when customers pay on your website. Secret keys stay on your server.

Package	Runs on	Use it for	npm
`@ionicfi/sdk`	Your server	Payments, customers, saved cards, Connect requests, and webhook verification	@ionicfi/sdk
`@ionicfi/js`	Your customer’s browser	Ionic Blocks and embedded checkout	@ionicfi/js
`@ionicfi/react`	Your React frontend	Embedded checkout with `<CheckoutEmbed>`	@ionicfi/react

Install

Install each package with npm, which is included with Node.js. The server SDK requires Node 18 or later.

npm install @ionicfi/sdk

npm install @ionicfi/js

npm install @ionicfi/react

Choose your integration

Hosted checkout: the server SDK creates a session; redirect the customer to its URL.
Your own payment form: the server SDK creates a PaymentIntent; the browser SDK mounts a Payment Block.
Embedded checkout in React: the server SDK creates a session; @ionicfi/react renders it.
Payments for connected accounts: the server SDK and Blocks, with the merchant’s account option. See How Connect works.

Every server operation also has an HTTP API for other languages. The API reference includes request and response details. The browser packages load Ionic.js from Ionic’s CDN at runtime, so updates to the payment components reach your integration without a redeploy. For an existing integration, see SDK upgrades.