Accepter un paiement en stablecoinVersion bêta publique

Commencez à accepter les stablecoins en intégrant le moyen de paiement en cryptomonnaie.

Vous pouvez accepter les paiements en stablecoins avecCheckout, Elements ou les intégrer directement via l’API Payment Intents. Si vous êtes une plateforme Connect, consultez la page Prise en charge de Connect.

Lorsqu’elle est intégrée, l’option de paiement par cryptomonnaie apparaît dans votre page de paiement, redirigeant les clients vers une page hébergée par crypto.link.com pour l’exécution du paiement. Là, vos clients peuvent connecter leur wallet, et enregistrer et réutiliser leur compte en utilisant Link. Vous recevez immédiatement la notification de la réussite ou de l’échec du paiement. Avant de commencer, consultez notre démo.

Permettez à vos utilisateurs de payer avec des cryptomonnaies

Web

Appareils mobiles

Intégrez Pay with Crypto directement via l’API Payment Intents. Avant de créer un PaymentIntent, activez Cryptomonnaie dans vos paramètres des moyens de paiement.

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 :

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

L’objet PaymentIntent représente votre intention d’encaisser un paiement de votre client et suit le cycle de vie du processus de paiement. Créez un PaymentIntent sur votre serveur et précisez le montant à percevoir ainsi qu’une devise prise en charge. Si vous disposez déjà d’une intégration Payment Intents, ajoutez crypto à la liste payment_method_types.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"=crypto \
  -d amount=1099 \
  -d currency=usd

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 :

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/v3/"></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_intent`	L’identifiant unique du `PaymentIntent`.
`payment_intent_client_secret`	La clé secrète du client de l’objet `PaymentIntent`.

FacultatifGérer les événements post-paiement

Tester votre intégration

Testez votre intégration Pay with Crypto en affichant la page de redirection à l’aide de vos clés API de test. Vous pouvez tester le cas de paiement réussi en authentifiant le paiement sur la page de redirection. Le PaymentIntent passe de requires_action à succeeded.

Dans l’environnement de test, payez avec des crypto-actifs testnet sur la page de paiement vers laquelle vous êtes redirigé.
Configurez votre portefeuille en fonction du réseau de test sur lequel vous avez l’intention de payer. Par exemple, si vous souhaitez payer en USDC sur Ethereum, assurez-vous que votre portefeuille est configuré sur le réseau de test Sepolia d’Ethereum.

Approvisionner votre portefeuille avec des actifs de test

Vous pouvez utiliser les « robinets » de testnet pour recharger votre portefeuille. En voici quelques-uns :