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

Configurer de futurs paiements Klarna

Découvrez comment enregistrer des informations Klarna pour débiter vos clients ultérieurement.

Vous pouvez enregistrer Klarna comme moyen de paiement d’un client et facturer les paiements futurs pour prendre en charge :

  • le paiement automatique des abonnements, avec ou sans essai gratuit.
  • Enregistrer Klarna dans un portefeuille électronique pour simplifier les futurs achats à la demande sans nécessiter une réauthentification du client.

Les options de paiement, les durées d’abonnement et les pays acheteurs suivants prennent en charge les paiements récurrents avec Klarna :

Options de paiementCas d’usage pris en chargePays acheteurs pris en charge
Payer la totalité
  • Abonnements à fréquence courte (hebdomadaire ou mensuelle)
  • Abonnements à fréquence longue (plus longue que mensuelle)
  • Panier mixte (achat ponctuel et abonnement)
  • Paiements à la demande
AT, BE, CA, CH, DE, DK, ES, FI, FR, IE, IT, GR, NL, NO, PL, PT, SE, UK, US
l’option de paiement différé
  • Abonnements à fréquence courte (hebdomadaire ou mensuelle)
  • Abonnements à fréquence longue (plus longue que mensuelle)
  • Paiements à la demande
DE, SE, US
Payer en 3 ou 4 fois
  • Abonnements à fréquence longue (plus longue que mensuelle) uniquement
AT, CA, CH, DE, DK, ES, FI, FR, IE, IT, GR, NL, NO, PL, PT, UK, US

Choisissez votre type d’intégration de paiement ci-dessous pour enregistrer Klarna comme moyen de paiement. Si vous utilisez Stripe Billing, consultez Klarna pour les abonnements.

Utilisez Stripe Checkout pour recueillir à l’avance des informations de paiement Klarna en vue d’un paiement dont la date et le montant seront déterminés ultérieurement. Utilisez cette fonction pour :

Configurer Stripe
Côté serveur

Pour commencer, vous devez créer un compte Stripe. Inscrivez-vous maintenant.

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

Command Line
# Available as a gem
sudo gem install stripe
Gemfile
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Créer ou récupérer un objet Customer avant la configuration
Côté serveur

Pour réutiliser un moyen de paiement Klarna en vue de paiements futurs, vous devez l’associer à un objet Customer.

Créez un objet Customer lorsque votre client crée un compte auprès votre entreprise. En associant l’ID de l’objet Customer à votre propre représentation interne de ce client, vous pourrez par la suite récupérer et utiliser les informations du moyen de paiement enregistré. Si votre client n’a pas créé de compte, vous pouvez tout de même lui créer un objet Customer, puis l’associer à votre représentation interne de ce compte du client par la suite.

Command Line
curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Créer une session Checkout
Côté client
Côté serveur

Pour que vous puissiez accepter des paiements Klarna, votre client doit préalablement vous autoriser à utiliser son compte Klarna en vue de paiement ultérieurs via Stripe Checkout.

Ajoutez sur votre site Web un bouton de paiement qui appelle un endpoint côté serveur afin de créer une session Checkout.

index.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Lorsque vous utilisez Checkout pour configurer un abonnement, il est recommandé de transmettre les détails de l’abonnement. Cela permet d’optimiser les taux d’autorisation et de vous assurer que vos clients ont accès à toutes les options de paiement Klarna applicables.

La référence d’abonnement que vous utilisez n’est pas visible par les clients et constitue un identifiant arbitraire de votre choix. Utilisez la même référence lorsque vous débitez le moyen de paiement enregistré.

L’exemple ci-dessous illustre comment transmettre les détails d’un abonnement annuel. Pour plus d’informations sur ces champs, consultez la section Options de mode de paiement des abonnements Klarna.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=setup \
  -d customer={{CUSTOMER_ID}} \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "payment_method_options[klarna][subscriptions][0][reference]"=EXAMPLE_REFERENCE \
  -d "payment_method_options[klarna][subscriptions][0][name]"="Customer-facing name for subscription" \
  -d "payment_method_options[klarna][subscriptions][0][interval]"=year \
  -d "payment_method_options[klarna][subscriptions][0][next_billing][amount]"=10000 \
  -d "payment_method_options[klarna][subscriptions][0][next_billing][date]"=2026-01-01

