Recettes d'intégration back-endBêta
Pour optimiser l’expérience utilisateur, faites de la rampe d’accès un composant natif de votre application. En plus de la conception du front-end, vous pouvez souhaiter préremplir les paramètres de la rampe d’accès lors de la création d’une session de rampe d’accès sur votre back-end. Vous trouverez ci-dessous des cas d’usage courants et des suggestions d’implémentation.
Portefeuille
Les utilisateurs de portefeuilles ont deux points d’entrée principaux : le financement par portefeuille et la recharge par transaction.
Financement par portefeuille
Vous pouvez inviter les utilisateurs à recharger leur portefeuille de manière proactive une fois qu’ils en ont créé un nouveau ou lorsque leurs fonds sont au plus bas.
Dans ces cas, vous pouvez spécifier les éléments suivants :
wallet_addresses
: utilisez l’adresse du portefeuille déjà utilisée.destination_networks
: définissez ce paramètre sur le réseau par défaut ou sélectionné pour éviter toute confusion chez l’utilisateur.destination_currencies
: vous pouvez laisser ce champ vide, mais vous pouvez éventuellement le limiter au token gas natif ou à toute cryptomonnaie de votre choix (par exemple, si vous proposez un service Defi en USDC, envisagez le cas où l’utilisateur a probablement besoin à la fois d’USDC et du token gas).destination_network
: laissez ce champ vide pour hériter de la première valeur du réseau pris en charge.destination_currency
: laissez ce champ vide pour hériter de la première valeur de cryptomonnaie prise en charge.
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u
: \ -d "customer_ip_address"="8.8.8.8" \ -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" \ -d "wallet_addresses[solana]"="bufoH37MTiMTNAfBS4VEZ94dCEwMsmeSijD2vZRShuV" \ -d "destination_networks[]"="ethereum" \ -d "destination_networks[]"="solana"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Recharge de la transaction
Lorsqu’une Dapp ou l’utilisateur propose une transaction, il se peut que vous détectiez que la transaction échoue en raison de fonds insuffisants. Dans ce cas, vous pouvez calculer le delta nécessaire à la réalisation de la transaction. Cependant, il est souvent difficile de détecter le montant demandé ou la cryptomonnaie pour les tokens ERC ou SPL.
Dans ces cas, vous pouvez spécifier les éléments suivants :
wallet_addresses
: utilisez l’adresse du portefeuille utiliséedestination_networks
: définissez ce paramètre sur le réseau sélectionnédestination_currencies
: limitez-vous aux devises manquantes lorsque cela est possibledestination_network
: définissez ce paramètre sur le réseau sélectionné (obligatoire si vous souhaitez définir le montant)destination_currency
: définissez ce paramètre sur la devise cible (une valeur obligatoire si vous souhaitez définir le montant)destination_amount
: définissez ce paramètre sur les différences de solde et laissez suffisamment de marge pour les frais de transaction, le cas échéant
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u
: \ -d "customer_ip_address"="8.8.8.8" \ -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" \ -d "destination_networks[]"="ethereum" \ -d "destination_currencies[]"="usdc" \ -d "destination_network"="ethereum" \ -d "destination_currency"="usdc" \ -d "destination_amount"="10"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Paiement Dapp ou NFT
Dans certaines applications, vous pouvez utiliser la rampe d’accès dans le paiement lorsque vous connaissez le montant de destination. Par exemple, un Dapp peut être utilisé pour vendre des abonnements à un tarif fixe, ou lorsque l’utilisateur cherche à acheter un NFT spécifique sur une place de marché.
Dans ces cas, vous pouvez spécifier les éléments suivants :
wallet_addresses
: utilisez l’adresse du portefeuille connectédestination_networks
: utilisez le réseau connectédestination_currencies
: utilisez la devise de présentation (c’est-à-dire le prix dans la devise dans laquelle les biens sont indiqués)destination_network
: définissez ce paramètre sur le réseau sélectionné ci-dessus (valeur obligatoire si vous souhaitez définir le montant)destination_currency
: définissez ce paramètre sur la devise cible ci-dessus (une valeur obligatoire si vous souhaitez définir le montant)destination_amount
: définissez ce paramètre sur la différence de solde ou sur le montant total de l’achat. Certains utilisateurs adoptent les deux à l’aide d’analyses on-chain avec une répartition à peu près égale. Un utilisateur peut choisir le montant total pour simplifier sa base de coûts fiscaux ou pour ne pas dépenser les actifs accumulés. Dans les deux cas, vous devez laisser de la marge pour les frais de transaction.
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u
: \ -d "customer_ip_address"="8.8.8.8" \ -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" \ -d "destination_networks[]"="ethereum" \ -d "destination_currencies[]"="eth" \ -d "destination_network"="ethereum" \ -d "destination_currency"="eth" \ -d "destination_amount"="0.2343"sk_test_4eC39HqLyjWDarjtT1zdp7dc
DEX
Un DEX offre une occasion unique de permettre aux utilisateurs d’acheter n’importe quelle cryptomonnaie avec des monnaies fiduciaires. Bien qu’un DEX puisse inviter progressivement les utilisateurs à recharger des cryptomonnaies lorsqu’ils échangent des paires de cryptomonnaies arbitraires à l’aide d’une interface existante, il est préférable de disposer d’un flux utilisateur dédié qui se concentre uniquement sur le passage des monnaies fiduciaires en cryptomonnaies.
Étant donné que la rampe d’accès vous permet de maîtriser votre marque et votre expérience utilisateur, un DEX peut créer un widget de rampe d’accès qui tire parti de la capacité de Stripe à convertir les monnaies fiduciaires en certaines cryptomonnaies. Le DEX peut effectuer la dernière étape en les échangeant dans des devises arbitraires. Un DEX peut également créer un widget de rampe d’accès pour un token spécifique. Par exemple, un DAO peut approuver un pool de liquidités spécifique et utiliser un DEX pour distribuer ses tokens et intégrer de nouveaux utilisateurs avec les monnaies fiduciaires.
Dans ces cas, vous pouvez spécifier les éléments suivants :
wallet_addresses
: utilisez l’adresse du portefeuille déjà utiliséedestination_networks
: définissez ce paramètre sur le réseau sélectionnédestination_currencies
: limitez-vous à la cryptomonnaie sélectionnéedestination_network
: définissez ce paramètre sur le réseau sélectionné (une valeur obligatoire si vous souhaitez définir le montant)destination_currency
: définissez ce paramètre sur la devise cible (une valeur obligatoire si vous souhaitez définir le montant)destination_amount
: définissez ce paramètre uniquement si vous pouvez recueillir l’intention de l’utilisateur à l’avance. Sinon, laissez ce champ vide pour que Stripe suggère des valeurs par défaut intelligentes
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u
: \ -d "customer_ip_address"="8.8.8.8" \ -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" \ -d "destination_networks[]"="ethereum" \ -d "destination_currencies[]"="eth" \ -d "destination_network"="ethereum" \ -d "destination_currency"="eth"sk_test_4eC39HqLyjWDarjtT1zdp7dc