Using the standalone hosted onrampBeta
Learn how to use the standalone hosted onramp.
The standalone hosted onramp is a prebuilt frontend integration of the crypto onramp hosted at https://crypto.link.com. Platforms can integrate the crypto onramp by redirecting their users to the standalone hosted onramp, rather than hosting an embedded version of the onramp within their application.
Generate a redirect URL | Mint a session with a redirect URL | |
---|---|---|
Overview | Generate a redirect URL in the frontend without a Stripe account. | Mint a session with a redirect URL in the backend with a Stripe account. |
Customization | Customize the suggested source or destination amount, and the destination currency and network. | Allows full customization, including destination wallet address. For a full list of parameters, go to using the api. |
Best for | Platforms that want only want a lightweight frontend integration with light customization and no branding. | Platforms that want a fully customized onramp with branding. |
Platforms that want to embed the crypto onramp within their application can integrate the onramp.
Generate a redirect URL![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Include the following scripts using script tags within the <head>
element of your HTML. These scripts must always load directly from Stripe domains, https://js.stripe.com and https://crypto-js.stripe.com, for compatibility and PCI compliance. Don’t include the scripts in a bundle or host a copy yourself. If you do, your integration might break without warning.
<head> <title>Onramp</title> <script src="https://js.stripe.com/v3/"></script> <script src="https://crypto-js.stripe.com/crypto-onramp-outer.js"></script> </head>
Generate a redirect URL using the Standalone
function, passing in desired parameters:
const standaloneOnramp = window.StripeOnramp.Standalone({ source_currency: 'usd', amount: {source_amount: '42'}, destination_networks: ['ethereum', 'bitcoin'], destination_currencies: ['eth', 'btc'], destination_currency: 'btc', destination_network: 'bitcoin' }); const redirectUrl = standaloneOnramp.getUrl();
We allow the following parameters to be pre-populated:
source_
: The fiat currency for the transaction (currency usd
andeur
only for now).amount
: The fixed amount of fiat currency or cryptocurrency for this purchase. Specify a fiat amount by passing insource_
(for example,amount {source_
). Specify a cryptocurrency amount by passing inamount: 42} destination_
(for example,amount {destination_
). You can only specify one amount.amount: 42} destination_
: An array of cryptocurrencies you want to restrict to (for example,currencies [eth, usdc]
).destination_
: An array of crypto networks you want to restrict to (for example,networks [ethereum, polygon]
).destination_
: The default crypto network for this onramp (for example,network ethereum
).destination_
: The default cryptocurrency for this onramp session (for example,currency eth
).
Redirect your users to the URL for a prebuilt frontend integration of the crypto onramp on the standalone hosted onramp.
Mint a session with a redirect URL![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Similar to other integrations, you need to implement a server endpoint to create a new onramp session for every user visit. The onramp session creation request returns a redirect_
. Redirect your users to the URL for a fully customized and branded crypto onramp on the standalone hosted onramp.
Generate a crypto onramp session with a redirect_
by running the following curl command in your terminal:
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u
:sk_test_4eC39HqLyjWDarjtT1zdp7dc
Sample response:
{ "id": "cos_0MpKNb589O8KAxCGjmaOVF8T", "object": "crypto.onramp_session", "client_secret": "cos_0MpKNb589O8KAxCGjmaOVF8T_secret_fqV1TAdhSCFeO9FW5HnygRXca00AwEHIOu8", "created": 1679701843, "livemode": false, "redirect_url": "https://crypto.link.com?session_hash=CCwaGwoZYWNjdF8yOERUNTg5TzhLQXhDR2JMbXh5WijU7vigBjIGmyBbkqO4Oi10eFHEaFln9gFSsTGQBoQf5qRZK-A0NhiEIeH3QaCMrz-d4oYotirrAd_Bkz4", "status": "initialized", "transaction_details": { "destination_currency": null, "destination_amount": null, "destination_network": null, "fees": null, "lock_wallet_address": false, "source_currency": null, "source_amount": null, "destination_currencies": [ "btc", "eth", "sol", "usdc", "xlm" ], "destination_networks": [ "bitcoin", "ethereum", "solana", "polygon", "stellar" ], "transaction_id": null, "wallet_address": null, "wallet_addresses": null } }