- Directives d'intégration
- Fonctionnalités prises en charge (Modes de paiement)
- Mise en œuvre d'une intégration des paiements avec redirection
- Klarna Financing
Klarna Financing
Klarna Financing est un mode de paiement fourni par Klarna AB, une banque suédoise populaire, aux payeurs en Europe. Klarna Financing offre une option de financement flexible aux payeurs lorsqu'ils achètent des biens en ligne.
Les payeurs entrent une entente de financement à long terme lorsqu'ils achètent un articlent et paient en plusieurs versements. Les payeurs peuvent choisir de rembourser en six à trente-six mensualités égales, intérêts compris (le cas échéant), de payer un montant minimum chaque mois ou de rembourser la totalité du montant en un mois.
La méthode Klarna Financing est prise en charge dans Mastercard Gateway. Cette page explique les détails de l'intégration spécifique à Klarna Financing. Nous vous recommandons de lire les instructions d'intégration pour les paiements avec redirection avant de créer une intégration Klarna Financing.
Conditions préalables
Pour proposer Klarna Financing via Mastercard Gateway,
- vous devez être inscrit auprès de votre prestataire de services de paiement avec redirection,
- votre profil de commerçant sur Mastercard Gateway doit être configuré en utilisant les détails de votre compte auprès de votre prestataire de services de paiement avec redirection, et
- vous devez disposer d'un compte bancaire dans l'une des devises prise en charge enregistré pour votre compte de commerçant chez votre prestataire de services de paiement avec redirection.
Opérations Klarna Financing
Klarna Financing prend en charge les transactions provenant de différents pays avec leurs devises correspondantes.
| Pays | Devise |
|---|---|
| Autriche (AUT) | EUR |
| Allemagne (DEU) | EUR |
| Pays-Bas (NLD) | EUR |
| Finlande (FIN) | EUR |
| Suède (SWE) | SEK |
| Norvège (NOR) | NOK |
Intégration Klarna Financing
L'intégration Hosted Checkout vous permet de recueillir des détails de paiement auprès de vos payeurs à l'aide d'une interaction hébergée et affichée par Mastercard Gateway.
À compter de la version 62 de l'API, Klarna Financing est automatiquement disponible comme mode de paiement après votre activation et votre configuration par votre your payment service provider pour ce mode de paiement.
Pour plus d'informations, voir Intégration des paiements avec redirection via Hosted Checkout.
L'intégration Direct Payment vous permet de proposer Klarna Financing sur votre propre page de paiement.
La méthode Klarna Financing est prise en charge à compter de la version 61 de DirectAPI.
Vous pouvez utiliser la demande Initiate Browser Payment (Lancer un paiement avec redirection) où sourceOfFunds.type = KLARNA_FINANCING et browserPayment.operation = PAY (l'opération Authorize (Autoriser) n'est pas prise en charge par Klarna Financing).
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"<your_merchant_URL>"
},
"customer":{
"email":"john.smith@example.com",
"firstName":"John",
"lastName":"Smith",
"mobilePhone":"01234567890"
},
"billing":{
"address":{
"street":"10 Upper Bank Street",
"postcodeZip":"E14 5NP",
"city":"London",
"country":"GBR"
}
},
"order":{
"amount":99.2,
"currency":"GBP",
"item":[
{
"name":"Blue Jeans",
"quantity":"1",
"unitPrice":70.83,
"unitDiscountAmount":48.16,
"unitTaxAmount":4.53,
"detail":{
"unitTaxRate":0.2
}
},
{
"name":"Red Shirt",
"quantity":"1",
"unitPrice":20.83,
"unitTaxAmount":4.17,
"detail":{
"unitTaxRate":0.2
}
},
{
"name":"Leather Belt",
"quantity":"1",
"unitPrice":25,
"unitTaxAmount":5,
"detail":{
"unitTaxRate":0.2
}
},
{
"name":"Baseball Cap",
"quantity":"1",
"unitPrice":10,
"unitTaxAmount":2,
"detail":{
"unitTaxRate":0.2
}
},
{
"name":"Shipping and Handling",
"quantity":"1",
"unitPrice":4.17,
"unitTaxAmount":0.83,
"detail":{
"unitTaxRate":0.2
}
}
]
},
"sourceOfFunds":{
"type":"KLARNA_FINANCING"
}
}
Outre les champs standard requis dans une demande de paiement avec redirection, vous devez fournir les informations requises suivantes pour le traitement Klarna Financing.
Adresse de facturation et détails du contact
Ces champs sont obligatoires, sauf indication contraire, et sont requis pour prendre en charge les processus d'évaluation des risques et de contrôle du crédit Klarna Financing. Les coordonnées du payeur sont utilisées pour communiquer avec lui et pour envoyer des factures électroniques et des notifications de paiement.
billing.address.citybilling.address.countrybilling.address.postcodeZipbilling.address.streetcustomer.emailcustomer.firstNamecustomer.lastNamecustomer.mobilePhone: ce champ est requis lorsquecustomer.phonen'est pas indiqué.customer.phone: ce champ est requis lorsquecustomer.mobilePhonen'est pas indiqué.
Adresse d'expédition et détails du contact
Ces champs sont obligatoires lorsqu'une valeur pour shipping.address.* ou shipping.contact.* est indiquée.
shipping.address.cityshipping.address.countryshipping.address.postcodeZipshipping.address.streetshipping.contact.emailshipping.contact.firstNameshipping.contact.lastName
Détails de l'article commandé
Fournissez des informations complètes sur chaque article de commande acheté afin que Klarna Financing puisse correctement valider et afficher ces informations pour les payeurs et pour prendre en charge les processus de contrôle des risques et du crédit de Klarna Financing.
order.item[n].nameorder.item[n].quantity: la valeur de ce champ doit être un nombre entier.order.item[n].unitPriceorder.item[n].unitDiscountAmount: ce champ est obligatoire lorsque l'article a fait l'objet d'une remise et doit être indiqué si le champorder.discount.amountest renseigné.order.item[n].unitTaxAmount: ce champ est obligatoire lorsque le payeur doit payer la taxe sur l'article.order.item[n].detail.unitTaxRate: ce champ est obligatoire lorsque le montant de taxe unitaire a été renseigné.
Expédition et manutention
Le montant total de la taxe à payer pour la commande est affiché aux payeurs au cours du flux de paiement. Si le montant à payer pour les frais d'expédition et de manutention inclut la taxe, vous devez créer une ligne de commande représentant les frais d'expédition et de manutention afin que le montant de la taxe puisse être indiqué. Si la taxe ne s'applique pas, le montant des frais d'expédition et de manutention peut être indiqué dans le champ order.shippingAndHandlingAmount.
Langue préférée
Vous pouvez définir la langue que vous préférez que Klarna Financing utilise pour les pages affichées aux payeurs en renseignant le champ browserPayment.preferredLanguage dans la demande Initiate Browser Payment (Lancer un paiement avec redirection). Cependant, pour Klarna Financing, seule la langue nationale principale du pays indiqué dans le champ billing.address.country ou l'anglais sera pris en charge.
Rétrofacturations
Les paiements Klarna Financing peuvent faire l'objet de rétrofacturations. Si des payeurs contestent avec succès un paiement après de Klarna Financing, une transaction Chargeback (Rétrofacturation) sera créée sur la commande. Pour plus d'informations, voir Transaction Chargeback (Rétrofacturation).
Comment interpréter le résultat de la transaction
Le tableau ci-dessous illustre les codes de réponse de transaction pour les scénarios possibles auxquels vous pouvez devoir faire face après avoir initié un paiement Klarna Financing.
Réponse Initiate Browser Payment (Lancer un paiement avec redirection) |
Qu'est-ce que cela signifie ? |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Redirigez le payeur en utilisant l'URL indiquée dans la réponse. |
Réponse Retrieve Transaction/Retrieve Order (Extraire une transaction/Extraire une commande) |
Qu'est-ce que cela signifie ? |
response.gatewayCode=APPROVEDresult=SUCCESS |
Le paiement a réussi. |
response.gatewayCode=PENDINGresult=PENDING |
Mastercard Gateway attend une notification de l'acquéreur à propos du résultat du paiement. Réessayez la transaction RETRIEVE_TRANSACTION ou surveillez les notifications de Mastercard Gateway. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Le payeur a annulé l'interaction pour ce paiement. Proposez au payeur d'essayer un autre mode de paiement. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Le paiement a été refusé. Proposez au payeur d'essayer un autre mode de paiement. En cas d'une erreur ACQUIRER_SYSTEM_ERROR, vous pouvez vouloir demander à l'acquéreur la raison de l'échec du paiement, ou vous pouvez réessayer la transaction RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Traitez cela comme un paiement refusé. Mastercard Gateway vérifiera que la transaction a échoué ou l'annulera. |
ID de commande Klarna Financing
Pour les paiements approuvés, Mastercard Gateway vous fournira l'ID que Klarna Financing a attribué à cette commande dans le champ transaction.acquirer.additionalResponseData. Cela peut être une information utile pour les communications que vous pourriez avoir directement avec Klarna Financing.
Notifications Webhook
Si vous avez souscrit aux notifications Webhook de Mastercard Gateway, vous pouvez recevoir des notifications supplémentaires pour les mises à jour du statut du financement et les rétrofacturations.
Test de votre intégration
Mastercard Gateway propose un émulateur de paiements avec redirection qui vous permet de tester votre intégration Klarna Financing.