Klarna : données d'achat supplémentairesVersion bêta publique
Découvrez comment fournir des données supplémentaires spécifiques à Klarna pour divers secteurs verticaux.
Disponible avec l'en-tête d'aperçu
Vous pouvez utiliser cette fonctionnalité de version bêta publique en incluant l’en-tête de version 2025-11-17. ou une version bêta ultérieure dans votre requête API.
Les données d’achat complémentaires ajoutent du contexte à une transaction pour améliorer les résultats de paiement et le service de support client. Utilisez-les pour envoyer des détails spécifiques au secteur pour des verticales telles que les événements, le transport, les marketplaces et l’assurance.
Quand utiliser les données d’achat complémentaires
Utilisez les données d’achat complémentaires si vous opérez dans une verticale prise en charge et souhaitez améliorer vos résultats de paiement avec Klarna.
Les données complémentaires partagées avec Klarna sont utilisées pour les cas d’usage suivants :
- Transparence après l’achat.Fournissez des détails de transaction complets à vos clients dans l’application Klarna, simplifiez les contestations et retours, et réduisez les litiges auprès du service de support.
- Taux d’acceptation plus élevés. Les données historiques renforcent l’évaluation des risques et peuvent augmenter les autorisations pour les transactions légitimes.
- Évaluation renforcée de la fraude. Les détails de transaction améliorés soutiennent des enquêtes plus efficaces, notamment dans les segments à risque élevé.
- Suivi de l’exposition au risque. Les données de transaction soutiennent une surveillance continue et une atténuation rapide.
- Offres améliorées. À partir du comportement historique, Klarna peut développer des solutions améliorées pour des incitations et actions qui bénéficient à vous et à vos clients.
Limites
Gardez ces limites à l’esprit :
- Aucun changement de frais. L’envoi de données d’achat complémentaires n’a aucun impact sur les frais appliqués aux transactions Klarna. Votre tarification reste identique avec ou sans ces données.
- Aucun retour de validation. Stripe et Klarna acceptent les données d’achat complémentaires correctement formatées mais n’indiquent pas si les données envoyées améliorent réellement les résultats.
Mesurer l’impact
Suivez vos taux d’autorisation Klarna dans vos analyses de paiement. Après avoir implémenté des données d’achat complémentaires, vous pouvez constater plus d’autorisations réussies, bien que l’impact dépende de vos modèles transactionnels et des données envoyées.
Disponibilité
Les données d’achat supplémentaires sont disponibles exclusivement pour les paiements Klarna et prennent en charge les secteurs verticaux suivants :
- Événements (concerts, festivals, sports, conférences)
- Assurance (polices d’assurance autonomes)
- Bons (cartes cadeaux, codes de réduction)
- Transport par train
- Transport par autobus
- Transport par ferry
- Voyages et visites organisés
- Commerçants sur marketplaces
Secteurs verticaux du voyage et du divertissement
Pour l’hébergement, la location de voitures et le transport aérien avec les paiements Klarna, voir la documentation sur les métadonnées du secteur du voyage et du divertissement. Ces secteurs verticaux sont communs aux paiements par carte bancaire, tandis que les secteurs verticaux présentés sur cette page sont exclusifs à Klarna.
Envoyez des données d’achat supplémentaires
Vous envoyez des données d’achat supplémentaires spécifiques à Klarna par le biais du paramètre payment_ lorsque vous créez, mettez à jour, ou confirmez un PaymentIntent.
Le hachage supplementary_ contient un tableau de hachages pour chaque verticale. Klarna traite toutes les entrées de ces tableaux à des fins d’évaluation des risques. Vous pouvez envoyer plusieurs verticales dans une seule requête.
Exemple : créer une PaymentIntent avec les données du bon d’achat
Exemple : créer une PaymentIntent avec plusieurs secteurs verticaux
Formats de données verticaux
Les onglets suivants décrivent les hachages pour les secteurs verticaux pris en charge :
Mettre à jour et supprimer les données d’achat supplémentaires
Utilisez la méthode de mise à jour ou de confirmation pour modifier ou supprimer des données d’achat supplémentaires.
Remplacement complet des verticales
Lorsque vous mettez à jour le tableau d’une verticale, les nouvelles données remplacent complètement les données existantes pour cette verticale. Par exemple, si une PaymentIntent comporte 2 bons d’achat et que vous envoyez une mise à jour avec 1 bon, le résultat est 1 bon (et non 3).
Créez une PaymentIntent avec 2 bons d’achat :
Mettez à jour la PaymentIntent avec une bon d’achat pour remplacer les deux bons existants :
La PaymentIntent n’a plus qu’un seul bon d’achat.
Conserver les données existantes
Les secteurs verticaux exclus d’une requête de mise à jour restent inchangés. Par exemple, vous pouvez ajouter des données relatives aux trains sans affecter les bons d’achat ou les assurances existants :
La PaymentIntent conserve les bons d’achat et les assurances existants, et ajoute la réservation de train.
Annuler la définition d’une verticale spécifique
Pour désactiver toutes les données d’un secteur vertical spécifique tout en conservant les autres secteurs verticaux, définissez le secteur vertical sur une chaîne vide. Cela supprime le secteur vertical de PaymentIntent.
Annuler la définition de toutes les données d’achat supplémentaires
Pour désactiver toutes les données d’achat supplémentaires d’une PaymentIntent, définissez l’intégralité du paramètre supplementary_ en une chaîne vide :
Test
Testez que votre intégration fonctionne correctement pour vos clients. Simulez des appels à l’API dans un environnement de test Stripe avec une clé d’environnement de test. Attachez un moyen de paiement en utilisant la méthode update avant de confirmer. Pour plus d’informations, consultez Tests.