Vielen Dank, dass Sie unsere API für die Integration gewählt haben! Das Ziel dieser Dokumentation ist es, zu beschreiben, wie Sie eine Verbindung zu einer Zahlungs-App, die auf Android-Geräten läuft, und der GP tom-App herstellen können. Diese API soll Ihnen helfen, selbst entwickelte Android-basierte Apps einfach zu integrieren. Wir glauben, dass Sie mit unserer API die Integration in kürzester Zeit schaffen werden.
Bereiten Sie alles vor, was Sie brauchen
Im Abschnitt „Downloads“ dieses Leitfadens können Sie die neuesten Anwendungspakete, Demoanwendungen und die AIDL-Bibliothek herunterladen. Das Ziel des GP tom-Simulators ist es, die Notwendigkeit von Testkarten zu vermeiden und alle Fälle von Zahlungsergebnissen zu simulieren, die Sie in einer Produktionsumgebung antreffen können. Wir weisen darauf hin, dass die API in Test- und Produktionsumgebungen identisch ist.
Derzeit können Sie das folgende Verhalten simulieren, indem Sie den genauen Betrag von Ihrer App aus senden:
Betrag: 1111
KARTE VERKAUFSERFOLG AKZEPTIERT
Ihre Anwendung erhält ein erfolgreiches Transaktionsergebnis und verarbeitet die Transaktion erfolgreich auf Ihrer Seite.
Betrag: 1122
KARTENVERKAUF ABGELEHNT
Ihre Anwendung erhält eine Transaktionsablehnung und verarbeitet die Transaktion auf Ihrer Seite richtig - Sie sehen, dass die Transaktion fehlgeschlagen ist.
Betrag: 1123
ZEITÜBERSCHREITUNG BEIM KARTENVERKAUF
Es wird eine Zahlungsfrist auf unserer Seite geben und Ihre App muss das Ergebnis in diesem Sinne anzeigen.
Betrag: 1124
KARTE VERKAUF SCHEITERN AUSNAHME
Simuliert eine Bedingung, bei der auf unserer Seite eine Ausnahme auftritt - z. B. ein technisches Versagen. Auf diese Weise müssen Sie dem Benutzer das Ergebnis mitteilen.
Demo-Client-Anwendung
Wenn Sie sehen möchten, wie die Integration mit einer Anwendung eines Drittanbieters funktioniert, können Sie das Demo-Client-Paket herunterladen, das den Quellcode enthält, der Ihnen hilft zu verstehen, wie die Integration auf der Android-Plattform durchgeführt werden kann.
AIDL-Bibliothek
Die AIDL-Bibliothek übernimmt die Kommunikation zwischen Ihrer Anwendung und unserer - Sie müssen sie zu Ihrem Entwicklungsprojekt hinzufügen. Die neueste Version finden Sie im Download-Bereich.
Fortschritt der Transaktion
Der Transaktionsablauf ist für alle Transaktionsarten sehr ähnlich und besteht aus den unten beschriebenen Schritten. Zum Verständnis der versendeten Zahlungsergebnisse, die von der GP tom App empfangen werden können, lesen Sie bitte den Artikel „Return Codes“ in diesem Abschnitt. Vereinfacht ausgedrückt, sieht der Transaktionsablauf wie folgt aus:
Bevor Sie in GP tom eine Anfrage stellen können, müssen Sie sich vergewissern, dass der Benutzer angemeldet ist. Alle Anfragen werden dann unter dem angemeldeten Benutzer bearbeitet.
NEU Seit Version 1.2.0 dieser API können Sie die Identität des angemeldeten Benutzers überprüfen, indem Sie den Wert „clientID“ senden. Weitere Einzelheiten und Anwendungsfälle finden Sie unter Diese Artikel.
NEU Für Android 11 stellen Sie bitte sicher, dass das Paket sichtbar ist - mehr dazu hier. Andernfalls wird die Anwendung nicht automatisch geöffnet.
Gebundener Dienst - Gebundener Dienst
Der gebundene Dienst ist ein Server an der Client-Server-Schnittstelle. Ein gebundener Dienst ermöglicht es Komponenten (z. B. Aktivitäten), sich an einen Dienst zu binden, Anfragen zu senden, Antworten zu empfangen und sogar Interprozesskommunikation (IPC) durchzuführen. Ein gebundener Dienst bleibt in der Regel nur dann bestehen, wenn er eine andere Anwendungskomponente bedient und läuft nicht für unbestimmte Zeit im Hintergrund. Weitere Informationen über die Arbeit mit gebundenen Diensten finden Sie auf dem Android Developer Portal hier - Gebundener Dienst.