Utiliser la rampe d’accès autonomeVersion 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 à l’API Onramp, y compris aux environnements de test, vous devez suivre ces étapes pour soumettre votre demande. Nous examinons la plupart des demandes de rampe d’accès dans les 48 heures.

Créez ou connectez-vous à votre compte Stripe et soumettez la demande de rampe d’accès.
Complétez votre demande Stripe.
Après avoir soumis la demande, commencez le développement en utilisant des environnements de test.

Nous vous informerons lorsque votre demande sera approuvée ou si nous avons besoin de plus d’informations. Vous pouvez vérifier l’état de votre demande à tout moment en visitant la page d’inscription.

Rampe d’accès autonome no-code

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

Personnaliser la rampe d’accès autonome

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/basil/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 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_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
  }
}