Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usageUtiliser Managed Payments
Moyens de paiement
Interfaces de paiement
Scénarios de paiement
Paiements par TPE
Au-delà des paiements

Accepter les paiements en stablecoins

Commencez à accepter les stablecoins en activant le moyen de paiement en cryptomonnaie.

Vous pouvez accepter les paiements en stablecoins via Payment Links, Checkout, Elements ou l’API Payment Intents. Lorsque les clients paient avec des stablecoins, tels que l’USDC, ils sont redirigés vers crypto.stripe.com afin de connecter leur portefeuille crypto et de finaliser la transaction. Les fonds sont versés sur votre solde Stripe en USD.

Avant de commencer

Spécificités régionales
États-Unis

Les clients peuvent utiliser les stablecoins comme moyen de paiement partout dans le monde, mais actuellement, seules les entreprises américaines peuvent accepter les paiements en stablecoins.

Pour commencer à accepter des paiements en stablecoins, activez le moyen de paiement Cryptomonnaie :

  1. Assurez-vous que votre compte Stripe est actif.
  2. Accédez à Paramètres > Payments > Moyens de paiement et requête le moyen de paiement Cryptomonnaie.
  3. Stripe examine votre demande d’accès et peut vous contacter pour obtenir plus de détails si nécessaire. Dans ce cas, le moyen de paiement apparaît comme En attente pendant l’examen de votre requête.
  4. Une fois votre demande approuvée, Cryptomonnaie devient actif dans le Dashboard.

Utiliser avec des moyens de paiement dynamiques Recommended

Si vous utilisez les moyens de paiement dynamiques par défaut de Stripe avec Payment Links, Paiement hébergé, Paiement intégré ou Elements, vous n’avez pas besoin d’effectuer d’autres mises à jour. Stripe affiche automatiquement les options de paiement en stablecoins aux clients admissibles.

Utilisation avec une intégration Custom

Si nécessaire, vous pouvez ajouter le moyen de paiement cryptomonnaie à votre intégration de paiement manuellement.

Intégrez Pay with Crypto directement via l’{% glossary term="payment-intents » %}API Payment Intents.

Configurer Stripe
Côté serveur

Tout d’abord, créez un compte Stripe ou connectez-vous.

Utilisez nos bibliothèques officielles pour accéder à l’API Stripe depuis votre application :

Command Line
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Créer un PaymentIntent et récupérer la clé secrète du client
Côté serveur

L’objet PaymentIntent représente votre intention de collecter un paiement de la part de votre client et suit le cycle de vie du paiement traité. Créez un PaymentIntent sur votre serveur et indiquez le montant à collecter ainsi qu’une devise prise en charge. Si vous disposez d’une intégration PaymentIntents existante, ajoutez la cryptomonnaie à la liste des payment_method_types.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]"=crypto

Récupérer la clé secrète du client

Le PaymentIntent contient une clé secrète à utiliser côté client pour finaliser le processus de paiement en toute sécurité. Vous pouvez adopter différentes approches pour transmettre cette clé secrète côté client.

Récupérez la clé secrète du client à partir d’un endpoint sur votre serveur, à l’aide de la fonction fetch du navigateur. Cette approche est recommandée si votre côté client est une application d’une seule page, en particulier si elle repose sur un framework front-end moderne tel que React. Créez l’endpoint de serveur qui gère la clé secrète du client :

main.rb
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
get '/secret' do
  intent = # ... Create or retrieve the PaymentIntent
  {client_secret: intent.client_secret}.to_json
end

Récupérez ensuite la clé secrète du client à l’aide JavaScript côté client :

(async () => {
  const response = await fetch('/secret');
  const {client_secret: clientSecret} = await response.json();
  // Render the form using the clientSecret
})();

Redirection vers la page des paiements en stablecoins

Utilisez Stripe.js pour envoyer le paiement à Stripe lorsqu’un client choisit Cryptomonnaie comme moyen de paiement. Stripe.js est la bibliothèque JavaScript de base pour créer des tunnels de paiement. Il gère automatiquement des situations complexes telles que la redirection décrite ci-dessous et vous permet d’étendre votre intégration à d’autres moyens de paiement. Intégrez le script Stripe.js à votre page de paiement en l’ajoutant entre les balises <head> de votre fichier HTML.

<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/clover/stripe.js"></script>
</head>

Créez une instance de Stripe.js avec le code JavaScript suivant sur votre page de paiement :

// Set your publishable key. Remember to change this to your live publishable key in production!
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx'
);

Utilisez la clé secrète du client du PaymentIntent et appelez stripe.confirmPayment pour gérer la redirection vers Pay with Crypto. Ajoutez un return_url pour indiquer où Stripe redirige le client une fois qu’il a effectué le paiement.

const form = document.getElementById('payment-form');

form.addEventListener('submit', async function(event) {
  event.preventDefault();

  // Set the clientSecret of the PaymentIntent
  const { error } = await stripe.confirmPayment({
    clientSecret: clientSecret,
    confirmParams: {
      payment_method_data: {
        type: 'crypto',
      },
      // Return URL where the customer should be redirected after the authorization
      return_url: `${window.location.href}`,
    },
  });

  if (error) {
    // Inform the customer that there was an error.
    const errorElement = document.getElementById('error-message');
    errorElement.textContent = result.error.message;
  }
});

Le return_url correspond à une page de votre site Web qui affiche le résultat du paiement. Vous pouvez déterminer ce qu’il faut afficher en vérifiant l’état du PaymentIntent. Pour vérifier l’état, la redirection Stripe vers le return_url inclut les paramètres de requête d’URL suivants. Vous pouvez également ajouter vos propres paramètres de requête au return_url. Ils persistent tout au long du processus de redirection.

