- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες
- Συγκεντρωτικές πληρωμές ναύλων διαμετακόμισης
Συγκεντρωτικές πληρωμές ναύλων διαμετακόμισης
Οι συγκεντρωτικοί ναύλοι μεταφοράς παρέχουν υποστήριξη σε σενάρια όπου δεν γνωρίζετε τον τελικό ναύλο που θα χρεωθεί στην αρχή του ταξιδιού. Σε τέτοια σενάρια, ο τελικός ναύλος υπολογίζεται στο τέλος μιας περιόδου ταξιδιού, συνήθως 24 ωρών, με βάση τα ταξίδια που πραγματοποιήθηκαν κατά τη διάρκεια αυτής της περιόδου. Αυτή η σελίδα περιγράφει τις συγκεντρωτικές περιπτώσεις χρήσης ναύλου μεταφοράς και τη διαδικασία υποβολής έγκυρου αιτήματος στην πύλη. Υποβάλετε διαφορετικά αιτήματα για τις κάρτες Mastercard και Visa. Για τις κάρτες American Express, ακολουθήστε τις οδηγίες που δίνονται για την Mastercard. Μέσω του προγράμματος συγκεντρωτικών πληρωμών ναύλων μεταφοράς,
- μπορείτε να συγκεντρώνετε τους ναύλους συναλλαγής του πληρωτή από πολλαπλά ταξίδια για συγκεκριμένο χρονικό διάστημα και έως συγκεκριμένο ποσό, και
- μπορείτε να χρεώνετε ναύλους κατ' αποκοπή, βάσει απόστασης ή χρόνου για κάθε ταξίδι εντός της περιόδου.
Οι υπηρεσίες Mastercard Gateway παρέχουν υποστήριξη για τη λειτουργία συγκεντρωτικού ναύλου διαμετακόμισης για
- Διεκπεραίωση μιας συναλλαγής EMV και ανέπαφες πληρωμών με κινητή συσκευή από την έκδοση 66 του WS API
- Mastercard, εξαιρουμένων των καρτών Maestro σύμφωνα με τους κανόνες του προγράμματος Mastercard
- Κάρτες Visa σύμφωνα με τους κανόνες του προγράμματος Visa και
- Κάρτες American Express σύμφωνα με τους κανόνες του προγράμματος Mastercard.
Προαπαιτούμενα
Για να υποβάλλετε συγκεντρωτικές συναλλαγές ναύλων μεταφοράς, ο κωδικός κατηγορίας εμπόρου (MCC) πρέπει να είναι ένας από τους παρακάτω:
Mastercard
- 4111 - Επιβάτης μεταφορών - προαστιακού και τοπικών μέσων, συμπεριλαμβανομένων των πορθμείων
- 4131 - Γραμμές λεωφορείων
- 4784 - Τέλη γεφυρών και δρόμων, διόδια
- 7523 - Χώροι στάθμευσης αυτοκινήτων
Visa
- 4111 - Επιβάτης αστικών και υπεραστικών μέσων μεταφοράς, συμπεριλαμβανομένων των πορθμείων
- 4112 - Επιβάτης σιδηροδρόμων
- 4131 - Γραμμές λεωφορείων
American Express
- 4111 - Επιβάτης αστικών και υπεραστικών μέσων μεταφοράς, συμπεριλαμβανομένων των πορθμείων
- 4112 - Επιβάτης σιδηροδρόμων
- 4131 - Γραμμές λεωφορείων
- 4784 - Διόδια και τέλη γεφυρών
- 7523 - Χώροι στάθμευσης και γκαράζ
Πραγματοποιήστε μια πιστοποίηση EMV σύμφωνα με τους ισχύοντες κανόνες του προγράμματος. Ο Your payment service provider πρέπει να σας επιτρέψει
- να υποβάλλετε συναλλαγές δέσμευσης πιστωτικού υπολοίπου και
- να ανακτάτε τους αριθμού των καρτών χωρίς απόκρυψη.
Ανέπαφες πληρωμές EMV έναντι ανέπαφων πληρωμών με κινητή συσκευή
Υποστήριξη για τη λειτουργία συγκεντρωτικού ναύλου διαμετακόμισης παρέχεται για
- Ανέπαφες πληρωμές EMV, όπου οι πληρωτές παρουσιάζουν την πιστωτική τους κάρτα στο τερματικό.
- Ανέπαφες πληρωμές με κινητή συσκευή, όπου οι πληρωτές παρουσιάζουν τις συσκευές τους, όπως κινητό τηλέφωνο ή ρολόι, στο τερματικό.
Ανέπαφες πληρωμές με κινητή συσκευή
Για ανέπαφες πληρωμές με κινητή συσκευή, θα λαμβάνετε μόνο τις λεπτομέρειες του κύριου αριθμού λογαριασμού (DPAN) για τη συγκεκριμένη συσκευή και όχι τις λεπτομέρειες του αριθμού κύριου λογαριασμού χρηματοδότησης (FPAN) από το τερματικό. Όπου το αίτημα Authorization περιέχει ένα DPAN, η απόκριση συναλλαγής θα περιέχει
- το DPAN όπως δίνεται στο αίτημα στο πεδίο
sourceOfFunds.provided.card.deviceSpecificNumber - το έτος και τον μήνα λήξης του DPAN όπως δίνεται στο αίτημα στα πεδία
sourceOfFunds.provided.card.deviceSpecificExpiry.yearκαιsourceOfFunds.provided.card.deviceSpecificExpiry.month - το FPAN όπως επιστρέφεται από το πρόγραμμα στο πεδίο
sourceOfFunds.provided.card.numberκαι - το έτος και τον μήνα λήξης του FPAN όπως επιστρέφεται από το πρόγραμμα στα πεδία
sourceOfFunds.provided.card.expiry.yearκαιsourceOfFunds.provided.card.expiry.month.
responseControls.sensitiveData=UNMASK στο αίτημα συναλλαγής Retrieve Transaction.
Αναγνωριστικό λογαριασμού πληρωμής
Η υποστήριξη πύλης για τη συμπλήρωση της αναφοράς λογαριασμού πληρωμής (PAR) στην απόκριση συναλλαγής προστέθηκε από την έκδοση 65 του API και μετά. Για αποκρίσεις συναλλαγής, RETRIEVE_TRANSACTION και RETRIEVE_ORDER: Το PAR επιστρέφεται στο πεδίο sourceOfFunds.provided.card.paymentAccountReference.
Σενάρια
Αυτά είναι πολλαπλά σενάρια για τη διεκπεραίωση των συγκεντρωτικών πληρωμών ναύλων μεταφοράς σύμφωνα με τους κανόνες του προγράμματος.
Πρώτο πάτημα με νέα κάρτα
Κάρτα Mastercard ή American Express
Αντιμετωπίστε αυτό το σενάριο όπως το πρώτο πάτημα στο σενάριο της περιόδου ταξιδιού.
Κάρτα Visa
Για να βεβαιωθείτε ότι η κάρτα είναι έγκυρη, υποβάλετε το αίτημα Verify με τις ακόλουθες λεπτομέρειες.
- ένα αναγνωριστικό για την παραγγελία στο
order.id - ένα αναγνωριστικό μοναδικό στην παραγγελία για τη συναλλαγή Verification στο
transaction.id - κανένα ποσό παραγγελίας στο
order.amountή στοorder.amount=0 - το νόμισμα παραγγελίας στο
order.currency sourceOfFunds.provided.card.emvRequestμε έγκυρα δεδομένα ετικέτας EMV από το πρώτο πάτημα εντός της περιόδου ταξιδιούtransaction.source=CARD_PRESENTposTerminal.attended=UNATTENDEDposTerminal.location=MERCHANT_TERMINAL_ON_PREMISESposTerminal.cardholderActivated=SELF_SERVICE_TERMINALposTerminal.inputCapability=CONTACTLESS_CHIPposTerminal.panEntryMode=CONTACTLESSposTerminal.pinEntryCapability=PIN_NOT_SUPPORTEDposTerminal.lane=99991111posTerminal.cardPresenceCapability=CARD_PRESENT
Ακολουθεί το παράδειγμα REST για επαλήθευση κάρτας πριν από την έναρξη μιας περιόδου ταξιδιού.
| URL | https://eu-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "VERIFY",
"order": {
"amount": "0.00",
"currency": "AUD"
},
"posTerminal": {
"address": {
"country": "AUS",
"postcodeZip": "4000"
},
"attended": "UNATTENDED",
"cardPresenceCapability": "CARD_PRESENT",
"cardholderActivated": "SELF_SERVICE_TERMINAL",
"inputCapability": "CONTACTLESS_CHIP",
"lane": "99991111",
"location": "MERCHANT_TERMINAL_ON_PREMISES",
"panEntryMode": "CONTACTLESS",
"pinEntryCapability": "PIN_NOT_SUPPORTED"
},
"sourceOfFunds": {
"provided": {
"card": {
"emvRequest": {
"5F2A": "036",
"5F34": "099",
"82": "0000",
"84": "010101010101",
"95": "0000000000",
"9A": "161021",
"9B": "0101",
"9C": "00",
"9F02": "000000010000",
"9F03": "000000000000",
"9F10": "06011103A000000A0100000000000BB0ABAD",
"9F1A": "036",
"9F1E": "0123ABCD",
"9F26": "D1F722D47FCA8273",
"9F27": "40",
"9F33": "E0B8C8",
"9F34": "1E0300",
"9F35": "12",
"9F36": "0002",
"9F37": "2A4E1690",
"9F6E": "0101"
},
"expiry": {
"month": "12",
"year": "39"
},
"track2": "400555xxxxxx0019=391220xxxx06711"
}
},
"type": "CARD"
},
"transaction": {
"source": "CARD_PRESENT"
}
}
Μπορείτε να υποβάλετε αυτό το αίτημα
- όταν μια κάρτα χρησιμοποιείται για πρώτη φορά
- σε τακτά χρονικά διαστήματα για να βεβαιωθείτε ότι η κάρτα εξακολουθεί να ισχύει, ή
- την πρώτη φορά που μια κάρτα χρησιμοποιείται αφού αφαιρεθεί από τη λίστα άρνησης.
Πρώτο πάτημα εντός της περιόδου ταξιδιού
Κάρτα Mastercard ή American Express
Για να εξουσιοδοτήσετε την πληρωμή για τον συγκεντρωτικό ναύλο μεταφοράς για αυτήν την κάρτα, υποβάλετε το αίτημα Authorization με τις ακόλουθες λεπτομέρειες.
- ένα αναγνωριστικό για την παραγγελία στο
order.id - ένα αναγνωριστικό μοναδικό στην παραγγελία για τη συναλλαγή Authorization στο
transaction.id - ένα ονομαστικό ποσό στο
order.amount - το νόμισμα παραγγελίας στο
order.currency transaction.transit.aggregatedFare.type=FAREtransaction.transit.aggregatedFare.transportationMode with a valid enumeration value that reflects the transportation mode used by the payer for the first triptransaction.transit.aggregatedFare.aggregationStartDateμε έγκυρη ημερομηνία έναρξης του ταξιδιούsourceOfFunds.provided.card.emvRequestμε έγκυρα δεδομένα EMV από το πρώτο πάτημα εντός της περιόδου ταξιδιούtransaction.source=CARD_PRESENTposTerminal.attended=UNATTENDEDposTerminal.location=MERCHANT_TERMINAL_ON_PREMISESposTerminal.cardholderActivated=SELF_SERVICE_TERMINALposTerminal.inputCapability=CONTACTLESS_CHIPposTerminal.panEntryMode=CONTACTLESSposTerminal.pinEntryCapability=PIN_NOT_SUPPORTEDposTerminal.lane=99991111posTerminal.cardPresenceCapability=CARD_PRESENT
Ακολουθεί το παράδειγμα REST για ονομαστικό αίτημα Authorization για συγκέντρωση των ναύλων μεταφοράς.
| URL | https://eu-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "1.00",
"currency": "AUD"
},
"posTerminal": {
"address": {
"country": "AUS",
"postcodeZip": "4000"
},
"attended": "UNATTENDED",
"cardPresenceCapability": "CARD_PRESENT",
"cardholderActivated": "SELF_SERVICE_TERMINAL",
"inputCapability": "CONTACTLESS_CHIP",
"lane": "99991111",
"location": "MERCHANT_TERMINAL_ON_PREMISES",
"panEntryMode": "CONTACTLESS",
"pinEntryCapability": "PIN_NOT_SUPPORTED"
},
"sourceOfFunds": {
"provided": {
"card": {
"emvRequest": {
"5F2A": "036",
"5F34": "099",
"82": "0000",
"84": "010101010101",
"95": "0000000000",
"9A": "161021",
"9B": "0101",
"9C": "00",
"9F02": "000000010000",
"9F03": "000000000000",
"9F10": "06011103A000000A0100000000000BB0ABAD",
"9F1A": "036",
"9F1E": "0123ABCD",
"9F26": "D1F722D47FCA8273",
"9F27": "40",
"9F33": "E0B8C8",
"9F34": "1E0300",
"9F35": "12",
"9F36": "0002",
"9F37": "2A4E1690",
"9F6E": "0101"
},
"expiry": {
"month": "12",
"year": "39"
},
"track2": "545721xxxxxx0012=391220xxxxx6711"
}
},
"type": "CARD"
},
"transaction": {
"source": "CARD_PRESENT",
"transit": {
"aggregatedFare": {
"type": "FARE",
"aggregationStartDate": "2020-05-05",
"transportationMode": "TRAIN"
}
}
}
"responseControls":{
"sensitiveData": "UNMASK"
}
}
Αν το αίτημα είναι επιτυχές, συγκεντρώστε τον ναύλο μεταφοράς για αυτήν την κάρτα. Αν το αίτημα είναι ανεπιτυχές, προσθέστε την κάρτα στη λίστα άρνησης και εκκινήστε μια ανάκτηση χρέους για τον ναύλο αυτού του ταξιδιού.
Κάρτα Visa
Συγκεντρώστε τον ναύλο μεταφοράς για αυτήν την κάρτα και βεβαιωθείτε ότι συλλέγετε τα δεδομένα με πάτημα για αυτό το ταξίδι.
Επακόλουθα πατήματα εντός της περιόδου ταξιδιού
Κάρτα Mastercard ή American Express
Προσθέστε τον ναύλο μεταφοράς για κάθε ταξίδι στον συγκεντρωτικό ναύλο μεταφοράς για αυτή την κάρτα. Στο τέλος της περιόδου ταξιδιού, υποβάλετε το αίτημα Capture για τον συνολικό συγκεντρωτικό ναύλο μεταφοράς.
Κάρτα Visa
Προσθέστε τον ναύλο μεταφοράς για κάθε ταξίδι στον συγκεντρωτικό ναύλο μεταφοράς για αυτή την κάρτα. Στο τέλος της περιόδου ταξιδιού, υποβάλετε το αίτημα Authorization για τον συνολικό συγκεντρωτικό ναύλο μεταφοράς. Βεβαιωθείτε ότι συλλέγετε τα δεδομένα πατήματος για κάθε ταξίδι.
Τέλος της περιόδου ταξιδιού
Κάρτα Mastercard ή American Express
Στο τέλος της περιόδου ταξιδιού, μπορείτε να δεσμεύσετε τον συνολικό συγκεντρωτικό ναύλο μεταφοράς εντός της περιόδου ταξιδιού υποβάλλοντας το αίτημα Capture με τις ακόλουθες λεπτομέρειες.
- το αναγνωριστικό της παραγγελίας επιτυχούς αιτήματος Authorization στο order.id
- ένα αναγνωριστικό συναλλαγής μοναδικό στην παραγγελία για τη συναλλαγή Capture στο transaction.id
- τον συνολικό συγκεντρωτικό ναύλο μεταφοράς για την περίοδο ταξιδιού στο transaction.amount, και
- το νόμισμα παραγγελίας όπως στο transaction.currency για το αίτημα Authorization.
Ακολουθεί το παράδειγμα REST για το αίτημα Capture των συγκεντρωτικών ναύλων μεταφοράς.
Μην υποβάλετε άλλες λεπτομέρειες πληρωμής στο αίτημα Capture, καθώς η πύλη αποθηκεύει τις λεπτομέρειες πληρωμής για κάθε παραγγελία.
| URL | https://eu-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "CAPTURE",
"transaction": {
"amount": "15.00",
"currency": "AUD"
}
}
Ο πληρωτής μπορεί να χρησιμοποιήσει ξανά την κάρτα εντός της επόμενης περιόδου ταξιδιού. Υπάρχουν διαφορετικά όρια στο ποσό που μπορείτε να δεσμεύσετε και να εφαρμόσετε ανάλογα με τη χώρα σας. Για περισσότερες πληροφορίες σχετικά με τους κανόνες, ανατρέξτε στους κανόνες του προγράμματος Mastercard.
Κάρτα Visa
Στο τέλος της περιόδου ταξιδιού, μπορείτε να εγκρίνετε τον συνολικό συγκεντρωτικό ναύλο μεταφοράς εντός της περιόδου ταξιδιού υποβάλλοντας το αίτημα Authorization με τις ακόλουθες λεπτομέρειες.
- ένα αναγνωριστικό για την παραγγελία στο πεδίο order.id - Μπορείτε να υποβάλετε αυτό το αίτημα με το ίδιο αναγνωριστικό παραγγελίας που χρησιμοποιείτε για το αίτημα Verifyστο πρώτο πάτημα με αυτήν την κάρτα ή ένα νέο αναγνωριστικό παραγγελίας.
- ένα αναγνωριστικό μοναδικό στην παραγγελία για τη συναλλαγή Authorization στο transaction.id
- τον συνολικό συγκεντρωτικό ναύλο μεταφοράς για την περίοδο ταξιδιού στο order.amount
- το νόμισμα της παραγγελίας στο order.currency
- transaction.transit.aggregatedFare.type=FARE
- transaction.transit.aggregatedFare.transportationMode με έγκυρη τιμή απαρίθμησης που αντικατοπτρίζει τον τρόπο μεταφοράς που χρησιμοποιήθηκε από τον πληρωτή για το πρώτο ταξίδι
- transaction.transit.aggregatedFare.aggregationStartDate με έγκυρη ημερομηνία έναρξης του ταξιδιού
- sourceOfFunds.provided.card.emvRequest με έγκυρα δεδομένα EMV από το τελευταίο πάτημα εντός της περιόδου ταξιδιού
- sourceOfFunds.provided.card.sequenceNumber
- transaction.source=CARD_PRESENT
- posTerminal.attended=UNATTENDED
- posTerminal.location=MERCHANT_TERMINAL_ON_PREMISES
- posTerminal.cardholderActivated=SELF_SERVICE_TERMINAL
- posTerminal.inputCapability=CONTACTLESS_CHIP
- posTerminal.panEntryMode=CONTACTLESS
- posTerminal.pinEntryCapability=PIN_NOT_SUPPORTED
- posTerminal.lane=99991111
- posTerminal.cardPresenceCapability=CARD_PRESENT
Ακολουθεί το παράδειγμα REST για αίτημα Authorization του συνολικού συγκεντρωτικού ναύλου διαμετακόμισης.
| URL | https://eu-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "15.00",
"currency": "AUD"
},
"posTerminal": {
"address": {
"country": "AUS",
"postcodeZip": "4000"
},
"attended": "UNATTENDED",
"cardPresenceCapability": "CARD_PRESENT",
"cardholderActivated": "SELF_SERVICE_TERMINAL",
"inputCapability": "CONTACTLESS_CHIP",
"lane": "99991111",
"location": "MERCHANT_TERMINAL_ON_PREMISES",
"panEntryMode": "CONTACTLESS",
"pinEntryCapability": "PIN_NOT_SUPPORTED"
},
"sourceOfFunds": {
"provided": {
"card": {
"emvRequest": {
"5F2A": "036",
"5F34": "099",
"82": "0000",
"84": "010101010101",
"95": "0000000000",
"9A": "161021",
"9B": "0101",
"9C": "00",
"9F02": "000000010000",
"9F03": "000000000000",
"9F10": "06011103A000000A0100000000000BB0ABAD",
"9F1A": "036",
"9F1E": "0123ABCD",
"9F26": "D1F722D47FCA8273",
"9F27": "40",
"9F33": "E0B8C8",
"9F34": "1E0300",
"9F35": "12",
"9F36": "0002",
"9F37": "2A4E1690",
"9F6E": "0101"
},
"expiry": {
"month": "12",
"year": "39"
},
"track2": "400555xxxxxx0019=391220xxxxx6711"
}
},
"type": "CARD"
},
"transaction": {
"source": "CARD_PRESENT",
"transit": {
"aggregatedFare": {
"type": "FARE",
"aggregationStartDate": "2020-05-05",
"transportationMode": "TRAIN"
}
}
}
}
Αν το αίτημα είναι επιτυχές, υποβάλετε το αίτημα Capture με τις ακόλουθες λεπτομέρειες
- order identifier της επιτυχούς συναλλαγής Authorization στο
order.id - αναγνωριστικό συναλλαγής μοναδικό στην παραγγελία για τη συναλλαγή Capture στο
transaction.id - επιτυχώς εγκεκριμένο ποσό στο
transaction.amount - το νόμισμα παραγγελίας όπως στο
transaction.currencyγια το αίτημα Authorization
Ακολουθεί το παράδειγμα REST για το αίτημα Capture συγκεντρωτικών ναύλων μεταφοράς.
| URL | https://eu-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "CAPTURE",
"transaction": {
"amount": "15.00",
"currency": "AUD"
}
}
Ο πληρωτής μπορεί να χρησιμοποιήσει ξανά την κάρτα εντός της επόμενης περιόδου ταξιδιού. Αν το αίτημα Authorization αποτύχει, συνεχίστε με το σενάριο κινδύνου πρώτης διαδρομής.
Κίνδυνος πρώτης διαδρομής
Κάρτα Mastercard ή American Express
Η πύλη δεν παρέχει ακόμη υποστήριξη για το πλαίσιο κινδύνου κινδύνου πρώτης διαδρομής της Mastercard.
Κάρτα Visa
Στο τέλος της περιόδου ταξιδιού, όπου το Authorization απορρίπτεται αλλά επιτρέπεται η δέσμευση σύμφωνα με τους κανόνες της Visa, υποβάλετε το αυτόνομο αίτημα Capture με τις ακόλουθες λεπτομέρειες:
- ένα αναγνωριστικό για την παραγγελία στο πεδίο order.id – Αυτό πρέπει να είναι νέο order.id. Δεν μπορείτε να χρησιμοποιήσετε το ίδιο order.id που χρησιμοποιείται για το απορριφθέν αίτημα Authorize.
- ένα αναγνωριστικό συναλλαγής μοναδικό στην παραγγελία για τη συναλλαγή Capture στο transaction.id
- το συνολικό συγκεντρωτικό ποσό ναύλου όπως δίνεται στο ανεπιτυχές αίτημα Authorization στο order.amount
- το νόμισμα παραγγελίας όπως δίνεται στο ανεπιτυχές αίτημα Authorization στο order.currency
- transaction.transit.aggregatedFare.type=FARE
- transaction.transit.aggregatedFare.aggregationStartDate με έγκυρη ημερομηνία πρώτου πατήματος
- transaction.transit.aggregatedFare.transportationMode με έγκυρη τιμή απαρίθμησης που αντικατοπτρίζει τον τρόπο μεταφοράς που χρησιμοποιήθηκε από τον πληρωτή για το πρώτο ταξίδι
- sourceOfFunds.provided.card.emvRequest με έγκυρα δεδομένα EMV από το τελευταίο πάτημα εντός της περιόδου ταξιδιού
- sourceOfFunds.provided.card.sequenceNumber
- transaction.source=CARD_PRESENT
- posTerminal.attended=UNATTENDED
- posTerminal.location= MERCHANT_TERMINAL_ON_PREMISES
- posTerminal.cardholderActivated=SELF_SERVICE_TERMINAL
- posTerminal.inputCapability=CONTACTLESS_CHIP
- posTerminal.panEntryMode=CONTACTLESS
- posTerminal.pinEntryCapability=PIN_NOT_SUPPORTED
- την αριθμητική τιμή 15 ψηφίων που επιστράφηκε στην ανεπιτυχή απόκριση Authorization στο authorizationResponse.transactionIdentifier στο πεδίο authorizationResponse.transactionIdentifier
- την τιμή 1 χαρακτήρα που επιστράφηκε στην ανεπιτυχή απόκριση Authorization στο πεδίο authorizationResponse.returnAci στο πεδίο authorizationResponse.returnAci
- transaction.authorizationCode=VFT000 - Αυτός είναι ο κωδικός Authorization που ορίζει η Visa για αυτόν τον συγκεκριμένο σκοπό
Ακολουθεί το παράδειγμα REST για το αίτημα Standalone Capture συγκεντρωτικών ναύλων μεταφοράς.
| URL | https://eu-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "CAPTURE",
"posTerminal": {
"address": {
"country": "AUS",
"postcodeZip": "4000"
},
"attended": "UNATTENDED",
"cardPresenceCapability": "CARD_PRESENT",
"cardholderActivated": "SELF_SERVICE_TERMINAL",
"inputCapability": "CONTACTLESS_CHIP",
"lane": "teapost",
"location": "MERCHANT_TERMINAL_ON_PREMISES",
"panEntryMode": "CONTACTLESS",
"pinEntryCapability": "PIN_NOT_SUPPORTED"
},
"sourceOfFunds": {
"provided": {
"card": {
"emvRequest": {
"5F2A": "036",
"5F34": "099",
"82": "0000",
"84": "010101010101",
"95": "0000000000",
"9A": "161021",
"9B": "0101",
"9C": "00",
"9F02": "000000010000",
"9F03": "000000000000",
"9F10": "06011103A000000A0100000000000BB0ABAD",
"9F1A": "036",
"9F1E": "0123ABCD",
"9F26": "D1F722D47FCA8273",
"9F27": "40",
"9F33": "E0B8C8",
"9F34": "1E0300",
"9F35": "12",
"9F36": "0002",
"9F37": "2A4E1690",
"9F6E": "0101"
},
"expiry": {
"month": "05",
"year": "25"
},
"track2": "400555xxxxxx0019=391220116006711"
}
},
"type": "CARD"
},
"transaction": {
"amount": "8.00",
"currency": "AUD",
"source": "CARD_PRESENT",
"authorizationCode": "VFT000",
"transit": {
"aggregatedFare": {
"type": "FARE",
"aggregationStartDate": "2022-05-05",
"transportationMode": "TRAIN"
}
}
},
"authorizationResponse": {
"transactionIdentifier": "140929101914398",
"returnAci": "Y"
}
}
Η δέσμευη ενός ανεπιτυχούς αιτήματος Authorization επιτρέπεται σύμφωνα με τους κανόνες της Visa αν:
- ο εκδότης έχει απορρίψει το πρώτο αίτημα Authorization για αυτή την κάρτα
- ο εκδότης έχει απορρίψει το πρώτο αίτημα Authorization για αυτή την κάρτα από το προηγούμενο επιτυχές αίτημα Authorization για έναν συγκεντρωτικό ναύλο μεταφοράς, και
- το ποσό συναλλαγής είναι λιγότερο από ή ίσο με το όριο αντιστροφής χρέωσης (chargeback) της χώρας σας.
Αφού υποβάλετε το αίτημα Capture, η κάρτα θα εξακολουθεί να βρίσκεται στη λίστα άρνησης. Μπορείτε να χρησιμοποιήσετε την ανάκτηση χρέους που εκκινείται από τον έμπορο για να προσδιορίσετε αν η κάρτα έχει επανέλθει σε καθεστώς φερεγγυότητας και επομένως θα πρέπει να αφαιρεθεί από τη λίστα άρνησης. Υποβάλετε το αίτημα Authorization με νέα παραγγελία με τις ακόλουθες λεπτομέρειες:
- order.id - Πρέπει να είναι νέο order.id
- transaction.id
- order.amount - Πρέπει να είναι το ίδιο ποσό με αυτό στο αίτημα Standalone Capture
- το νόμισμα στο πεδίο order.currency
- transaction.transit.aggregatedFare.type=DEBT_RECOVERY_MERCHANT_INITIATED
- transaction.transit.aggregatedFare.transportationMode (υποχρεωτικό) με έγκυρη τιμή απαρίθμησης
- transaction.source=MERCHANT
- transaction.transit.aggregatedFare.aggregationStartDate (υποχρεωτικό) με έγκυρη ημερομηνία πρώτου πατήματος
- την αριθμητική τιμή 15 ψηφίων που επιστράφηκε στην ανεπιτυχή απόκριση Authorization στα πεδία authorizationResponse.transactionIdentifier και transaction.acquirer.customData χρησιμοποιώντας την ακόλουθη σύνταξη:{"VisaTransitFailedAuthTransactionIdentifier":"<value>"}
- τις λεπτομέρειες πληρωμής, συμπεριλαμβανομένων του αριθμού κάρτας, της ημερομηνίας λήξης κ.λπ.
Αν το αίτημα Authorization είναι επιτυχές, πρέπει να αφαιρέσετε την κάρτα από τη λίστα άρνησης εντός μίας ώρας και να ακυρώσετε αμέσως το αίτημα Authorization.
Ακύρωση έγκρισης
Στη συνέχεια, πρέπει να υποβάλετε ένα αίτημα WS API VOID για την ίδια παραγγελία όπως για το επιτυχές αίτημα Authorization με:
- order.id- Πρέπει να είναι το order.id του επιτυχούς αιτήματος Authorization
- transaction.id - Πρέπει να είναι το νέο transaction ID στην παραγγελία
- transaction.targetTransactionId - Πρέπει να είναι το transaction.id του επιτυχούς αιτήματος Authorization
Μπορείτε να επαναλάβετε το αίτημα Authorization μέχρι τον επιτρεπόμενο αριθμό προσπαθειών ή τη συχνότητα για τα αιτήματα ανάκτησης χρέους που εκκινήθηκαν από τον έμπορο. Για περισσότερες πληροφορίες σχετικά με την ανάκτηση χρέους που εκκινείται από τον έμπορο, ανατρέξτε στο παρακάτω σενάριο ανάκτησης χρέους. Ο εκδότης είναι υπεύθυνος για το αίτημα Standalone Capture. Αυτό σημαίνει ότι ένα επιτυχές αίτημα Capture δεν σημαίνει ότι ο λογαριασμός του πληρωτή είναι φερέγγυος και ότι η κάρτα μπορεί να αφαιρεθεί από τη λίστα άρνησης.
Ανάκτηση χρέους που εκκινείται από τον πληρωτή
Τα προγράμματα σάς επιτρέπουν να επιχειρήσετε να ανακτήσετε εκκρεμείς οφειλές για ναύλους μεταφοράς χωρίς να εμπλέκετε τον πληρωτή. Μια επιτυχής ανάκτηση χρέους θα επιτρέψει στην κάρτα να γίνει ξανά αποδεκτή για ταξίδι μόλις ο λογαριασμός του πληρωτή καταστεί ξανά φερέγγυος.
Για να υποβάλετε συναλλαγές ανάκτησης χρέους, δώστε τις λεπτομέρειες πληρωμής που χρησιμοποιεί ένας πληρωτής.
- Ανέπαφη πληρωμή EMV: Δώστε τις λεπτομέρειες FPAN.
- Ανέπαφη πληρωμή με κινητή συσκευή:
- Για Mastercard: Δώστε τις λεπτομέρειες FPAN. Η πύλη θα δώσει τις λεπτομέρειες FPAN της απόκρισης συναλλαγής στην αρχική συναλλαγή.
- Για την κάρτα Visa: Δώστε τις λεπτομέρειες DPAN. Βεβαιωθείτε ότι έχετε αποθηκεύσει αυτές τις λεπτομέρειες καθώς η πύλη δεν σας επιτρέπει να τις ανακτήσετε.
Κάρτα Mastercard ή American Express
Αν το αίτημα Authorization που είχατε υποβάλει για το πρώτο ταξίδι κατά την περίοδο του ταξιδιού αποτύχει, τότε μπορείτε να επιχειρήσετε να ανακτήσετε τον συνολικό ναύλο για αυτό το ταξίδι σύμφωνα με τους ισχύοντες κανόνες του προγράμματος Mastercard. Υποβάλετε ένα αίτημα Authorization με τις ακόλουθες λεπτομέρειες:
- ένα αναγνωριστικό για την παραγγελία στο πεδίο
order.id– Αυτό πρέπει να είναι ένα νέο order.id. Δεν μπορεί να είναι το ίδιο order.id που χρησιμοποιείται για το αίτημα VERIFY, το αίτημα AUTHORIZE που απορρίφθηκε ή το αίτημα CAPTURE. - ένα αναγνωριστικό μοναδικό στην παραγγελία για τη συναλλαγή
Authorizationστοtransaction.id transaction.transit.aggregatedFare.type=DEBT_RECOVERY_MERCHANT_INITIATEDtransaction.transit.aggregatedFare.transportationModeμε έγκυρη τιμή απαρίθμησης που αντικατοπτρίζει τον τρόπο μεταφοράς που χρησιμοποιεί ο πληρωτής για το πρώτο ταξίδιtransaction.transit.aggregatedFare.aggregationStartDateμε έγκυρη ημερομηνία έναρξης του ταξιδιούtransaction.source=MERCHANT- οι λεπτομέρειες πληρωμής συμπεριλαμβανομένων του FPAN και της λήξης του FPAN
Ακολουθεί το παράδειγμα REST για το αίτημα Authorization συγκεντρωτικών ναύλων μεταφοράς για την ανάκτηση χρέους.
| URL | https://eu-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "15.00",
"currency": "AUD"
},
"sourceOfFunds": {
"provided": {
"card": {
"expiry": {
"month": "12",
"year": "39"
},
"number": "512345xxxxxx1234",
"sequenceNumber": "099"
}
},
"type": "CARD"
},
"transaction": {
"source": "MERCHANT",
"transit": {
"aggregatedFare": {
"type": "DEBT_RECOVERY_MERCHANT_INITIATED",
"aggregationStartDate": "2020-05-05",
"transportationMode": "TRAIN"
}
}
}
}
Αν το αίτημα είναι επιτυχές, υποβάλετε το αίτημα Capture με τις ακόλουθες λεπτομέρειες:
- το αναγνωριστικό παραγγελίας της επιτυχούς συναλλαγής Authorization στο order.id
- ένα αναγνωριστικό συναλλαγής μοναδικό στην παραγγελία για τη συναλλαγή Capture στο transaction.id
- το επιτυχώς εγκεκριμένο ποσό στο transaction.amount
- το νόμισμα παραγγελίας όπως στο transaction.currency για το αίτημα Authorization
Ακολουθεί το παράδειγμα REST για το αίτημα Capture συγκεντρωτικών ναύλων μεταφοράς για την ανάκτηση χρέους.
| URL | https://eu-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "CAPTURE",
"transaction": {
"amount": "15.00",
"currency": "AUD"
}
}
Αφού γίνει η ανάκτηση του χρέους με επιτυχία, αφαιρέστε την κάρτα από τη λίστα άρνησης. Το αίτημα Authorization για την ανάκτηση χρέους θα είναι επιτυχές μόνο αν οι πληρωτές έχουν επαρκή κεφάλαια στον λογαριασμό τους. Οι εκδότες δεν αναλαμβάνουν ευθύνη για τις συναλλαγές ανάκτησης χρέους. Αν το αίτημα Authorization αποτύχει, μπορείτε να επαναλάβετε την ανάκτηση του χρέους σύμφωνα με τους ισχύοντες κανόνες του προγράμματος Mastercard. Η Mastercard ορίζει το επιτρεπόμενο ποσό για τη συναλλαγή ανάκτησης χρέους και τη συχνότητα των προσπαθειών ανάκτησης χρέους. Το επιτρεπόμενο ποσό πρέπει να είναι μικρότερο από ή ίσο με το ανώτατο όριο ανέπαφων συγκεντρωτικών συναλλαγών μεταφοράς που ορίζει η Mastercard. Δεν πρέπει να επιχειρήσετε ανάκτηση χρέους αν έχετε επαρκείς πληροφορίες για να προσδιορίσετε ότι το αίτημα Authorization για το πρώτο ταξίδι κατά την περίοδο του ταξιδιού απορρίφθηκε εξαιτίας της απώλειας ή της κλοπής της κάρτας, αυτό αποτελεί άμεση απόρριψη. Δεν μπορείτε να ανακτήσετε τα χρήματα αν η κάρτα χαθεί ή κλαπεί. Αυτό είναι άμεση απόρριψη ή όλες οι επιτρεπόμενες προσπάθειες για την ανάκτηση του χρέους έχουν αποτύχει.
Κάρτα Visa
Αν δεν έχετε υποβάλει το αίτημα Capture, μπορείτε να επιχειρήσετε να ανακτήσετε τον ναύλο σύμφωνα με τους ισχύοντες κανόνες του προγράμματος Visa. Για περισσότερες πληροφορίες σχετικά με την πρώτη απορριφθείσα συναλλαγή στην ανέπαφη κάρτα Visa μέχρι ένα καθορισμένο όριο κοινής ευθύνης συναλλαγής κινητικότητας και μεταφοράς, ανατρέξτε στο σενάριο κινδύνου πρώτης διαδρομής.
Υποβάλετε το αίτημα Authorization με τις ακόλουθες λεπτομέρειες:
- ένα αναγνωριστικό για την παραγγελία στο πεδίο order.id – Αυτό πρέπει να είναι νέο order.id. Δεν μπορεί να είναι το ίδιο order.id που χρησιμοποιείται για το αίτημα VERIFY, το αίτημα AUTHORIZE που απορρίφθηκε ή το αίτημα CAPTURE
- ένα αναγνωριστικό μοναδικό στην παραγγελία για αυτή τη συναλλαγή Authorization στο
transaction.id transaction.source=MERCHANTtransaction.transit.aggregatedFare.type=DEBT_RECOVERY_MERCHANT_INITIATEDtransaction.transit.aggregatedFare.transportationModeμε έγκυρη τιμή απαρίθμησης που αντικατοπτρίζει τον τρόπο μεταφοράς που χρησιμοποιεί ο πληρωτής για το πρώτο ταξίδιtransaction.transit.aggregatedFare.aggregationStartDateμε έγκυρη ημερομηνία έναρξης του ταξιδιού- την αριθμητική τιμή 15 ψηφίων που επιστράφηκε στην ανεπιτυχή απόκριση Authorization στα πεδία
authorizationResponse.transactionIdentifier and the transaction.acquirer.customDataχρησιμοποιώντας την ακόλουθη σύνταξη: {"VisaTransitFailedAuthTransactionIdentifier":"<value>"} - οι λεπτομέρειες πληρωμής, συμπεριλαμβανομένων είτε του FPAN ή της λήξης του FPAN όπου η αρχική συναλλαγή ήταν μια ανέπαφη πληρωμή EMV είτε του DPAN ή της λήξης του DPAN όπου η αρχική συναλλαγή ήταν μια ανέπαφη πληρωμή μέσω κινητής συσκευής
Ακολουθεί το παράδειγμα REST για το αίτημα Authorization συγκεντρωτικών ναύλων μεταφοράς για την ανάκτηση χρέους.
| URL | https://eu-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "15.00",
"currency": "AUD"
},
"sourceOfFunds": {
"provided": {
"card": {
"expiry": {
"month": "12",
"year": "39"
},
"number": "400555xxxxxx0019",
"sequenceNumber": "099"
}
},
"type": "CARD"
},
"transaction": {
"source": "MERCHANT",
"transit": {
"aggregatedFare": {
"type": "DEBT_RECOVERY_MERCHANT_INITIATED",
"aggregationStartDate": "2020-05-05",
"transportationMode": "TRAIN"
}
}
}
}
Αν το αίτημα είναι επιτυχές, υποβάλετε το αίτημα Capture με τις ακόλουθες λεπτομέρειες:
- το αναγνωριστικό παραγγελίας της επιτυχούς συναλλαγής Authorization στο
order.id - ένα αναγνωριστικό συναλλαγής που είναι μοναδικό στην παραγγελία για τη συναλλαγή Capture στο
transaction.id - το επιτυχώς εγκεκριμένο ποσό στο
transaction.amount - το νόμισμα παραγγελίας που είναι το ίδιο όπως για το αίτημα Authorization στο
transaction.currency
Ακολουθεί το παράδειγμα REST για το αίτημα Capture συγκεντρωτικών ναύλων μεταφοράς για την ανάκτηση χρέους.
| URL | https://eu-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "CAPTURE",
"transaction": {
"amount": "15.00",
"currency": "AUD"
}
}
Μετά την επιτυχή ανάκτηση του χρέους, σύμφωνα με τους κανόνες της Visa, πρέπει να αφαιρέσετε την κάρτα από τη λίστα άρνησης εντός μίας ώρας από τη στιγμή που λάβατε την έγκριση του αιτήματος Authorization. Αν το αίτημα Authorization αποτύχει, μπορείτε να επαναλάβετε την ανάκτηση του χρέους σύμφωνα με τους ισχύοντες κανόνες του προγράμματος Visa. Η Visa καθορίζει τον επιτρεπόμενο αριθμό προσπαθειών για την ανάκτηση χρέους.
Ανάκτηση χρέους που εκκινείται από τον πληρωτή
Αυτό το σενάριο ισχύει για τις Mastercard, Visa και American Express. Για τις πληρωμές ανάκτησης χρέους που εκκινούνται από τον πληρωτή, δεν πρέπει να υποβάλετε κανένα πεδίο στην ομάδα παραμέτρων transaction.transit. Η συναλλαγή ανάκτησης χρέους που εκκινείται από τον πληρωτή θα αντιμετωπίζεται σαν μια κανονική συναλλαγή κατά την οποία ο πληρωτής πραγματοποιεί μια αγορά από τον έμπορο.
Ανάκτηση χρέους που εκκινείται με πάτημα
Αυτό το σενάριο ισχύει για τις Mastercard, Visa και American Express.
Για τις πληρωμές ανάκτησης χρέους που εκκινούνται με πάτημα, δεν πρέπει να υποβάλετε κανένα πεδίο στην ομάδα παραμέτρων transaction.transit. Η συναλλαγή ανάκτησης χρέους που εκκινείται με πάτημα θα αντιμετωπίζεται σαν μια κανονική συναλλαγή κατά την οποία ο πληρωτής πραγματοποιεί μια αγορά από τον έμπορο.
Δοκιμή της ενοποίησής σας
Για περισσότερες πληροφορίες σχετικά με τη δοκιμή της ενοποίησης, επικοινωνήστε με τον αντιπρόσωπο για τον λογαριασμό σας.