Utilisation de la rampe d'accès autonome hébergéeBêta
La rampe d’accès autonome hébergée est une intégration front-end préconfigurée de la rampe d’accès à la cryptomonnaie hébergée sur https://crypto.link.com. Les plateformes ont la possibilité d’intégrer la rampe d’accès à la cryptomonnaie en redirigeant leurs utilisateurs vers la rampe d’accès autonome hébergée, plutôt que d’en héberger une version intégrée dans leur application.
Générer une URL de redirection | Créer une session avec une URL de redirection | |
---|---|---|
Description | Générez une URL de redirection dans le front-end sans compte Stripe. | Créez une session avec une URL de redirection dans le back-end avec un compte Stripe. |
Personnalisation | Personnalisez le montant source ou de destination suggéré, ainsi que la devise de destination et le réseau. | Permet une personnalisation complète, y compris de l’adresse du portefeuille de destination. Pour obtenir la liste exhaustive des paramètres, consultez la page Utilisation de l’API. |
Convient pour | Les plateformes qui recherchent une intégration front-end simple avec peu de personnalisation et sans adaptation à leur marque. | Les plateformes qui souhaitent personnaliser la rampe d’accès à l’image de leur marque. |
Les plateformes qui souhaitent intégrer la rampe d’accès à la cryptomonnaie à leur application peuvent intégrer la rampe d’accès.
Générer une URL de redirection
Incluez les scripts suivants à l’aide de balises de script dans l’élément <head>
de votre HTML. Ces scripts doivent toujours se charger directement depuis les domaines de Stripe, https://js.stripe.com et https://crypto-js.stripe.com, à des fins de compatibilité et de conformité PCI. Vous ne devez pas inclure le script dans un bundle ni en héberger de copie. Dans le cas contraire, votre intégration pourrait s’interrompre sans avertissement préalable.
<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>
Générez une URL de redirection à l’aide de la fonction Standalone
et transmettez les paramètres de votre choix :
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();
Nous autorisons le préremplissage des paramètres suivants :
source_currency
: monnaie fiduciaire de la transaction (usd
uniquement pour le moment).amount
: montant fixe dans la cryptomonnaie ou devise fiduciaire associée à cet achat. Spécifiez un montant fiduciaire en transmettantsource_amount
(par exemple,{source_amount: 42}
). Pour spécifier un montant de cryptomonnaie, transmettezdestination_amount
(par exemple,{destination_amount: 42}
). Vous ne pouvez indiquer qu’un seul montant.destination_currencies
: table des cryptomonnaies auxquelles vous souhaitez vous limiter (par exemple,[eth, usdc]
).destination_networks
: table des réseaux de chiffrement auxquels vous souhaitez vous limiter (par exemple,[ethereum, polygon]
).destination_network
: réseau de chiffrement par défaut pour cette rampe d’accès (par exemple,ethereum
).destination_currency
: cryptomonnaie par défaut pour cette session de rampe d’accès (par exemple,eth
).
Redirigez vos utilisateurs vers l’URL d’intégration front-end prédéfinie de la rampe d’accès à la cryptomonnaie sur la rampe d’accès autonome hébergée.
Créer une session avec une URL de redirection
Comme pour les autres intégrations, vous devez implémenter un endpoint de serveur pour créer une nouvelle session de rampe d’accès pour chaque visite de l’utilisateur. La requête de création d’une session de rampe d’accès renvoie une redirect_url
. Redirigez vos utilisateurs vers l’URL pour leur offrir une rampe d’accès à la cryptomonnaie entièrement personnalisée et aux couleurs de votre marque sur la rampe d’accès autonome hébergée.
Générez une session de rampe d’accès à la cryptomonnaie avec une redirect_url
en exécutant la commande curl suivante sur votre terminal :
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u
:sk_test_4eC39HqLyjWDarjtT1zdp7dc
Exemple de réponse :
{ "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 } }