payment_intentL’identifiant unique du PaymentIntent.
payment_intent_client_secretLa clé secrète du client de l’objet PaymentIntent.

FacultatifGérer les événements post-paiement

Une fois le paiement effectué, Stripe envoie un événement payment_intent.succeeded. Utilisez le Dashboard, un webhook personnalisé ou une solution partenaire pour recevoir ces événements et exécuter des actions, comme envoyer une confirmation de commande par e-mail à votre client, enregistrer la vente dans une base de données ou lancer un workflow de livraison.

Nous vous conseillons d’écouter ces événements plutôt que d’attendre un rappel de votre client. Côté client, il arrive en effet que l’utilisateur ferme la fenêtre de son navigateur ou quitte l’application avant l’exécution du rappel, et des tentatives de manipulation de la réponse par des clients malintentionnés ne sont par ailleurs pas à exclure. La configuration de votre intégration pour écouter les événements asynchrones peut également vous aider à accepter davantage de moyens de paiement à l’avenir. Pour connaître les différences entre tous les moyens de paiement pris en charge, consultez notre guide sur les moyens de paiement.

Recevoir des événements et exécuter des actions métier

Plusieurs options s’offrent à vous pour recevoir et exécuter des actions :

  • Manuellement : utilisez le Dashboard Stripe pour afficher tous vos paiements Stripe, envoyer des reçus par e-mail, gérer les virements ou relancer les paiements en échec.
  • Code personnalisé : créez un gestionnaire de webhooks pour écouter les événements et créer des tunnels de paiement asynchrones personnalisés. Testez et déboguez votre intégration de webhook localement à l’aide de l’interface de ligne de commande Stripe.
  • Applications préconfigurées : intégrez une application partenaire pour gérer les événements courants, comme l’automatisation, le marketing ou les ventes.

Devises prises en charge

Vous pouvez créer des paiements en cryptomonnaies dans les devises qui correspondent à votre pays. La devise locale par défaut pour la cryptomonnaie est l’USD. Les clients voient également le montant de leurs achats dans cette devise.

Tester votre intégration

Testez votre intégration de paiement en cryptomonnaie en ouvrant la page de redirection des paiements à l’aide de vos clés API de test. Vous pouvez tester gratuitement un tunnel de paiement réussi à l’aide des ressources de testnet.

  1. Dans un environnement de test, créez une nouvelle transaction avec la méthode d’intégration choisie, puis ouvrez l’URL de redirection.
  2. Connectez votre wallet et votre réseau de paiement préférés.
  3. Effectuez le paiement et vérifiez que vous pouvez accéder à l’URL attendue.

Paiements tests avec des actifs testnet

La plupart des cryptomonnaies proposent des actifs testnet, ou des tokens qui n’ont aucune valeur monétaire, que vous pouvez utiliser pour tester les transactions blockchain. Stripe recommande le wallet MetaMask, le testnet Polygon Amoy et le faucet Circle pour les tests, mais vous pouvez utiliser vos propres services préférés.

Installez un wallet

  1. Téléchargez l’extension MetaMask pour votre navigateur Web.
  2. Créez un wallet ou importez un wallet existant.

Activer un testnet

  1. Dans votre wallet MetaMask, sélectionnez Réseaux dans le menu principal.
  2. Cliquez sur Ajouter un réseau personnalisé.
  3. Saisissez les informations suivantes :
    • Nom du réseau : Polygon Amoy
    • URL RPC par défaut : https://rpc-amoy.polygon.technology/
    • ID de chaîne : 80002
    • Symbole devise : POL
    • Bloquer l’URL de l’explorateur : https://amoy.polygonscan.com/
  4. Cliquez sur Enregistrer.

Importez un token

  1. Dans votre wallet MetaMask, sous Tokens, sélectionnez Polygon Amoy dans la liste déroulante du réseau.
  2. Cliquez sur le menu de débordement () et sélectionnez Importer des tokens.
  3. Cliquez sur Sélectionner un réseau > Polygon Amoy.
  4. Sous Adresse du contrat token, collez l’adresse du contrat testnet Polygon Amoy :
    0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582
    Le champ Symbole du token se met automatiquement à jour avec USDC et le champ Décimales avec 6.
  5. Cliquez sur Suivant.
  6. Vérifiez que vous importez le token USDC, puis cliquez sur Importer.

Votre wallet MetaMask affiche désormais Polygon Amoy et USDC dans la liste des tokens.

Obtenir des ressources testnet

  1. Ouvrir le paramètre faucet.circle.com
  2. Cliquez sur USDC.
  3. Sous Réseau, sélectionnez Polygon PDV Amoy.
  4. Sous l’onglet Envoyer vers, collez l’adresse de votre wallet.
  5. Cliquez sur Envoyer 10 USDC.

En plus de l’USDC pour effectuer des paiements, vous avez besoin de POL pour payer les frais de transaction :

  1. Ouvrir faucet.polygon.technology.
  2. Sous Sélectionner la chaîne et le Token, sélectionnez Polygon Amoy et POL.
  3. Sous Vérifier votre identité, cliquez sur la plateforme tierce avec laquelle vous souhaitez vous authentifier, puis suivez la procédure de connexion.
  4. Sous Saisir l’adresse wallet, collez l’adresse de votre wallet.
  5. Cliquez sur Réclamer.

La finalisation des transactions Testnet peut prendre quelques minutes. Vérifiez votre wallet pour confirmer que l’USDC et le POL ont bien été transférés.

Plus de faucets testnet

Consultez ces sites de faucets pour plus d’options de tokens de test :

Cette page vous a-t-elle été utile ?
OuiNon
Guides connexes
Abonnements aux stablecoins