- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser
- Πληρωμές eps-Überweisung
eps-Überweisung
Το eps-Überweisung είναι ένας online τρόπος πληρωμής για πελάτες αυστριακών τραπεζών. Οι πληρωτές επιλέγουν πρώτα την τράπεζα τους και, στη συνέχεια, ανακατευθύνονται στο online banking για την επιλεγμένη τράπεζα για να ολοκληρώσουν την πληρωμή.
Συνιστάται να διαβάσετε τις οδηγίες ενοποίησης για πληρωμές μέσω browser, πριν δομήσετε την ενοποίηση για το eps-Überweisung.
Οι πληρωμές μέσω browser με την υπηρεσία eps-Überweisung υποστηρίζονται μόνο για συναλλαγές σε EUR.
Προαπαιτούμενα
Για την προσφορά του eps-Überweisung ως τρόπου πληρωμής μέσω του <<paymentGateway>>:
- πρέπει να είστε εγγεγραμμένοι στον πάροχο υπηρεσιών πληρωμής μέσω browser
- το προφίλ εμπόρου σας στο <<paymentGateway>> πρέπει να διαμορφωθεί χρησιμοποιώντας τις λεπτομέρειες του λογαριασμού που έχετε με τον πάροχο υπηρεσιών πληρωμής μέσω browser, και
- πρέπει να διαθέτετε τραπεζικό λογαριασμό σε ένα από τα υποστηριζόμενα νομίσματα που έχουν καταχωρηθεί για τον λογαριασμό εμπόρου σας με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Συναλλαγές eps-Überweisung
Οι τράπεζες εμπόρου PPRO υποστηρίζουν τις συναλλαγές eps-Überweisung που προέρχονται από τη χώρα και το αντίστοιχο νόμισμα που αναφέρεται στον ακόλουθο πίνακα.
| Χώρα | Νόμισμα |
|---|---|
| Αυστρία (AUT) | EUR |
Ενοποίηση του eps-Überweisung
Η ενοποίηση <<checkout>> σάς επιτρέπει να συλλέγετε τις λεπτομέρειες πληρωμής από τον πληρωτή σας μέσω μιας αλληλεπίδρασης που φιλοξενείται και εμφανίζεται από το <<paymentGateway>>.
Από το API έκδοση 67 και νεότερη, το eps-Überweisung είναι αυτόματα διαθέσιμο ως τρόπος πληρωμής μόλις το <<paymentServiceProvider>> σάς ενεργοποιεί και σας διαμορφώνει για αυτόν τον τρόπο πληρωμής.
Για λεπτομέρειες, βλ. Πληρωμές μέσω browser με ενοποίηση <<checkout>>.
Η ενοποίηση <<directPayment>> σάς επιτρέπει να προσφέρετε τον τρόπο πληρωμής eps-Überweisung στη δική σας σελίδα checkout.
Κοινά πεδία
Επιπλέον των βασικών πεδίων που απαιτούνται σε ένα αίτημα πληρωμής μέσω browser, πρέπει να δώσετε τα ακόλουθα κοινά πεδία στο αίτημα Initiate Browser Payment:
sourceOfFunds.type-EPS_UEBERWEISUNGbrowserPayment.operation-PAYcustomer.account.id-The ID, username, hash, or anything that is used to identify the payercustomer.email-Email address of a payersourceOfFunds.provided.epsUeberweisung.bankAccountHolder-Name of the bank account holder for the payer's bank accountsourceOfFunds.provided.epsUeberweisung.bankAccountCountryCode-The country where payers have their bank account. Provide the ISO 3166 alpha-3 country code for this country
Προτιμώμενη γλώσσα
Μπορείτε να ορίσετε τη γλώσσα που προτιμάτε να χρησιμοποιεί το eps-Überweisung για τις σελίδες που εμφανίζονται στον πληρωτή δίνοντας το πεδίο browserPayment.preferredLanguage στο αίτημα Initiate Browser Payment. Ωστόσο, η γλώσσα θα χρησιμοποιηθεί μόνο αν υποστηρίζεται από το eps-Überweisung.
{
"apiOperation": "INITIATE_BROWSER_PAYMENT",
"browserPayment": {
"operation": "PAY",
"returnUrl": "<your_merchant_URL>"
},
"customer": {
"email": "john.smith@example.com"
},
"order": {
"amount": "142.01",
"currency": "EUR"
},
"sourceOfFunds": {
"type": "EPS_UEBERWEISUNG",
"provided": {
"epsUeberweisung": {
"bankAccountHolder": "Test accountHolder",
"bankAccountCountryCode": "AUT"
}
}
}
}
Τρόπος ερμηνείας του αποτελέσματος της συναλλαγής
Ο παρακάτω πίνακας καθορίζει τους κωδικούς απόκρισης συναλλαγής για τα πιθανά σενάρια που ενδέχεται να αντιμετωπίσετε μετά την έναρξη μιας πληρωμής eps-Überweisung.
| Απόκριση 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 ή ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Η πληρωμή απορρίφθηκε. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. Στην περίπτωση ACQUIRER_SYSTEM_ERROR, ίσως θελήσετε να ρωτήσετε την τράπεζα εμπόρου σχετικά με τον λόγο της αποτυχίας πληρωμής ή μπορείτε να δοκιμάσετε ξανά τη συναλλαγή RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Αντιμετωπίστε το αποτέλεσμα ως απόρριψη πληρωμής. Το <<paymentGateway>> θα επιχειρήσει να επιβεβαιώσει ότι η συναλλαγή δεν είναι επιτυχής ή θα αναστρέψει τη συναλλαγή. |
Επιστροφές χρημάτων
Μπορείτε να επιστρέψετε τα χρήματα από πληρωμές eps-Überweisung σε δόσεις ή στο ακέραιο. Βεβαιωθείτε ότι έχετε διαμορφωθεί για να επιστροφές χρημάτων στο <<paymentGateway>> και στον λογαριασμό εμπόρου που τηρείται με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Δοκιμή της ενοποίησής σας
Το <<paymentGateway>> παρέχει έναν εξομοιωτή πληρωμών μέσω browser που σας επιτρέπει να δοκιμάζετε την ενοποίηση eps-Überweisung.