Après avoir créé la session de paiement, redirigez votre client vers l’URL renvoyée dans la réponse.

Gérer la redirection au retour de Checkout
Côté client
Côté serveur

Lorsque votre client fournit les détails de son moyen de paiement, il est redirigé vers la success_url, une page de votre site Web qui l’informe qu’il a correctement enregistré son moyen de paiement. Mettez l’ID de session à disposition sur votre page de confirmation en incluant le modèle de variable {CHECKOUT_SESSION_ID} dans la success_url, comme illustré ci-dessus.

Si lors d’une session Checkout, votre client clique sur votre logo sans fournir les données de son moyen de paiement, Checkout le redirige vers votre site Web sur la page cancel_url. Cette page est généralement celle que le client a consultée sur votre site avant d’être redirigé vers Stripe Checkout.

Mise en garde

Ne vous fiez pas uniquement à la redirection vers le success_url pour détecter l’initiation du paiement, sachant que :

  • Des utilisateurs malveillants pourraient accéder directement au success_url sans payer et obtenir l’accès à vos biens ou à vos services.
  • Il peut arriver que le client n’aboutisse pas au success_url à l’issue de son paiement. Il peut par exemple lui arriver de fermer l’onglet de son navigateur avant que la redirection n’intervienne.

Récupérer le moyen de paiement
Côté serveur

Une fois que le client a soumis ses informations de paiement, récupérez l’objet PaymentMethod. Un PaymentMethod stocke les informations Klarna account du client pour ses paiements ultérieurs. Vous pouvez récupérer cet objet de manière synchrone en utilisant la success_url ou de manière asynchrone au moyen de webhooks.

La décision de récupérer l’objet PaymentMethod de manière synchrone ou asynchrone dépend de votre tolérance aux abandons de paiement. En effet, il peut arriver que le client n’aboutisse pas au success_url à l’issue de son paiement (il peut par exemple lui arriver de fermer l’onglet de son navigateur avant que la redirection n’intervienne). L’utilisation de webhooks vous permet d’éviter que votre intégration ne subisse ce type d’abandon.

Gérez des webhooks checkout.session.completed, qui contiennent un objet Session. Pour en savoir plus, consultez la page sur la configuration de webhooks. Voici un exemple de réponse checkout.session.completed :

{
  "id": "evt_1Ep24XHssDVaQm2PpwS19Yt0",
  "object": "event",
  "api_version": "2019-03-14",
  "created": 1561420781,
  "data": {
    "object": {
      "id": "cs_test_MlZAaTXUMHjWZ7DcXjusJnDU4MxPalbtL5eYrmS2GKxqscDtpJq8QM0k",
      "object": "checkout.session",
      "billing_address_collection": null,
      "cancel_url": "https://example.com/cancel",
      "client_reference_id": null,
      "customer": null,
      "customer_email": null,
      "display_items": [],
      "mode": "setup",
      "setup_intent": "seti_1EzVO3HssDVaQm2PJjXHmLlM",
      "submit_type": null,
      "subscription": null,
      "success_url": "https://example.com/success"
    }
  },
  "livemode": false,
  "pending_webhooks": 1,
  "request": {
    "id": null,
    "idempotency_key": null
  },
  "type": "checkout.session.completed"
}

Notez la valeur de la clé setup_intent, qui constitue l’ID du SetupIntent créé avec la session Checkout. Un SetupIntent est un objet utilisé pour configurer les informations Klarna account du client pour les paiements futurs. Récupérez l’objet SetupIntent avec l’ID.

Command Line
curl https://api.stripe.com/v1/setup_intents/seti_1EzVO3HssDVaQm2PJjXHmLlM \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Gérer les événements post-configuration
Côté serveur

Utilisez une méthode telle que les webhooks pour confirmer que le client a autorisé le contrat de facturation. Ne comptez pas sur votre client pour revenir à la page d’état du paiement.

