- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Υλοποίηση μιας ενοποίησης πληρωμής μέσω 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 υποστηρίζεται στο Suncorp Bank Gateway. Αυτή η σελίδα περιγράφει τις λεπτομέρειες ενοποίησης ειδικά για το Klarna Pay Later. Συνιστάται να διαβάσετε τις οδηγίες ενοποίησης για πληρωμές μέσω browser, πριν δομήσετε την ενοποίηση για το Klarna Pay Later.
Προαπαιτούμενα
Για την προσφορά του Klarna Pay Later μέσω του Suncorp Bank Gateway,
- πρέπει να είστε εγγεγραμμένοι στον πάροχο υπηρεσιών πληρωμής μέσω browser
- το προφίλ εμπόρου σας στο Suncorp Bank Gateway πρέπει να διαμορφωθεί χρησιμοποιώντας τις λεπτομέρειες του λογαριασμού που έχετε με τον πάροχο υπηρεσιών πληρωμής μέσω 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
Η ενοποίηση Hosted Checkout σάς επιτρέπει να συλλέγετε τις λεπτομέρειες πληρωμής από τους πληρωτές σας μέσω μιας αλληλεπίδρασης που φιλοξενείται και εμφανίζεται από το Suncorp Bank Gateway.
Από το API έκδοση 52 και νεότερη, το Klarna Pay Later είναι αυτόματα διαθέσιμο ως τρόπος πληρωμής μόλις το your payment service provider σάς ενεργοποιεί και σας διαμορφώνει για αυτόν τον τρόπο πληρωμής.
Για λεπτομέρειες, βλ. Πληρωμές μέσω browser με ενοποίηση Hosted Checkout.
Η ενοποίηση Direct Payment σάς επιτρέπει να προσφέρετε τον τρόπο πληρωμής Klarna Pay Later στη δική σας σελίδα checkout.
Το Klarna Pay Later υποστηρίζεται μόνο από το API έκδοση 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 |
Το Suncorp Bank Gateway περιμένει μια ειδοποίηση από την τράπεζα εμπόρου σχετικά με το αποτέλεσμα της πληρωμής. Δοκιμάστε ξανά το RETRIEVE_TRANSACTION αργότερα ή ακούστε ειδοποιήσεις από το Suncorp Bank Gateway. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Ο πληρωτής έχει ακυρώσει την αλληλεπίδραση για αυτή την πληρωμή. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Η πληρωμή απορρίφθηκε. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. Στην περίπτωση ACQUIRER_SYSTEM_ERROR, ίσως θελήσετε να ρωτήσετε την τράπεζα εμπόρου σχετικά με τον λόγο της αποτυχίας πληρωμής ή μπορείτε να δοκιμάσετε ξανά τη συναλλαγή RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Αντιμετωπίστε το αποτέλεσμα ως απόρριψη πληρωμής. Το Suncorp Bank Gateway θα επιχειρήσει να διασφαλίσει ότι η συναλλαγή δεν είναι επιτυχής ή θα αναστρέψει τη συναλλαγή. |
ID παραγγελίας Klarna Pay Later
Για τις εγκεκριμένες πληρωμές, το Suncorp Bank Gateway θα σας δώσει το ID που έχει εκχωρήσει η υπηρεσία Klarna Pay Later σε αυτήν την παραγγελία, στο πεδίο transaction.acquirer.additionalResponseData. Μπορεί να αποτελεί χρήσιμη πληροφορία για την επικοινωνία σας απευθείας με την Klarna Pay Later.
Ειδοποιήσεις webhook
Αν έχετε εγγραφεί για να λαμβάνετε ειδοποιήσεις webhook από το Suncorp Bank Gateway, ενδέχεται να λάβετε πρόσθετες ειδοποιήσεις σχετικά με τις ενημερώσεις της κατάστασης χρηματοδότησης και τις αντιστροφές χρεώσεων (chargeback).
Δοκιμή της ενοποίησής σας
Το Suncorp Bank Gateway παρέχει έναν εξομοιωτή πληρωμών μέσω browser που σας επιτρέπει να δοκιμάζετε την ενοποίηση Klarna Pay Later.