Migrer Klarna depuis Sources

Klarna lance un nouveau processus de paiement qui nécessite l’utilisation de l’API Payment Methods et de l’API Payment Intents. Ce guide décrit plusieurs chemins de migration recommandés pour effectuer votre migration depuis l’API Sources, dont une option low-code qui utilise Stripe Checkout.

Déclenchement du paiement Klarna sur Payment Intents

Finalisation du paiement Klarna sur Payment Intents

Différences notables

• Sélection de produit Klarna : vous n’avez pas besoin de spécifier le type de produit Klarna dans votre intégration. À la place, les clients choisissent désormais un produit sur la page de redirection Klarna. Ajoutez un seul bouton Klarna sur votre page de paiement, et non pas un bouton distinct pour chaque option de paiement Klarna.
• L’affichage intégré du SDK Klarna n’est pas pris en charge : les clients doivent désormais être redirigés vers le site Klarna à partir de votre page de paiement pour autoriser le paiement. Par conséquent, vous n’avez pas besoin de charger le SDK Klarna ni d’afficher les composants intégrés.
• La confirmation de paiement est synchronisée sur tous les marchés : auparavant, la confirmation d’un paiement ayant abouti pouvait être asynchrone. À présent, vous pouvez détecter si le paiement a abouti immédiatement après que votre client l’a autorisé.

Migrer votre tunnel de paiement

Pour migrer votre intégration Klarna pour les paiements Web, vous devez mettre à jour votre serveur et votre front-end afin d’utiliser l’API Payment Intents. Voici les trois options d’intégration classiques :

• Rediriger les clients vers Stripe Checkout pour votre tunnel de paiement.
• Utilisez le Payment Element de Stripe sur votre propre page de paiement.
• Créer votre propre formulaire et utilisez le SDK Stripe JS pour effectuer le paiement.

Utilisez Stripe Checkout ou le Payment Element pour ajouter et gérer la plupart des moyens de paiement depuis le Dashboard Stripe sans toucher à votre code.

Vous trouverez ci-dessous une comparaison détaillée entre les anciennes et les nouvelles étapes d’intégration :

Option 1 : Utiliser une session Checkout

Stripe Checkout est une solution de paiement hébergée avec peu d’écriture code et qui accepte les paiements Klarna, ainsi que de nombreux autres moyens de paiement pris en charge par Stripe. Si vous hébergez actuellement une page de paiement sur votre site et que vous souhaitez utiliser Stripe Checkout, procédez comme suit :

1. Assurez-vous que Klarna est activé dans votre Dashboard.
2. Créez une session Checkout sur votre serveur. Vous pouvez définir explicitement klarna comme l’un des payment_method_types ou utiliser des moyens de paiement dynamiques.
3. Si vous vendez des biens physiques, activez la collecte de l’adresse de livraison ou incluez l’adresse de livraison dans le hachage shipping_details.
4. Redirigez le client vers l’URL de la session pour qu’il procède au paiement.

Option 2 : Utiliser Payment Element

Le Payment Element Stripe est un composant d’interface utilisateur intégré unique pour votre page de paiement qui prend en charge Klarna ainsi que d’autres moyens de paiement. Il offre de nombreuses fonctionnalités de Stripe Checkout, mais s’affiche sur votre propre page de paiement. Pour utiliser le Payment Element, procédez comme suit :

1. Assurez-vous que Klarna est activé dans votre Dashboard.
2. Créer un PaymentIntent sur votre serveur

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "automatic_payment_methods[enabled]"=true \
  -d amount=1099 \
  -d currency=eur

Vous pouvez explicitement activer Klarna en le définissant comme l’un des payment_method_types.

1. Transmettez la clé secrète du client du PaymentIntent au front-end et initialisez la bibliothèque de l’interface utilisateur de Stripe Elements.
2. Créez un Payment Element et intégrez-le à la page. Cet élément collecte automatiquement tous les champs supplémentaires nécessaires selon le moyen de paiement sélectionné par le client.
3. Appelez confirmPayment sur le Payment Element lorsque l’utilisateur procède au paiement. Assurez-vous de transmettre une return_url.

Option 3 : Créer votre propre formulaire

Vous pouvez créer vos propres composants de formulaire et effectuer un paiement Klarna à l’aide du SDK Stripe JS. En savoir plus sur l’intégration complète. Pour intégrer cette méthode, procédez comme suit :

1. Assurez-vous que Klarna est activé dans votre Dashboard.
2. Créez un PaymentIntent sur votre serveur.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "automatic_payment_methods[enabled]"=true \
  -d amount=1099 \
  -d currency=eur

Si vous ne souhaitez pas gérer les moyens de paiement via le Dashboard, vous pouvez explicitement activer Klarna en le définissant comme l’un des payment_method_types.

1. Utilisez un formulaire pour collecter l’adresse e-mail et le pays de facturation de votre client.
2. Initialisez Stripe.JS sur votre page de paiement et appelez confirmKlarnaPayment avec la clé secrète du client du PaymentIntent lorsque le client est prêt à autoriser le paiement. Assurez-vous que son adresse e-mail et son pays de facturation figurent dans les champs billing_details[email] et billing_details[address][country].

Documentation sur le mappage des champs

Si vous utilisez le Payment Element ou votre propre formulaire, vous devez rediriger les champs de la source vers le PaymentIntent. Le tableau ci-dessous schématise les correspondances entre les anciens champs et les nouveaux. Si vous vendez des biens physiques, nous vous recommandons de transmettre les informations de livraison. Tous les autres champs sont facultatifs, et Klarna recueille les informations supplémentaires nécessaires sur sa page.

Après l’achat

Les modifications suivantes sont requises pour tous les points d’intégration survenant suite à la finalisation d’un paiement.

Vérification de l’état du paiement

Auparavant, votre intégration aurait dû vérifier à la fois l’état des objets Source et Charge après chaque appel à l’API. Ce n’est plus nécessaire désormais ; il suffit de vérifier l’état du PaymentIntent ou de la session Checkout après confirmation sur le front-end.

Confirmez toujours l’état du PaymentIntent en le récupérant ou en écoutant les webhooks sur votre serveur. Ne comptez pas uniquement sur le retour de l’utilisateur à la return_url fournie lorsque vous confirmez le PaymentIntent. Pour en savoir plus, cliquez ici.

Remboursements

Vous pouvez continuer à appeler l’API Refunds avec l’objet Charge créé par le PaymentIntent. L’ID du paiement est accessible dans le paramètre latest_charge. Vous pouvez également fournir l’ID du PaymentIntent à l’API Refunds à la place de l’objet Charge.

Gestion des erreurs

Auparavant, vous deviez gérer les erreurs sur les Sources qui étaient créées. Avec l’API Payment Intents, vous n’avez pas besoin de vérifier les erreurs sur les objets Source, mais sur le PaymentIntent au moment de sa création et après que le client a autorisé le paiement. La plupart des erreurs sur le PaymentIntent concernent le champ type renvoyé dans une requête non valide.

Webhooks

Si vous écoutiez précédemment des événements sources, vous devrez peut-être mettre à jour votre intégration pour écouter de nouveaux types d’événements. Vous trouverez ci-dessous une liste des nouveaux types d’événements à écouter.