- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser
- Πληρωμές Boleto Bancário
Boleto Bancário
Το Boleto Bancário είναι ένα σύστημα πληρωμών ηλεκτρονικού εμπορίου που χρησιμοποιείται στη Βραζιλία και επιτρέπει στους πληρωτές να πραγματοποιούν αγορές χρησιμοποιώντας είτε πληρωμές σε μετρητά είτε μέσω ηλεκτρονικών τραπεζικών πληρωμών. Όταν ο πληρωτής επιλέγει το Boleto Bancário στη σελίδα checkout και συνεχίζει σε πληρωμή σε μετρητά, οι λεπτομέρειες πληρωμής εμφανίζονται στην οθόνη και μπορούν να εκτυπωθούν. Ο πληρωτής μπορεί τότε να πληρώσει το ποσό που απαιτείται για την αγορά σε μια θέση Boleto Bancário. Για τις πληρωμές online banking, ο πληρωτής εισάγει τις λεπτομέρειες του Boleto Bancário, εξετάζει και εγκρίνει την πληρωμή. Και στις δύο περιπτώσεις, μόλις γίνει η πληρωμή, θα ειδοποιηθείτε και τα προϊόντα θα εγκριθούν για αποστολή στον πληρωτή.
Το Boleto Bancário είναι ένας υποστηριζόμενος τρόπος πληρωμής μέσω browser στο American Express PSP. Αυτή η σελίδα περιγράφει τις λεπτομέρειες ενοποίησης ειδικά για το Boleto Bancário. Συνιστάται να διαβάσετε τις οδηγίες ενοποίησης για πληρωμές μέσω browser, πριν δομήσετε την ενοποίηση για το Boleto Bancário.
Οι πληρωμές μέσω browser με την υπηρεσία Boleto Bancário υποστηρίζονται μόνο για συναλλαγές σε USD.
- Για λόγους ασφαλείας, το Boleto μπορεί να αξιολογηθεί μόνο στο American Express PSP για 48 ώρες ή πέντε φορές το μέγιστο. Μετά από αυτές τις προσπάθειες, το Boleto δεν θα είναι πλέον διαθέσιμο. Η πληρωμή με την υπηρεσία Boleto θα λήξει ανάλογα με τη διαμόρφωση σας.
- Τα Boleto δημιουργούνται πάντα ως αρχεία PDF. Αν απαιτείτε τα αρχεία αυτά να είναι διαθέσιμα στους πληρωτές για μεγάλο χρονικό διάστημα, πρέπει να κρατήσετε αντίγραφα τους στον τοπικό σας διακομιστή.
Προαπαιτούμενα
Για την προσφορά του Boleto Bancário ως τρόπο πληρωμής μέσω του American Express PSP:
- Πρέπει να είστε εγγεγραμμένοι στον πάροχο υπηρεσιών πληρωμής μέσω browser.
- Το προφίλ εμπόρου σας στην πύλη πρέπει να διαμορφωθεί χρησιμοποιώντας τις λεπτομέρειες του λογαριασμού που έχετε με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
- Πρέπει να διαθέτετε τραπεζικό λογαριασμό σε ένα από τα υποστηριζόμενα νομίσματα που έχουν καταχωρηθεί για τον λογαριασμό εμπόρου σας με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Ενοποίηση Boleto Bancário
Το Boleto Bancário μέσω Hosted Checkout θα είναι σύντομα διαθέσιμο. Επικοινωνήστε με τον your payment service provider για περισσότερες πληροφορίες.
Web-Services API σάς επιτρέπει να προσφέρετε τον τρόπο πληρωμής Boleto Bancário στη δική σας σελίδα checkout.
Επιπλέον των βασικών πεδίων που απαιτούνται σε ένα αίτημα πληρωμής μέσω browser, πρέπει να δώσετε τα ακόλουθα πεδία στο αίτημα Initiate Browser Payment:
sourceOfFunds.type=BOLETO_BANCARIObrowserPayment.operation=PAY(η πράξη Authorize δεν υποστηρίζεται από το Boleto Bancário).billing.address.*: Λεπτομέρειες της διεύθυνσης χρέωσης του πληρωτή.customer.email: Η διεύθυνση email του πληρωτή.customer.account.id: Το αναγνωριστικό σας για τον λογαριασμό εμπόρου μαζί σας.customer.nationalId: Ένα αναγνωριστικό για τον πληρωτή που ανατίθεται από κρατική αρχή.sourceOfFunds.provided.boletoBancario.bankAccountHolder: Το όνομα του κατόχου του τραπεζικού λογαριασμού για τον τραπεζικό λογαριασμό του πληρωτή.
Προτιμώμενη γλώσσα
Μπορείτε να ορίσετε τη γλώσσα που προτιμάτε να χρησιμοποιεί το Boleto Bancário για τις σελίδες που εμφανίζονται στον πληρωτή δίνοντας το πεδίο browserPayment.preferredLanguage στο αίτημα Initiate Browser Payment. Ωστόσο, η γλώσσα θα χρησιμοποιηθεί μόνο αν υποστηρίζεται από το Boleto Bancário.
{
"apiOperation": "INITIATE_BROWSER_PAYMENT",
"billing": {
"address": {
"street": "10 Upper Bank Street",
"postcodeZip": "E14 5NP",
"city": "London",
"country": "GBR"
}
},
"browserPayment": {
"operation": "PAY",
"returnUrl": "<your_merchant_URL>"
},
"customer": {
"email": "john.smith@example.com",
"account": {
"id": "1234567890"
},
"nationalId": "1234567890"
},
"order": {
"amount": "10.00",
"currency": "USD"
},
"sourceOfFunds": {
"type": "BOLETO_BANCARIO",
"provided": {
"boletoBancario": {
"bankAccountHolder": "John Smith"
}
}
}
}
Τρόπος ερμηνείας του αποτελέσματος της συναλλαγής
Ο παρακάτω πίνακας δείχνει τους κωδικούς απόκρισης συναλλαγής για τα πιθανά σενάρια που ενδέχεται να αντιμετωπίσετε μετά την έναρξη μιας πληρωμής στο Boleto Bancário.
| Απόκριση Initiate Browser Payment | Τι σημαίνει αυτό... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Ανακατευθύνετε τον πληρωτή χρησιμοποιώντας τη διεύθυνση URL που δίνεται στην απόκριση. |
| Απόκριση Retrieve Transaction/Retrieve Order | Τι σημαίνει αυτό... |
response.gatewayCode=APPROVEDresult=SUCCESS |
Η πληρωμή είναι επιτυχής. |
response.gatewayCode=PENDINGresult=PENDING |
Το American Express PSP περιμένει μια ειδοποίηση από την τράπεζα εμπόρου σχετικά με το αποτέλεσμα της πληρωμής. Δοκιμάστε ξανά το RETRIEVE_TRANSACTION αργότερα ή ακούστε ειδοποιήσεις από το American Express PSP. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Ο πληρωτής έχει ακυρώσει την αλληλεπίδραση για αυτή την πληρωμή. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. |
response.gatewayCode=DECLINED ή ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Η πληρωμή απορρίφθηκε. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. Στην περίπτωση ACQUIRER_SYSTEM_ERROR ίσως θελήσετε να ρωτήσετε την τράπεζα εμπόρου για το λόγο της αποτυχίας πληρωμής ή μπορείτε να δοκιμάσετε ξανά τη συναλλαγή RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Αντιμετωπίστε το αποτέλεσμα ως απόρριψη πληρωμής. Το American Express PSP θα επιχειρήσει να διασφαλίσει ότι η συναλλαγή δεν είναι επιτυχής ή θα αναστρέψει τη συναλλαγή. |
Δοκιμή της ενοποίησής σας
Το American Express PSP παρέχει έναν εξομοιωτή πληρωμών μέσω browser που σας επιτρέπει να δοκιμάζετε την ενοποίηση Boleto Bancário.