​
On-ramp

The Meso on-ramp enables your users to quickly move funds directly from their bank account and exchange them for crypto, which is then immediately deposited into their self-custodial wallet.

The user flow is as follows:

1

Launch

In your app, the user chooses the chain, asset, and amount to buy (on-ramp).

2

Initialize transfer

Your app initializes the on-ramp transfer with Meso, triggering the iframe or webview to open.

3

Authenticate

The user signs a message with the destination wallet for the crypto asset this can be done headlessly if you are a wallet; see Authentication Strategies.

4

Sign up or login

Within the Meso iframe/webview, the user will either log in or sign up.

5

Execute a quote

The user is then presented with a final quote and prompted to click the Buy.

6

Finish the transfer

On clicking Buy, Meso processes the fiat money movement, closing the iframe/webview once the payment is confirmed.

7

Update UI with transfer status

With the user now focused back on your app, you can listen for the TRANSFER_COMPLETE event from MesoJS to confirm to the user when the crypto has been deposited to their wallet.

8

Notify user

Meso sends an email receipt directly to the user.

​
User experience

For new Meso users, after connecting and verifying their wallet, they will be led through the Meso onboarding flow.

The flow for existing users returning with the same wallet is very simple. They verify wallet ownership with a signature, enter a 2FA code sent by SMS, and complete the transfer.

​
Security & Support

Before a transfer can be initiated, two steps must always be completed:

  1. The user must verify ownership of the wallet by signing a message. For wallets or embedded wallet platforms, this can be done on the user’s behalf; see Authentication Strategies. This ensures that the destination wallet address for the funds is accurate and that the user is in possession of that wallet at the time of the transfer.
  2. The user is fully authenticated to Meso by entering a one-time code sent by SMS to their phone.

Should the user run into any issues onboarding, completing a transfer, or after a transfer has been finished, they can be directed to Meso support:

​
Off-ramp

Coming soon!

Welcome to MesoCore Concepts