Package com.girosolution.girocheckout
Interface Project
public interface Project
Interface, das ein Projekt eines Händlers bei Girosolution repräsentiert.
-
Method Summary
Modifier and TypeMethodDescriptioncreateBlueCodeRefundRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose)
BlueCode - Erstattung (REFUND)createBlueCodeTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String urlRedirect, String urlNotify, String kassenzeichen)
Initialisierung einer BlueCode Zahlung.createCreditCardCancelRequest(String merchantTxId, String reference)
Kreditkarte - StornierungcreateCreditCardCaptureRequest(String merchantTxId, Integer amount, String currency, String purpose, String reference, String kassenzeichen)
Kreditkarte - Buchung (CAPTURE)createCreditCardGetPKNRequest(String reference)
Pseudo-Kartennummer Informationen abfragencreateCreditCardRecurringTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, String pkn, Integer recurring, String urlNotify, String kassenzeichen)
Führt eine wiederkehrende Kreditkartenzahlung durchcreateCreditCardRefundRequest(String merchantTxId, Integer amount, String currency, String purpose, String reference, String kassenzeichen)
Kreditkarte - Erstattung (REFUND)createCreditCardSenderInfoRequest(String reference)
Abfrage von SenderinformationencreateCreditCardTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, String locale, Integer mobile, String pkn, Integer recurring, String urlRedirect, String urlNotify, String tds2Address, String tds2Postcode, String tds2City, String tds2Country, String tds2Optional, String kassenzeichen)
Initialisierung einer KreditkartenzahlungcreateDirectDebitCancelRequest(String merchantTxId, String reference)
Lastschrift - StornierungcreateDirectDebitCaptureRequest(String merchantTxId, Integer amount, String currency, String purpose, String reference, String kassenzeichen)
Lastschrift - Buchung (CAPTURE)createDirectDebitGetPKNRequest(String reference)
Pseudo-Kartennummer Informationen abfragencreateDirectDebitRefundRequest(String merchantTxId, Integer amount, String currency, String purpose, String reference, String kassenzeichen)
Lastschrift - Erstattung (REFUND)createDirectDebitSenderInfoRequest(String reference)
Abfrage von SenderinformationencreateDirectDebitTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, String bankcode, String bankaccount, String iban, String accountHolder, String mandateReference, String mandateSignedOn, String mandateReceiverName, Integer mandateSequence, String pkn, String urlNotify, String kassenzeichen)
Führt eine Lastschriftzahlung durchcreateDirectDebitTransactionWithPaymentPageRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, String locale, Integer mobile, String mandateReference, String mandateSignedOn, String mandateReceiverName, Integer mandateSequence, String pkn, String urlRedirect, String urlNotify, String kassenzeichen)
Initialisierung einer Lastschriftzahlung mit FormularservicecreateEpcCreateRequest(Integer amount, String currency, String purposetext, String paymentreference, String purposecode, String infotext, String receiverName, String receiverIban, String receiverBic, String format, Integer resolution)
Legt die übergebenen Zahldaten werden unter einer GiroCode Referenznummer ab und generiert einen QR Code.createEpcGetRequest(String girocodeReference, String format, Integer resolution)
Abfrage der zu einem GiroCode hinterlegten DatenPrüft ob die angegebene Bank am eps Verfahren teilnimmt.Gibt die Liste aller Banken, die am eps Verfahren teilnehmen, zurück.createEpsSenderInfoRequest(String reference)
Abfrage von SenderinformationencreateEpsTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String bic, String urlRedirect, String urlNotify, String kassenzeichen)
Initialisiert eine eps TransaktionPrüft ob die angegebene Bank am giropay-Verfahren teilnimmt.createGiropayIDCheckRequest(String merchantTxId, String bic, String iban, String info1Label, String info2Label, String info3Label, String info4Label, String info5Label, String info1Text, String info2Text, String info3Text, String info4Text, String info5Text, String urlRedirect, String urlNotify)
Führt eine giropay-Altersverifikation durch.Gibt die Liste aller Banken, die am giropay Verfahren teilnehmen, zurück.createGiropaySenderInfoRequest(String reference)
Abfrage von SenderinformationencreateGiropayTransactionRequest(String giropayMerchantId, String merchantTxId, Integer amount, String currency, String purpose, String shoppingCartType, String shippingAddresseFirstName, String shippingAddresseLastName, String shippingCompany, String shippingAdditionalAddressInformation, String shippingStreet, String shippingStreetNumber, String shippingZipCode, String shippingCity, String shippingCountry, String shippingEmail, String merchantOrderReferenceNumber, ShoppingCartItem[] cart, String deliveryType, String urlRedirect, String urlNotify, String kassenzeichen)
Führt eine Giropay-Bezahltransaktion durchcreateGiropayTransactionWithGiropayIDRequest(String merchantTxId, Integer amount, String currency, String purpose, String bic, String iban, String info1Label, String info2Label, String info3Label, String info4Label, String info5Label, String info1Text, String info2Text, String info3Text, String info4Text, String info5Text, String urlRedirect, String urlNotify)
Führt eine giropay Transaktion mit gleichzeitiger Altersverifiktation durchGibt die Liste aller Banken, die am IDEAL Verfahren teilnehmen, zurück.createIdealPaymentRefundRequest(String merchantTxId, Integer amount, String currency, String reference)
iDEAL - Erstattung (REFUND)createIdealPaymentRequest(String merchantTxId, Integer amount, String currency, String purpose, String issuer, String urlRedirect, String urlNotify, String kassenzeichen)
Initialisiert eine IDEAL ZahlungcreateIdealSenderInfoRequest(String reference)
Abfrage von SenderinformationencreateMaestroCaptureRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose, String kassenzeichen)
Maestro - Buchung (CAPTURE)createMaestroRefundRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose, String kassenzeichen)
Maestro - Erstattung (REFUND)createMaestroTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, String locale, Integer mobile, String urlRedirect, String urlNotify, String kassenzeichen)
Initialisierung einer Zahlung mit der Maestro-KartecreatePaydirektCancelRequest(String merchantTxId, String reference)
Paydirekt Zahlung - StornierungcreatePaydirektCaptureRequest(String merchantTxId, Integer amount, String currency, String purpose, String reference, String merchantReconciliationReferenceNumber, Boolean finalCapture, String kassenzeichen)
Paydirekt Zahlung - Buchen (CAPTURE)createPaydirektRefundRequest(String merchantTxId, Integer amount, String currency, String purpose, String reference, String merchantReconciliationReferenceNumber)
Paydirekt Zahlung - Erstattung (REFUND)createPaydirektTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, Integer securedAuth, String securedAuthUntil, String shoppingCartType, String customerId, Integer shippingAmount, String shippingAddresseFirstName, String shippingAddresseLastName, String shippingCompany, String shippingAdditionalAddressInformation, String shippingStreet, String shippingStreetNumber, String shippingZipCode, String shippingCity, String shippingCountry, String shippingEmail, String merchantReconciliationReferenceNumber, Integer orderAmount, String orderId, ShoppingCartItem[] cart, String invoiceId, String customerMail, Integer minimumAge, String urlRedirect, String urlNotify, String kassenzeichen)
Initialisierung einer Paydirekt Zahlung.createPaymentPageCaptureRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose, String txreference)
PaymentPage - Buchung (CAPTURE)Gibt die Liste aller Projekte, die bei der Payment- oder Spenden-Page verwendet werden, zurück.createPaymentPageRefundRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose, String txreference)
PaymentPage - Erstattung (REFUND)createPaymentPageRequest(String merchantTxId, Integer amount, String currency, String purpose, String description, Integer pagetype, String expirydate, Integer single, Integer timeout, String txType, String locale, String paymethods, String payprojects, String organization, Integer freeamount, String fixedvalues, Integer minamount, Integer maxamount, String orderid, String projectlist, String pkn, Integer test, Integer certdata, String otherpayments, String paydirektShoppingCartType, String paydirektShippingFirstName, String paydirektShippingLastName, String paydirektShippingCompany, String paydirektShippingAdditionalAddressInformation, String paydirektShippingStreet, String paydirektShippingStreetNumber, String paydirektShippingZipCode, String paydirektShippingCity, String paydirektShippingCountry, String paydirektShippingEmail, String paydirektMerchantReconciliationReferenceNumber, ShoppingCartItem[] paydirektCart, String paydirektDeliveryType, String successUrl, String backUrl, String failUrl, String notifyUrl, String tds2Address, String tds2Postcode, String tds2City, String tds2Country, String tds2Optional, String mandateReference, String mandateSignedOn, String mandateReceiverName, Integer mandateSequence, String informationText, String kassenzeichen, Integer qrcodeReturn)
Initialisierung einer Payment Page Zahlung.createPaypalCaptureRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose, String kassenzeichen)
Paypal - Buchung (CAPTURE)createPaypalRefundRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose)
Paypal - Erstattung (REFUND)createPaypalTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, String urlRedirect, String urlNotify, String kassenzeichen)
Initialisierung einer PayPal ZahlungcreateShoppingCartItem(String name, String ean, BigDecimal quantity, Integer grossAmount)
Warenkorb-ElementcreateSofortUwTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String bic, String urlRedirect, String urlNotify)
Initialisierung einer SOFORT Zahlung.createToolsGetTransactionRequest(String reference)
Abfrage von TransaktionsinformationenKalkuliert den Hashwert für den angegebenen Stringvoid
Die Verbindung wird über den angegebenen Proxy aufgebaut
-
Method Details
-
createEpsBankstatusRequest
Prüft ob die angegebene Bank am eps Verfahren teilnimmt.- Parameters:
bic
- - BIC der Käuferbank (8 oder 11-stellig), die geprüft werden soll- Returns:
- EpsBankstatusRequest
-
createEpsTransactionRequest
EpsTransactionRequest createEpsTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String bic, String urlRedirect, String urlNotify, String kassenzeichen)Initialisiert eine eps Transaktion- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, z.B. EUR = Europurpose
- - Verwendungszweck der eps Überweisungbic
- - BIC der Käuferbank (8 oder 11-stellig)urlRedirect
- - URL, an die der Kunde nach der Zahlung geschickt werden sollurlNotify
- - URL, an die der Zahlungsausgang gemeldet werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- EpsTransactionRequest
-
createEpsIssuerListRequest
EpsIssuerListRequest createEpsIssuerListRequest()Gibt die Liste aller Banken, die am eps Verfahren teilnehmen, zurück.- Returns:
- EpsIssuerListRequest
-
createGiropayBankstatusRequest
Prüft ob die angegebene Bank am giropay-Verfahren teilnimmt.- Parameters:
bic
- - BIC der Käuferbank (8 oder 11-stellig), die geprüft werden soll- Returns:
- GiropayBankstatusRequest
-
createGiropayIssuerListRequest
GiropayIssuerListRequest createGiropayIssuerListRequest()Gibt die Liste aller Banken, die am giropay Verfahren teilnehmen, zurück.- Returns:
- GiropayIssuerListRequest
-
createGiropayIDCheckRequest
GiropayIDCheckRequest createGiropayIDCheckRequest(String merchantTxId, String bic, String iban, String info1Label, String info2Label, String info3Label, String info4Label, String info5Label, String info1Text, String info2Text, String info3Text, String info4Text, String info5Text, String urlRedirect, String urlNotify)Führt eine giropay-Altersverifikation durch.- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersbic
- - BIC der Käuferbank (8 oder 11-stellig)iban
- - IBAN der Kundenbankverbindung ohne Leerzeicheninfo1Label
- - Bezeichnung 1 / zusätzliche Information für die giropay Überweisungsseiteninfo2Label
- - Bezeichnung 2 / zusätzliche Information für die giropay Überweisungsseiteninfo3Label
- - Bezeichnung 3 / zusätzliche Information für die giropay Überweisungsseiteninfo4Label
- - Bezeichnung 4 / zusätzliche Information für die giropay Überweisungsseiteninfo5Label
- - Bezeichnung 5 / zusätzliche Information für die giropay Überweisungsseiteninfo1Text
- - Text 1 / zusätzliche Information für die giropay Überweisungsseiteninfo2Text
- - Text 2 / zusätzliche Information für die giropay Überweisungsseiteninfo3Text
- - Text 3 / zusätzliche Information für die giropay Überweisungsseiteninfo4Text
- - Text 4 / zusätzliche Information für die giropay Überweisungsseiteninfo5Text
- - Text 5 / zusätzliche Information für die giropay ÜberweisungsseitenurlRedirect
- - URL, an die der Kunde nach der Zahlung geschickt werden soll.urlNotify
- - URL, an die der Zahlungsausgang gemeldet werden soll- Returns:
- GiropayIDCheckRequest
-
createGiropayTransactionRequest
GiropayTransactionRequest createGiropayTransactionRequest(String giropayMerchantId, String merchantTxId, Integer amount, String currency, String purpose, String shoppingCartType, String shippingAddresseFirstName, String shippingAddresseLastName, String shippingCompany, String shippingAdditionalAddressInformation, String shippingStreet, String shippingStreetNumber, String shippingZipCode, String shippingCity, String shippingCountry, String shippingEmail, String merchantOrderReferenceNumber, ShoppingCartItem[] cart, String deliveryType, String urlRedirect, String urlNotify, String kassenzeichen)Führt eine Giropay-Bezahltransaktion durch- Parameters:
giropayMerchantId
- - Giropay merchant IDmerchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, z.B. EUR = Europurpose
- - Verwendungszweck der giropay Überweisung (27 Zeichen)shoppingCartType
- - Typ des WarenkorbsshippingAddresseFirstName
- Vorname des AddressatenshippingAddresseLastName
- Nachname des AddressatenshippingCompany
- FirmennameshippingAdditionalAddressInformation
- AddresszusatzshippingStreet
- Straße des AddressatenshippingStreetNumber
- Hausnummer des AddressatenshippingZipCode
- PLZ des AddressatenshippingCity
- Ort des AddressatenshippingCountry
- Ländercode (ISO 3166-1)shippingEmail
- Email-Adresse des Käufers. Dies ist Pflicht bei digitalen Warenkörben (DIGITAL), bei allen anderen optional.merchantOrderReferenceNumber
- Zusatzinformation für die Zahlungszuordnung, die im Verwendungszweck angezeigt wird (nur bei type=SALE)cart
- Alle Elemente des WarenkorbsdeliveryType
- Typ des Versands.urlRedirect
- - URL, an die der Kunde nach der Zahlung geschickt werden soll.urlNotify
- - URL, an die der Zahlungsausgang gemeldet werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- GiropayTransactionRequest
-
createGiropayTransactionWithGiropayIDRequest
GiropayTransactionWithGiropayIDRequest createGiropayTransactionWithGiropayIDRequest(String merchantTxId, Integer amount, String currency, String purpose, String bic, String iban, String info1Label, String info2Label, String info3Label, String info4Label, String info5Label, String info1Text, String info2Text, String info3Text, String info4Text, String info5Text, String urlRedirect, String urlNotify)Führt eine giropay Transaktion mit gleichzeitiger Altersverifiktation durch- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, z.B. EUR = Europurpose
- - Verwendungszweck der giropay Überweisung (27 Zeichen)bic
- - BIC der Käuferbank (8 oder 11-stellig)iban
- - IBAN der Kundenbankverbindung ohne Leerzeicheninfo1Label
- - Bezeichnung 1 / zusätzliche Information für die giropay Überweisungsseiteninfo2Label
- - Bezeichnung 2 / zusätzliche Information für die giropay Überweisungsseiteninfo3Label
- - Bezeichnung 3 / zusätzliche Information für die giropay Überweisungsseiteninfo4Label
- - Bezeichnung 4 / zusätzliche Information für die giropay Überweisungsseiteninfo5Label
- - Bezeichnung 5 / zusätzliche Information für die giropay Überweisungsseiteninfo1Text
- - Text 1 / zusätzliche Information für die giropay Überweisungsseiteninfo2Text
- - Text 2 / zusätzliche Information für die giropay Überweisungsseiteninfo3Text
- - Text 3 / zusätzliche Information für die giropay Überweisungsseiteninfo4Text
- - Text 4 / zusätzliche Information für die giropay Überweisungsseiteninfo5Text
- - Text 5 / zusätzliche Information für die giropay ÜberweisungsseitenurlRedirect
- - URL, an die der Kunde nach der Zahlung geschickt werden soll.urlNotify
- - URL, an die der Zahlungsausgang gemeldet werden soll- Returns:
- GiropayTransactionWithGiropayIDRequest
-
createIdealIssuerListRequest
IdealIssuerListRequest createIdealIssuerListRequest()Gibt die Liste aller Banken, die am IDEAL Verfahren teilnehmen, zurück.- Returns:
- IdealIssuerListRequest
-
createIdealPaymentRequest
IdealPaymentRequest createIdealPaymentRequest(String merchantTxId, Integer amount, String currency, String purpose, String issuer, String urlRedirect, String urlNotify, String kassenzeichen)Initialisiert eine IDEAL Zahlung- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Betrag in Centcurrency
- - Währung der Transaktion, EUR = Euro (default)purpose
- - Verwendungszweck der iDEAL Überweisung (27 Zeichen)issuer
- - IDEAL Issuer BankurlRedirect
- - URL, an die der Kunde nach der Zahlung geschickt werden soll.urlNotify
- - URL, an die der Zahlungsausgang gemeldet werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- IdealPaymentRequest
-
createIdealPaymentRefundRequest
IdealPaymentRefundRequest createIdealPaymentRefundRequest(String merchantTxId, Integer amount, String currency, String reference)iDEAL - Erstattung (REFUND)- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Euroreference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll- Returns:
- IdealPaymentRefundRequest
-
createCreditCardTransactionRequest
CreditCardTransactionRequest createCreditCardTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, String locale, Integer mobile, String pkn, Integer recurring, String urlRedirect, String urlNotify, String tds2Address, String tds2Postcode, String tds2City, String tds2Country, String tds2Optional, String kassenzeichen)Initialisierung einer Kreditkartenzahlung- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, z.B. EUR = Europurpose
- - Verwendungszweck der Kreditkartenransaktion. Diese Information erscheint auf der Kreditkartenabrechnung.type
- - Transaktionsartlocale
- - Sprache des Kreditkartenformulars, z.B. de = deutschmobile
- - Bezahlseite für mobile Browser optimiertpkn
- - Das Feld dient dazu eine erneute Transaktion, ohne erneute Eingabe der Kreditkartendaten, zu starten. create = neue Pseudo-Kartennummer für die verwendete Kreditkarte generieren.
[Pseudo-Kartennummer] = Kartennumer der zu verwendenden Kreditkarterecurring
- - wiederkehrende ZahlungurlRedirect
- - URL, an die der Kunde nach der Zahlung geschickt werden soll.urlNotify
- - URL, an die der Zahlungsausgang gemeldet werden solltds2Address
- - Für 3D Secure 2.0: Hauptadresszeile (i.d.R. Straße+Hausnummer) der Rechnungsadresse des Karteninhabers, Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50. Wenn angegeben, müssen auch die restlichen tds2-Felder angegeben werden, außer tds2Optional.tds2Postcode
- - Für 3D Secure 2.0: Postleitzahl der Rechnungsadresse des Karteninhabers, Format A-Z, a-z, 0-9, Blank, [-], max. 11. Wenn angegeben, müssen auch die restlichen tds2-Felder angegeben werden, außer tds2Optional.tds2City
- - Für 3D Secure 2.0: Ort der Rechnungsadresse des Karteninhabers, Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50. Wenn angegeben, müssen auch die restlichen tds2-Felder angegeben werden, außer tds2Optional.tds2Country
- - Für 3D Secure 2.0: Land der Rechnungsadresse des Karteninhabers, Format A-Z, max. 2. Zweibuchstabiges Länderkürzel nach dem aktuell gültigen Standard ISO 3166. Wenn angegeben, müssen auch die restlichen tds2-Felder angegeben werden, außer tds2Optional.tds2Optional
- - Für 3D Secure 2.0: JSON-String, der weitere optionale Felder enthält. Eine genaue Auflistung der Felder ist unter dieser Tabelle unter 3D Secure 2.0 Optionale Felder (tds2Optional) zu findenkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- CreditCardTransactionRequest
-
createCreditCardGetPKNRequest
Pseudo-Kartennummer Informationen abfragen- Parameters:
reference
- - Eindeutige GiroCheckout Transaktions-ID- Returns:
- CreditCardGetPKNRequest
-
createCreditCardRecurringTransactionRequest
CreditCardRecurringTransactionRequest createCreditCardRecurringTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, String pkn, Integer recurring, String urlNotify, String kassenzeichen)Führt eine wiederkehrende Kreditkartenzahlung durch- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Betrag in Centcurrency
- - Währung der Transaktion als Währungscode gemäß ISO 4217, z.B. EUR = Europurpose
- - Verwendungszweck der Transaktion. Diese Information erscheint auf der Kreditkartenabrechnung.type
- - Transaktionsartpkn
- - Pseudo-Kartennummer einer Kreditkarte, mit der die Transaktion durchgeführt werden soll.recurring
- - Definiert, ob es sich um eine wiederkehrende Kreditkartenzahlung handelt.urlNotify
- - URL, an die der Zahlungsausgang gemeldet werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- CreditCardRecurringTransactionRequest
-
createCreditCardCaptureRequest
CreditCardCaptureRequest createCreditCardCaptureRequest(String merchantTxId, Integer amount, String currency, String purpose, String reference, String kassenzeichen)Kreditkarte - Buchung (CAPTURE)- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Europurpose
- - Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.reference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- CreditCardCaptureRequest
-
createCreditCardRefundRequest
CreditCardRefundRequest createCreditCardRefundRequest(String merchantTxId, Integer amount, String currency, String purpose, String reference, String kassenzeichen)Kreditkarte - Erstattung (REFUND)- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Europurpose
- - Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.reference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- CreditCardRefundRequest
-
createCreditCardCancelRequest
Kreditkarte - Stornierung- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Euroreference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll- Returns:
- CreditCardCancelRequest
-
createDirectDebitTransactionRequest
DirectDebitTransactionRequest createDirectDebitTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, String bankcode, String bankaccount, String iban, String accountHolder, String mandateReference, String mandateSignedOn, String mandateReceiverName, Integer mandateSequence, String pkn, String urlNotify, String kassenzeichen)Führt eine Lastschriftzahlung durch- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, z.B. EUR = Europurpose
- - Verwendungszweck der Lastschrift Transaktion. Diese Information erscheint auf dem Kontoauszug.type
- - Transaktionsartbankcode
- - Bankleitzahl. Plicht, wenn keine IBAN angegeben ist.bankaccount
- - Kontonummer. Plicht, wenn keine IBAN angegeben ist.iban
- - IBAN-Nummer des Käufers ohne LeerzeichenaccountHolder
- - KontoinhabermandateReference
- - Mandatsreferenz. Wird keine angegeben, wird eine eindeutige Mandatsreferenz generiert. Die Manadatsreferenz ist in der Antwort enthalten.mandateSignedOn
- - Datum im Format JJJJ-MM-TT, wann das SEPA-Lastschriftmandat erteilt wurde. Wenn kein Datum angegeben wird, wird das aktuelle Datum verwendet.mandateReceiverName
- - Name des Empfängers, der im SEPA Mandat verwendet wurde. Falls nichts angegeben, wird der in den Stammdaten hinterlegte Firmenname verwendet.mandateSequence
- - Sequenztyp der SEPA-Lastschrift. Falls nichts angegeben, wird eine Einmalzahlung angenommen.pkn
- - Das Feld dient dazu eine erneute Transaktion, ohne erneute Eingabe der Bankverbindung, zu starten.urlNotify
- - URL, an die der Zahlungsausgang gemeldet werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- DirectDebitTransactionRequest
-
createDirectDebitTransactionWithPaymentPageRequest
DirectDebitTransactionWithPaymentPageRequest createDirectDebitTransactionWithPaymentPageRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, String locale, Integer mobile, String mandateReference, String mandateSignedOn, String mandateReceiverName, Integer mandateSequence, String pkn, String urlRedirect, String urlNotify, String kassenzeichen)Initialisierung einer Lastschriftzahlung mit Formularservice- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, z.B. EUR = Europurpose
- - Verwendungszweck der Lastschrift Transaktion. Diese Information erscheint auf dem Kontoauszug.type
- - Transaktionsartlocale
- - Sprache des Lastschriftformulars, z.B. de = deutschmobile
- - Definiert, ob das Formular für Smartphones und mobile Browser optimiert angezeigt werden soll.mandateReference
- - Mandatsreferenz. Wird keine angegeben, wird eine eindeutige Mandatsreferenz generiert. Die Manadatsreferenz ist in der Antwort enthalten.mandateSignedOn
- - Datum im Format JJJJ-MM-TT, wann das SEPA-Lastschriftmandat erteilt wurde. Wenn kein Datum angegeben wird, wird das aktuelle Datum verwendet.mandateReceiverName
- - Name des Empfängers, der im SEPA Mandat verwendet wurde. Falls nichts angegeben, wird der in den Stammdaten hinterlegte Firmenname verwendet.mandateSequence
- - Sequenztyp der SEPA-Lastschrift. Falls nichts angegeben, wird eine Einmalzahlung angenommen.pkn
- - Das Feld dient dazu eine erneute Transaktion, ohne erneute Eingabe der Bankverbindung, zu starten.urlRedirect
- - URL, an die der Kunde nach der Zahlung geschickt werden soll.urlNotify
- - URL, an die der Zahlungsausgang gemeldet werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- DirectDebitTransactionWithPaymentPageRequest
-
createDirectDebitCaptureRequest
DirectDebitCaptureRequest createDirectDebitCaptureRequest(String merchantTxId, Integer amount, String currency, String purpose, String reference, String kassenzeichen)Lastschrift - Buchung (CAPTURE)- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Europurpose
- - Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.reference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- DirectDebitCaptureRequest
-
createDirectDebitRefundRequest
DirectDebitRefundRequest createDirectDebitRefundRequest(String merchantTxId, Integer amount, String currency, String purpose, String reference, String kassenzeichen)Lastschrift - Erstattung (REFUND)- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Europurpose
- - Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.reference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- DirectDebitRefundRequest
-
createDirectDebitCancelRequest
Lastschrift - Stornierung- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersreference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll- Returns:
- DirectDebitCancelRequest
-
createPaypalTransactionRequest
PaypalTransactionRequest createPaypalTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, String urlRedirect, String urlNotify, String kassenzeichen)Initialisierung einer PayPal Zahlung- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Betrag in Centcurrency
- - Währung der Transaktion EUR = Europurpose
- - Verwendungszweck der PayPal Transaktiontype
- - TransaktionsarturlRedirect
- - URL, an die der Kunde nach der Zahlung geschickt werden soll.urlNotify
- - URL, an die der Zahlungsausgang gemeldet werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- PaypalTransactionRequest
-
createToolsGetTransactionRequest
Abfrage von Transaktionsinformationen- Parameters:
reference
- - eindeutige GiroCheckout Transaktions-ID- Returns:
- ToolsGetTransactionRequest
-
createGiropaySenderInfoRequest
Abfrage von Senderinformationen- Parameters:
reference
- - eindeutige GiroCheckout Transaktions-ID- Returns:
- GiropaySenderInfoRequest
-
createEpcGetRequest
Abfrage der zu einem GiroCode hinterlegten Daten- Parameters:
girocodeReference
- - eindeutige GiroCode Referenznummerformat
- - Format des GiroCode Grafik in der Antwort. Werte: epc-qr, epc-qr-optimizied, noneresolution
- - Auflösung in Pixel (z.B. 250), wenn der GiroCode als Grafik angefordert wird. Maximal 500- Returns:
- EpcGetRequest
-
createEpcCreateRequest
EpcCreateRequest createEpcCreateRequest(Integer amount, String currency, String purposetext, String paymentreference, String purposecode, String infotext, String receiverName, String receiverIban, String receiverBic, String format, Integer resolution)Legt die übergebenen Zahldaten werden unter einer GiroCode Referenznummer ab und generiert einen QR Code.- Parameters:
amount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent Maximal 99999999999 (999.999.999,99)currency
- - Währung der Transaktion, z.B. EUR = Europurposetext
- - Verwendungszweck für die Zahlung, wenn keine Zahlungsreferenz angegeben ist. Zulässige Zeichen: SEPA Zeichensatzpaymentreference
- - Zahlungsreferenz, wenn kein Verwendungszweck angegeben istpurposecode
- - Textschlüssel für die SEPA Überweisung (SEPA Category Purpose Code)infotext
- - Informationstext für den ZahlendenreceiverName
- - Kontoinhaber des Empfängerkontos, Zulässige Zeichen: SEPA ZeichensatzreceiverIban
- - IBAN des EmpfängerkontosreceiverBic
- - BIC des Empfängerkontosformat
- - Format des GiroCode Grafik in der Antwort. Werte: epc-qr, epc-qr-optimizied, noneresolution
- - Auflösung in Pixel (z.B. 250), wenn der GiroCode als Grafik angefordert wird. Maximal 500- Returns:
- EpcCreateRequest
-
createSofortUwTransactionRequest
SofortUwTransactionRequest createSofortUwTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String bic, String urlRedirect, String urlNotify)Initialisierung einer SOFORT Zahlung.- Parameters:
merchantTxId
- Eindeutige Transaktions-ID des Händlersamount
- Betrag in Cent Wenn kind = 2, dann als Betrag 0 angebencurrency
- Währung der Transaktion EUR = Euro (default)purpose
- Verwendungszweck der SOFORT Überweisungbic
- BIC der Käuferbank (8 oder 11-stellig)urlRedirect
- URL, an die der Kunde nach der Zahlung geschickt werden soll.urlNotify
- URL, an die der Zahlungsausgang gemeldet werden soll.- Returns:
- SofortUwTransactionRequest
-
createPaymentPageRequest
PaymentPageRequest createPaymentPageRequest(String merchantTxId, Integer amount, String currency, String purpose, String description, Integer pagetype, String expirydate, Integer single, Integer timeout, String txType, String locale, String paymethods, String payprojects, String organization, Integer freeamount, String fixedvalues, Integer minamount, Integer maxamount, String orderid, String projectlist, String pkn, Integer test, Integer certdata, String otherpayments, String paydirektShoppingCartType, String paydirektShippingFirstName, String paydirektShippingLastName, String paydirektShippingCompany, String paydirektShippingAdditionalAddressInformation, String paydirektShippingStreet, String paydirektShippingStreetNumber, String paydirektShippingZipCode, String paydirektShippingCity, String paydirektShippingCountry, String paydirektShippingEmail, String paydirektMerchantReconciliationReferenceNumber, ShoppingCartItem[] paydirektCart, String paydirektDeliveryType, String successUrl, String backUrl, String failUrl, String notifyUrl, String tds2Address, String tds2Postcode, String tds2City, String tds2Country, String tds2Optional, String mandateReference, String mandateSignedOn, String mandateReceiverName, Integer mandateSequence, String informationText, String kassenzeichen, Integer qrcodeReturn)Initialisierung einer Payment Page Zahlung.- Parameters:
merchantTxId
- Eindeutige Transaktions-ID des Händlers.amount
- Betrag in Cent Wenn kind = 2, dann als Betrag 0 angeben.currency
- Währung der Transaktion EUR = Euro (default).purpose
- Verwendungszweck - es sind nur SEPA-konforme Zeichen zulässig.description
- Beschreibung für die Bezahlung, wird nur auf der Payment Page angezeigt.pagetype
- Typ der zu erzeugenden Bezahlseite: 0=normale API-Paypage (kompatibel zu früheren Paypages, Defaultwert), 1=Bezahlseite, 2=Spendenseiteexpirydate
- Verfallsdatum: Leer=Bezahlseite ist immer gültig, 'once'=Bezahlseite kann nur für eine erfolgreiche Bezahlung genutzt werden, danach ungültig, JJJJ-MM-TT=Datumsangabe im Format Jahr-Monat-Tag, bis zu diesem Datum ist die Bezahlseite gültig.single
- Erlaubt nur einen einzigen Bezahlversuch für diesen Payment-Link, egal ob erfolgreich oder nicht. 0 = single-Modus inaktiv (default), 1 = single-Modus aktivtimeout
- (Verfügbar ab API 2.1.33) Erlaubt die Angabe eines Timeouts für die Auswahl einer Zahlungsart auf der Payment Page. Der Timeout wird in Sekunden angegeben und wird aktiv, sobald die Seite angezeigt wird. Er wird dort angezeigt und bei Ablauf wird auf eine Fehlermeldung weitergeleitet. Neu Laden der Seite startet den Timeout NICHT neu, nur ein Löschen der Cookies hätte diesen Effekt. Wurde die Payment Page mit Parameter single=1 intialisiert, führt ein Ablauf des Timeouts dazu, dass der Link invalidiert wird. Für bestimmte Zahlungsarten (Lastschrift, Paypal, Kreditkarte) wird der Timeout ausgesetzt, sobald die Kachel der Zahlungsart aktiviert wird. Im Hintergrund läuft er aber weiter und greift wieder, sobald eine andere Zahlungsart gewählt wird. Für die genannten 3 Zahlungsarten gibt es separate Timeouts, die für jede Zahlungsart im GiroCockpit konfiguriert werden können (nur durch administrative Mitarbeiter der GS).txType
- Transaktionsart - SALE (default) oder AUTH. Bei SALE Transaktionen wird der Verkauf sofort gebucht, bei AUTH erfolgt - sofern bei der Zahlungsart verfügbar - eine Reservierung des Betrags.locale
- Sprache der Payment Page (aktuell wird nur de unterstützt).paymethods
- Einschränkung welche Zahlenarten angezeigt werden sollen. Wird nichts angegeben erscheinen alle beim Händler unterstützten Zahlarten zur Auswahl.payprojects
- Kommaseparierte Liste der Projekt-IDs, deren zugehörige Zahlungsarten in der Payment Page verfügbar sein sollen. Wird hier nichts angegeben, werden alle Projekte des Händlers berücksichtigt. Die Projekt-Ids können entweder manuell im GiroCockpit oder über Aufruf der Funktion Projektabfrage ermittelt werden.organization
- Name des Anbieters der Bezahl- oder Spendenseite. Wenn nicht angegeben, wird der Name aus dem GiroCockpit verwendet.freeamount
- Gibt an, ob der Anwender einen freien Betrag eingeben darf (=1) oder nicht (=0, Defaultwert).fixedvalues
- JSON-codierter String, der einen Array der zur Auswahl stehenden Beträge enthält. z.B. '[„10000“,“20000“,“50050“]', alle Beträge sind in Cent anzugeben. Ist dieses Feld leer, wird der Inhalt des Amount-Feldes als einziger fester Wert verwendet. Enthält dieses Feld Werte, wird der Betrag im Feld Amount ignoriert!.minamount
- Mindestwert, wenn ein freier Betrag eingegeben werden darf, also freeamount=1 ist. Fehlt dieser Wert, ist der Default 1,00.maxamount
- Maximalwert, wenn ein freier Betrag eingegeben werden darf, also freeamount=1 ist.orderid
- Wird nur bei Zahlungsart Paydirekt verwendet, wenn leer wird die orderid aus dem Purpose erzeugt. Es sind nur SEPA-konforme Zeichen zulässig (s. SEPA-konforme Zeichen).projectlist
- JSON-codierter String, der einen Array der Projekte enthält (Strings=Projektnamen), für die auf dieser Spendenseite gespendet werden kann. Macht nur Sinn, wenn pagetype=2.pkn
- Das Feld dient dazu eine erneute Transaktion, ohne erneute Eingabe der Kreditkarten- oder Lastschriftdaten, zu starten. create = neue Pseudo-Kartennummer für die verwendete Kreditkarte/Kontoverbindung generieren.test
- 1 = Zahlarten im Test-Modus werden angezeigt 0 = Zahlarten im LIVE-Modus werden angezeigt.certdata
- 1 = Formular für Abfrage der Spendenbescheinigungsdaten anbieten 0 = Formular nicht anbieten (default)otherpayments
- JSON-formatierter Array of objects, der es erlaubt, optional externe Zahlungsarten in der Payment Page zu integrieren. Ein Klick auf diese Zahlungsart innerhalb der Payment Page leitet dann direkt an den angegebenen Link weiter, anstatt wie bei den anderen Zahlungsarten intern über GiroCheckout verarbeitet zu werden. Aktuell sind hier nur Zahlungsarten erlaubt, die in der Liste der unterstützten Arten enthalten sind (s. Zahlungsarten). Felder der Objekte: id: Nummer der Zahlungsart lt. obiger Tabelle. url: Link, zu dem nach Auswahl weitergeleitet werden soll. Dieser Link muss alles enthalten, was seitens des externen Anbieters (z.B. PayPal) notwendig ist, um die Zahlung zu verarbeiten, die Payment Page nimmt keine Ersetzung von Parametern o.ä. vor. position: Position innerhalb der angebotenen Zahlungsarten (>=1) Beispiel (PayPal und Kreditkarte): [{"id":14, "url": "https://www.paypal.de/process/123456¶m1=48399", "position":1}, {"id":11, "url":"https://www.visa.com/wasauchimmer", "position":2}]paydirektShoppingCartType
- Typ des Warenkorbs für giropay- und paydirekt-Zahlungen (nur neue giropay-Zahlungen).paydirektShippingFirstName
- Vorname für die Lieferadresse (nur für paydirekt PHYSICAL-Bestellungen).paydirektShippingLastName
- Nachname für die Lieferadresse (nur für paydirekt PHYSICAL-Bestellungen).paydirektShippingCompany
- Firmenname (nur für giropay- und paydirekt-Zahlungen).paydirektShippingAdditionalAddressInformation
- Addresszusatz (nur für giropay- und paydirekt-Zahlungen).paydirektShippingStreet
- Straße des Addressaten (nur für giropay- und paydirekt-Zahlungen).paydirektShippingStreetNumber
- Hausnummer des Addressaten (nur für giropay- und paydirekt-Zahlungen).paydirektShippingZipCode
- Postleitzahl für die Lieferadresse (nur für paydirekt PHYSICAL-Bestellungen).paydirektShippingCity
- Ort für die Lieferadresse (nur für paydirekt PHYSICAL-Bestellungen).paydirektShippingCountry
- Ländercode (ISO 2-stellig) für die Lieferadresse (nur für paydirekt PHYSICAL-Bestellungen).paydirektShippingEmail
- Email-Adresse des Käufers (nur für giropay- und paydirekt-Zahlungen, Pflicht bei digitalen Warenkörben (DIGITAL), bei allen anderen optional)paydirektMerchantReconciliationReferenceNumber
- Zusatzinformation für die Zahlungszuordnung für giropay- und paydirekt-Zahlungen, die im Verwendungszweck angezeigt wird (nur bei type=SALE).paydirektCart
- Nur für giropay- und paydirekt-Zahlungen: Alle Elemente des Warenkorbs.paydirektDeliveryType
- Nur für giropay- und paydirekt-Zahlungen: Typ des Versands.successUrl
- URL, an die der Kunde nach erfolgreicher Zahlung weitergeleitet wird.backUrl
- URL, an die der Kunde weitergeleitet wird, wenn er auf Zurück klickt.failUrl
- URL, an die der Kunde nach erfolgreicher Zahlung weitergeleitet wird.tds2Address
- Für 3D Secure 2.0: Hauptadresszeile (i.d.R. Straße+Hausnummer) der Rechnungsadresse des Karteninhabers, Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50. Wenn angegeben, müssen auch die restlichen tds2-Felder angegeben werden, außer tds2Optional.tds2Postcode
- Für 3D Secure 2.0: Postleitzahl der Rechnungsadresse des Karteninhabers, Format A-Z, a-z, 0-9, Blank, [-], max. 11. Wenn angegeben, müssen auch die restlichen tds2-Felder angegeben werden, außer tds2Optional.tds2City
- Für 3D Secure 2.0: Ort der Rechnungsadresse des Karteninhabers, Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50. Wenn angegeben, müssen auch die restlichen tds2-Felder angegeben werden, außer tds2Optional.tds2Country
- Für 3D Secure 2.0: Land der Rechnungsadresse des Karteninhabers, Format A-Z, max. 2. Zweibuchstabiges Länderkürzel nach dem aktuell gültigen Standard ISO 3166. Wenn angegeben, müssen auch die restlichen tds2-Felder angegeben werden, außer tds2Optional.tds2Optional
- Für 3D Secure 2.0: JSON-String, der weitere optionale Felder enthält. Eine genaue Auflistung der Felder ist unter dieser Tabelle unter 3D Secure 2.0 Optionale Felder (tds2Optional) zu findenmandateReference
- Mandatsreferenz Wird keine angegeben, wird eine eindeutige Mandatsreferenz generiert. Die Mandatsreferenz ist in der Antwort enthalten. Ziffern: 0 – 9 Buchstaben: A – Z und a – z Sonderzeichen: ' : \ , ? - + . ( ) /mandateSignedOn
- Datum im Format JJJJ-MM-TT, wann das SEPA-Lastschriftmandat erteilt wurde. Wenn kein Datum angegeben wird, wird das aktuelle Datum verwendet.mandateReceiverName
- Names des Empfängers, der im SEPA Mandat verwendet wurde. Falls nichts angegeben, wird der in den Stammdaten hinterlegte Firmenname verwendet. Ziffern: 0 – 9 Buchstaben: A – Z und a – z Sonderzeichen: & / = + , : ; . _ - ! ?mandateSequence
- Sequenztyp der SEPA-Lastschrift. Falls nichts angegeben, wird eine Einmalzahlung angenommen. 1 = Einmalzahlung (default) 2 = erste Zahlung einer Sequenz 3 = Folgezahlung 4 = letzte Zahlung einer SequenzinformationText
- Hinweistext, der in der Payment Page oberhalb der Zahlartenauswahl angezeigt wird.kassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transactionqrcodeReturn
- - Optionales Feld, das die Erzeugung eines QR-Codes für den Bezahllink auslöst. Dieser wird dann im Return-Parameter „qrcode“ als base64-codierter String (PNG-Bild) zurückgeliefert. Der Wert von qrcodeReturn ist eine ganze Zahl zwischen 1 und 20 und definiert die Größe des QR-Codes (1=kleinste Größe, 20=größte Größe).- Returns:
- PayementPageRequest
-
createPaymentPageProjectsRequest
PaymentPageProjectsRequest createPaymentPageProjectsRequest()Gibt die Liste aller Projekte, die bei der Payment- oder Spenden-Page verwendet werden, zurück.- Returns:
- PaymentPageProjectsRequest
-
createPaydirektTransactionRequest
PaydirektTransactionRequest createPaydirektTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, Integer securedAuth, String securedAuthUntil, String shoppingCartType, String customerId, Integer shippingAmount, String shippingAddresseFirstName, String shippingAddresseLastName, String shippingCompany, String shippingAdditionalAddressInformation, String shippingStreet, String shippingStreetNumber, String shippingZipCode, String shippingCity, String shippingCountry, String shippingEmail, String merchantReconciliationReferenceNumber, Integer orderAmount, String orderId, ShoppingCartItem[] cart, String invoiceId, String customerMail, Integer minimumAge, String urlRedirect, String urlNotify, String kassenzeichen)Initialisierung einer Paydirekt Zahlung.- Parameters:
merchantTxId
- Eindeutige Transaktions-ID des Händlersamount
- Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- Währung der Transaktion, gemäß ISO 4217, EUR = Europurpose
- Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.type
- Transaktionsart (siehe Transaktionsarten), SALE = Verkauf wird sofort gebucht (default), AUTH = Reservierung des BetragssecuredAuth
- Erlaubt das Anlegen einer gesicherten Vorbestellung. Diese Einstellung macht nur Sinn, wenn type=AUTH ist und wird ansonsten ignoriert.securedAuthUntil
- Endedatum für die gesicherte Vorbestellung, d.h. das Datum bis wann diese maximal gilt.shoppingCartType
- Typ des WarenkorbscustomerId
- KundennummershippingAmount
- Versandkosten. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, PennyshippingAddresseFirstName
- Vorname des AddressatenshippingAddresseLastName
- Nachname des AddressatenshippingCompany
- FirmennameshippingAdditionalAddressInformation
- AddresszusatzshippingStreet
- Straße des AddressatenshippingStreetNumber
- Hausnummer des AddressatenshippingZipCode
- PLZ des AddressatenshippingCity
- Ort des AddressatenshippingCountry
- Ländercode (ISO 3166-1)shippingEmail
- Email-Adresse des Käufers. Dies ist Pflicht bei digitalen Warenkörben (DIGITAL), bei allen anderen optional.merchantReconciliationReferenceNumber
- Zusatzinformation für die Zahlungszuordnung, die im Verwendungszweck angezeigt wird (nur bei type=SALE)orderAmount
- Betrag der Bestellung (ohne Versandkosten), Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, PennyorderId
- Bestellnummer, zulässige Zeichen: A-Z a-z 0-9 + ? / - : ( ) . , ' (Blank), maximale Länge: 20cart
- Alle Elemente des WarenkorbsinvoiceId
- RechnungsnummercustomerMail
- E-Mail des KundenminimumAge
- Mindestalter, das der Käufer erreicht haben mussurlRedirect
- URL, an die der Kunde nach der Zahlung weitergeleitet werden sollurlNotify
- URL, an die der Zahlungsausgang gemeldet werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- PaydirektTransactionRequest
-
createPaydirektCaptureRequest
PaydirektCaptureRequest createPaydirektCaptureRequest(String merchantTxId, Integer amount, String currency, String purpose, String reference, String merchantReconciliationReferenceNumber, Boolean finalCapture, String kassenzeichen)Paydirekt Zahlung - Buchen (CAPTURE)- Parameters:
merchantTxId
- Eindeutige Transaktions-ID des Händlers.amount
- Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.currency
- Währung der Transaktion, gemäß ISO 4217, EUR = Euro.purpose
- Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.reference
- GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.merchantReconciliationReferenceNumber
- Zusatzinformation für die Zahlungszuordnung, die im Verwendungszweck angezeigt wird.finalCapture
- Letzter CAPTURE auf eine Reservierung. Danach kann auf die referenzierte Reservierung kein weiterer CAPTURE mehr erstellt werden.kassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- PaydirektCaptureRequest
-
createPaydirektRefundRequest
PaydirektRefundRequest createPaydirektRefundRequest(String merchantTxId, Integer amount, String currency, String purpose, String reference, String merchantReconciliationReferenceNumber)Paydirekt Zahlung - Erstattung (REFUND)- Parameters:
merchantTxId
- Eindeutige Transaktions-ID des Händlers.amount
- Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.currency
- Währung der Transaktion, gemäß ISO 4217, EUR = Euro.purpose
- Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.reference
- GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.merchantReconciliationReferenceNumber
- Zusatzinformation für die Zahlungszuordnung, die im Verwendungszweck angezeigt wird.- Returns:
- PaydirektRefundRequest
-
createPaydirektCancelRequest
Paydirekt Zahlung - Stornierung- Parameters:
merchantTxId
- Eindeutige Transaktions-ID des Händlers.reference
- GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.- Returns:
- PaydirektCancelRequest
-
createBlueCodeTransactionRequest
BlueCodeTransactionRequest createBlueCodeTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String urlRedirect, String urlNotify, String kassenzeichen)Initialisierung einer BlueCode Zahlung.- Parameters:
merchantTxId
- Eindeutige Transaktions-ID des Händlers.amount
- Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.currency
- Währung der Transaktion, gemäß ISO 4217, EUR = Euro.purpose
- Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.urlRedirect
- URL, an die der Kunde nach der Zahlung weitergeleitet werden soll.urlNotify
- URL, an die der Zahlungsausgang gemeldet werden soll.kassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- BlueCodeTransactionRequest
-
createMaestroTransactionRequest
MaestroTransactionRequest createMaestroTransactionRequest(String merchantTxId, Integer amount, String currency, String purpose, String type, String locale, Integer mobile, String urlRedirect, String urlNotify, String kassenzeichen)Initialisierung einer Zahlung mit der Maestro-Karte- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, z.B. EUR = Europurpose
- - Verwendungszweck der Transaktion. Diese Information erscheint auf der Kartenabrechnung bzw. dem Kontoauszug.type
- - Transaktionsartlocale
- - Sprache des Formulars, z.B. de = deutschmobile
- - Bezahlseite für mobile Browser optimierturlRedirect
- - URL, an die der Kunde nach der Zahlung geschickt werden soll.urlNotify
- - URL, an die der Zahlungsausgang gemeldet werden sollkassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- MaestroTransactionRequest
-
createMaestroCaptureRequest
MaestroCaptureRequest createMaestroCaptureRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose, String kassenzeichen)Maestro - Buchung (CAPTURE)- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Euroreference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden sollpurpose
- - Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.kassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- MaestroCaptureRequest
-
createMaestroRefundRequest
MaestroRefundRequest createMaestroRefundRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose, String kassenzeichen)Maestro - Erstattung (REFUND)- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Euroreference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden sollpurpose
- - Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.kassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- MaestroRefundRequest
-
createEpsSenderInfoRequest
Abfrage von Senderinformationen- Parameters:
reference
- - eindeutige GiroCheckout Transaktions-ID- Returns:
- EpsSenderInfoRequest
-
createIdealSenderInfoRequest
Abfrage von Senderinformationen- Parameters:
reference
- - eindeutige GiroCheckout Transaktions-ID- Returns:
- IdealSenderInfoRequest
-
createCreditCardSenderInfoRequest
Abfrage von Senderinformationen- Parameters:
reference
- - eindeutige GiroCheckout Transaktions-ID- Returns:
- CreditCardSenderInfoRequest
-
createDirectDebitSenderInfoRequest
Abfrage von Senderinformationen- Parameters:
reference
- - eindeutige GiroCheckout Transaktions-ID- Returns:
- DirectDebitSenderInfoRequest
-
createDirectDebitGetPKNRequest
Pseudo-Kartennummer Informationen abfragen- Parameters:
reference
- - Eindeutige GiroCheckout Transaktions-ID- Returns:
- DirectDebitGetPKNRequest
-
createPaypalCaptureRequest
PaypalCaptureRequest createPaypalCaptureRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose, String kassenzeichen)Paypal - Buchung (CAPTURE)- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Euroreference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden sollpurpose
- - Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.kassenzeichen
- - Optional field that allows passing an additional reference/identifier for the transaction- Returns:
- PaypalCaptureRequest
-
createPaypalRefundRequest
PaypalRefundRequest createPaypalRefundRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose)Paypal - Erstattung (REFUND)- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Euroreference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden sollpurpose
- - Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.- Returns:
- PaypalRefundRequest
-
createPaymentPageCaptureRequest
PaymentPageCaptureRequest createPaymentPageCaptureRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose, String txreference)PaymentPage - Buchung (CAPTURE)- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Euroreference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden sollpurpose
- - Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.txreference
- - GiroCheckout Transaktions-ID der konkreten Zahlungstransaktion, für die eine Buchung oder Erstattung durchgeführt werden soll- Returns:
- PaymentPageCaptureRequest
-
createPaymentPageRefundRequest
PaymentPageRefundRequest createPaymentPageRefundRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose, String txreference)PaymentPage - Erstattung (REFUND)- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Euroreference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden sollpurpose
- - Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.txreference
- - GiroCheckout Transaktions-ID der konkreten Zahlungstransaktion, für die eine Buchung oder Erstattung durchgeführt werden soll- Returns:
- PaymentPageRefundRequest
-
createBlueCodeRefundRequest
BlueCodeRefundRequest createBlueCodeRefundRequest(String merchantTxId, Integer amount, String currency, String reference, String purpose)BlueCode - Erstattung (REFUND)- Parameters:
merchantTxId
- - eindeutige Transaktions-ID des Händlersamount
- - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Pennycurrency
- - Währung der Transaktion, gemäß ISO 4217, EUR = Euroreference
- - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden sollpurpose
- - Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.- Returns:
- BlueCodeRefundRequest
-
createShoppingCartItem
ShoppingCartItem createShoppingCartItem(String name, String ean, BigDecimal quantity, Integer grossAmount)Warenkorb-Element- Parameters:
name
- Artikelnameean
- Die Internationale Artikel Nummer (EAN bzw. GTIN)quantity
- Menge des Artikels (4 Nachkommastellen)grossAmount
- Brutto- und Einzelbetrag des Artikels (also Preis pro Stück, bei mehreren), bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny- Returns:
- PaydirektTransactionRequest.Item
-
getHash
Kalkuliert den Hashwert für den angegebenen String- Parameters:
input
- - String für den der Hashwert kalkuliert werden soll- Returns:
- Hashwert
- Throws:
GiroCheckoutException
-
setProxy
Die Verbindung wird über den angegebenen Proxy aufgebaut- Parameters:
proxy
- - Proxy über den die Verbindung aufgebaut wird.
-