Boleto Bancário
Το Boleto Bancário, ή απλά το Boleto, είναι ένας ασφαλής και βολικός τρόπος πληρωμής στη Βραζιλία που επιτρέπει στους πληρωτές να πραγματοποιούν ηλεκτρονικές πληρωμές ή σε μετρητά για αγαθά και υπηρεσίες. Οι πληρωτές μπορούν να χρησιμοποιήσουν το δελτίο ή κουπόνι Boleto που εκδίδεται στο checkout για να κάνουν την πληρωμή με έναν από δύο τρόπους: μέσω της online τράπεζας, είτε εκτυπώνοντας το δελτίο Boleto και πληρώνοντας σε μετρητά σε εγγεγραμμένες τοποθεσίες στη Βραζιλία. Οι πληρωτές έχουν τη βολική επιλογή να πληρώσουν αργότερα και όχι στο checkout, ενώ έχετε το κεφάλι σας ήσυχο γνωρίζοντας ότι όλες οι συναλλαγές Boleto Bancário ελέγχονται από την Κεντρική Τράπεζα της Βραζιλίας.
Επί του παρόντος, το Mastercard Gateway υποστηρίζει μόνο πληρωμένες με την υπηρεσία Boleto Bancário σε νόμισμα BRL.
Προαπαιτούμενα
Αν θέλετε να προσφέρετε το Boleto Bancário ως τρόπο πληρωμής στους πληρωτές σας:
- Πρέπει να είστε εγγεγραμμένος σε έναν πάροχο υπηρεσιών πληρωμής για το Boleto Bancário. για παράδειγμα, η Citibank.
- Your payment service provider πρέπει να ενεργοποιήσετε τον τρόπο πληρωμής Boleto Bancário και να διαμορφώσετε το προφίλ εμπόρου σας στο Mastercard Gateway.
- Πρέπει να έχετε το μοναδικό αναγνωριστικό εμπόρου που δημιουργήθηκε από το your payment service provider, το οποίο θα χρησιμοποιηθεί για την επεξεργασία συναλλαγών Boleto Bancário στο Mastercard Gateway.
Ροή πληρωμών Boleto Bancário
Η γενική ροή πληροφοριών για τον τρόπο πληρωμής Boleto Bancário περιγράφεται παρακάτω.
 |
Ενσωμάτωση και εγγραφή στον πάροχο υπηρεσιών πληρωμής. Ο πάροχος υπηρεσιών πληρωμής δημιουργεί τα ακόλουθα διαπιστευτήρια: αριθμός βάσης, αριθμός cosmos και αριθμός χαρτοφυλακίου. |
 |
Χρησιμοποιώντας τα διαπιστευτήρια από το βήμα 1, ο your payment service provider ενσωματώνει και εγγράφει το προφίλ εμπόρου σας στο Mastercard Gateway και δημιουργεί ένα μοναδικό ID εμπόρου το οποίο θα σας το δώσουν. Θα χρησιμοποιήσετε το αναγνωριστικό εμπόρου για να υποβάλετε συναλλαγές Boleto Bancário στο Mastercard Gateway. |
 |
Ο πληρωτής επισκέπτεται τον ιστότοπό σας ηλεκτρονικού εμπορίου, πραγματοποιεί μια αγορά και επιλέγει το Boleto Bancário ως τρόπο πληρωμής στο checkout. |
 |
Η πύλη πληρωμών λαμβάνει το αίτημα API για τη διεκπεραίωση της συναλλαγής. |
 |
Ο Your payment service provider εγγράφει ένα Boleto στο κεντρικό γραφείο συμψηφισμού, δημιουργεί έναν αριθμό γραμμικού κωδικού και έναν 47ψήφιο σειριακό αριθμό, και στέλνει αυτές τις λεπτομέρειες στην πύλη πληρωμών. |
 |
