- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser
- Klarna Pay Later
Klarna Pay Later
Το Klarna Pay Later είναι ένας τρόπος πληρωμής που προσφέρεται από την Klarna AB, μια δημοφιλή σουηδική τράπεζα, σε πληρωτές στην Ευρώπη.
Στο Klarna Pay Later, οι πληρωτές μπορούν να πραγματοποιήσουν την πληρωμή μέσα στον προκαθορισμένο αριθμό ημερών. Οι πληρωτές εξετάζουν τα είδη που τους παραδίδει ο έμπορος και κρατούν μόνο τα είδη που προτίθενται να αγοράσουν και να πληρώσουν, και επιστρέφουν όλα τα ανεπιθύμητα είδη. Για τις εγκεκριμένες πληρωμές, η Klarna AB αναλαμβάνει όλους τους πιστωτικούς κινδύνους και τους κινδύνους απάτης, και σας πληρώνει για το πλήρες ποσό μιας παραγγελίας. Διασφαλίστε την επιστροφή των χρημάτων κάθε είδους που σας επιστρέφουν οι πληρωτές μέσω της πράξης Refund. Οι πληρωτές μπορούν να ακυρώσουν πληροφορίες με την πράξη Refund για το πλήρες ποσό της αγοράς. Στη συνέχεια, το Klarna Pay Later τιμολογεί τους πληρωτές και εισπράττει την πληρωμή, παρέχοντας ειδοποιήσεις μέσω email και υπενθυμίσεις εκ των προτέρων για την προθεσμία της πληρωμής.
Το Klarna Pay Later υποστηρίζεται στο <<paymentGateway>>. Αυτή η σελίδα περιγράφει τις λεπτομέρειες ενοποίησης ειδικά για το Klarna Pay Later. Συνιστάται να διαβάσετε τις οδηγίες ενοποίησης για πληρωμές μέσω browser, πριν δομήσετε την ενοποίηση για το Klarna Pay Later.
Προαπαιτούμενα
Για την προσφορά του Klarna Pay Later μέσω του <<paymentGateway>>,
- πρέπει να είστε εγγεγραμμένοι στον πάροχο υπηρεσιών πληρωμής μέσω browser
- το προφίλ εμπόρου σας στο <<paymentGateway>> πρέπει να διαμορφωθεί χρησιμοποιώντας τις λεπτομέρειες του λογαριασμού που έχετε με τον πάροχο υπηρεσιών πληρωμής μέσω browser, και
- πρέπει να διαθέτετε τραπεζικό λογαριασμό σε ένα από τα υποστηριζόμενα νομίσματα που έχουν καταχωρηθεί για τον λογαριασμό εμπόρου σας με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Συναλλαγές Klarna Pay Later
Το Klarna Pay Later υποστηρίζει συναλλαγές που προέρχονται από διάφορες χώρες με τα αντίστοιχα νομίσματά τους.
| Χώρα | Νόμισμα |
|---|---|
| Αυστρία (AUT) | EUR |
| Βέλγιο (BEL) | EUR |
| Δανία (DNK) | DKK |
| Φινλανδία (FIN) | EUR |
| Γερμανία (DEU) | EUR |
| Μεγάλη Βρετανία (GBR) | GBP |
| Κάτω Χώρες (NLD) | EUR |
| Νορβηγία (NOR) | NOK |
| Πολωνία (POL) | PLN |
| Σουηδία (SWE) | SEK |
| Ελβετία (CHE) | CHF |
Ενοποίηση του Klarna Pay Later
Η ενοποίηση <<checkout>> σάς επιτρέπει να συλλέγετε τις λεπτομέρειες πληρωμής από τους πληρωτές σας μέσω μιας αλληλεπίδρασης που φιλοξενείται και εμφανίζεται από το <<paymentGateway>>.
Από το API έκδοση 52 και νεότερη, το Klarna Pay Later είναι αυτόματα διαθέσιμο ως τρόπος πληρωμής μόλις το <<paymentServiceProvider>> σάς ενεργοποιεί και σας διαμορφώνει για αυτόν τον τρόπο πληρωμής.
Για λεπτομέρειες, βλ. Πληρωμές μέσω browser με ενοποίηση <<checkout>>.
Η ενοποίηση <<directPayment>> σάς επιτρέπει να προσφέρετε τον τρόπο πληρωμής Klarna Pay Later στη δική σας σελίδα checkout.
Το Klarna Pay Later υποστηρίζεται μόνο από το <<webServicesIntegration>> έκδοση 52 και νεότερη.
Κάντε το αίτημα Initiate Browser Payment όπου sourceOfFunds.type = KLARNA_PAY_LATER και browserPayment.operation = PAY (η πράξη Authorize δεν υποστηρίζεται από το Klarna Pay Later).
sourceOfFunds.type = KLARNA PAY LATER όταν κάνετε το αίτημα Initiate Browser Payment.
{
"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"
}
}
Επιπλέον των βασικών πεδίων που απαιτούνται σε ένα αίτημα πληρωμής μέσω browser, δώστε τις ακόλουθες απαιτούμενες πληροφορίες για τη διεκπεραίωση πληρωμών Klarna Pay Later.
Λεπτομέρειες διεύθυνσης χρέωσης και επικοινωνίας
Αυτά τα πεδία είναι υποχρεωτικά, εκτός αν δηλώνεται διαφορετικά, και απαιτούνται για την υποστήριξη των διαδικασιών εκτίμησης κινδύνου και πιστοληπτικής αξιολόγησης από την Klarna Pay Later. Οι πληροφορίες επαφής του πληρωτή χρησιμοποιούνται για την επικοινωνία με τον πληρωτή και για την παροχή ηλεκτρονικών τιμολογίων και ειδοποιήσεων πληρωμής.
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 Pay Later να μπορεί να επικυρώσει και να εμφανίσει σωστά αυτές τις πληροφορίες στους πληρωτές και να υποστηρίξει τις διαδικασίες ελέγχου κινδύνων και πιστοληπτικής ικανότητας του Klarna Pay Later.
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 Pay Later για τις σελίδες που εμφανίζονται στους πληρωτές δίνοντας το πεδίο browserPayment.preferredLanguage στο αίτημα Initiate Browser Payment. Ωστόσο, για το Klarna Pay Later υποστηρίζεται μόνο η κύρια εθνική γλώσσα της billing.address.country ή τα Αγγλικά.
Αντιστροφή χρέωσης (chargeback)
Οι πληρωμένες με Klarna Pay Later διατρέχουν τον κίνδυνο αντιστροφής χρέωσης (chargeback). Αν οι πληρωτές αμφισβητήσουν επιτυχώς μια πληρωμή με Klarna Pay Later, τότε θα δημιουργηθεί μια συναλλαγή αντιστροφής χρέωσης (chargeback) για την παραγγελία. Για περισσότερες πληροφορίες, βλ. τη συναλλαγή αντιστροφής χρέωσης (chargeback).
Τρόπος ερμηνείας του αποτελέσματος της συναλλαγής
Ο παρακάτω πίνακας δείχνει τους κωδικούς απόκρισης συναλλαγής για τα πιθανά σενάρια που ενδέχεται να αντιμετωπίσετε μετά την έναρξη μιας πληρωμής Klarna Pay Later.
Απόκριση Initiate Browser Payment |
Τι σημαίνει αυτό... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Ανακατευθύνετε τον πληρωτή χρησιμοποιώντας τη διεύθυνση URL που δίνεται στην απόκριση. |
Απόκριση Retrieve Transaction/Retrieve Order |
Τι σημαίνει αυτό... |
response.gatewayCode=APPROVEDresult=SUCCESS |
Η πληρωμή είναι επιτυχής. |
response.gatewayCode=PENDINGresult=PENDING |
Το <<paymentGateway>> περιμένει μια ειδοποίηση από την τράπεζα εμπόρου σχετικά με το αποτέλεσμα της πληρωμής. Δοκιμάστε ξανά το RETRIEVE_TRANSACTION αργότερα ή ακούστε ειδοποιήσεις από το <<paymentGateway>>. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Ο πληρωτής έχει ακυρώσει την αλληλεπίδραση για αυτή την πληρωμή. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Η πληρωμή απορρίφθηκε. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. Στην περίπτωση ACQUIRER_SYSTEM_ERROR, ίσως θελήσετε να ρωτήσετε την τράπεζα εμπόρου σχετικά με τον λόγο της αποτυχίας πληρωμής ή μπορείτε να δοκιμάσετε ξανά τη συναλλαγή RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Αντιμετωπίστε το αποτέλεσμα ως απόρριψη πληρωμής. Το <<paymentGateway>> θα επιχειρήσει να διασφαλίσει ότι η συναλλαγή δεν είναι επιτυχής ή θα αναστρέψει τη συναλλαγή. |
ID παραγγελίας Klarna Pay Later
Για τις εγκεκριμένες πληρωμές, το <<paymentGateway>> θα σας δώσει το ID που έχει εκχωρήσει η υπηρεσία Klarna Pay Later σε αυτήν την παραγγελία, στο πεδίο transaction.acquirer.additionalResponseData. Μπορεί να αποτελεί χρήσιμη πληροφορία για την επικοινωνία σας απευθείας με την Klarna Pay Later.
Ειδοποιήσεις webhook
Αν έχετε εγγραφεί για να λαμβάνετε ειδοποιήσεις webhook από το <<paymentGateway>>, ενδέχεται να λάβετε πρόσθετες ειδοποιήσεις σχετικά με τις ενημερώσεις της κατάστασης χρηματοδότησης και τις αντιστροφές χρεώσεων (chargeback).
Δοκιμή της ενοποίησής σας
Το <<paymentGateway>> παρέχει έναν εξομοιωτή πληρωμών μέσω browser που σας επιτρέπει να δοκιμάζετε την ενοποίηση Klarna Pay Later.