Σας ευχαριστούμε που επιλέξατε το API μας για την ενσωμάτωση! Σκοπός αυτής της τεκμηρίωσης είναι να περιγράψει τον τρόπο με τον οποίο μπορείτε να συνδεθείτε με την εφαρμογή πληρωμών που λειτουργεί σε συσκευές με λειτουργικό σύστημα Android και με την εφαρμογή GP tom. Αυτό το API θα σας βοηθήσει να ενσωματώσετε εύκολα τις εφαρμογές που βασίζονται στο Android και τις οποίες έχετε αναπτύξει οι ίδιοι. Πιστεύουμε ότι, με τη βοήθεια του API μας, θα ολοκληρώσετε την ενσωμάτωση σε λίγα λεπτά.
Ετοιμάστε όλα τα απαραίτητα
Μεταβείτε στην ενότητα „Λήψεις“ αυτού του εγχειριδίου και κατεβάστε τα πιο πρόσφατα πακέτα με την εφαρμογή, την δοκιμαστική έκδοση της εφαρμογής και τη βιβλιοθήκη AIDL. Στόχος αυτού του προσομοιωτή είναι να αποφευχθεί η ανάγκη χρήσης δοκιμαστικών καρτών και να βοηθήσει στην προσομοίωση όλων των περιπτώσεων αποτελεσμάτων πληρωμών που ενδέχεται να συναντήσετε σε περιβάλλον παραγωγής. Σημειώνουμε ότι το API είναι πανομοιότυπο τόσο στο περιβάλλον δοκιμών όσο και στο περιβάλλον παραγωγής.
Προς το παρόν, μπορείτε να προσομοιώσετε την ακόλουθη συμπεριφορά στέλνοντας το ακριβές ποσό από την εφαρμογή σας:
Ποσό: 1111
Η ΠΩΛΗΣΗ ΤΩΝ ΚΑΡΤΩΝ ΟΛΟΚΛΗΡΩΘΗΚΕ ΜΕ ΕΠΙΤΥΧΙΑ
Η εφαρμογή σας θα λάβει το μήνυμα επιτυχούς ολοκλήρωσης της συναλλαγής και θα επεξεργαστεί τη συναλλαγή με επιτυχία από την πλευρά σας.
Ποσό: 1122
ΑΠΟΤΥΧΙΑ ΠΩΛΗΣΗΣ ΚΑΡΤΑΣ – ΑΠΟΡΡΙΨΗ
Η εφαρμογή σας θα λάβει ένα αποτέλεσμα απόρριψης της συναλλαγής και θα επεξεργαστείτε τη συναλλαγή με τον σωστό τρόπο από την πλευρά σας – θα εμφανίσετε ότι η συναλλαγή απέτυχε.
Ποσό: 1123
ΑΠΟΤΥΧΙΑ ΠΩΛΗΣΗΣ ΚΑΡΤΑΣ – ΛΗΞΗ ΧΡΟΝΟΥ ΑΝΑΜΟΝΗΣ
Θα σημειωθεί time out της πληρωμής από την πλευρά μας και η εφαρμογή σας πρέπει να εμφανίσει το αποτέλεσμα ανάλογα.
Ποσό: 1124
ΕΞΑΙΡΕΣΗ ΑΠΟΤΥΧΙΑΣ ΠΩΛΗΣΗΣ ΚΑΡΤΑΣ
Προσομοιώνει μια κατάσταση κατά την οποία προκύπτει ένα σφάλμα από την πλευρά μας – π.χ. τεχνική βλάβη. Με αυτόν τον τρόπο πρέπει να κοινοποιήσετε το αποτέλεσμα στον χρήστη.
Δοκιμαστική εφαρμογή πελάτη
Αν θέλετε να δείτε πώς λειτουργεί η ενσωμάτωση με μια εφαρμογή τρίτου κατασκευαστή, μπορείτε να κατεβάσετε το πακέτο-δείγμα για πελάτες, το οποίο περιλαμβάνει και τους πηγαίους κώδικες, οι οποίοι μπορούν να σας βοηθήσουν να κατανοήσετε πώς μπορεί να πραγματοποιηθεί η ενσωμάτωση στην πλατφόρμα Android.
Βιβλιοθήκη AIDL
Η βιβλιοθήκη AIDL εξασφαλίζει την επικοινωνία μεταξύ της δικής σας και της δικής μας εφαρμογής – πρέπει να την προσθέσετε στο έργο ανάπτυξης σας. Μπορείτε να βρείτε την πιο πρόσφατη έκδοση στην ενότητα «Λήψεις».
Η πορεία της συναλλαγής
Η διαδικασία της συναλλαγής είναι πολύ παρόμοια για όλους τους τύπους συναλλαγών και αποτελείται από τα βήματα που περιγράφονται παρακάτω. Για να κατανοήσετε τα αποτελέσματα πληρωμών που λαμβάνετε από την εφαρμογή GP, ανατρέξτε στο άρθρο „Κωδικοί επιστροφής“ σε αυτό το κεφάλαιο. Με απλά λόγια, η διαδικασία της συναλλαγής έχει ως εξής:
Προτού μπορέσετε να υποβάλετε οποιοδήποτε αίτημα στο GP, πρέπει να βεβαιωθείτε ότι ο χρήστης έχει συνδεθεί. Όλα τα αιτήματα διεκπεραιώνονται στη συνέχεια υπό το όνομα του συνδεδεμένου χρήστη.
ΝΕΟ Από την έκδοση 1.2.0 αυτού του API, μπορείτε να επαληθεύσετε την ταυτότητα του συνδεδεμένου χρήστη στέλνοντας την τιμή „clientID“. Για περισσότερες λεπτομέρειες και παραδείγματα χρήσης, ανατρέξτε στο αυτό άρθρου.
ΝΕΟ Για το Android 11, βεβαιωθείτε ότι έχετε ρυθμίσει την ορατότητα του πακέτου – διαβάστε περισσότερα εδώ. Διαφορετικά, η εφαρμογή δεν θα ανοίξει αυτόματα.
Δεσμευμένη υπηρεσία – bound service
Η συνδεδεμένη υπηρεσία είναι ένας διακομιστής σε περιβάλλον πελάτη-διακομιστή. Η συνδεδεμένη υπηρεσία επιτρέπει σε στοιχεία (όπως οι δραστηριότητες) να συνδεθούν με την υπηρεσία, να στέλνουν αιτήματα, να λαμβάνουν απαντήσεις και ακόμη και να πραγματοποιούν επικοινωνία μεταξύ διεργασιών (IPC). Μια συνδεδεμένη υπηρεσία συνήθως παραμένει ενεργή μόνο όταν εξυπηρετεί κάποιο άλλο στοιχείο της εφαρμογής και δεν εκτελείται στο παρασκήνιο για απεριόριστο χρονικό διάστημα. Για περισσότερες πληροφορίες σχετικά με τον τρόπο χρήσης των συνδεδεμένων υπηρεσιών, επισκεφθείτε την Πύλη Προγραμματιστών Android εδώ – Υπηρεσία Bound.