Paybis On/Off Ramp solution provides flexible integration options tailored to your application's capabilities and desired user journey. Among them are options perfectly suited for decentralized web3 apps, allowing complete integration without a backend.

Backend integration options

In terms of backend usage, Paybis supports the following three integration types:

No-Backend Integration

Swift and straightforward, this option involves redirecting users to a URL with extra query parameters. However, it comes with a limitation – it allows passing limited transaction information to the widget and lacks support for certain add-ons.

Server-to-Server API with Private Key

Please make sure to elevate your security game with this option. Integration occurs server-to-server with a private key, unlocking all available add-ons (shared KYC, single sign-on, etc.). While it ensures the highest level of security, the trade-off is a slightly more intricate implementation process.

Key functionality offered by Paybis API

get a Quote for the supplied amount and fiat/cryptocurrency pair for all or specific payment/payout method
get the list of supported fiat/cryptocurrency pairs enabled for your partner account
get the list of supported payment and payout methods with transaction amount limits
pass the extra transaction and customer data in the session Request used to initialize the widget front to customize the user journey
pass the extra customer data to apply add-ons: KYC reliance (Shared KYC), Single Sign-On.

Backend integration options comparison

Integration type	Integration process	Supported add-ons and flows	Compatible frontend options
API integration (server-to-server)	1. Get a private API key from Paybis (sandbox and production). 2 Build integration using the necessary server-to-server endpoints with a private API key. 2. Obtain `requestId` required to initialize widget. 3. Initialize the widget from your app.	- Single Sign-On - Shared KYC - Customer and transaction data transfer available (quote, payment method, email, wallet) - One-click checkout	- Web js SDK - Mobile native iOS SDK - Mobile native Android SDK - Widget UI by direct URL with `requestId`
API-less integration (direct URL)	1. Get a unique `partnerId` from Paybis (sandbox and production). 2. Generate a direct URL with partnerId and optional extra query parameters. 3. Open the direct URL from your app.	- Limited customer and transaction data transfer available (amount, currency pair, wallet) - One-click checkout not supported	Widget UI by direct URL with `partnerId`

Frontend integration options

Frontend SDKs

Web JavaScript SDK

This option is suitable for web applications and provides seamless functionality within the browser environment.
It's platform-independent, easy to deploy, and straightforward. All new feature enhancements for the On/Off Ramp are seamlessly deployed to the SDK without requiring any modifications in the integration on your end.

Native iOS SDK

Tailored for iOS applications, the Native iOS SDK provides a robust and native integration for a smooth user experience on Apple devices and access to iOS-specific features. Note that upgrading to the latest SDK version is necessary whenever new functionality is released by Paybis.

Native Android SDK

Designed for Android applications, ensures optimal performance and seamless user experience on Android devices. Note that upgrading to the latest SDK version is necessary whenever new functionality is released by Paybis.

Frontend integration modes

iFrame fullscreen overlay

By default, the JavaScript SDK opens the On/Off Ramp UI in a full-screen overlay within an iframe. Please note that Apple Pay functionality is not supported within an iframe. To enhance the user experience for iOS/MacOS users, we've introduced the smart detectAndOpen method. This method identifies the user's browser and, if Apple Pay is available, opens the On/Off Ramp in a new browser tab rather than an iframe.

Alternatively, you have the option to create your iframe and open the On/Off Ramp UI using the direct link with the necessary query parameters.

Redirect

To redirect the user to the On/Off Ramp within the same browser tab, use the openRedirect JS SDK method or incorporate the redirect logic directly into your application when employing direct URL integration.

New browser tab

To open On/Off Ramp in a new browser tab, use the openInNewTabJS SDK method or or directly open the direct URL in a new tab from within your application.

Embedded mode

Embedded mode allows to seamlessly integrate Paybis widget directly into webpage layout, providing a more integrated and customizable user experience.