Οδηγός ενοποίησης

Βήμα 1: Ελέγξτε τη συνδεσιμότητα της πύλης

Πριν στείλετε οποιαδήποτε αιτήματα, ελέγξτε τη σύνδεσή σας στην πύλη. Για έλεγχο, μεταβείτε στην ακόλουθη διεύθυνση URL μέσω ενός web browser: https://test.ibanke-commerce.nbg.gr/api/rest/version/1/information. Αν η προσπάθεια σύνδεσης είναι επιτυχής και η πύλη επεξεργάζεται αιτήματα, τότε η σελίδα του browser εμφανίζει {"status":"OPERATING"}.

Βήμα 2: Ρυθμίστε τη μέθοδο ταυτοποίησης

Η πύλη υποστηρίζει δύο μεθόδους ταυτοποίησης, τα πιστοποιητικά SSL Secure Sockets Layer (SSL) και κωδικούς πρόσβασης.

Επιλέξτε τη μέθοδο που εξυπηρετεί καλύτερα το επιχειρηματικό σας μοντέλο και εφαρμόστε την.

Αν χρησιμοποιείτε πιστοποιητικά SSL ως μέθοδο ταυτοποίησης, βεβαιωθείτε ότι επικυρώνετε τη διαδρομή του πιστοποιητικού SSL της πύλης κάθε φορά που συνδέεστε στην πύλη. Επικοινωνήστε με έναν προγραμματιστή web αν δεν είστε εξοικειωμένοι με τον τρόπο επικύρωσης ή εξαγωγής των πιστοποιητικών SSL από ιστότοπους. Βεβαιωθείτε ότι ο διακομιστής είναι μια αξιόπιστη πηγή.

Βήμα 3: Δημιουργήστε το αίτημα συναλλαγής

Η δημιουργία του σώματος του αιτήματος είναι κρίσιμο βήμα για την ενοποίηση. Τα πεδία σώματος αιτήματος που συγκεντρώθηκαν από τη φόρμα πληρωτή και δημιουργήθηκαν στο σύστημά σας αποστέλλονται στη διεύθυνση URL του API σε μορφή REST JSON. Ανάλογα με την πράξη της συναλλαγής, μία από τις ακόλουθες μεθόδους HTTP χρησιμοποιείται στη διεύθυνση URL:

Η μέθοδος POST χρησιμοποιείται όταν θέλετε το σύστημα να δημιουργήσει μια νέα συλλογή.
Η μέθοδος PUT χρησιμοποιείται όταν θέλετε να προσθέσετε ή να τροποποιήσετε ένα μέλος μιας συλλογής.
Η μέθοδος GET χρησιμοποιείται για την ανάκτηση πράξεων.

Η φόρμα που απευθύνεται στον πληρωτή πρέπει να εκθέτει μόνο τα πεδία που απαιτούν στοιχεία από τον πληρωτή. Οι τιμές για πεδία όπως το ID παραγγελίας, το ID συναλλαγής, η Έκδοση και το ID εμπόρου πρέπει να υπολογίζονται στον κώδικά σας.

Μορφοποίηση δεδομένων σώματος αιτήματος από φόρμες

Ανεξάρτητα από τη γλώσσα που έχει επιλεγεί στο απόσπασμα κώδικα. Είναι σημαντικό η ενοποίησή σας να μορφοποιεί σωστά τα δεδομένα αιτήματος συναλλαγής. Σε πολλές γλώσσες, είναι σύνηθες να λαμβάνετε τα δεδομένα φόρμας που έχει εισάγει ένας πληρωτής, ως πίνακα.

Στις περισσότερες περιπτώσεις, μπορείτε στη συνέχεια να χρησιμοποιήσετε έναν πίνακα για να αποθηκεύσετε τα ονόματα πεδίων και τις τιμές για κάθε πεδίο που σκοπεύετε να διαβιβάσετε στην πύλη και να τον μορφοποιήσετε όπως φαίνεται στο παρακάτω απόσπασμα. Αυτό το απόσπασμα κώδικα ολοκληρώνει δύο κρίσιμες λειτουργίες για να οδηγήσει σε ένα σωστά διαμορφωμένο σώμα αιτήματος συναλλαγής:

