- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser
- Πληρωμές Bancontact
Bancontact
Το Bancontact είναι ένας τρόπος πληρωμής online τραπεζικού εμβάσματος σε πραγματικό χρόνο (real time) με έδρα το Βέλγιο. Το Bancontact είναι ένας υποστηριζόμενος τρόπος πληρωμής μέσω browser στο <<paymentGateway>>. Αυτή η σελίδα περιγράφει τις λεπτομέρειες ενοποίησης ειδικά για το Bancontact.
Συνιστάται να διαβάσετε τις οδηγίες ενοποίησης για πληρωμές μέσω browser πριν δομήσετε την ενοποίηση για το Bancontact.
Οι πληρωμές μέσω browser με την υπηρεσία Bancontact υποστηρίζονται μόνο για συναλλαγές σε EUR.
Προαπαιτούμενα
Για την προσφορά του Bancontact ως τρόπου πληρωμής μέσω του <<paymentGateway>>:
- πρέπει να είστε εγγεγραμμένοι στον πάροχο υπηρεσιών πληρωμής μέσω browser
- το προφίλ εμπόρου σας στο <<paymentGateway>> πρέπει να διαμορφωθεί χρησιμοποιώντας τις λεπτομέρειες του λογαριασμού που έχετε με τον πάροχο υπηρεσιών πληρωμής μέσω browser, και
- πρέπει να διαθέτετε έναν τραπεζικό λογαριασμό σε ένα από τα υποστηριζόμενα νομίσματα που έχουν καταχωρηθεί για τον λογαριασμό εμπόρου σας με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Ενοποίηση Bancontact
Η ενοποίηση <<checkout>> σάς επιτρέπει να συλλέγετε τις λεπτομέρειες πληρωμής από τον πληρωτή σας μέσω μιας αλληλεπίδρασης που φιλοξενείται και εμφανίζεται από το <<paymentGateway>>.
Από την έκδοση API 65 και νεότερη, το Bancontact είναι αυτόματα διαθέσιμο ως τρόπος πληρωμής μόλις το <<paymentServiceProvider>> σάς ενεργοποιεί και σας διαμορφώνει για αυτόν τον τρόπο πληρωμής.
Για λεπτομέρειες, βλ. Πληρωμές μέσω browser με ενοποίηση <<checkout>>.
Η ενοποίηση <<directPayment>> σάς επιτρέπει να προσφέρετε τον τρόπο πληρωμής Bancontact στη δική σας σελίδα checkout.
Επιπλέον των βασικών πεδίων που απαιτούνται σε ένα αίτημα πληρωμής μέσω browser, πρέπει να δώσετε τα ακόλουθα πεδία στο αίτημα Initiate Browser Payment:
Κοινά πεδία
sourceOfFunds.type=BANCONTACTbrowserPayment.operation=PAY (Bancontact does not support the Authorize operation)customer.email=Email address of a payersourceOfFunds.provided.bancontact.bankAccountHolder= Όνομα του κατόχου του τραπεζικού λογαριασμού για τον τραπεζικό λογαριασμό του πληρωτή.
Προτιμώμενη γλώσσα
Μπορείτε να ορίσετε τη γλώσσα που προτιμάτε να χρησιμοποιεί το Bancontact για τις σελίδες που εμφανίζονται στον πληρωτή δίνοντας το πεδίο browserPayment.preferredLanguage στο αίτημα Initiate Browser Payment. Ωστόσο, η γλώσσα θα χρησιμοποιηθεί μόνο αν υποστηρίζεται από το Bancontact.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"<your_merchant_URL>"
},
"order":{
"amount":"10.00",
"currency":"EUR"
},
"sourceOfFunds":{
"type":"BANCONTACT",
"provided":{
"bancontact":{
"bankAccountHolder":"George Smith"
}
}
}
}
Τρόπος ερμηνείας του αποτελέσματος της συναλλαγής
Αυτός ο πίνακας καθορίζει τους κωδικούς απόκρισης συναλλαγής για τα πιθανά σενάρια που ενδέχεται να αντιμετωπίσετε μετά την έναρξη μιας πληρωμής Bancontact.
| Απόκριση 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>> θα επιχειρήσει να διασφαλίσει ότι η συναλλαγή δεν είναι επιτυχής ή θα αναστρέψει τη συναλλαγή. |
Επιστροφές χρημάτων
Μπορείτε να επιστρέψετε τα χρήματα από πληρωμές Bancontact σε δόσεις ή στο ακέραιο. Βεβαιωθείτε ότι έχετε διαμορφωθεί για να επιστροφές χρημάτων στο <<paymentGateway>> και στον λογαριασμό εμπόρου που τηρείται με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Δοκιμή της ενοποίησής σας
Το <<paymentGateway>> παρέχει έναν εξομοιωτή πληρωμών μέσω browser που σας επιτρέπει να δοκιμάζετε την ενοποίηση Bancontact.