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