- Directives d'intégration
- Fonctionnalités prises en charge (Méthodes de paiement)
- Mise en œuvre d'une intégration des paiements avec redirection
- Klarna Pay Now
Klarna Pay Now
Klarna Pay Now est une méthode de paiement immédiat fournie par Klarna AB, une banque suédoise populaire, aux payeurs en Europe. Les payeurs peuvent payer par virement bancaire, par prélèvement automatique ou à l'aide de n'importe quelle carte.
La méthode Klarna Pay Now est prise en charge dans Payment Gateway. Cette page explique les détails de l'intégration spécifique à Klarna Pay Now. Nous vous recommandons de lire les instructions d'intégration pour les paiements avec redirection avant de créer une intégration Klarna Pay Now.
Conditions préalables
Pour proposer Klarna Pay Now via Payment Gateway,
- vous devez être inscrit auprès de votre prestataire de services de paiement avec redirection,
- votre profil de commerçant sur Payment 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.
Transactions Klarna Pay Now
Klarna Pay Now prend en charge les transactions provenant de différents pays avec leurs devises correspondantes.
| Pays | Devise |
|---|---|
| Autriche (AUT) | EUR |
| Belgique (BEL) | EUR |
| Allemagne (DEU) | EUR |
| Italie (ITA) | EUR |
| Pays-Bas (NLD) | EUR |
| Suède (SWE) | SEK |
| Espagne (ESP) | EUR |
| Suisse (CHE) | CHF |
Intégration Klarna Pay Now
L'intégration Hosted Checkout vous permet de recueillir des détails de paiement auprès de votre payeur à l’aide d’une interaction hébergée et affichée par la passerelle.
À compter de la version 65 de l'API, Klarna Pay Now est automatiquement disponible comme méthode de paiement après votre activation et votre configuration par your payment service provider pour cette méthode de paiement.
Pour plus d'informations, voir Intégration des paiements avec redirection via Hosted Checkout.
L'intégration Direct API vous permet de proposer Klarna Pay Now sur votre propre page de paiement.
La méthode Klarna Pay Now est prise en charge à compter de la version 63 de Direct API.
Vous pouvez utiliser la demande Initiate Browser Payment (Lancer un paiement avec redirection) où sourceOfFunds.type = KLARNA_PAY_NOW et browserPayment.operation = PAY (l'opération Authorize (Autoriser) n'est pas prise en charge par Klarna Pay Now).
À compter de la version 65 de l'API, utilisez le champ bankAccountCountryCode. Ce champ précise le pays dans lequel les payeurs ont leurs comptes bancaires.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"billing":{
"address":{
"city":"Edinburgh",
"company":"MPGS",
"country":"DEU",
"postcodeZip":"EH123AB",
"stateProvince":"Scotland",
"street":"OceanPoint",
"street2":"OceanDrive"
}
},
"browserPayment":{
"operation":"PAY",
"returnUrl":"<your_merchant_URL>"
},
"customer":{
"account":{
"id":"custoAccount"
},
"dateOfBirth":"1999-12-31",
"email":"john.smith@example.com",
"firstName":"John",
"lastName":"Smith",
"mobilePhone":"01234567890",
"nationalId":"X4RTBPFW4"
},
"order":{
"amount":"154.16",
"currency":"EUR",
"item":[
{
"name":"Diesel Jeans",
"quantity":"1",
"unitPrice":"70.83"
},
{
"name":"Adidas Trainers",
"quantity":"1",
"unitPrice":"83.33"
}
]
},
"shipping":{
"address":{
"city":"Shipsville",
"country":"GBR",
"postcodeZip":"EH67DX",
"stateProvince":"Scotland",
"street":"2ShippingHeights",
"street2":"ShipsDrive"
},
"contact":{
"email":"john.smith@example.com",
"firstName":"John",
"lastName":"Smith"
}
},
"sourceOfFunds":{
"type":"KLARNA_PAY_NOW",
"provided":{
"klarnaPayNow":{
"bankAccountCountryCode":"GBR"
}
}
}
}
Outre les champs standard requis dans une demande de paiement avec redirection, vous devez fournir les informations requises suivantes pour le traitement des paiements Klarna Pay Now.
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 Pay Now. 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é.customer.nationalId: ce champ est facultatif.
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 Pay Now 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 Pay Now.
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é.
Code de pays du compte bancaire du payeur
Vous devez indiquer le code de pays du compte bancaire du payeur dans le champ sourceOfFunds.provided.klarnaPayNow.bankAccountCountryCode.
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 Pay Now 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 Pay Now, 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 Pay Now peuvent faire l'objet de rétrofacturations. Si des payeurs contestent avec succès un paiement après de Klarna Pay Now, 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 Pay Now.
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 |
Payment 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 Payment Gateway. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Le payeur a annulé l'interaction pour ce paiement. Proposez au payeur d'essayer une autre méthode de paiement. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Le paiement a été refusé. Proposez au payeur d'essayer une autre méthode de paiement. Dans le 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é. Payment Gateway vérifiera que la transaction a échoué ou l'annulera. |
ID de commande Klarna Pay Now
Pour les paiements approuvés, Payment Gateway vous fournira l’ID que Klarna Pay Now 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 Pay Now.
Notifications Webhook
Si vous avez souscrit aux notifications Webhook de Payment 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
Payment Gateway propose un émulateur de paiements avec redirection qui vous permet de tester votre intégration Klarna Pay Now.