Διασφαλίζει ότι δεν προστίθενται κενά πεδία στο σώμα αιτήματος συναλλαγής.
Μορφοποιεί τα δεδομένα σύμφωνα με το πρωτόκολλο JSON.

Τρόπος μετατροπής δεδομένων φόρμας σε

(, ) Αλλαγή

Αυτό το απόσπασμα κώδικα δείχνει πώς μπορείτε να μετατρέψετε δεδομένα φόρμας σε .

Βήμα 4: Στείλτε το αίτημα συναλλαγής

Ακολουθήστε αυτά τα βήματα για να διασφαλίσετε ότι το σώμα αιτήματος συναλλαγής αποστέλλεται με ασφάλεια στην πύλη πληρωμών:

Ορισμός δεδομένων ταυτοποίησης

Το API απαιτεί επιτυχή ταυτοποίηση κάθε αιτήματος συναλλαγής. Αν χρησιμοποιείτε τον κωδικό πρόσβασης API ως τη μέθοδο ταυτοποίησης, το παρακάτω απόσπασμα κώδικα καλύπτει τον τρόπο παροχής των δεδομένων ταυτοποίησης, όπως το αναγνωριστικό εμπόρου ή τον κωδικό πρόσβασης API ή και τα δύο, ως κεφαλίδα σε κάθε αίτημα συναλλαγής.

Μην συμπεριλάβετε την κεφαλίδα ταυτοποίησης αν χρησιμοποιείτε την ταυτοποίηση πιστοποιητικού SSL.

Ορισμός κεφαλίδων HTTP

Οι κεφαλίδες HTTP παρέχουν πληροφορίες μεταδεδομένων σχετικά με το αίτημα συναλλαγής που αποστέλλεται στην πύλη. Εκτός από τυχόν κεφαλίδες ελέγχου ταυτοποίησης που καλύπτονται στις προηγούμενες ενότητες, το ακόλουθο απόσπασμα κώδικα δείχνει πώς να ορίσετε τις υποχρεωτικές κεφαλίδες HTTP για κάθε αίτημα συναλλαγής.

Οι κεφαλίδες Content-Length και Content-Type είναι κρίσιμες καθώς υποδεικνύουν τον web server σχετικά με τον αριθμό και τον τύπο των byte δεδομένων, που προσδιορίζονται από έναν τύπο MIME.

Η κωδικοποίηση χαρακτήρων του αιτήματός σας πρέπει να περιλαμβάνει μορφή ISO-8859-1 ή UTF-8. Η πύλη απορρίπτει τυχόν χαρακτήρες που δεν μπορούν να αναπαρασταθούν σε μία από τις υποστηριζόμενες μορφές. Αν δεν καθορίζεται, η πύλη ορίζει την κωδικοποίηση από προεπιλογή σε ISO-8859-1. Ακολουθεί ένα παράδειγμα της κεφαλίδας Content-Type.

Παράδειγμα κεφαλίδας Content-Type

"Content-Type: application/json; charset=UTF-8"

Για να ορίσετε την κεφαλίδα, χρησιμοποιήστε τον ακόλουθο κώδικα.

Παρόλο που το UTF-8 είναι μια υποστηριζόμενη μορφή χαρακτήρων, τα πεδία που αποστέλλονται σε διεκπεραιωτή πιστωτικών καρτών περιορίζονται στους χαρακτήρες ISO-8859-1. Αυτό οφείλεται στα μεταγενέστερα οικονομικά συστήματα που δεν μπορούν να υποστηρίξουν όλους τους χαρακτήρες UTF-8.

Χρήση συγκεκριμένης μεθόδου HTTP

Η χρήση μιας συγκεκριμένης μεθόδου HTTP όπως POST, PUT ή GET για κάθε συναλλαγή είναι σημαντική. Όλες οι βασικές πράξεις που εκτελούνται μέσω του API χρησιμοποιούν το πρωτόκολλο HTTP και τις μεθόδους POST ή PUT, εκτός από το CHECK GATEWAY και διάφορες πράξεις ανάκτησης:

Η μέθοδος HTTP PUT ενημερώνει το μέλος της συλλογής που απευθύνεται, ή αν δεν υπάρχει, δημιουργεί νέο μέλος. Για παράδειγμα, εξετάστε ένα αίτημα όπου η τιμή Request URI είναι: http://example.com/version/v1/merchant/m1/order/o1/transaction/t1

