- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser
- Πληρωμές Giropay
Giropay
Το Giropay είναι ένα σύστημα πληρωμών ηλεκτρονικού εμπορίου που χρησιμοποιείται στη Γερμανία και επιτρέπει στους πληρωτές να πραγματοποιούν αγορές χρησιμοποιώντας απευθείας online εμβάσματα από τον τραπεζικό λογαριασμό τους. Οι πληρωτές ανακατευθύνονται στον ιστότοπο online banking της τράπεζάς τους, όπου ξεκινούν ένα άμεσο τραπεζικό έμβασμα.
Το Giropay είναι ένας υποστηριζόμενος τρόπος πληρωμής μέσω browser στο American Express PSP. Αυτή η σελίδα περιγράφει τις λεπτομέρειες ενοποίησης ειδικά για το Giropay. Συνιστάται να διαβάσετε τις οδηγίες ενοποίησης για πληρωμές μέσω browser, πριν δομήσετε την ενοποίηση για το Giropay.
Οι πληρωμές μέσω browser με την υπηρεσία Giropay υποστηρίζονται μόνο για συναλλαγές σε EUR.
Προαπαιτούμενα
Για την προσφορά του Giropay ως τρόπο πληρωμής μέσω του American Express PSP:
- Πρέπει να είστε εγγεγραμμένοι στον πάροχο υπηρεσιών πληρωμής μέσω browser.
- Το προφίλ εμπόρου σας στην πύλη πρέπει να διαμορφωθεί χρησιμοποιώντας τις λεπτομέρειες του λογαριασμού που έχετε με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
- Πρέπει να διαθέτετε έναν τραπεζικό λογαριασμό σε ένα από τα υποστηριζόμενα νομίσματα που έχουν καταχωρηθεί για τον λογαριασμό εμπόρου σας με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Ενοποίηση Giropay
Με ενοποιήσεις του Hosted Checkout έκδοσης 50 και νεότερης, το Giropay είναι αυτόματα διαθέσιμο στους πληρωτές σας εφόσον έχετε ενεργοποιηθεί και διαμορφωθεί για αυτό από τον your payment service provider.
Για λεπτομέρειες, βλ. Πληρωμές μέσω browser με ενοποίηση Hosted Checkout.
Η ενοποίηση Web-Services API σάς επιτρέπει να προσφέρετε τον τρόπο πληρωμής Giropay στη δική σας σελίδα checkout.
Επιπλέον των βασικών πεδίων που απαιτούνται σε ένα αίτημα πληρωμής μέσω browser, πρέπει να δώσετε τα ακόλουθα πεδία στο αίτημα Initiate Browser Payment για τη διεκπεραίωση πληρωμών Giropay.
sourceOfFunds.type = GIROPAYbrowserPayment.operation = PAY(η πράξη Authorize δεν υποστηρίζεται από το Giropay).sourceOfFunds.provided.giropay.bankIdentifier: (προαιρετικά) Δώστε το αναγνωριστικό γερμανικής τράπεζας (Bankleitzahl) για τον τραπεζικό λογαριασμό του πληρωτή.sourceOfFunds.provided.giropay.bic: Ο διεθνής αναγνωριστικός εταιρικός κωδικός (BIC) για τον τραπεζικό λογαριασμό του πληρωτή. Για μια ενισχυμένη εμπειρία πληρωτή συνιστάται να δίνετε αυτό το πεδίο. Με αυτόν τον τρόπο, στον πληρωτή δεν εμφανίζεται η φόρμα επιλογής τράπεζας. Αντιθέτως, μεταφέρεται αυτόματα στην τράπεζά του.
Προτιμώμενη γλώσσα
Μπορείτε να ορίσετε τη γλώσσα που προτιμάτε να χρησιμοποιεί το Giropay για τις σελίδες που εμφανίζονται στον πληρωτή δίνοντας το πεδίο browserPayment.preferredLanguage στο αίτημα Initiate Browser Payment. Ωστόσο, η γλώσσα θα χρησιμοποιηθεί μόνο αν υποστηρίζεται από το Giropay.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"https://<return_url>"
},
"order":{
"amount":"10.00",
"currency":"EUR"
},
"sourceOfFunds":{
"type":"GIROPAY"
}
}
Τρόπος ερμηνείας του αποτελέσματος της συναλλαγής
Ο παρακάτω πίνακας δείχνει τους κωδικούς απόκρισης συναλλαγής για τα πιθανά σενάρια που ενδέχεται να αντιμετωπίσετε μετά την έναρξη μιας πληρωμής Giropay.
Απόκριση Initiate Browser Payment |
Τι σημαίνει αυτό... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Ανακατευθύνετε τον πληρωτή χρησιμοποιώντας τη διεύθυνση URL που δίνεται στην απόκριση. |
Απόκριση Retrieve Transaction/Retrieve Order |
Τι σημαίνει αυτό... |
response.gatewayCode=APPROVEDresult=SUCCESSsourceOfFunds.provided.giropay.bankIdentifiersourceOfFunds.provided.giropay.bic
|
Η πληρωμή είναι επιτυχής. |
response.gatewayCode=PENDINGresult=PENDING |
Το American Express PSP περιμένει μια ειδοποίηση από την τράπεζα εμπόρου σχετικά με το αποτέλεσμα της πληρωμής. Δοκιμάστε ξανά το RETRIEVE_TRANSACTION αργότερα ή ακούστε ειδοποιήσεις από το American Express PSP. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Ο πληρωτής έχει ακυρώσει την αλληλεπίδραση για αυτή την πληρωμή. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Η πληρωμή απορρίφθηκε. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. Στην περίπτωση ACQUIRER_SYSTEM_ERROR ίσως θελήσετε να ρωτήσετε την τράπεζα εμπόρου για το λόγο της αποτυχίας πληρωμής ή μπορείτε να δοκιμάσετε ξανά τη συναλλαγή RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Αντιμετωπίστε το αποτέλεσμα ως απόρριψη πληρωμής. Το American Express PSP θα επιχειρήσει να διασφαλίσει ότι η συναλλαγή δεν είναι επιτυχής ή θα αναστρέψει τη συναλλαγή. |
Επιστροφές χρημάτων
Μπορείτε να επιστρέψετε τα χρήματα από πληρωμές Giropay εν μέρει ή εν όλω. Πρέπει να έχετε διαμορφωθεί για να είναι δυνατές οι επιστροφές χρημάτων στο American Express PSP και στον λογαριασμό εμπόρου που τηρείται με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Δοκιμή της ενοποίησής σας
Το American Express PSP παρέχει έναν εξομοιωτή πληρωμών μέσω browser που σας επιτρέπει να δοκιμάζετε την ενοποίηση Giropay.