Σας ευχαριστούμε που επιλέξατε το API μας για ενσωμάτωση! Στόχος αυτής της τεκμηρίωσης είναι να περιγράψει τον τρόπο με τον οποίο μπορείτε να συνδεθείτε με μια εφαρμογή πληρωμών που εκτελείται σε συσκευές Android και την εφαρμογή GP tom. Αυτό το API θα σας βοηθήσει να ενσωματώσετε εύκολα εφαρμογές που βασίζονται σε Android και έχουν αναπτυχθεί εσωτερικά. Πιστεύουμε ότι με τη χρήση του API μας θα ολοκληρώσετε σε χρόνο μηδέν.
Προετοιμάστε ό,τι χρειάζεστε
Μεταβείτε στην ενότητα "Λήψεις" αυτού του οδηγού για να κατεβάσετε τα πιο πρόσφατα πακέτα εφαρμογών, τις εφαρμογές επίδειξης και τη βιβλιοθήκη AIDL. Στόχος του προσομοιωτή GP tom είναι να αποφύγετε την ανάγκη για δοκιμαστικές κάρτες και να βοηθήσετε στην προσομοίωση όλων των περιπτώσεων αποτελεσμάτων πληρωμής που μπορεί να συναντήσετε σε ένα περιβάλλον παραγωγής. Σημειώνουμε ότι το API είναι πανομοιότυπο σε δοκιμή και παραγωγή.
Επί του παρόντος, μπορείτε να προσομοιώσετε την ακόλουθη συμπεριφορά στέλνοντας το ακριβές ποσό από την εφαρμογή σας:
Ποσό: 1111
ΚΆΡΤΑ ΠΏΛΗΣΗ ΕΠΙΤΥΧΊΑ ΑΠΟΔΕΚΤΉ
Η εφαρμογή σας λαμβάνει ένα επιτυχές αποτέλεσμα συναλλαγής και επεξεργάζεται τη συναλλαγή με επιτυχία από την πλευρά σας.
Ποσό: 1122
ΑΠΟΤΥΧΊΑ ΠΏΛΗΣΗΣ ΚΆΡΤΑΣ ΑΠΟΡΡΊΦΘΗΚΕ
Η εφαρμογή σας λαμβάνει ένα αποτέλεσμα απόρριψης συναλλαγής και επεξεργάζεται τη συναλλαγή με τον σωστό τρόπο από την πλευρά σας - δείχνοντας ότι η συναλλαγή απέτυχε.
Ποσό: 1123
TIMEOUT ΑΠΟΤΥΧΊΑΣ ΠΏΛΗΣΗΣ ΚΆΡΤΑΣ
Θα υπάρξει ένα χρονικό όριο πληρωμής από την πλευρά μας και η εφαρμογή σας πρέπει να εμφανίζει το αποτέλεσμα σε αυτό το πνεύμα.
Ποσό: 1124
ΕΞΑΊΡΕΣΗ ΑΠΟΤΥΧΊΑΣ ΠΏΛΗΣΗΣ ΚΆΡΤΑΣ
Προσομοιώνει μια κατάσταση όπου συμβαίνει μια εξαίρεση από την πλευρά μας - π.χ. μια τεχνική βλάβη. Με αυτόν τον τρόπο πρέπει να διαφημίσετε το αποτέλεσμα στον χρήστη.
Εφαρμογή πελάτη Demo
Αν θέλετε να δείτε πώς λειτουργεί η ενσωμάτωση με μια εφαρμογή τρίτου μέρους, μπορείτε να κατεβάσετε το πακέτο demo client, το οποίο περιλαμβάνει πηγαίο κώδικα που μπορεί να σας βοηθήσει να κατανοήσετε πώς μπορεί να γίνει η ενσωμάτωση στην πλατφόρμα Android.
Βιβλιοθήκη AIDL
Η βιβλιοθήκη AIDL χειρίζεται την επικοινωνία μεταξύ της εφαρμογής σας και της δικής μας - πρέπει να την προσθέσετε στο έργο ανάπτυξής σας. Την τελευταία έκδοση μπορείτε να βρείτε στην ενότητα download.
Πρόοδος συναλλαγής
Η ροή της συναλλαγής είναι πολύ παρόμοια για όλους τους τύπους συναλλαγών και αποτελείται από τα βήματα που περιγράφονται παρακάτω. Για να κατανοήσετε τα αποτελέσματα των ταχυδρομικών πληρωμών που μπορούν να ληφθούν από την εφαρμογή GP tom, ανατρέξτε στο άρθρο "Κωδικοί επιστροφής" σε αυτήν την ενότητα. Με απλουστευμένους όρους, η ροή της συναλλαγής μοιάζει ως εξής:
Πριν μπορέσετε να πραγματοποιήσετε οποιαδήποτε κλήση στο GP tom οποιοδήποτε αίτημα, πρέπει να βεβαιωθείτε ότι ο χρήστης είναι συνδεδεμένος. Στη συνέχεια, όλα τα αιτήματα διεκπεραιώνονται υπό τον συνδεδεμένο χρήστη.
ΝΕΟ Από την έκδοση 1.2.0 αυτού του API, μπορείτε να ελέγξετε την ταυτότητα του συνδεδεμένου χρήστη στέλνοντας την τιμή "clientID". Ανατρέξτε σε αυτό το άρθρο για περισσότερες λεπτομέρειες και περιπτώσεις χρήσης.
ΝΕΟ Για το Android 11, βεβαιωθείτε ότι το πακέτο σας είναι ορατό - διαβάστε περισσότερα εδώ. Διαφορετικά, η εφαρμογή δεν θα ανοίξει αυτόματα.
Υπηρεσία δέσμευσης - δεσμευμένη υπηρεσία
Η δεσμευμένη υπηρεσία είναι ένας διακομιστής στη διεπαφή πελάτη-διακομιστή. Μια δεσμευμένη υπηρεσία επιτρέπει σε στοιχεία (όπως οι δραστηριότητες) να συνδέονται με μια υπηρεσία, να στέλνουν αιτήματα, να λαμβάνουν απαντήσεις και ακόμη και να εκτελούν επικοινωνία μεταξύ διεργασιών (IPC). Μια δεσμευμένη υπηρεσία παραμένει συνήθως μόνο όταν εξυπηρετεί ένα άλλο συστατικό της εφαρμογής και δεν εκτελείται στο παρασκήνιο για αόριστο χρονικό διάστημα. Για περισσότερες πληροφορίες σχετικά με τον τρόπο εργασίας με δεσμευμένες υπηρεσίες, επισκεφθείτε την Πύλη προγραμματιστών Android εδώ - Bound Service.