Στο URI, το t1 είναι μέλος του πόρου συλλογής o1. Αν υπάρχει t1, το αίτημα τροποποιεί την προέλευση t1 και αν όχι, δημιουργεί ένα νέο μέλος t1.
Η μέθοδος HTTP GET ανακτά μια αναπαράσταση του απευθυνόμενου μέλους της συλλογής. Για παράδειγμα, εξετάστε ένα αίτημα όπου η τιμή Request URI είναι: http://example.com/version/v1/merchant/m1/order/o1/transaction/t1

Το αίτημα ανακτά το μέλος t1 του πόρου συλλογής o1.
Η μέθοδος HTTP POST δημιουργεί μια νέα συλλογή. Στα API πύλης, χρησιμοποιείται κυρίως για πράξεις που δημιουργούν ένα νέο σύνολο δεδομένων, όπως η πράξηCREATE SESSION ή PAYMENT OPTIONS INQUIRY.

Το παρακάτω απόσπασμα κώδικα δείχνει πώς να χρησιμοποιήσετε τη μέθοδο HTTP POST.

Το παρακάτω απόσπασμα κώδικα δείχνει πώς να χρησιμοποιήσετε τη μέθοδο HTTP PUT.

Ορισμός της διεύθυνσης URL προορισμού

Η διεύθυνση URL που χρησιμοποιείται για την αποστολή αιτήματος συναλλαγής ποικίλλει για κάθε πράξη συναλλαγής. Στο παρακάτω απόσπασμα κώδικα, η συνάρτηση υπολογίζει τη διεύθυνση URL από τη διαμόρφωσή σας, ορίζει τις τιμές των πόρων έκδοσης και εμπόρου και, τέλος, προσαρτά μια προσαρμοσμένη λίστα πόρων και τα αναγνωριστικά τους.

Αυτά τα προσαρμοσμένα στοιχεία αντιπροσωπεύουν τους πόρους παραγγελιών και συναλλαγών. Για περισσότερες πληροφορίες σχετικά με τη μορφή διεύθυνσης URL για κάθε πράξη, ανατρέξτε στις μεμονωμένες πράξεις στην Αναφορά API.

Ορισμός της διεύθυνσης URL για την αποστολή της συναλλαγής

Το παρακάτω απόσπασμα κώδικα δείχνει πώς να ορίσετε τη διεύθυνση URL για την αποστολή μιας συναλλαγής.

Επαλήθευση του πιστοποιητικού SSL μιας πύλης

Αν χρησιμοποιείτε τη μέθοδο ταυτοποίησης με πιστοποιητικό SSL, επικυρώστε το πιστοποιητικό SSL της πύλης. Η επικύρωση του πιστοποιητικού SSL κατά την αποστολή του αιτήματος συναλλαγής αποτρέπει κακόβουλες επιθέσεις και άλλα πιθανά ζητήματα ασφάλειας. Το παρακάτω απόσπασμα κώδικα δείχνει πώς να επαληθεύσετε το πιστοποιητικό SSL.

Διαμόρφωση διακομιστή μεσολάβησης

Σε ορισμένα περιβάλλοντα δικτύου, μπορεί να είναι απαραίτητο να στείλετε το αίτημα συναλλαγής μέσω διακομιστή μεσολάβησης. Επικοινωνήστε με τον διαχειριστή του δικτύου σας ή τον πάροχο web hosting για πληροφορίες σχετικά με το αν απαιτείται διακομιστής μεσολάβησης για την ενοποίησή σας. Το παρακάτω απόσπασμα κώδικα δείχνει πώς να ορίσετε έναν διακομιστή μεσολάβησης και την ταυτοποίησή του.

Στείλτε τη συναλλαγή στην πύλη

Στείλτε το σωστό μορφοποιημένο αίτημα συναλλαγής στην πύλη και περιμένετε απόκριση. Το παρακάτω απόσπασμα κώδικα δείχνει πώς να στείλετε μια συναλλαγή στην πύλη.

ΣΕ ΑΥΤΗ ΤΗ ΣΕΛΙΔΑ