Utiliser la rampe d'accès autonome hébergée par StripeBêta

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

La rampe d’accès autonome hébergée par Stripe 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, plutôt que d’en héberger une version intégrée dans leur application. Pour intégrer la rampe d’accès, vous devez envoyer une demande.

	Générer une URL de redirection	Créer une session avec une URL de redirection
Aperçu	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é, 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 Préremplir les paramètres de transaction.
Idéal pour	Les plateformes qui ne souhaitent qu’une intégration front-end simple avec peu de personnalisation et sans adaptation à leur marque.	Les plateformes qui souhaitent une rampe d’accès personnalisée avec une adaptation à leur marque.

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/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();

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 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 proposer une rampe d’accès à la cryptomonnaie entièrement personnalisée et aux couleurs de votre marque sur la rampe d’accès autonome.

Générez une session de rampe d’accès à la cryptomonnaie avec une redirect_url en exécutant la commande curl suivante :

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

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