Lorsqu’un client autorise le contrat de facturation, Stripe émet un événement webhook payment_intent.succeeded ou setup_intent.succeeded et l’état de l’Intent passe à succeeded. Enregistrez l’ID payment_method qui en résulte pour effectuer ultérieurement des paiements à l’aide du PaymentMethod enregistré.

Si un client n’autorise pas correctement le contrat de facturation, Stripe émet un événement de webhook payment_intent.payment_failed ou de setup_intent.setup_failed et l’état de l’Intent repasse à requires_payment_method.

Utiliser le moyen de paiement pour les paiements ultérieurs
Côté serveur

Au moment de débiter votre client hors session, utilisez les ID des objets Customer et PaymentMethod pour créer un PaymentIntent. Définissez quelques autres paramètres pour effectuer le paiement hors session :

  • Définissez off_session sur true pour indiquer que le client ne se trouve pas dans votre tunnel de paiement pendant cette tentative de paiement, ce qui entraîne le renvoi d’une erreur par le PaymentIntent si une authentification est requise.
  • Définissez la propriété confirm du PaymentIntent sur la valeur true, ce qui aura pour effet de générer immédiatement une confirmation lors de la création du PaymentIntent.
  • Renseignez l’ID du PaymentMethod dans payment_method et l’ID du client dans customer.
  • Specify a return_url to indicate where Stripe needs to redirect the customer after they return from Klarna’s website.

Envoyez les informations d’abonnement et les postes de facture à chaque renouvellement. Utilisez la même reference pour votre abonnement que lorsque vous avez configuré le moyen de paiement. Si les informations d’abonnement ont changé depuis que vous avez enregistré le moyen de paiement, envoyez les nouvelles informations avec la même reference.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=5000 \
  -d currency=usd \
  -d confirm=true \
  -d customer={{CUSTOMER_ID}} \
  -d payment_method={{PAYMENT_METHOD_ID}} \
  -d off_session=true \
  --data-urlencode return_url="https://example.com/setup/complete" \
  -d "amount_details[line_items][0][product_name]"="Annual subscription renewal" \
  -d "amount_details[line_items][0][quantity]"=1 \
  -d "amount_details[line_items][0][unit_cost]"=5000 \
  -d "amount_details[line_items][0][payment_method_options][klarna][subscription_reference]"=EXAMPLE_REFERENCE \
  -d "payment_method_options[klarna][subscriptions][0][reference]"=EXAMPLE_REFERENCE \
  -d "payment_method_options[klarna][subscriptions][0][interval]"=year

Tester votre intégration

Lorsque vous testez votre intégration Checkout, sélectionnez le moyen de paiement Klarna et cliquez sur le bouton Enregistrer. Dans un environnement de test, vous pouvez ensuite simuler différents résultats dans la redirection de Klarna.

Nous avons réuni ci-dessous des données de test pour les pays pris en charge. Dans un environnement de test, Klarna s’appuie sur l’adresse e-mail fournie pour approuver ou refuser une transaction.

ApprouvéRefusé
Date de naissance10/07/197003-05-1994
PrénomTestJohn
NomPerson-ausnow
RueWharf StSilverwater Rd
Numéro de rue41-5
Code postal48772128
VillePort DouglasSilverwater
RégionQLDNSW
Téléphone+61473752244+61473763254
Adresse e-mailcustomer@email.aucustomer+denied@email.au

Authentification à deux facteurs

Tout numéro à six chiffres forme un code d’authentification à deux facteurs valide. Utilisez 999999pour que l’authentification échoue.

Mode de remboursement

Dans le flux Klarna, vous pouvez utiliser les valeurs de test suivantes pour essayer divers types de remboursements :

TypeValeur
Prélèvement automatiqueDE11520513735120710131
Virement bancaireBanque de démonstration
Carte bancaire
  • Numéro : 4111 1111 1111 1111
  • CVV : 123
  • Date d’expiration : toute date future valide
Carte de débit
  • Numéro : 4012 8888 8888 1881
  • CVV : 123
  • Date d’expiration : toute date future valide
Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc