Girocheckout Java SDK
Das GiroCheckout SDK für Java ermöglicht die einfache Integration der GiroCheckout API in alle Arten von javabasierte Anwendungen. Das SDK umfasst alle Schnittstellen des GiroCheckout APIs der Girosolution AG zur Erzeugung von Requests und der Verarbeitung von Responses. Das SDK kümmert sich dabei um alle technischen Details, wie z.B. die Berechnung der Hash-Summen und die Thread-sichere Verarbeitung.
Ergänzend zu der vorliegenden Dokumentation stehen Ihnen unter http://api.girocheckout.de weiterführende Informationen zur Verfügung.
Beispiele und Einbindung
Voraussetzung für die Verwendung von GiroCheckout ist die Anlage eines Benutzerkontos und entsprechender Projekte unter https://www.girocockpit.de.Einbindung des Jar-Files
Fügen Sie zunächst das File girocheckout.jar
zum Build Path hinzu.
Referenz auf Ihr Händlerkonto und Ihr Projekt
Für alle Aufrufe des GiroCheckout APIs benötigen Sie eine Referenz auf Ihr Händlerkonto und das zu verwendende Projekt.
Merchant merchant = MerchantFactory.createMerchant(ihreHändlerID);
Project project = merchant.createProject(ihreProjektID, ihrProjektPasswort);
Requests und Responses
Beim Absetzen von Requests in Richtung GiroCheckout definieren Sie die zunächst die für die Transaktion benötigten Daten und erstellen dann auf dem Project Objekt
den entsprechenden Request.
Beispiel: Giropay Zahlung
GiropayTransactionRequest request = project.createGiropayTransactionRequest(null, merchantTxId, amount,
currency, purpose, shoppingCartType, shippingAddresseFirstName, shippingAddresseLastName,
shippingCompany, shippingAdditionalAddressInformation, shippingStreet, shippingStreetNumber,
shippingZipCode, shippingCity, shippingCountry, shippingEmail, merchantReconciliationReferenceNumber,
cart, deliveryType, urlRedirect, urlNotify);
Jeder Request besitzt eine execute
Methode, die das zugehörige Response Objekt zurückliefert.
Beispiel:
GiropayTransactionResponse response = request.execute();
System.out.println("redirect: [" + response.getRedirect() + "]");
System.out.println("reference: [" + response.getReference() + "]");
Fehlerhandling
Sofern bei der Kommunikation mit dem GiroCheckout API Probleme auftreten wird eine GiroCheckoutProtocolException
geworfen, die weitergehende Informationen
zum Fehler enthält. Darüber hinaus zeigt die GiroCheckoutException
interne Fehler an.
Eine Auflistung der Fehlernummern finden Sie hier
Ergniscodes / Zahlungsausgang
Das Ergebnis eines Zahlungsausgangs ist entweder in der notify/redirect URL oder bei direkten Zahlungen in der entsprechenden Response-Klasse enthalten. Der Code 4000 kennzeichnet dabei immer eine erfolgreiche Transaktion. Alle anderen Codes beschreiben, welcher Fehler aufgetreten ist. Eine Auflistung der Ergebniscodes finden Sie hier