- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (τρόποι πληρωμής)
- Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser
- Klarna Pay Now
Klarna Pay Now
Το Klarna Pay Now είναι ένας άμεσος τρόπος πληρωμής που προσφέρεται από την Klarna AB, μια δημοφιλή σουηδική τράπεζα, σε πληρωτές στην Ευρώπη. Οι πληρωτές μπορούν να πληρώσουν είτε μέσω τραπεζικού εμβάσματος, είτε με άμεσες χρώσεις, είτε μέσω οποιασδήποτε κάρτας.
Το Klarna Pay Now υποστηρίζεται στο ANZ eGate. Αυτή η σελίδα περιγράφει τις λεπτομέρειες ενοποίησης ειδικά για το Klarna Pay Now. Συνιστάται να διαβάσετε τις οδηγίες ενοποίησης για πληρωμές μέσω browser πριν δομήσετε την ενοποίηση για το Klarna Pay Now.
Προαπαιτούμενα
Για την προσφορά του Klarna Pay Now μέσω του ANZ eGate,
- πρέπει να είστε εγγεγραμμένοι στον πάροχο υπηρεσιών πληρωμής μέσω browser
- το προφίλ εμπόρου σας στο ANZ eGate πρέπει να διαμορφωθεί χρησιμοποιώντας τις λεπτομέρειες του λογαριασμού που έχετε με τον πάροχο υπηρεσιών πληρωμής μέσω browser, και
- πρέπει να διαθέτετε τραπεζικό λογαριασμό σε ένα από τα υποστηριζόμενα νομίσματα που έχουν καταχωρηθεί για τον λογαριασμό εμπόρου σας με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Συναλλαγές Klarna Pay Now
Το Klarna Pay Now υποστηρίζει συναλλαγές που προέρχονται από διάφορες χώρες με τα αντίστοιχα νομίσματά τους.
| Χώρα | Νόμισμα |
|---|---|
| Αυστρία (AUT) | EUR |
| Βέλγιο (BEL) | EUR |
| Γερμανία (DEU) | EUR |
| Ιταλία (ITA) | EUR |
| Κάτω Χώρες (NLD) | EUR |
| Σουηδία (SWE) | SEK |
| Ισπανία (ESP) | EUR |
| Ελβετία (CHE) | CHF |
Ενοποίηση του Klarna Pay Now
Η ενοποίηση Hosted Checkout σάς επιτρέπει να συλλέγετε τις λεπτομέρειες πληρωμής από τον πληρωτή σας μέσω μιας αλληλεπίδρασης που φιλοξενείται και εμφανίζεται.
Από το API έκδοση 65 και νεότερη, το Klarna Pay Now είναι αυτόματα διαθέσιμο ως τρόπος πληρωμής μόλις το your payment service provider σάς ενεργοποιεί και σας διαμορφώνει για αυτόν τον τρόπο πληρωμής.
Για λεπτομέρειες, βλ. Πληρωμές μέσω browser με ενοποίηση Hosted Checkout.
Η ενοποίηση <<directPayment>> σάς επιτρέπει να προσφέρετε τον τρόπο πληρωμής Klarna Pay Now στη δική σας σελίδα checkout.
Το Klarna Pay Now υποστηρίζεται μόνο από το API έκδοση 63 και νεότερη.
Κάντε ένα αίτημα Initiate Browser Payment όπου sourceOfFunds.type = KLARNA_PAY_NOW και browserPayment.operation = PAY (η πράξη Authorize δεν υποστηρίζεται από το Klarna Pay Now).
Από την API έκδοση 65 και νεότερη, χρησιμοποιείτε το πεδίο bankAccountCountryCode. Αυτό το πεδίο προσδιορίζει τη χώρα στην οποία οι πληρωτές έχουν τους τραπεζικούς λογαριασμούς τους.
{
"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"
}
}
}
}
Επιπλέον των βασικών πεδίων που απαιτούνται σε ένα αίτημα πληρωμής μέσω browser, δώστε τις ακόλουθες απαιτούμενες πληροφορίες για τη διεκπεραίωση πληρωμών Klarna Pay Now.
Λεπτομέρειες διεύθυνσης χρέωσης και επικοινωνίας
Αυτά τα πεδία είναι υποχρεωτικά, εκτός αν δηλώνεται διαφορετικά, και απαιτούνται για την υποστήριξη των διαδικασιών αξιολόγησης κινδύνου και πιστοληπτικής αξιολόγησης από την Klarna Pay Now. Οι πληροφορίες επαφής του πληρωτή χρησιμοποιούνται για την επικοινωνία με τον πληρωτή και για την παροχή ηλεκτρονικών τιμολογίων και ειδοποιήσεων πληρωμής.
billing.address.citybilling.address.countrybilling.address.postcodeZipbilling.address.streetcustomer.emailcustomer.firstNamecustomer.lastNamecustomer.mobilePhone: Αυτό το πεδίο απαιτείται όταν δεν παρέχεται τοcustomer.phone.customer.phone: Αυτό το πεδίο απαιτείται όταν δεν παρέχεται τοcustomer.mobilePhone.customer.nationalId: Αυτό το πεδίο είναι προαιρετικό.
Λεπτομέρειες διεύθυνσης αποστολής και επικοινωνίας
Αυτά τα πεδία είναι υποχρεωτικά όταν δίνεται μια τιμή για οποιοδήποτε πεδίο shipping.address.* ή shipping.contact.*.
shipping.address.cityshipping.address.countryshipping.address.postcodeZipshipping.address.streetshipping.contact.emailshipping.contact.firstNameshipping.contact.lastName
Λεπτομέρειες είδους παραγγελίας
Δώστε ολοκληρωμένες λεπτομέρειες για κάθε είδος της παραγγελίας που αγοράστηκε, έτσι ώστε το Klarna Pay Now να μπορεί να επικυρώσει και να εμφανίσει σωστά αυτές τις πληροφορίες στους πληρωτές και να υποστηρίξει τις διαδικασίες ελέγχου κινδύνων και πιστοληπτικής ικανότητας του Klarna Pay Now.
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: Αυτό το πεδίο απαιτείται όταν έχει δοθεί μια τιμή για το ποσό του φόρου μονάδας.
Κωδικός χώρας τραπεζικού λογαριασμού πληρωτή
Πρέπει να δώσετε τον κωδικό χώρας του τραπεζικού λογαριασμού του πληρωτή στο πεδίο sourceOfFunds.provided.klarnaPayNow.bankAccountCountryCode.
Αποστολή και διακίνηση
Το συνολικό ποσό φόρου που καταβάλλεται για την παραγγελία εμφανίζεται στους πληρωτές κατά τη διάρκεια της ροής πληρωμών. Αν το ποσό που πρέπει να καταβληθεί για την αποστολή και τη διακίνηση περιλαμβάνει φόρο, τότε πρέπει να δημιουργήσετε μια γραμμή παραγγελίας για την αποστολή και τη διακίνηση, ώστε να μπορεί να δοθεί το ξεχωριστό ποσό φόρου. Αν δεν ισχύει φόρος, τότε το ποσό αποστολής και διακίνησης μπορεί να δοθεί στο πεδίο order.shippingAndHandlingAmount.
Προτιμώμενη γλώσσα
Μπορείτε να ορίσετε τη γλώσσα που προτιμάτε να χρησιμοποιεί το Klarna Pay Now για τις σελίδες που εμφανίζονται στους πληρωτές δίνοντας το πεδίο browserPayment.preferredLanguage στο αίτημα Initiate Browser Payment. Ωστόσο, για το Klarna Pay Now υποστηρίζεται μόνο η κύρια εθνική γλώσσα της billing.address.country ή τα Αγγλικά.
Αντιστροφή χρέωσης (chargeback)
Οι πληρωμένες με Klarna Pay Now διατρέχουν τον κίνδυνο αντιστροφής χρέωσης (chargeback). Αν οι πληρωτές αμφισβητήσουν επιτυχώς μια πληρωμή με Klarna Pay Now, τότε θα δημιουργηθεί μια συναλλαγή αντιστροφής χρέωσης (chargeback) για την παραγγελία. Για περισσότερες πληροφορίες, βλ. τη συναλλαγή αντιστροφής χρέωσης (chargeback).
Τρόπος ερμηνείας του αποτελέσματος της συναλλαγής
Ο παρακάτω πίνακας δείχνει τους κωδικούς απόκρισης συναλλαγής για τα πιθανά σενάρια που ενδέχεται να αντιμετωπίσετε μετά την έναρξη μιας πληρωμής Klarna Pay Now.
Απόκριση Initiate Browser Payment |
Τι σημαίνει αυτό... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Ανακατευθύνετε τον πληρωτή χρησιμοποιώντας τη διεύθυνση URL που δίνεται στην απόκριση. |
Απόκριση Retrieve Transaction/Retrieve Order |
Τι σημαίνει αυτό... |
response.gatewayCode=APPROVEDresult=SUCCESS |
Η πληρωμή είναι επιτυχής. |
response.gatewayCode=PENDINGresult=PENDING |
Το ANZ eGate περιμένει μια ειδοποίηση από την τράπεζα εμπόρου σχετικά με το αποτέλεσμα της πληρωμής. Δοκιμάστε ξανά το RETRIEVE_TRANSACTION αργότερα ή ακούστε ειδοποιήσεις από το ANZ eGate. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Ο πληρωτής έχει ακυρώσει την αλληλεπίδραση για αυτή την πληρωμή. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Η πληρωμή απορρίφθηκε. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. Στην περίπτωση ACQUIRER_SYSTEM_ERROR ίσως θελήσετε να ρωτήσετε την τράπεζα εμπόρου για το λόγο της αποτυχίας πληρωμής ή μπορείτε να δοκιμάσετε ξανά τη συναλλαγή RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Αντιμετωπίστε το αποτέλεσμα ως απόρριψη πληρωμής. Το ANZ eGate θα επιχειρήσει να διασφαλίσει ότι η συναλλαγή δεν είναι επιτυχής ή θα αναστρέψει τη συναλλαγή. |
ID παραγγελίας Klarna Pay Now
Για τις εγκεκριμένες πληρωμές, το ANZ eGate θα σας δώσει το ID που έχει εκχωρήσει η υπηρεσία Klarna Pay Now σε αυτήν την παραγγελία, στο πεδίο transaction.acquirer.additionalResponseData. Μπορεί να αποτελεί χρήσιμη πληροφορία για την επικοινωνία σας απευθείας με την υπηρεσία Klarna Pay Now.
Ειδοποιήσεις webhook
Αν έχετε εγγραφεί για να λαμβάνετε ειδοποιήσεις webhook από το ANZ eGate, ενδέχεται να λάβετε πρόσθετες ειδοποιήσεις σχετικά με τις ενημερώσεις της κατάστασης χρηματοδότησης και τις αντιστροφές χρεώσεων (chargeback).
Δοκιμή της ενοποίησής σας
Το ANZ eGate παρέχει έναν εξομοιωτή πληρωμών μέσω browser που σας επιτρέπει να δοκιμάζετε την ενοποίηση Klarna Pay Now.