Docs
Search…
⌃K
Links

Embedded

Overview

The easiest way to get started with Ratio is through our embedded experience. This can be deployed anywhere you can embed HTML, such as an iframe or a mobile web view. All you need to get started is a Client ID and a signing wallet.

Wallet Signing

The first step to integrating our embedded partner flow is to have the user sign in with their crypto wallet, this allows a user to use their wallet as a primary and familiar means of authentication with Ratio, regardless of from where they access it.
If you want to provide a different deposit address to be used in the embed than the one used for the signing transaction, you can set that here.
For more information on the APIs themselves, look at our partner auth endpoints:

Bridge to Embed

Once you have called the authenticate endpoint and have received a URL, you'll note it has a unique session ID in the path. That is a securely generated unique URL for that user's session, you may embed and navigate to that URL to allow the user to continue to use Ratio, completing the bridging between your native experience and Ratio's embedded flow.
The user will have to provide a second authentication factor to ensure their security within the Ratio embed.

Example