Intégrer Pay with CryptoVersion bêta publique

Commencez à accepter les cryptomonnaies en intégrant Pay with Crypto.

Pay with Crypto est compatible avec Checkout, Elements, ou peut être directement intégré par le biais de l’API Payment Intents. Si vous êtes une plateforme Connect, consultez la rubrique Prise en charge de Connect.

When integrated, the option to pay with crypto appears in your checkout page, redirecting customers to a page hosted by crypto.link.com for payment completion. There, your customers can connect their wallet, and save and reuse their account using Link. You’re immediately notified if the payment succeeds or fails. Before you get started, see our Pay with Crypto demo.

Permettez à vos utilisateurs de payer avec des cryptomonnaies

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

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 de percevoir un paiement de la part de votre client et suit le cycle de vie du processus de paiement. 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 PaymentIntent existante, ajoutez crypto à la liste des payment_method_types.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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 Pay with Crypto

Utilisez Stripe.js pour soumettre 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. Elle gère automatiquement les opérations complexes telles que la redirection décrite ci-dessous, et vous permet d’étendre votre intégration à d’autres moyens de paiement. Incluez le script Stripe.js sur votre page de paiement en l’ajoutant à la section <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 une return_url vers laquelle Stripe redirigera votre client une fois le paiement effectué.

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

L’URL return_url correspond à une page de votre site Web qui affiche le résultat du paiement. Pour déterminer l’information à afficher, vous pouvez vérifier l’état du PaymentIntent. Pour ce faire, la redirection de Stripe vers la page return_url inclut les paramètres de requête d’URL suivants. Vous pouvez également ajouter vos propres paramètres de requête à la return_url. Ils seront conservés pendant tout le 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

Test your Pay with Crypto integration with your test API keys by viewing the redirect page. You can test the successful payment case by authenticating the payment on the redirect page. The PaymentIntent transitions from requires_action to succeeded.

To test the case where the user fails to authenticate:

Use your test API keys and view the redirect page.
On the redirect page, click Fail test payment.

The PaymentIntent transitions from requires_action to requires_payment_method. For manual capture PaymentIntents in test mode, the uncaptured PaymentIntent auto-expires seven days after successful authorization.