Bonnes pratiques d'intégration de back-endVersion bêta publique

Pour que la rampe d’accès semble faire partie de l’interface utilisateur de votre produit, faites-en un composant natif de votre application. En plus de la conception du front-end, envisagez de 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.

Portefeuille

Les utilisateurs de portefeuilles ont deux points d’entrée principaux : le financement par portefeuille et les recharges 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 ce cas, envisagez de spécifier les paramètres 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 aussi le limiter au token gas natif ou à toute cryptomonnaie de votre choix. Par exemple, si vous proposez un service DeFi en USDC, envisagez que 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.

L’exemple de code suivant illustre comment créer une session de rampe d’accès à l’aide de plusieurs de ces paramètres :

curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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"

Recharges de transactions

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 ce cas, envisagez de spécifier les éléments suivants :

• wallet_addresses : utilisez l’adresse du portefeuille utilisée.
• destination_networks : définissez ce paramètre sur le réseau sélectionné.
• destination_currencies : limitez-vous aux devises manquantes lorsque cela est possible.
• destination_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 de destination (une valeur obligatoire si vous souhaitez définir le montant).
• destination_amount : définissez ce paramètre sur les différences de solde, en laissant suffisamment de marge pour les frais de transaction, le cas échéant.

L’exemple de code suivant illustre comment créer une session de rampe d’accès à l’aide de plusieurs de ces paramètres :

curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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"

Paiement Dapp ou NFT

Vous pouvez utiliser la rampe d’accès dans le paiement lorsque vous connaissez le montant de destination. Par exemple, une Dapp peut vendre des abonnements à un tarif fixe, ou un utilisateur peut chercher à acheter un NFT spécifique sur une place de marché.

Dans ce cas, envisagez de 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 (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 (obligatoire si vous souhaitez définir le montant).
• destination_currency : définissez ce paramètre sur la devise de destination ci-dessus (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 presque égale. Un utilisateur peut choisir le montant total pour simplifier sa base de coûts fiscaux ou pour éviter de dépenser les actifs accumulés. Dans les deux cas, laissez de la marge pour les frais de transaction.

L’exemple de code suivant illustre comment créer une session de rampe d’accès à l’aide de plusieurs de ces paramètres :

curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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"

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 les utilisateurs à recharger des cryptomonnaies lorsqu’ils échangent des paires de cryptomonnaies arbitraires à l’aide d’une interface existante, il est mieux 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 contrôler votre marque et votre interface utilisateur, un DEX peut créer un widget de rampe d’accès qui utilise la capacité de Stripe à convertir les monnaies fiduciaires en cryptomonnaies sélectionnées. Le DEX peut ensuite effectuer le dernière échange 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 ce cas, envisagez de 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 sélectionné.
• destination_currencies : limitez-vous à la cryptomonnaie sélectionnée.
• destination_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 de destination (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.

L’exemple de code suivant illustre comment créer une session de rampe d’accès à l’aide de plusieurs de ces paramètres :

curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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"