Αναγνωριστικά
Διάφορα αναγνωριστικά χρησιμοποιούνται για τη συμφωνία και την παρακολούθηση συναλλαγών που κινούνται μέσω των συστημάτων πληρωμών. Αυτά τα αναγνωριστικά χρησιμοποιούνται στην αναφορά τακτοποίησης (settlement) από την τράπεζα εμπόρου σας για να σας βοηθήσουν να προσδιορίσετε κάθε συναλλαγή.
Παρέχετε αναγνωριστικά όταν στέλνετε αιτήματα στο Tyro eCommerce Payment Gateway. Ιδανικά, το ίδιο αναγνωριστικό μπορεί να χρησιμοποιηθεί σε όλα τα συστήματα, δηλαδή το δικό σας, την πύλη και την τράπεζα εμπόρου σας. Ωστόσο, τα διαφορετικά συστήματα έχουν διαφορετικές απαιτήσεις και συχνά απαιτείται συνδυασμός αναγνωριστικών. Κάθε παραγγελία που δημιουργείτε μπορεί να έχει τρία διαφορετικά είδη αναγνωριστικών:
Τύποι αναγνωριστικών
Κάθε παραγγελία που δημιουργείτε μπορεί να έχει τρία διαφορετικά είδη αναγνωριστικών:
- ID παραγγελίας: Αυτό είναι ένα υποχρεωτικό αναγνωριστικό που πρέπει να ορίσετε ως μέρος της πρώτης συναλλαγής σε κάθε παραγγελία. Η τιμή δίνεται ως πεδίο orderID στο σώμα αιτήματος και απόκρισης ή ως παράμετρος ερωτήματος
orderIDερωτήματος, ανάλογα με την πράξη. Η τιμή πρέπει να είναι μοναδική σε όλες τις παραγγελίες που αποστέλλονται από τον λογαριασμό εμπόρου σας, καθώς η πύλη τη χρησιμοποιεί για να προσδιορίσει μια συγκεκριμένη παραγγελία που υποβάλατε. Για ευκολία, χρησιμοποιήστε ένα φυσικό κλειδί στο δικό σας σύστημα ωςorder ID, όπως το αναγνωριστικό καλαθιού αγορών ή τον αριθμό τιμολογίου. Αυτό διευκολύνει την παρακολούθηση παραγγελιών μεταξύ του συστήματός σας και της πύλης. Καθώς η πύλη επιχειρεί επίσης να χρησιμοποιήσει το αναγνωριστικό παραγγελίας σε μηνύματα τράπεζας εμπόρου όταν είναι δυνατόν, και τα τρία συστήματα, δηλαδή το δικό σας, η πύλη και η τράπεζά σας μπορούν να συνδεθούν με ένα κοινό αναγνωριστικό. - αναφορά παραγγελίας: Σε ορισμένες περιπτώσεις, τα αναγνωριστικά παραγγελιών που χρησιμοποιείτε στο δικό σας σύστημα δεν μπορούν να χρησιμοποιηθούν στην πύλη, καθώς δεν πληρούν τις απαιτήσεις της πύλης. Για παράδειγμα, αν το σύστημά σας δημιουργεί αναγνωριστικά παραγγελιών, επανεκκινεί όταν υπερβαίνει ένα καθορισμένο ανώτατο όριο ή ομαδοποιεί πολλές προσφορές σε μία παραγγελία, το αναγνωριστικό παραγγελίας στο σύστημά σας δεν λειτουργεί ως μοναδικό αναγνωριστικό στην πύλη. Σε αυτήν την περίπτωση, πρέπει να δημιουργήσετε ένα νέο μοναδικό αναγνωριστικό
order IDπου θα χρησιμοποιείται στην πύλη. Επιπλέον, μπορείτε να παρέχετε μια προαιρετική τιμή,order.reference, η οποία περιέχει το αναγνωριστικό που χρησιμοποιείτε στο δικό σας σύστημα και σας επιτρέπει να παρακολουθείτε τις παραγγελίες μεταξύ του συστήματός σας και της πύλης. - Αναγνωριστικό για την τράπεζα εμπόρου: Καθώς η πύλη πρέπει να διαβιβάσει ένα αναγνωριστικό στην τράπεζα εμπόρου, επιχειρεί να χρησιμοποιήσει το
order IDσας. Ωστόσο, αν αυτό δεν είναι κατάλληλο για την τράπεζα εμπόρου σας, η πύλη μετατρέπει την τιμή σε κάτι που ταιριάζει με το μήκος του πεδίου και τις απαιτήσεις μορφής της τράπεζας εμπόρου. Αν θέλετε να ελέγξετε την τιμή που παρέχει η πύλη στην τράπεζα εμπόρου, μπορείτε να δώσετε μια τιμή transaction.acquirer.transactionId στο αίτημα. Ωστόσο, αν αυτή η τιμή δεν αντιστοιχεί στις απαιτήσεις της τράπεζας εμπόρου, η πύλη τη μετατρέπει και αυτή πριν από την αποστολή. Και στις δύο περιπτώσεις, μπορείτε να βρείτε το αναγνωριστικό που έστειλε η πύλη στην τράπεζα εμπόρου στο πεδίο transaction.acquirer.transactionId της απόκρισης αιτήματος. Αν η πύλη έπρεπε να μετατρέψει το αναγνωριστικό, αποθηκεύστε την τιμή απόκρισης για να μπορέσετε να αντιστοιχίσετε τις λεπτομέρειες πληρωμής της τράπεζας εμπόρου στις παραγγελίες που βρίσκονται στο σύστημά σας.
Συναλλαγές
Για να αναγνωρίσει τις μεμονωμένες συναλλαγές σε μια παραγγελία, η πύλη χρησιμοποιεί αναγνωριστικά συναλλαγών. Η τιμή δίνεται ως το πεδίο transaction.id στο σώμα του αιτήματος και της απόκρισης, ή ως παράμετρος ερωτήματος transactionID για συγκεκριμένες πράξεις. Αν το σύστημά σας παρακολουθεί τις συναλλαγές χρησιμοποιώντας ένα μοναδικό αναγνωριστικό, χρησιμοποιήστε το. Διαφορετικά, χρησιμοποιήστε οποιονδήποτε διαδοχικό ή τυχαίο αριθμό, αρκεί να είναι μοναδικός για κάθε συναλλαγή εντός της ίδιας παραγγελίας.
Για να προσδιορίσετε τη συναλλαγή στην τράπεζα εμπόρου για την κάρτα, χρησιμοποιήστε την απόδειξη. Αυτή η τιμή επιστρέφεται στο πεδίο transaction.receipt της απόκρισης αιτήματος, ωστόσο, αυτή η τιμή μπορεί να μην είναι μοναδική.