Interface Project


public interface Project
Interface, das ein Projekt eines Händlers bei Girosolution repräsentiert.
  • Method Details

    • createEpsBankstatusRequest

      EpsBankstatusRequest createEpsBankstatusRequest(String bic)
      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ändlers
      amount - - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny
      currency - - Währung der Transaktion, z.B. EUR = Euro
      purpose - - Verwendungszweck der eps Überweisung
      bic - - 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
      kassenzeichen - - 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

      GiropayBankstatusRequest createGiropayBankstatusRequest(String bic)
      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ändlers
      bic - - BIC der Käuferbank (8 oder 11-stellig)
      iban - - IBAN der Kundenbankverbindung ohne Leerzeichen
      info1Label - - Bezeichnung 1 / zusätzliche Information für die giropay Überweisungsseiten
      info2Label - - Bezeichnung 2 / zusätzliche Information für die giropay Überweisungsseiten
      info3Label - - Bezeichnung 3 / zusätzliche Information für die giropay Überweisungsseiten
      info4Label - - Bezeichnung 4 / zusätzliche Information für die giropay Überweisungsseiten
      info5Label - - Bezeichnung 5 / zusätzliche Information für die giropay Überweisungsseiten
      info1Text - - Text 1 / zusätzliche Information für die giropay Überweisungsseiten
      info2Text - - Text 2 / zusätzliche Information für die giropay Überweisungsseiten
      info3Text - - Text 3 / zusätzliche Information für die giropay Überweisungsseiten
      info4Text - - Text 4 / zusätzliche Information für die giropay Überweisungsseiten
      info5Text - - Text 5 / zusätzliche Information für die giropay Überweisungsseiten
      urlRedirect - - 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 ID
      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, z.B. EUR = Euro
      purpose - - Verwendungszweck der giropay Überweisung (27 Zeichen)
      shoppingCartType - - Typ des Warenkorbs
      shippingAddresseFirstName - Vorname des Addressaten
      shippingAddresseLastName - Nachname des Addressaten
      shippingCompany - Firmenname
      shippingAdditionalAddressInformation - Addresszusatz
      shippingStreet - Straße des Addressaten
      shippingStreetNumber - Hausnummer des Addressaten
      shippingZipCode - PLZ des Addressaten
      shippingCity - Ort des Addressaten
      shippingCountry - 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 Warenkorbs
      deliveryType - Typ des Versands.
      urlRedirect - - URL, an die der Kunde nach der Zahlung geschickt 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:
      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ändlers
      amount - - Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny
      currency - - Währung der Transaktion, z.B. EUR = Euro
      purpose - - Verwendungszweck der giropay Überweisung (27 Zeichen)
      bic - - BIC der Käuferbank (8 oder 11-stellig)
      iban - - IBAN der Kundenbankverbindung ohne Leerzeichen
      info1Label - - Bezeichnung 1 / zusätzliche Information für die giropay Überweisungsseiten
      info2Label - - Bezeichnung 2 / zusätzliche Information für die giropay Überweisungsseiten
      info3Label - - Bezeichnung 3 / zusätzliche Information für die giropay Überweisungsseiten
      info4Label - - Bezeichnung 4 / zusätzliche Information für die giropay Überweisungsseiten
      info5Label - - Bezeichnung 5 / zusätzliche Information für die giropay Überweisungsseiten
      info1Text - - Text 1 / zusätzliche Information für die giropay Überweisungsseiten
      info2Text - - Text 2 / zusätzliche Information für die giropay Überweisungsseiten
      info3Text - - Text 3 / zusätzliche Information für die giropay Überweisungsseiten
      info4Text - - Text 4 / zusätzliche Information für die giropay Überweisungsseiten
      info5Text - - Text 5 / zusätzliche Information für die giropay Überweisungsseiten
      urlRedirect - - 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ändlers
      amount - - Betrag in Cent
      currency - - Währung der Transaktion, EUR = Euro (default)
      purpose - - Verwendungszweck der iDEAL Überweisung (27 Zeichen)
      issuer - - IDEAL Issuer Bank
      urlRedirect - - URL, an die der Kunde nach der Zahlung geschickt 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:
      IdealPaymentRequest
    • createIdealPaymentRefundRequest

      IdealPaymentRefundRequest createIdealPaymentRefundRequest(String merchantTxId, Integer amount, String currency, String reference)
      iDEAL - Erstattung (REFUND)
      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
      reference - - 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ä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, z.B. EUR = Euro
      purpose - - Verwendungszweck der Kreditkartenransaktion. Diese Information erscheint auf der Kreditkartenabrechnung.
      type - - Transaktionsart
      locale - - Sprache des Kreditkartenformulars, z.B. de = deutsch
      mobile - - Bezahlseite für mobile Browser optimiert
      pkn - - 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 Kreditkarte
      recurring - - wiederkehrende Zahlung
      urlRedirect - - URL, an die der Kunde nach der Zahlung geschickt werden soll.
      urlNotify - - URL, an die der Zahlungsausgang gemeldet werden soll
      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 finden
      kassenzeichen - - Optional field that allows passing an additional reference/identifier for the transaction
      Returns:
      CreditCardTransactionRequest
    • createCreditCardGetPKNRequest

      CreditCardGetPKNRequest createCreditCardGetPKNRequest(String reference)
      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ändlers
      amount - - Betrag in Cent
      currency - - Währung der Transaktion als Währungscode gemäß ISO 4217, z.B. EUR = Euro
      purpose - - Verwendungszweck der Transaktion. Diese Information erscheint auf der Kreditkartenabrechnung.
      type - - Transaktionsart
      pkn - - 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 soll
      kassenzeichen - - 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ä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 Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.
      reference - - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll
      kassenzeichen - - 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ä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 Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.
      reference - - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll
      kassenzeichen - - Optional field that allows passing an additional reference/identifier for the transaction
      Returns:
      CreditCardRefundRequest
    • createCreditCardCancelRequest

      CreditCardCancelRequest createCreditCardCancelRequest(String merchantTxId, String reference)
      Kreditkarte - Stornierung
      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
      reference - - 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ä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, z.B. EUR = Euro
      purpose - - Verwendungszweck der Lastschrift Transaktion. Diese Information erscheint auf dem Kontoauszug.
      type - - Transaktionsart
      bankcode - - Bankleitzahl. Plicht, wenn keine IBAN angegeben ist.
      bankaccount - - Kontonummer. Plicht, wenn keine IBAN angegeben ist.
      iban - - IBAN-Nummer des Käufers ohne Leerzeichen
      accountHolder - - Kontoinhaber
      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.
      urlNotify - - URL, an die der Zahlungsausgang gemeldet werden soll
      kassenzeichen - - 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ä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, z.B. EUR = Euro
      purpose - - Verwendungszweck der Lastschrift Transaktion. Diese Information erscheint auf dem Kontoauszug.
      type - - Transaktionsart
      locale - - Sprache des Lastschriftformulars, z.B. de = deutsch
      mobile - - 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 soll
      kassenzeichen - - 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ä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 Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.
      reference - - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll
      kassenzeichen - - 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ä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 Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.
      reference - - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll
      kassenzeichen - - Optional field that allows passing an additional reference/identifier for the transaction
      Returns:
      DirectDebitRefundRequest
    • createDirectDebitCancelRequest

      DirectDebitCancelRequest createDirectDebitCancelRequest(String merchantTxId, String reference)
      Lastschrift - Stornierung
      Parameters:
      merchantTxId - - eindeutige Transaktions-ID des Händlers
      reference - - 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ändlers
      amount - - Betrag in Cent
      currency - - Währung der Transaktion EUR = Euro
      purpose - - Verwendungszweck der PayPal Transaktion
      type - - Transaktionsart
      urlRedirect - - URL, an die der Kunde nach der Zahlung geschickt 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:
      PaypalTransactionRequest
    • createToolsGetTransactionRequest

      ToolsGetTransactionRequest createToolsGetTransactionRequest(String reference)
      Abfrage von Transaktionsinformationen
      Parameters:
      reference - - eindeutige GiroCheckout Transaktions-ID
      Returns:
      ToolsGetTransactionRequest
    • createGiropaySenderInfoRequest

      GiropaySenderInfoRequest createGiropaySenderInfoRequest(String reference)
      Abfrage von Senderinformationen
      Parameters:
      reference - - eindeutige GiroCheckout Transaktions-ID
      Returns:
      GiropaySenderInfoRequest
    • createEpcGetRequest

      EpcGetRequest createEpcGetRequest(String girocodeReference, String format, Integer resolution)
      Abfrage der zu einem GiroCode hinterlegten Daten
      Parameters:
      girocodeReference - - eindeutige GiroCode Referenznummer
      format - - Format des GiroCode Grafik in der Antwort. Werte: epc-qr, epc-qr-optimizied, none
      resolution - - 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 = Euro
      purposetext - - Verwendungszweck für die Zahlung, wenn keine Zahlungsreferenz angegeben ist. Zulässige Zeichen: SEPA Zeichensatz
      paymentreference - - Zahlungsreferenz, wenn kein Verwendungszweck angegeben ist
      purposecode - - Textschlüssel für die SEPA Überweisung (SEPA Category Purpose Code)
      infotext - - Informationstext für den Zahlenden
      receiverName - - Kontoinhaber des Empfängerkontos, Zulässige Zeichen: SEPA Zeichensatz
      receiverIban - - IBAN des Empfängerkontos
      receiverBic - - BIC des Empfängerkontos
      format - - Format des GiroCode Grafik in der Antwort. Werte: epc-qr, epc-qr-optimizied, none
      resolution - - 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ändlers
      amount - Betrag in Cent Wenn kind = 2, dann als Betrag 0 angeben
      currency - Währung der Transaktion EUR = Euro (default)
      purpose - Verwendungszweck der SOFORT Überweisung
      bic - 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=Spendenseite
      expirydate - 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 aktiv
      timeout - (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 finden
      mandateReference - 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 Sequenz
      informationText - Hinweistext, der in der Payment Page oberhalb der Zahlartenauswahl angezeigt wird.
      kassenzeichen - - Optional field that allows passing an additional reference/identifier for the transaction
      qrcodeReturn - - 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ä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.
      type - Transaktionsart (siehe Transaktionsarten), SALE = Verkauf wird sofort gebucht (default), AUTH = Reservierung des Betrags
      securedAuth - 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 Warenkorbs
      customerId - Kundennummer
      shippingAmount - Versandkosten. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny
      shippingAddresseFirstName - Vorname des Addressaten
      shippingAddresseLastName - Nachname des Addressaten
      shippingCompany - Firmenname
      shippingAdditionalAddressInformation - Addresszusatz
      shippingStreet - Straße des Addressaten
      shippingStreetNumber - Hausnummer des Addressaten
      shippingZipCode - PLZ des Addressaten
      shippingCity - Ort des Addressaten
      shippingCountry - 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, Penny
      orderId - Bestellnummer, zulässige Zeichen: A-Z a-z 0-9 + ? / - : ( ) . , ' (Blank), maximale Länge: 20
      cart - Alle Elemente des Warenkorbs
      invoiceId - Rechnungsnummer
      customerMail - E-Mail des Kunden
      minimumAge - Mindestalter, das der Käufer erreicht haben muss
      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:
      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

      PaydirektCancelRequest createPaydirektCancelRequest(String merchantTxId, String reference)
      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ä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, z.B. EUR = Euro
      purpose - - Verwendungszweck der Transaktion. Diese Information erscheint auf der Kartenabrechnung bzw. dem Kontoauszug.
      type - - Transaktionsart
      locale - - Sprache des Formulars, z.B. de = deutsch
      mobile - - Bezahlseite für mobile Browser optimiert
      urlRedirect - - URL, an die der Kunde nach der Zahlung geschickt 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:
      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ä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
      reference - - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll
      purpose - - 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ä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
      reference - - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll
      purpose - - 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

      EpsSenderInfoRequest createEpsSenderInfoRequest(String reference)
      Abfrage von Senderinformationen
      Parameters:
      reference - - eindeutige GiroCheckout Transaktions-ID
      Returns:
      EpsSenderInfoRequest
    • createIdealSenderInfoRequest

      IdealSenderInfoRequest createIdealSenderInfoRequest(String reference)
      Abfrage von Senderinformationen
      Parameters:
      reference - - eindeutige GiroCheckout Transaktions-ID
      Returns:
      IdealSenderInfoRequest
    • createCreditCardSenderInfoRequest

      CreditCardSenderInfoRequest createCreditCardSenderInfoRequest(String reference)
      Abfrage von Senderinformationen
      Parameters:
      reference - - eindeutige GiroCheckout Transaktions-ID
      Returns:
      CreditCardSenderInfoRequest
    • createDirectDebitSenderInfoRequest

      DirectDebitSenderInfoRequest createDirectDebitSenderInfoRequest(String reference)
      Abfrage von Senderinformationen
      Parameters:
      reference - - eindeutige GiroCheckout Transaktions-ID
      Returns:
      DirectDebitSenderInfoRequest
    • createDirectDebitGetPKNRequest

      DirectDebitGetPKNRequest createDirectDebitGetPKNRequest(String reference)
      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ä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
      reference - - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll
      purpose - - 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ä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
      reference - - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll
      purpose - - 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ä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
      reference - - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll
      purpose - - 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ä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
      reference - - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll
      purpose - - 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ä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
      reference - - GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll
      purpose - - 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 - Artikelname
      ean - 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

      String getHash(String input) throws GiroCheckoutException
      Kalkuliert den Hashwert für den angegebenen String
      Parameters:
      input - - String für den der Hashwert kalkuliert werden soll
      Returns:
      Hashwert
      Throws:
      GiroCheckoutException
    • setProxy

      void setProxy(Proxy proxy)
      Die Verbindung wird über den angegebenen Proxy aufgebaut
      Parameters:
      proxy - - Proxy über den die Verbindung aufgebaut wird.