- Directives d'intégration
- Fonctionnalités prises en charge (Modes de paiement)
- Mise en œuvre d'une intégration des paiements avec redirection
- Klarna Pay Later
Klarna Pay Later
Klarna Pay Later est un mode de paiement fourni par Klarna AB, une banque suédoise populaire, aux payeurs en Europe.
Dans Klarna Pay Later, les payeurs peuvent effectuer le paiement dans le nombre de jours spécifié. Les payeurs examinent les articles qui livrés par le commerçant et ne conservent que ceux qu'ils ont l'intention d'acheter et de payer ; tous les articles non désirés sont retournés. Pour les paiements approuvés, Klarna AB assume tous les risques de crédit et de fraude et vous paie le montant total de la commande. Assurez-vous de rembourser chaque article que les payeurs vous retournent via l'opération Refund (Rembourser). Les payeurs peuvent annuler les commandes par une opération Refund (Rembourser) pour le montant total de l'achat. Par la suite, Klarna Pay Later facture les payeurs et collecte le paiement, en fournissant des notifications par e-mail et des rappels avant l'échéance du paiement.
La méthode Klarna Pay Later est prise en charge dans Mastercard Gateway. Cette page explique les détails de l'intégration spécifique à Klarna Pay Later. Nous vous recommandons de lire les instructions d'intégration pour les paiements avec redirection avant de créer une intégration Klarna Pay Later.
Conditions préalables
Pour proposer Klarna Pay Later 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.
Transactions Klarna Pay Later
Klarna Pay Later prend en charge les transactions provenant de différents pays avec leurs devises correspondantes.
| Pays | Devise |
|---|---|
| Autriche (AUT) | EUR |
| Belgique (BEL) | EUR |
| Danemark (DNK) | DKK |
| Finlande (FIN) | EUR |
| Allemagne (DEU) | EUR |
| Grande-Bretagne (GBR) | GBP |
| Pays-Bas (NLD) | EUR |
| Norvège (NOR) | NOK |
| Pologne (POL) | PLN |
| Suède (SWE) | SEK |
| Suisse (CHE) | CHF |
Intégration Klarna Pay Later
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 52 de l'API, Klarna Pay Later 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 Pay Later sur votre propre page de paiement.
La méthode Klarna Pay Later est prise en charge à compter de la version 52 de API.
Vous pouvez utiliser la demande Initiate Browser Payment (Lancer un paiement avec redirection) où sourceOfFunds.type = KLARNA_PAY_LATER et browserPayment.operation = PAY (l'opération Authorize (Autoriser) n'est pas prise en charge par Klarna Pay Later).
sourceOfFunds.type = KLARNA PAY LATER lors d'une demande Initiate Browser Payment (Lancer un paiement avec redirection).
{
"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": 57.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": "Shipping & Handling",
"quantity": "1",
"unitPrice": 4.17,
"unitTaxAmount": 0.83,
"detail": {
"unitTaxRate": 0.2
}
}
]
},
"sourceOfFunds": {
"type": "KLARNA_PAY_LATER"
}
}
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 Later.
Adresse de facturation et détails du contact
Ces champs sont obligatoires, sauf indication contraire, et sont requis pour prendre en charge les traitements d'évaluation des risques et de contrôle du crédit Klarna Pay Later. 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 Pay Later puisse correctement valider et afficher ces informations pour les payeurs et pour prendre en charge les traitements de contrôle des risques et du crédit de Klarna Pay Later.
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 Pay Later 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 Later, seule la langue nationale principale du pays indiqué dans le champ billing.address.country ou l'anglais sera pris en charge.
Rétrofacturations
Klarna Pay Later peut faire l'objet de rétrofacturations. Si des payeurs contestent avec succès un paiement après de Klarna Pay Later, 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 Later.
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. |
Identifiant de commande Klarna Pay Later
Pour les paiements approuvés, Mastercard Gateway vous fournira l'identifiant que Klarna Pay Later 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 Later.
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 Pay Later.