Η πύλη δημιουργεί ένα δελτίο ή κουπόνι Boleto και σας παρέχει τον αριθμό γραμμικού κωδικού και τον 47ψήφιο σειριακό αριθμό στην απόκριση API. Επιπλέον, παρέχεται μια διεύθυνση URL από όπου μπορείτε να κάνετε λήψη ή εκτύπωση του δελτίου Boleto. |
 |
Ο πληρωτής είτε κάνει μια online πληρωμή χρησιμοποιώντας τον 47ψηφιο σειριακό αριθμό είτε κάνει λήψη και εκτυπώνει το δελτίο Boleto για να πληρώσει σε μια εγγεγραμμένη τοποθεσία. Σημειώστε ότι οι πληρωτές που θέλουν να πληρώσουν σε μια εγγεγραμμένη τοποθεσία πρέπει να έχουν τη δυνατότητα να κάνουν λήψη ή να εκτυπώσουν το δελτίο Boleto. |
Μπορείτε να κατεβάσετε το δελτίο εντός δύο ωρών. Αν θέλετε να αποκτήσετε πρόσβαση στο δελτίο μετά την περίοδο ισχύος, επικοινωνήστε με τον your payment service provider.
Το Boleto Bancário ως επιλογή checkout στο Hosted Checkout
Αν χρησιμοποιείτε τη σελίδα πληρωμής της πύλης (Hosted Checkout), το Boleto Bancário θα προσφέρεται αυτόματα ως επιλογή checkout στους πληρωτές σας αν το Boleto Bancário έχει διαμορφωθεί στο προφίλ εμπόρου σας και έχουν υποβληθεί πεδία για το Boleto στην πύλη στο αίτημα Create Checkout Session.
Εκτός από τα τυπικά πεδία, μπορείτε να δώσετε τα ακόλουθα πεδία κατά την υποβολή ενός αιτήματος Create Checkout Session το API έκδοση 58 ή νεότερη:
| Πεδίο | Υποχρεωτικό | Περιγραφή |
|---|---|---|
sourceOfFunds.provided.boletoBancario.dueDate |
Ναι | Υποδεικνύει την ημερομηνία μέχρι την οποία το ποσό Boleto πρέπει να εξοφληθεί. |
sourceOfFunds.provided.boletoBancario.daysBeforeAction |
Όχι | Η περίοδος χάριτος αφού έχει περάσει η dueDate για να κάνει ο πληρωτής την πληρωμή Boleto και πριν ληφθεί η ενέργεια που καθορίζεται στο actionType. |
sourceOfFunds.provided.boletoBancario.actionType |
Όχι | Η ενέργεια που θα γίνει αν δεν γίνει η πληρωμή. |
order.invoiceNumber |
Όχι | Ο αριθμός τιμολογίου που εκδώσατε για τη συγκεκριμένη παραγγελία. Αν δεν δώσετε μια τιμή, η πύλη θα δημιουργήσει τον αριθμό και θα την δώσει στο αίτημα. |
Κατά τη διάρκεια της αλληλεπίδρασης του Hosted Checkout, εμφανίζονται τα ακόλουθα πεδία αν ο πληρωτής επιλέξει να πληρώσει χρησιμοποιώντας τον τρόπο πληρωμής Boleto Bancário:
- Τύπος πελάτη: Ο τύπος του πληρωτή, για παράδειγμα, ένα άτομο ή μια εταιρεία.
- Όνομα πελάτη/Επωνυμία εταιρείας. Αν ο Τύπος πελάτη = Φυσικό πρόσωπο, αυτό θα είναι το όνομα πελάτη, ενώ αν ο Τύπος πελάτη = Εταιρεία, θα είναι η επωνυμία της εταιρείας.
- CPF/CNPJ: Αυτό είναι το αναγνωριστικό πληρωτή που ανατίθεται από κρατική αρχή. Αν ο Τύπος πελάτη = Φυσικό πρόσωπο, θα είναι το Cadastro de Pessoas F-sicas (CPF), ενώ αν ο Τύπος πελάτη = Εταιρεία, θα είναι το Cadastro Nacional de Pessoas Jur-dicas (CNPJ)
| URL | https://na-gateway.mastercard.com/api/rest/version/72/merchant/{merchantId}/session/ |
| Μέθοδος HTTP | POST |
{
"apiOperation": "CREATE_CHECKOUT_SESSION",
"interaction": {
"operation": "PURCHASE"
},
"order": {
"taxAmount": 100,
"amount": 749.99,
"currency": "BRL",
"id": "98098902948",
"invoiceNumber": "1234",
"taxRegistrationId": "12345678901",
"description": "I am using this....",
"item": [
{
"name": "Test Item 1",
"quantity": 1,
"unitPrice": "249.99"
},
{
"name": "Test Item 2",
"quantity": 1,
"unitPrice": "200"
},
{
"name": "Test Item 3",
"quantity": 1,
"unitPrice": "200"
}
]
},
"sourceOfFunds": {
"provided": {
"boletoBancario": {
"dueDate": "2020-03-02",
"daysBeforeAction": "4",
"actionType": "WRITE_OFF"
}
}
},
"billing": {
"address": {
"street": "street name",
"street2": "street name 2",
"city": "city",
"stateProvince": "MH",
"postcodeZip": "00411038"
}
},
"transaction": {
"reference": "12341234"
}
}
Ακολουθεί ένα παράδειγμα απόκρισης μιας επιτυχημένης συναλλαγής Boleto Bancário που εμφανίζει όλες τις λεπτομέρειες που υποβλήθηκαν στο αίτημα και περιλαμβάνει τη διευθυνση URL για το δελτίο Boleto.
| URL | https://na-gateway.mastercard.com/api/rest/version/72/merchant/{merchantId}/order/{orderid}/transaction/{transactionid} |
| Μέθοδος HTTP | GET |
{
"billing":{
"address":{
"city":"city",
"postcodeZip":"00411038",
"stateProvince":"MH",
"street":"street name",
"street2":"street name 2"
}
},
"browserPayment":{
"operation":"PAY"
},
"gatewayEntryPoint":"CHECKOUT",
"merchant":"TESTMERCH01",
"order":{
"amount":749.99,
"chargeback":{
"amount":0,
"currency":"BRL"
},
"creationTime":"2020-09-03T06:26:33.932Z",
"currency":"BRL",
"customerOrderDate":"2020-09-03",
"description":"I am using this....",
"id":"order12345",
"invoiceNumber":"1234",
"item":[
{
"name":"Test Item 1",
"quantity":1,
"unitPrice":249.99
},
{
"name":"Test Item 2",
"quantity":1,
"unitPrice":200
},
{
"name":"Test Item 3",
"quantity":1,
"unitPrice":200
}
],
"itemAmount":649.99,
"lastUpdatedTime":"2020-09-03T06:26:38.056Z",
"merchantAmount":749.99,
"merchantCurrency":"BRL",
"status":"INITIATED",
"taxAmount":100,
"taxRegistrationId":"12345678901",
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0
},
"response":{
"acquirerCode":"0",
"acquirerMessage":"Data Received",
"gatewayCode":"SUBMITTED"
},
"result":"SUCCESS",
"sourceOfFunds":{
"provided":{
"boletoBancario":{
"actionType":"WRITE_OFF",
"bankAccountHolder":"TESTCUSTOMERNAME",
"customerType":"INDIVIDUAL",
"daysBeforeAction":"4",
"dueDate":"2020-03-02",
"slipUrl":"https://example.com/bpui/cb/transaction/slip/BP-0d10be5954744203eb355a1be98bb190"
}
},
"type":"BOLETO_BANCARIO"
},
"timeOfLastUpdate":"2020-09-03T06:26:38.056Z",
"timeOfRecord":"2020-09-03T06:26:33.967Z",
"transaction":{
"acquirer":{
"additionalResponseData":"{\"barcode\":\"12345678901234567890123456789012000000000001\",\"digitableLine\":\"12345678901234567890123456789012345678901234567\"}",
"id":"CITIBR_1",
"merchantId":"12335522222233331234",
"transactionId":"order12345"
},
"amount":749.99,
"currency":"BRL",
"id":"1",
"item":[
{
"name":"Test Item 1",
"quantity":1,
"unitPrice":249.99
},
{
"name":"Test Item 2",
"quantity":1,
"unitPrice":200
},
{
"name":"Test Item 3",
"quantity":1,
"unitPrice":200
}
],
"receipt":"12345678901234567890123456789012000000000001",
"reference":"000012341234",
"source":"INTERNET",
"stan":"0",
"type":"PAYMENT"
},
"version":"60"
}
Το Boleto Bancário ως επιλογή checkout στη σελίδα πληρωμής σας
Αν χρησιμοποιείτε τη δική σας σελίδα πληρωμής (βλ. την ενοποίηση Direct Payment) και θέλετε να προσφέρετε το Boleto Bancário ως επιλογή checkout στους πληρωτές σας, πρέπει να δώσετε τα ακόλουθα πεδία στο αίτημα Pay.
Πρέπει να χρησιμοποιήσετε το API έκδοση 57 ή νεότερη για την υποβολή αιτήματος Pay.
Αίτημα συναλλαγής
Όταν ένας πληρωτής πραγματοποιεί μια αγορά χρησιμοποιώντας το Boleto Bancário ως τρόπο πληρωμής, υποβάλετε ένα αίτημα Pay στο Mastercard Gateway και δώστε τα πεδία όπως περιγράφεται στον παρακάτω πίνακα.
| Πεδίο | Υποχρεωτικό | Περιγραφή |
|---|---|---|
sourceOfFunds.type |
Ναι | Υποδεικνύει τον τρόπο πληρωμής που επέλεξε ο πληρωτής. Ορίστε την τιμή αυτού του πεδίου σε BOLETO_BANCARIO. |
customer.nationalId |
Ναι | Το αναγνωριστικό πληρωτή που ανατίθεται από κρατική αρχή. Για παράδειγμα, στη Βραζιλία αυτό θα μπορούσε να είναι το Cadastro de Pessoas F-sicas (CPF) ή το Cadastro Nacional de Pessoas Jur-dicas (CNPJ). Αυτή η αριθμητική τιμή μεταξύ 11 και 14 αριθμών πρέπει να παρέχεται, διαφορετικά η συναλλαγή απορρίπτεται. |
order.referencetransaction.acquirer.transactionId |
Βλ. περιγραφή | Αν το order.id που παρέχετε συμμορφώνεται με τους κανόνες επικύρωσης του Boleto, χρησιμοποιείται ως αναφορά παραγγελίας. Διαφορετικά, δημιουργείται μια νέα αναφορά και χρησιμοποιείται από την πύλη.Αν θέλετε να δώσετε τη δική σας τιμή αναφοράς στο Boleto, καθορίστε την τιμή στο πεδίο transaction.acquirer.transactionId. Αν δεν πληρούνται οι κανόνες επικύρωσης του Boleto, η πύλη απορρίπτει τη συναλλαγή. Σε όλες τις περιπτώσεις, η πύλη επιστρέφει την αναφορά που χρησιμοποιήθηκε, στο πεδίο transaction.acquirer.transactionId. |
transaction.reference |
Βλ. περιγραφή | Το πεδίο transaction.reference είναι ένα μοναδικό αναγνωριστικό για κάθε συναλλαγή Boleto Bancário που δημιουργείται από εσάς ή από τον your payment service provider. Ο Your payment service provider θα διαμορφώσει το προφίλ σας για μία από αυτούς τους δύο τρόπους κατά τη διαδικασία ενσωμάτωσης. Συνιστάται να επικοινωνήσετε μαζί τους αν έχετε απορίες σχετικά με τον τρόπο που έχει διαμορφωθεί για εσάς.Αν πρόκειται να δημιουργήσετε το αναγνωριστικό συναλλαγής, πρέπει να το δώσετε ως μια τιμή στο πεδίο transaction.reference για κάθε συναλλαγή. Διαφορετικά, η πύλη απορρίπτει τη συναλλαγή.Αν ο your payment service provider πρόκειται να δημιουργήσει το αναγνωριστικό συναλλαγής, δεν πρέπει να παρέχετε το πεδίο αλλιώς η πύλη απορρίπτει τη συναλλαγή. |
sourceOfFunds.provided.boletoBancario.bankAccountHolder |
Ναι | Το όνομα του κατόχου του τραπεζικού λογαριασμού για τον τραπεζικό λογαριασμό του πληρωτή. |
sourceOfFunds.provided.boletoBancario.actionType |
Όχι | Η ενέργεια που θα γίνει αν δεν γίνει η πληρωμή. |
sourceOfFunds.provided.boletoBancario.customerType |
Όχι | Ο τύπος του πληρωτή, για παράδειγμα, ένα άτομο ή μια εταιρεία. Η προεπιλεγμένη τιμή για αυτό είναι "Φυσικό πρόσωπο". |
sourceOfFunds.provided.boletoBancario.dueDate |
Ναι | Υποδεικνύει την ημερομηνία μέχρι την οποία το ποσό Boleto πρέπει να εξοφληθεί. |
sourceOfFunds.provided.boletoBancario.daysBeforeAction |
Όχι | Η περίοδος χάριτος αφού έχει περάσει η dueDate για να κάνει ο πληρωτής την πληρωμή Boleto και πριν ληφθεί η ενέργεια που καθορίζεται στο actionType. |
order.invoiceNumber |
Βλ. περιγραφή | Ο αριθμός τιμολογίου που εκδώσατε για τη συγκεκριμένη παραγγελία. Αν δεν δώσετε μια τιμή, η πύλη θα δημιουργήσει τον αριθμό και θα την δώσει στο αίτημα. |
order.taxAmount |
Βλ. περιγραφή | Το συνολικό ποσό φόρου για την παραγγελία. Αν δεν δώσετε μια τιμή, η πύλη θα χρησιμοποιήσει ως προεπιλογή το μηδέν και θα την στείλει στο μεταγενέστερο σύστημα. Το order.amount θα είναι ίσο με το order.itemAmount στο αίτημα. |
Απόκριση συναλλαγής
Εκτός αν το Mastercard Gateway επιστρέψει result=ERROR, η απάντηση περιλαμβάνει όλα τα πεδία αιτήματος και τις τιμές τους που υποβλήθηκαν στο αίτημα PAY. Επιπλέον, το Mastercard Gateway επιστρέφει τις λεπτομέρειες που περιγράφονται στον παρακάτω πίνακα.
| Πεδίο | Περιγραφή |
|---|---|
response.acquirerCode |
Υποδεικνύει την επιτυχία ή αποτυχία της εγγραφής συναλλαγής. Η τιμή 0 (μηδέν) υποδηλώνει επιτυχία και η τιμή 99 υποδηλώνει αποτυχία. |
response.acquirerMessage |
Ένα επιπλέον μήνυμα που υποδεικνύει την επιτυχία ή αποτυχία της εγγραφής συναλλαγής. Αν η εγγραφή ήταν επιτυχής, αυτό το πεδίο περιέχει την τιμή "Ληφθέντα δεδομένα". Αν η εγγραφή ήταν ανεπιτυχής, αυτό το πεδίο περιέχει την τιμή "Μη ληφθέντα δεδομένα". |
response.gatewayCode |
Υποδεικνύει την επιτυχία ή αποτυχία της πράξης. |
sourceOfFunds.provided.boletoBancario.slipUrl |
Η διεύθυνση URL όπου ο πληρωτής μπορεί να έχει πρόσβαση στο δελτίο Boleto Bancário. |
transaction.receipt |
Όταν μια εγγραφή συναλλαγής επιτύχει, η τιμή αυτού του πεδίου περιέχει τον 44ψήφιο αριθμό που χρησιμοποιήθηκε για τη δημιουργία του γραμμικού κώδικα στο δελτίο Boleto. Αυτός ο γραμμικός κώδικας μπορεί στη συνέχεια να σαρωθεί από τον πωλητή αν ένας πληρωτής επιλέξει να πληρώσει το Boleto σε εγγεγραμμένη τοποθεσία. |
transaction.acquirer.additionalResponseData |
Αν η εγγραφή της συναλλαγής αποτύχει, αυτό το πεδίο περιέχει έναν κωδικό σφάλματος και μια περιγραφή σε μορφή ζεύγους κλειδιού-τιμής. |
Το παρακάτω παράδειγμα αιτήματος PAY μιας συναλλαγής Boleto Bancário περιλαμβάνει την προθεσμία, τις ημέρες πριν από την ανάληψη δράσης και ποια ενέργεια πρέπει να ληφθεί αν το Boleto δεν καταβληθεί έως την καθορισμένη προθεσμία.
{
"apiOperation": "PAY",
"order": {
"amount": "669.99",
"itemAmount": "649.99"
"currency": "BRL",
"taxRegistrationId": "12345678901",
"reference": "01234568",
"taxAmount": "20",
"invoiceNumber": "0001230000",
},
"transaction": {
"merchantNote": "01456789012",
"reference": "01234567",
"acquirer": {
"transactionId": "01234568"
}
},
"billing": {
"address": {
"street": "Street 123",
"street2": "Business Way",
"city": "Pune",
"stateProvince": "MH",
"postcodeZip": "12345678"
}
},
"customer": {
"nationalId": "12345678901"
},
"sourceOfFunds": {
"type": "BOLETO_BANCARIO",
"provided": {
"boletoBancario": {
"customerType": "COMPANY",
"bankAccountHolder": "FIRSTNAME LASTNAME",
"dueDate": "2021-02-17",
"daysBeforeAction": "69",
"actionType": "WRITE_OFF"
}
}
}
}
Το ακόλουθο παράδειγμα απόκρισης μιας συναλλαγής Boleto Bancário εμφανίζει όλες τις λεπτομέρειες που υποβλήθηκαν στο αίτημα και περιλαμβάνει τη διεύθυνση URL στο δελτίο Boleto.
{
"billing":{
"address":{
"city":"Pune",
"postcodeZip":"00411038",
"stateProvince":"MH",
"street":"YERWADA",
"street2":"Business Way"
}
},
"browserPayment":{
"operation":"PAY"
},
"gatewayEntryPoint":"WEB_SERVICES_API",
"merchant":"TESTCRMER01",
"order":{
"amount":763.99,
"chargeback":{
"amount":0,
"currency":"BRL"
},
"creationTime":"2021-02-23T07:54:25.464Z",
"currency":"BRL",
"customerOrderDate":"2021-02-23",
"discount":{
"amount":10.00
},
"id":"vp_528",
"invoiceNumber":"1230000",
"item":[
{
"name":"Korg MS-20 Mini",
"quantity":1,
"unitPrice":649.99
}
],
"itemAmount":649.99,
"lastUpdatedTime":"2021-02-23T07:54:33.993Z",
"merchantAmount":763.99,
"merchantCurrency":"BRL",
"reference":"12334",
"status":"INITIATED",
"taxAmount":124.00,
"taxRegistrationId":"12345678901",
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0
},
"response":{
"acquirerCode":"0",
"acquirerMessage":"Data Received",
"gatewayCode":"SUBMITTED"
},
"result":"SUCCESS",
"sourceOfFunds":{
"provided":{
"boletoBancario":{
"bankAccountHolder":"TEST",
"customerType":"COMPANY",
"daysBeforeAction":"4",
"dueDate":"2020-03-02",
"slipUrl":"https://dl01aspall4bv.mpgsdev.mastercard.int/bpui/cb/transaction/slip/BP-a7af97458dc12e0c57265d3bd886c4a8"
}
},
"type":"BOLETO_BANCARIO"
},
"timeOfLastUpdate":"2021-02-23T07:54:33.993Z",
"timeOfRecord":"2021-02-23T07:54:27.030Z",
"transaction":{
"acquirer":{
"additionalResponseData":"{\"barcode\":\"12345678901234567890123456789012000000000001\",\"digitableLine\":\"12345678901234567890123456789012345678901234567\"}",
"id":"CITIBR_1",
"merchantId":"12335522222233331234",
"transactionId":"12333"
},
"amount":763.99,
"currency":"BRL",
"id":"1",
"item":[
{
"name":"Korg MS-20 Mini",
"quantity":1,
"unitPrice":649.99
}
],
"merchantNote":"81",
"receipt":"12345678901234567890123456789012000000000001",
"reference":"000000000001",
"source":"INTERNET",
"stan":"0",
"type":"PAYMENT"
},
"version":"60"
}
Λήψη ή εκτύπωση δελτίου Boleto
Είναι σημαντικό να σημειωθεί ότι αν και η απόκριση του Mastercard Gateway περιλαμβάνει τη διεύθυνση URL για πρόσβαση στο δελτίο Boleto, ο ιστότοπός σας ηλεκτρονικού εμπορίου πρέπει να επιτρέπει στους πληρωτές να προβάλουν, να κάνουν λήψη ή να εκτυπώνουν το δελτίο Boleto.
Για παράδειγμα, αυτή η λειτουργικότητα μπορεί να είναι ένα κουμπί στο οποίο μπορούν να κάνουν κλικ οι πληρωτές σας για προβολή και λήψη του δελτίου Boleto κατά τη διαδικασία checkout.
Δοκιμή της ενοποίησής σας
Μπορείτε να δοκιμάσετε την ενοποίησή σας χρησιμοποιώντας το δοκιμαστικό προφίλ εμπόρου (μπροστά στο ID εμπόρου προστίθεται το πρόθημα "TEST"). Αυτή η ενότητα παρέχει λεπτομέρειες σχετικά με το order.status που μπορεί να χρησιμοποιηθεί για την ενεργοποίηση μιας συγκεκριμένης απόκρισης.
Πριν τη δοκιμή της ενοποίησης, βεβαιωθείτε ότι πληρούνται οι ακόλουθες προϋποθέσεις:
- Έχει γίνει η ενοποίησή σας στην τράπεζα εμπόρου.
- Ο Your payment service provider που χρησιμοποιείτε έχει διαμορφώσει τον σύνδεσμο σε τράπεζα εμπόρου στο προφίλ εμπόρου σας στην πύλη χρησιμοποιώντας τις ακόλουθες πληροφορίες όπως παρέχονται από εσάς:
- "Αριθμός βάσης", "Αριθμός λογαριασμού Cosmos" και "Αριθμός χαρτοφυλακίου".
- Πληροφορίες σχετικά με το ποιος θα παρέχει το μοναδικό αναγνωριστικό συναλλαγής (transaction.reference) στη συναλλαγή: εσείς ή η τράπεζα εμπόρου.
- Δημιουργήσατε την ενοποίηση παρέχοντας τα απαιτούμενα πεδία στο αίτημα Pay.
| RESULT | order.status |
result |
response.gatewayCode |
response.acquirerCode |
|---|---|---|---|---|
| Επιτυχία | INITIATED | SUCCESS | SUBMITTED | 0 |
| Αποτυχία | FAILED | FAILURE | UNSPECIFIED_FAILURE | 99 |
| Λήξη χρονικού ορίου | FAILED | FAILURE | TIMED_OUT | N/A |