Configurer une intégration de rampe d'accèsBêta
Pour intégrer le SDK de la rampe d’accès :
- Installez le SDK et la bibliothèque client.
- Générez une session de rampe d’accès à la cryptomonnaie sur votre back-end.
- Affichez l’interface utilisateur de la rampe d’accès sur votre site Web.
- Consulter l’utilisation de votre intégration dans le Dashboard Stripe.
Installer le SDK et la bibliothèque clientcôté clientcôté serveur
Côté client
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>
Utiliser le SDK Onramp JS en tant que module
Utilisez le package npm pour charger le SDK Onramp JS en tant que module ES. Le package inclut des définitions de type Typescript.
npm install --save @stripe/stripe-js @stripe/crypto
Côté serveur
Nos bibliothèques officielles ne prennent pas en charge les endpoints de l’API de manière intégrée, car l’API de la rampe d’accès est actuellement en version bêta limitée. Par conséquent, nos exemples utilisent curl pour les interactions avec le back-end.
Générer une session de rampe d'accès à la cryptomonnaiecôté serveur
Générez une session de rampe d’accès à la cryptomonnaie en exécutant la commande curl suivante sur votre terminal :
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u
: \ # this secret key is from step 1sk_test_4eC39HqLyjWDarjtT1zdp7dc
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u
: \ -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" # add as many parameters as you'd likesk_test_4eC39HqLyjWDarjtT1zdp7dc
Exemple de réponse :
{ "id": "cos_0MYfrA589O8KAxCGEDdIVYy3", "object": "crypto.onramp_session", "client_secret": "cos_0MYfrA589O8KAxCGEDdIVYy3_secret_rnpnWaxQbYQOvp6nVMvEeczx300NRU4hErZ", "created": 1675732824, "livemode": false, "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" ], "destination_networks": [ "bitcoin", "ethereum", "solana" ], "transaction_id": null, "wallet_address": null, "wallet_addresses": { "bitcoin": null, "ethereum": "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2", "polygon": null, "solana": null } } }
Notre documentation de l’API dresse la liste complète des paramètres qu’il est possible de transmettre lors de la création d’une session.
Afficher l'interface utilisateur de la rampe d'accèscôté client
Après l’exécution du script, la rampe d’accès restitue ce qui suit :
Valeurs du mode test
Avertissement
Les montants des transactions en mode test sont remplacés par nos limites prédéterminées.
Utilisez les valeurs suivantes pour effectuer une transaction de rampe d’accès en mode test :
- Sur l’écran OTP, utilisez
000000
comme code de vérification. - Sur l’écran des informations personnelles, utilisez
000000000
comme numéro de sécurité sociale etaddress_full_match
pour la ligne d’adresse 1. - Sur l’écran des informations de paiement, utilisez le numéro de carte bancaire de test
4242424242424242
.
Consultez l'utilisation de votre intégration dans le Dashboard Stripe
Une fois que vous avez lancé la rampe d’accès à la cryptomonnaie, vous pouvez consulter des rapports d’utilisation personnalisés dans le Dashboard Stripe.
Vous pouvez également revenir à la page d’inscription pour mettre à jour les domaines sur lesquels vous comptez héberger la rampe d’accès et consulter l’état des tâches d’inscription.