- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser
- Πληρωμές Multibanco
Multibanco
Το Multibanco είναι ένας τρόπος πληρωμής που χρησιμοποιείται στην Πορτογαλία. Το Multibanco δίνει τη δυνατότητα στους καταναλωτές να πληρώνουν για μια σειρά αγαθών ή υπηρεσιών που περιλαμβάνουν ηλεκτρονικό εμπόριο, άδειες και φόρους είτε μέσω τραπεζικής μεταφοράς είτε μέσω της κάρτας Multibanco σε ΑΤΜ.
Το Multibanco είναι ένας υποστηριζόμενος τρόπος πληρωμής μέσω browser στο Mastercard Gateway. Αυτή η σελίδα περιγράφει τις λεπτομέρειες ενοποίησης ειδικά για το Multibanco. Συνιστάται να διαβάσετε τις οδηγίες ενοποίησης για πληρωμές μέσω browser, πριν δομήσετε την ενοποίηση για το Multibanco.
Οι πληρωμές μέσω browser με την υπηρεσία Multibanco υποστηρίζονται μόνο για συναλλαγές σε EUR.
Προαπαιτούμενα
Για την προσφορά του Multibanco ως τρόπου πληρωμής μέσω του Mastercard Gateway:
- πρέπει να είστε εγγεγραμμένοι στον πάροχο υπηρεσιών πληρωμής μέσω browser
- το προφίλ εμπόρου σας στην πύλη πρέπει να διαμορφωθεί χρησιμοποιώντας τις λεπτομέρειες του λογαριασμού που έχετε με τον πάροχο υπηρεσιών πληρωμής μέσω browser, και
- πρέπει να διαθέτετε τραπεζικό λογαριασμό σε ένα από τα υποστηριζόμενα νομίσματα που έχουν καταχωρηθεί για τον λογαριασμό εμπόρου σας με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Ενοποίηση Multibanco
Η ενοποίηση Hosted Checkout σάς επιτρέπει να συλλέγετε τις λεπτομέρειες πληρωμής από τον πληρωτή σας μέσω μιας αλληλεπίδρασης που φιλοξενείται και εμφανίζεται από την πύλη.
Από το API έκδοση 65 και νεότερη, το Multibanco είναι αυτόματα διαθέσιμο ως τρόπος πληρωμής μόλις το your payment service provider σάς ενεργοποιεί και σας διαμορφώνει για αυτόν τον τρόπο πληρωμής.
Για λεπτομέρειες, βλ. Πληρωμές μέσω browser με ενοποίηση Hosted Checkout.
Η ενοποίηση Direct Payment σάς επιτρέπει να προσφέρετε τον τρόπο πληρωμής Multibanco στη δική σας σελίδα checkout.
Κάντε ένα αίτημα Initiate Browser Payment όπου sourceOfFunds.type = MULTIBANCO και browserPayment.operation = PAY (η πράξη Authorize δεν υποστηρίζεται από το Multibanco). Για τα στάνταρ πεδία, βλ. Πληρωμές μέσω browser με ενοποίηση του Direct Payment.
Τα παρακάτω πεδία επιστρέφονται στην απόκριση Initiate Browser Payment/Retrieve Transaction/Retrieve Order αφού ξεκινήσετε μια πληρωμή Multibanco.
sourceOfFunds.provided.multibanco.entityId: Το αναγνωριστικό εμπόρου σας στην υπηρεσία Multibanco.sourceOfFunds.provided.multibanco.paymentReference: Ένα αναγνωριστικό για την πληρωμή Multibanco.
Πρέπει να δώσετε αυτά τα πεδία στον πληρωτή σας για να ολοκληρώσει την πληρωμή.
Προτιμώμενη γλώσσα
Μπορείτε να ορίσετε τη γλώσσα που προτιμάτε να χρησιμοποιεί το Multibanco για τις σελίδες που εμφανίζονται στον πληρωτή δίνοντας το πεδίο browserPayment.preferredLanguage στο αίτημα Initiate Browser Payment. Ωστόσο, η γλώσσα θα χρησιμοποιηθεί μόνο αν υποστηρίζεται από το Multibanco.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"<your_merchant_URL>"
},
"order":{
"amount":"10.00",
"currency":"EUR"
},
"sourceOfFunds":{
"type":"MULTIBANCO"
}
}
Τρόπος ερμηνείας του αποτελέσματος της συναλλαγής
Ο παρακάτω πίνακας δείχνει τους κωδικούς απόκρισης συναλλαγής για τα πιθανά σενάρια που ενδέχεται να αντιμετωπίσετε μετά την έναρξη μιας πληρωμής Multibanco.
Απόκριση Initiate Browser Payment |
Τι σημαίνει αυτό... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Ανακατευθύνετε τον πληρωτή χρησιμοποιώντας τη διεύθυνση URL που δίνεται στην απόκριση. |
Απόκριση Retrieve Transaction/Retrieve Order |
Τι σημαίνει αυτό... |
response.gatewayCode=APPROVEDresult=SUCCESSsourceOfFunds.provided.multibanco.terminalLocationsourceOfFunds.provided.multibanco.terminalId |
Η πληρωμή είναι επιτυχής. |
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 παρέχει έναν εξομοιωτή πληρωμών μέσω browser που σας επιτρέπει να δοκιμάζετε την ενοποίηση Multibanco.