Utilisez la rampe d’accès hébergée par StripeVersion bêta publique

Générez une URL de redirection et créez une session pour la rampe d'accès autonome.

The Stripe-hosted, standalone 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 onramp, rather than hosting an embedded version of the onramp within their application.

Avant de commencer

Pour accéder à la rampe d’accès Stripe, y compris aux environnements de test, vous devez suivre ces étapes pour soumettre votre demande :

Créez ou connectez-vous à votre compte Stripe.
Si ce n’est pas déjà fait, activez votre compte Stripe.
Soumettez votre demande de rampe d’accès. Nous examinons la plupart des demandes sous 48 heures et vous informons de leur approbation ou si des informations supplémentaires sont nécessaires. Vous pouvez consulter à tout moment le statut de votre demande dans le Dashboard.
Une fois votre demande approuvée, choisissez une méthode d’intégration et commencez le développement dans un environnement de test.

La rampe d’accès hébergé par Stripe

L’URL de redirection de la rampe d’accès autonome prend en charge la personnalisation des paramètres et vous permet de pré-remplir des champs tels que la devise de destination et le montant source ou le montant de destination.

Partagez le lien en l’envoyant directement aux utilisateurs ou en l’affichant avec un bouton, comme dans la démonstration suivante.

Rediriger les utilisateurs directement vers cette URL

https://crypto.link.comCopier dans le presse-papiers

Livemode

Exemple de bouton avec URL de redirection

Buy Crypto

Générer une URL de redirection avec un code

const standaloneOnramp = window.StripeOnramp.Standalone();
const redirectUrl = standaloneOnramp.getUrl();

return (
  <a href={redirectUrl}>
    Buy Crypto
  </a>
);

Personnalisez la rampe d’accès hébergée par Stripe

Vous pouvez également générer une URL de redirection avec du code en utilisant la fonction Standalone et en passant les champs souhaités. Choisissez de générer une URL de redirection ou de créer une session avec une URL de redirection :

Option de personnalisation	Aperçu	Idéal pour
Générer une URL de redirection	Générez une URL de redirection dans le front-end sans compte Stripe. Personnalisez le montant source ou de destination suggéré, la devise de destination et le réseau.	Si vous souhaitez une intégration front-end légère avec une personnalisation limitée et sans branding.
Créer une session avec une URL de redirection	Créez une session avec une URL de redirection dans le back-end avec un compte Stripe. Permet une personnalisation complète, y compris l’adresse du wallet de destination. Pour une liste complète des paramètres, consultez Pré-remplir les paramètres de transaction.	Si vous souhaitez une rampe d’accès entièrement personnalisée avec vos éléments de branding.

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 and 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/clover/stripe.js"></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();

Vous pouvez préremplir les paramètres suivants :

source_currency : devise fiduciaire de la transaction (usd et eur).
amount : montant fixe dans la cryptomonnaie ou devise fiduciaire associée à cet achat. Spécifiez un montant fiduciaire en transmettant source_amount ({source_amount: 42}). Pour spécifier un montant de cryptomonnaie, transmettez destination_amount ({destination_amount: 42}). Vous ne pouvez indiquer qu’un seul montant.
destination_currencies : un tableau de cryptomonnaies auxquelles vous souhaitez vous limiter (['eth', 'usdc']).
destination_networks : un tableau des réseaux de cryptomonnaies auxquels vous souhaitez vous limiter (['ethereum', 'polygon']).
destination_network : le réseau de cryptomonnaies par défaut pour cette rampe d’accès (ethereum).
destination_currency : la cryptomonnaie par défaut pour cette session de rampe d’accès (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.

Créer une session avec une URL de redirection

Comme pour d’autres intégrations, vous devez mettre en œuvre une serveur endpoint pour créer une nouvelle session de rampe d’accès pour chaque visite de l’utilisateur. La requête de création de session de rampe d’accès renvoie un paramètre redirect_url. Redirigez vos utilisateurs vers l’URL pour une rampe d’accès entièrement personnalisée et avec le logo de votre marque de cryptomonnaie sur la rampe d’accès autonome.

Générez une session d’accès aux cryptomonnaies avec un paramètre redirect_url en exécutant la commande curl suivante :

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -usk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Vous recevez une réponse semblable à ce qui suit :

{
  "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
  }
}