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
Im Abschnitt "Downloads" dieses Handbuchs können Sie die neuesten Anwendungspakete, Demoanwendungen und die AIDL-Bibliothek herunterladen. Ziel GP tom des Simulators ist es, die Notwendigkeit von Testkarten zu vermeiden und alle Zahlungsergebnisse zu simulieren, die in einer Produktionsumgebung auftreten können. Wir weisen darauf hin, dass API im Test und in der Produktion identisch ist.
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 Transaktionsablauf ist für alle Transaktionsarten sehr ähnlich und besteht aus den unten beschriebenen Schritten. Zum Verständnis der gesendeten Zahlungsergebnisse, die von der Anwendung empfangen werden können GP tom Anwendung empfangen werden können, lesen Sie bitte den Abschnitt "Return Codes" in diesem Kapitel. Vereinfacht ausgedrückt, sieht der Transaktionsablauf wie folgt 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.