- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser
- Klarna Financing
Klarna Financing
Το Klarna Financing είναι ένας τρόπος πληρωμής που προσφέρεται από την Klarna AB, μια δημοφιλής σουηδική τράπεζα, σε πληρωτές στην Ευρώπη. Το Klarna Financing προσφέρει στους πληρωτές μια ευέλικτη επιλογή χρηματοδότησης κατά την αγορά προϊόντων ηλεκτρονικά.
Οι πληρωτές συνάπτουν μια μακροπρόθεσμη συμφωνία χρηματοδότησης όταν αγοράσουν ένα είδος και πληρώνουν σε δόσεις. Οι πληρωτές μπορούν να επιλέξουν να εξοφλήσουν σε έξι έως τριάντα έξι ισόποσες μηνιαίες δόσεις συμπεριλαμβανομένων των τόκων (αν υπάρχουν), να πληρώσουν ένα ελάχιστο ποσό κάθε μήνα ή να εξοφλήσουν ολόκληρο το ποσό εντός ενός μήνα.
Το Klarna Financing υποστηρίζεται στο Mastercard Gateway. Αυτή η σελίδα περιγράφει τις λεπτομέρειες ενοποίησης ειδικά για το Klarna Financing. Συνιστάται να διαβάσετε τις οδηγίες ενοποίησης για πληρωμές μέσω browser πριν δομήσετε την ενοποίηση για το Klarna Financing.
Προαπαιτούμενα
Για την προσφορά του Klarna Financing μέσω του Mastercard Gateway:
- πρέπει να είστε εγγεγραμμένοι στον πάροχο υπηρεσιών πληρωμής μέσω browser
- το προφίλ εμπόρου σας στο Mastercard Gateway πρέπει να διαμορφωθεί χρησιμοποιώντας τις λεπτομέρειες του λογαριασμού που έχετε με τον πάροχο υπηρεσιών πληρωμής μέσω browser, και
- πρέπει να διαθέτετε τραπεζικό λογαριασμό σε ένα από τα υποστηριζόμενα νομίσματα που έχουν καταχωρηθεί για τον λογαριασμό εμπόρου σας με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Συναλλαγές Klarna Financing
Το Klarna Financing υποστηρίζει συναλλαγές που προέρχονται από διάφορες χώρες με τα αντίστοιχα νομίσματά τους.
| Χώρα | Νόμισμα |
|---|---|
| Αυστρία (AUT) | EUR |
| Γερμανία (DEU) | EUR |
| Κάτω Χώρες (NLD) | EUR |
| Φινλανδία (FIN) | EUR |
| Σουηδία (SWE) | SEK |
| Νορβηγία (NOR) | NOK |
Ενοποίηση του Klarna Financing
Η ενοποίηση Hosted Checkout σάς επιτρέπει να συλλέγετε τις λεπτομέρειες πληρωμής από τους πληρωτές σας μέσω μιας αλληλεπίδρασης που φιλοξενείται και εμφανίζεται από το Mastercard Gateway.
Από το API έκδοση 62 και νεότερη, το Klarna Financing είναι αυτόματα διαθέσιμο ως τρόπος πληρωμής μόλις το your payment service provider σάς ενεργοποιεί και σας διαμορφώνει για αυτόν τον τρόπο πληρωμής.
Για λεπτομέρειες, βλ. Πληρωμές μέσω browser με ενοποίηση Hosted Checkout.
Η ενοποίηση Direct Payment σάς επιτρέπει να προσφέρετε το Klarna Financing στη δική σας σελίδα checkout.
Το Klarna Financing υποστηρίζεται μόνο από το DirectAPI έκδοση 61 και νεότερη.
Κάντε ένα αίτημα Initiate Browser Payment όπου sourceOfFunds.type = KLARNA_FINANCING και browserPayment.operation = PAY (η πράξη Authorize δεν υποστηρίζεται από το 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"
}
}
Επιπλέον των βασικών πεδίων που απαιτούνται σε ένα αίτημα πληρωμής μέσω browser, πρέπει να δώσετε τις ακόλουθες απαιτούμενες πληροφορίες για τη διεκπεραίωση πληρωμών Klarna Financing.
Λεπτομέρειες διεύθυνσης χρέωσης και επικοινωνίας
Αυτά τα πεδία είναι υποχρεωτικά, εκτός αν δηλώνεται διαφορετικά, και απαιτούνται για την υποστήριξη των διαδικασιών εκτίμησης κινδύνου και πιστοληπτικής αξιολόγησης από το Klarna Financing. Οι πληροφορίες επαφής του πληρωτή χρησιμοποιούνται για την επικοινωνία με τον πληρωτή και για την παροχή ηλεκτρονικών τιμολογίων και ειδοποιήσεων πληρωμής.
billing.address.citybilling.address.countrybilling.address.postcodeZipbilling.address.streetcustomer.emailcustomer.firstNamecustomer.lastNamecustomer.mobilePhone: Αυτό το πεδίο απαιτείται όταν δεν παρέχεται τοcustomer.phone.customer.phone: Αυτό το πεδίο απαιτείται όταν δεν παρέχεται τοcustomer.mobilePhone.
Λεπτομέρειες διεύθυνσης αποστολής και επικοινωνίας
Αυτά τα πεδία είναι υποχρεωτικά όταν δίνεται μια τιμή για οποιοδήποτε πεδίο shipping.address.* ή shipping.contact.*.
shipping.address.cityshipping.address.countryshipping.address.postcodeZipshipping.address.streetshipping.contact.emailshipping.contact.firstNameshipping.contact.lastName
Λεπτομέρειες είδους παραγγελίας
Δώστε ολοκληρωμένες λεπτομέρειες για κάθε είδος της παραγγελίας που αγοράστηκε, έτσι ώστε το Klarna Financing να μπορεί να επικυρώσει και να εμφανίσει σωστά αυτές τις πληροφορίες στους πληρωτές και να υποστηρίξει τις διαδικασίες ελέγχου κινδύνων και πιστοληπτικής ικανότητας του Klarna Financing.
order.item[n].nameorder.item[n].quantity: Η τιμή αυτού του πεδίο πρέπει να είναι ακέραιος.order.item[n].unitPriceorder.item[n].unitDiscountAmount: Αυτό το πεδίο απαιτείται όταν το είδος έχει έκπτωση και πρέπει να δίνεται αν υπάρχει μια τιμή στο πεδίοorder.discount.amount.order.item[n].unitTaxAmount: Αυτό το πεδίο απαιτείται όταν ένας πληρωτής πρέπει να καταβάλει φόρο επί του είδους.order.item[n].detail.unitTaxRate: Αυτό το πεδίο απαιτείται όταν έχει δοθεί μια τιμή για το ποσό του φόρου μονάδας.
Αποστολή και διακίνηση
Το συνολικό ποσό φόρου που καταβάλλεται για την παραγγελία εμφανίζεται στους πληρωτές κατά τη διάρκεια της ροής πληρωμών. Αν το ποσό που πρέπει να καταβληθεί για την αποστολή και τη διακίνηση περιλαμβάνει φόρο, τότε πρέπει να δημιουργήσετε μια γραμμή παραγγελίας για την αποστολή και τη διακίνηση, ώστε να μπορεί να δοθεί το ξεχωριστό ποσό φόρου. Αν δεν ισχύει φόρος, τότε το ποσό αποστολής και διακίνησης μπορεί να δοθεί στο πεδίο order.shippingAndHandlingAmount.
Προτιμώμενη γλώσσα
Μπορείτε να ορίσετε τη γλώσσα που προτιμάτε να χρησιμοποιεί το Klarna Financing για τις σελίδες που εμφανίζονται στους πληρωτές δίνοντας το πεδίο browserPayment.preferredLanguage στο αίτημα Initiate Browser Payment. Ωστόσο, για το Klarna Financing υποστηρίζεται μόνο η κύρια εθνική γλώσσα της billing.address.country ή τα Αγγλικά.
Αντιστροφή χρέωσης (chargeback)
Οι πληρωμές με Klarna Financing διατρέχουν τον κίνδυνο αντιστροφής χρέωσης (chargeback). Αν οι πληρωτές αμφισβητήσουν επιτυχώς μια πληρωμή που έγινε με το Klarna Financing, τότε θα δημιουργηθεί μια συναλλαγή αντιστροφής χρέωσης (chargeback) για την παραγγελία. Για περισσότερες πληροφορίες, βλ. τη συναλλαγή αντιστροφής χρέωσης (chargeback).
Τρόπος ερμηνείας του αποτελέσματος της συναλλαγής
Ο παρακάτω πίνακας δείχνει τους κωδικούς απόκρισης συναλλαγής για τα πιθανά σενάρια που ενδέχεται να αντιμετωπίσετε μετά την έναρξη μιας πληρωμής με Klarna Financing.
Απόκριση Initiate Browser Payment |
Τι σημαίνει αυτό... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Ανακατευθύνετε τον πληρωτή χρησιμοποιώντας τη διεύθυνση URL που δίνεται στην απόκριση. |
Απόκριση Retrieve Transaction/Retrieve Order |
Τι σημαίνει αυτό... |
response.gatewayCode=APPROVEDresult=SUCCESS |
Η πληρωμή είναι επιτυχής. |
response.gatewayCode=PENDINGresult=PENDING |
Το Mastercard Gateway περιμένει μια ειδοποίηση από την τράπεζα εμπόρου σχετικά με το αποτέλεσμα της πληρωμής. Δοκιμάστε ξανά το RETRIEVE_TRANSACTION αργότερα ή ακούστε ειδοποιήσεις από το Mastercard Gateway. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Ο πληρωτής έχει ακυρώσει την αλληλεπίδραση για αυτή την πληρωμή. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Η πληρωμή απορρίφθηκε. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. Στην περίπτωση ACQUIRER_SYSTEM_ERROR, ίσως θελήσετε να ρωτήσετε την τράπεζα εμπόρου σχετικά με τον λόγο της αποτυχίας πληρωμής ή μπορείτε να δοκιμάσετε ξανά τη συναλλαγή RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Αντιμετωπίστε το αποτέλεσμα ως απόρριψη πληρωμής. Το Mastercard Gateway θα επιχειρήσει να διασφαλίσει ότι η συναλλαγή δεν είναι επιτυχής ή θα αναστρέψει τη συναλλαγή. |
ID παραγγελίας με το Klarna Financing
Για τις εγκεκριμένες πληρωμές, το Mastercard Gateway θα σας δώσει το αναγνωριστικό που έχει εκχωρήσει η υπηρεσία Klarna Financing σε αυτήν την παραγγελία, στο πεδίο transaction.acquirer.additionalResponseData. Μπορεί να αποτελεί χρήσιμη πληροφορία για την επικοινωνία σας απευθείας με την Klarna Financing.
Ειδοποιήσεις webhook
Αν έχετε εγγραφεί για να λαμβάνετε ειδοποιήσεις webhook από το Mastercard Gateway, ενδέχεται να λάβετε πρόσθετες ειδοποιήσεις σχετικά με τις ενημερώσεις της κατάστασης χρηματοδότησης και τις αντιστροφές χρεώσεων (chargeback).
Δοκιμή της ενοποίησής σας
Το Mastercard Gateway παρέχει έναν εξομοιωτή πληρωμών μέσω browser που σας επιτρέπει να δοκιμάζετε την ενοποίηση Klarna Financing.