Vielen Dank, dass Sie sich für unsere API! Das Ziel dieser Dokumentation besteht darin, zu beschreiben, wie Sie eine Verbindung zu einer Zahlungs-App herstellen können, die auf Android-Geräten und -Apps ausgeführt wird. GP tom. Das API sollte Ihnen helfen, selbst entwickelte Android-basierte Apps einfach zu integrieren. Wir glauben, dass mit Hilfe unserer API Sie integrieren sich im Handumdrehen.
Bereiten Sie alles vor, was Sie brauchen
Gehen Sie zum Abschnitt "Downloads" dieses Handbuchs und laden Sie die neuesten Pakete mit der App, der Demo-App und der AIDL-Bibliothek herunter. Ziel GP tom Der Simulator soll die Notwendigkeit von Testkarten vermeiden und helfen, alle Zahlungsergebnisse zu simulieren, die in der Produktion auftreten können. Wir stellen fest, dass API ist im Test und in der Produktion identisch.
Wenn Sie derzeit einen genauen Betrag aus Ihrer Anwendung senden, können Sie das folgende Verhalten simulieren:
Betrag: 1111
ERFOLG DES KARTENVERKAUFS AKZEPTIERT
Ihr Antrag erhält ein erfolgreiches Ergebnis der Transaktion und verarbeitet die Transaktion auf Ihrer Seite erfolgreich.
Betrag: 1122
CARD SALE FAIL ABGELEHNT
Ihre Anwendung erhält ein negatives Transaktionsergebnis und Sie verarbeiten die Transaktion auf Ihrer Seite korrekt – Sie werden sehen, dass die Transaktion fehlgeschlagen ist.
Betrag: 1123
TIMEOUT FÜR DEN KARTENVERKAUF BEIM FAILOUT
Es wird eine Auszeit von der Zahlung von unserer Seite geben und in diesem Sinne muss Ihre Bewerbung das Ergebnis anzeigen.
Betrag: 1124
AUSNAHME "KARTENVERKAUF FEHLGESCHLAGEN"
Es simuliert eine Situation, in der eine Ausnahme unsererseits auftritt – z.B. ein technisches Versagen. Auf diese Weise müssen Sie das Ergebnis beim Benutzer bewerben.
Demo-Client-Anwendung
Wenn Sie sehen möchten, wie die Integration mit einer 3rd-Party-App funktioniert, können Sie ein Demo-Client-Paket herunterladen, das auch Quellcode enthält, der Ihnen helfen kann, zu verstehen, wie die Integration auf Android durchgeführt werden kann.
AIDL-Bibliothek
Die AIDL-Bibliothek stellt die Kommunikation zwischen Ihrer und unserer Anwendung sicher – Sie müssen sie Ihrem Entwicklungsprojekt hinzufügen. Die neueste Version finden Sie im Download-Bereich.
Transaktionsfortschritt
Der Verlauf der Transaktion ist für alle Arten von Transaktionen sehr ähnlich und besteht aus den unten beschriebenen Schritten. Um die Ergebnisse der gesendeten Zahlungen zu verstehen, die von GP tom Anwendung, siehe Artikel "Rücksendecodes" in diesem Kapitel. Einfach ausgedrückt sieht der Ablauf der Transaktion so aus:
Bevor Sie anrufen können GP tom Bei jeder Anfrage müssen Sie sicherstellen, dass der Benutzer angemeldet ist. Alle Anfragen werden dann unter dem angemeldeten Benutzer verarbeitet.
NACHRICHTEN Ab Version 1.2.0 dieses API Sie können die Identität des angemeldeten Benutzers überprüfen, indem Sie den Wert "clientID" senden. Weitere Informationen und Anwendungsfälle finden Sie in diesem Artikel.
NACHRICHTEN Für Android 11 achten Sie bitte auf die Sichtbarkeit des Pakets – lesen Sie hier mehr. Andernfalls wird die App nicht automatisch geöffnet.
Gebundener Dienst
Ein gebundener Dienst ist ein Server in einer Client-Server-Schnittstelle. Ein gebundener Dienst ermöglicht es Komponenten (z. B. Aktivitäten), an einen Dienst gebunden zu werden, Anforderungen zu senden, Antworten zu empfangen und sogar eine prozessübergreifende Kommunikation (Interprocess Communication, IPC) durchzuführen. In der Regel bleibt ein gebundener Dienst nur erhalten, wenn er eine andere Komponente der Anwendung bedient, und wird nicht unbegrenzt im Hintergrund ausgeführt. Weitere Informationen zum Arbeiten mit Bounding Services finden Sie im Android Developer Portal hier - Bound Service.