Class Project

Namespace
GiroSolution.GiroCheckout
Assembly
GiroCheckout.dll

Repräsentiert ein Projekt bei Girosolution / Girocheckout

public class Project
Inheritance
Project
Inherited Members

Constructors

Project(Merchant, int, string)

Erzeugt eine neue Projektreferenz

public Project(Merchant merchant, int id, string password)

Parameters

merchant Merchant

Referenz auf das Händlerkonto bei Girosolution / GirocheckoutMerchant

id int

Projekt-Id

password string

Projekt-Passwort

Fields

connectTimeout

protected int connectTimeout

Field Value

int

id

protected int id

Field Value

int

merchant

protected Merchant merchant

Field Value

Merchant

password

protected string password

Field Value

string

readTimeout

protected int readTimeout

Field Value

int

Methods

createApplePayCancelRequest(string, int?, string, string, string, string, string, string)

Apple Pay Zahlung - Stornierung (REFUND)

public ApplePayCancelRequest createApplePayCancelRequest(string merchantTxId, int? amount, string currency, string purpose, string reference, string kassenzeichen, string basket, string shippingInfo)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int?

Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

basket string

Optionales Feld, das den Warenkorb beschreibt.

shippingInfo string

Optionales Feld, das Informationen zur Lieferung bereit stellt.

Returns

ApplePayCancelRequest

ApplePayCancelRequest

createApplePayCaptureRequest(string, int, string, string, string, string, string, string)

Apple Pay Zahlung - Buchen (CAPTURE).

public ApplePayCaptureRequest createApplePayCaptureRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string kassenzeichen, string basket, string shippingInfo)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

basket string

Optionales Feld, das den Warenkorb beschreibt.

shippingInfo string

Optionales Feld, das Informationen zur Lieferung bereit stellt.

Returns

ApplePayCaptureRequest

ApplePayCaptureRequest

createApplePayRefundRequest(string, int, string, string, string, string, string, string)

Apple Pay Zahlung - Erstattung (REFUND)

public ApplePayRefundRequest createApplePayRefundRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string kassenzeichen, string basket, string shippingInfo)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

basket string

Optionales Feld, das den Warenkorb beschreibt.

shippingInfo string

Optionales Feld, das Informationen zur Lieferung bereit stellt.

Returns

ApplePayRefundRequest

ApplePayRefundRequest

createApplePayTransactionRequest(string, int, string, string, string, string, string, string, string, string, string, string)

Initialisierung einer Apple Pay Zahlung.

public ApplePayTransactionRequest createApplePayTransactionRequest(string merchantTxId, int amount, string currency, string purpose, string type, string urlRedirect, string urlNotify, string billingAddress, string shippingAddress, string customerInfo, string basket, string kassenzeichen)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

type string

Transaktionsart (siehe Transaktionsarten), SALE = Verkauf wird sofort gebucht (default), AUTH = Reservierung des Betrags.

urlRedirect string

URL, an die der Kunde nach der Zahlung weitergeleitet werden soll

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll

billingAddress string

Optionales Feld, das die Rechnungsadresse des Käufers enthalten kann.

shippingAddress string

Optionales Feld, das die Lieferadresse des Käufers enthalten kann.

customerInfo string

Optionales Feld, das zusätzliche Informationen des Käufers enthalten kann.

basket string

Pflichtfeld, das den Warenkorb beschreibt.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

ApplePayTransactionRequest

ApplePayTransactionRequest

createCreditCardCancelRequest(string, string)

Eine Stornierung ist zu verwenden, wenn dem Kunden eine vorangegangene Zahlung storniert werden soll. Bedingung: kann nur auf folgende Transaktionstypen angewendet werden: 1.Reservierung. 2.Reservierung/Buchung. Betrag: Transaktionsbetrag der vormals gesendeten Transaktion.

public CreditCardCancelRequest createCreditCardCancelRequest(string merchantTxId, string reference)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

reference string

GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll

Returns

CreditCardCancelRequest

CreditCardCancelRequest

createCreditCardCaptureRequest(string, int, string, string, string, string)

Beim Buchen wird das Kundenkonto mit einem Betrag belastet, die Gutschrift erfolgt auf das Händlerkonto. Dieses Modell unterstellt, dass der zugrundeliegende Geschäftsvorfall abgeschlossen ist, z.B. wurde ein Warenkorb angeboten, bestellt und an den Kunden ausgeliefert. Bedingung: nur reservierte Transaktionen können gebucht werden. Betrag: Reservierungsbetrag. Buchung von Teilbeträgen möglich

public CreditCardCaptureRequest createCreditCardCaptureRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string kassenzeichen)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro

purpose string

Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.

reference string

GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

CreditCardCaptureRequest

CreditCardCaptureRequest

createCreditCardGetPKNRequest(string)

Pseudo-Kartennummer Informationen abfragen

public CreditCardGetPKNRequest createCreditCardGetPKNRequest(string reference)

Parameters

reference string

Eindeutige GiroCheckout Transaktions-ID

Returns

CreditCardGetPKNRequest

CreditCardGetPKNRequest

createCreditCardRecurringTransactionRequest(string, int, string, string, string, string, int?, string, string)

Führt eine wiederkehrende Kreditkartenzahlung durch

public CreditCardRecurringTransactionRequest createCreditCardRecurringTransactionRequest(string merchantTxId, int amount, string currency, string purpose, string type, string pkn, int? recurring, string urlNotify, string kassenzeichen)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen der Betrag in der kleinsten Währungseinheit, z.B. Cent, Penny

currency string

Währung der Transaktion, z.B. EUR = Euro

purpose string

Verwendungszweck der Kreditkartenzahlung

type string

Transaktionsart

pkn string

Pseudo-Kartennummer einer Kreditkarte, mit der die Transaktion durchgeführt werden soll.

recurring int?

Definiert, ob es sich um eine wiederkehrende Kreditkartenzahlung handelt.

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

CreditCardRecurringTransactionRequest

CreditCardRecurringTransactionRequest

createCreditCardRefundRequest(string, int, string, string, string, string)

Eine Erstattung ist zu verwenden, wenn dem Kunden eine vorangegangene Zahlung komplett oder teilweise erstattet werden soll. Bedingung: kann nur auf folgende Transaktionstypen angewendet werden: 1.Reservierung. 2.Reservierung/Buchung. Betrag: Transaktionsbetrag der vormals gesendeten Transaktion.

public CreditCardRefundRequest createCreditCardRefundRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string kassenzeichen)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro

purpose string

Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.

reference string

GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

CreditCardRefundRequest

CreditCardRefundRequest

createCreditCardSenderInfoRequest(string)

public CreditCardSenderInfoRequest createCreditCardSenderInfoRequest(string reference)

Parameters

reference string

eindeutige GiroCheckout Transaktions-ID

Returns

CreditCardSenderInfoRequest

CreditCardSenderInfoRequest

createCreditCardTransactionRequest(string, int, string, string, string, string, int, string, int, string, string, string, string, string, string, string, string)

Initialisierung einer Kreditkartenzahlung

public CreditCardTransactionRequest createCreditCardTransactionRequest(string merchantTxId, int amount, string currency, string purpose, string type, string locale, int mobile, string pkn, int recurring, string urlRedirect, string urlNotify, string tds2Address, string tds2Postcode, string tds2City, string tds2Country, string tds2Optional, string kassenzeichen)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen der Betrag in der kleinsten Währungseinheit, z.B. Cent, Penny

currency string

Währung der Transaktion, z.B. EUR = Euro

purpose string

Verwendungszweck der Kreditkartenzahlung

type string

Transaktionsart

locale string

Sprache des Kreditkartenformulars, z.B. de = deutsch

mobile int

Soll die Bezahlseite für mobile Browser optimiert werden

pkn string

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 int

wiederkehrende Zahlung

urlRedirect string

URL, an die der Kunde nach der Zahlung geschickt werden soll

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll

tds2Address string

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 string

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 string

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 string

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 string

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 string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

CreditCardTransactionRequest

CreditCardTransactionRequest

createDirectDebitCancelRequest(string, string)

Eine Stornierung ist zu verwenden, wenn dem Kunden eine vorangegangene Zahlung storniert werden soll. Bedingung: kann nur auf folgende Transaktionstypen angewendet werden: 1.Reservierung. 2.Reservierung/Buchung. Betrag: Transaktionsbetrag der vormals gesendeten Transaktion.

public DirectDebitCancelRequest createDirectDebitCancelRequest(string merchantTxId, string reference)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

reference string

GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll

Returns

DirectDebitCancelRequest

DirectDebitCancelRequest

createDirectDebitCaptureRequest(string, int, string, string, string, string)

Beim Buchen wird das Kundenkonto mit einem Betrag belastet, die Gutschrift erfolgt auf das Händlerkonto. Dieses Modell unterstellt, dass der zugrundeliegende Geschäftsvorfall abgeschlossen ist, z.B. wurde ein Warenkorb angeboten, bestellt und an den Kunden ausgeliefert. Bedingung: nur reservierte Transaktionen können gebucht werden. Betrag: Reservierungsbetrag. Buchung von Teilbeträgen möglich

public DirectDebitCaptureRequest createDirectDebitCaptureRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string kassenzeichen)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro

purpose string

Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.

reference string

GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

DirectDebitCaptureRequest

DirectDebitCaptureRequest

createDirectDebitGetPKNRequest(string)

Pseudo-Kartennummer Informationen abfragen

public DirectDebitGetPKNRequest createDirectDebitGetPKNRequest(string reference)

Parameters

reference string

Eindeutige GiroCheckout Transaktions-ID

Returns

DirectDebitGetPKNRequest

DirectDebitGetPKNRequest

createDirectDebitRefundRequest(string, int, string, string, string, string)

Eine Erstattung ist zu verwenden, wenn dem Kunden eine vorangegangene Zahlung komplett oder teilweise erstattet werden soll. Bedingung: kann nur auf folgende Transaktionstypen angewendet werden: 1.Reservierung. 2.Reservierung/Buchung. Betrag: Transaktionsbetrag der vormals gesendeten Transaktion.

public DirectDebitRefundRequest createDirectDebitRefundRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string kassenzeichen)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro

purpose string

Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.

reference string

GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

DirectDebitRefundRequest

DirectDebitRefundRequest

createDirectDebitSenderInfoRequest(string)

public DirectDebitSenderInfoRequest createDirectDebitSenderInfoRequest(string reference)

Parameters

reference string

eindeutige GiroCheckout Transaktions-ID

Returns

DirectDebitSenderInfoRequest

DirectDebitSenderInfoRequest

createDirectDebitTransactionRequest(string, int, string, string, string, string, string, string, string, string, string, string, int, string, string, string)

Führt eine Lastschriftzahlung durch

public DirectDebitTransactionRequest createDirectDebitTransactionRequest(string merchantTxId, int amount, string currency, string purpose, string type, string bankcode, string bankaccount, string iban, string accountHolder, string mandateReference, string mandateSignedOn, string mandateReceiverName, int mandateSequence, string pkn, string urlNotify, string kassenzeichen)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen der Betrag in der kleinsten Währungseinheit, z.B. Cent, Penny

currency string

Währung der Transaktion, z.B. EUR = Euro

purpose string

Verwendungszweck der Lastschrift

type string

Transaktionsart

bankcode string

Bankleitzahl. Plicht, wenn keine IBAN angegeben ist.

bankaccount string

Kontonummer. Plicht, wenn keine IBAN angegeben ist.

iban string

IBAN-Nummer des Käufers ohne Leerzeichen

accountHolder string

Kontoinhaber

mandateReference string

Mandatsreferenz. Wird keine angegeben, wird eine eindeutige Mandatsreferenz generiert. Die Manadatsreferenz ist in der Antwort enthalten.

mandateSignedOn string

Datum im Format JJJJ-MM-TT, wann das SEPA-Lastschriftmandat erteilt wurde. Wenn kein Datum angegeben wird, wird das aktuelle Datum verwendet.

mandateReceiverName string

Name des Empfängers, der im SEPA Mandat verwendet wurde. Falls nichts angegeben, wird der in den Stammdaten hinterlegte Firmenname verwendet.

mandateSequence int

Sequenztyp der SEPA-Lastschrift. Falls nichts angegeben, wird eine Einmalzahlung angenommen.

pkn string

Das Feld dient dazu eine erneute Transaktion, ohne erneute Eingabe der Bankverbindung, zu starten.

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

DirectDebitTransactionRequest

DirectDebitTransactionRequest

createDirectDebitTransactionWithPaymentPageRequest(string, int, string, string, string, string, int, string, string, string, int, string, string, string, string)

Initialisierung einer Lastschriftzahlung mit Formularservice

public DirectDebitTransactionWithPaymentPageRequest createDirectDebitTransactionWithPaymentPageRequest(string merchantTxId, int amount, string currency, string purpose, string type, string locale, int mobile, string mandateReference, string mandateSignedOn, string mandateReceiverName, int mandateSequence, string pkn, string urlRedirect, string urlNotify, string kassenzeichen)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen der Betrag in der kleinsten Währungseinheit, z.B. Cent, Penny

currency string

Währung der Transaktion, z.B. EUR = Euro

purpose string

Verwendungszweck der Lastschrift

type string

Transaktionsart

locale string

Sprache des Lastschriftformulars, z.B. de = deutsch

mobile int

Soll die Bezahlseite für mobile Browser optimiert werden

mandateReference string

Mandatsreferenz. Wird keine angegeben, wird eine eindeutige Mandatsreferenz generiert. Die Manadatsreferenz ist in der Antwort enthalten.

mandateSignedOn string

Datum im Format JJJJ-MM-TT, wann das SEPA-Lastschriftmandat erteilt wurde. Wenn kein Datum angegeben wird, wird das aktuelle Datum verwendet.

mandateReceiverName string

Name des Empfängers, der im SEPA Mandat verwendet wurde. Falls nichts angegeben, wird der in den Stammdaten hinterlegte Firmenname verwendet.

mandateSequence int

Sequenztyp der SEPA-Lastschrift. Falls nichts angegeben, wird eine Einmalzahlung angenommen.

pkn string

Das Feld dient dazu eine erneute Transaktion, ohne erneute Eingabe der Bankverbindung, zu starten.

urlRedirect string

URL, an die der Kunde nach der Zahlung geschickt werden soll

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

DirectDebitTransactionWithPaymentPageRequest

DirectDebitTransactionWithPaymentPageRequest

createDirektubwTransactionRequest(string, int, string, string, string, string, string, string)

Initialisierung einer Direktüberweisung Zahlung.

public DirektubwTransactionRequest createDirektubwTransactionRequest(string merchantTxId, int amount, string currency, string purpose, string type, string urlRedirect, string urlNotify, string kassenzeichen)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B.Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

type string

Transaktionsart

urlRedirect string

URL, an die der Kunde nach der Zahlung weitergeleitet werden soll.

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

DirektubwTransactionRequest

DirektubwTransactionRequest

createEpcCreateRequest(int, string, string, string, string, string, string, string, string, string, int)

Legt die übergebenen Zahldaten werden unter einer GiroCode Referenznummer ab und generiert einen QR Code.

public EpcCreateRequest createEpcCreateRequest(int amount, string currency, string purposetext, string paymentreference, string purposecode, string infotext, string receiverName, string receiverIban, string receiverBic, string format, int resolution)

Parameters

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent Maximal 99999999999 (999.999.999,99)

currency string

Währung der Transaktion, z.B. EUR = Euro

purposetext string

Verwendungszweck für die Zahlung, wenn keine Zahlungsreferenz angegeben ist. Zulässige Zeichen: SEPA Zeichensatz

paymentreference string

Zahlungsreferenz, wenn kein Verwendungszweck angegeben ist

purposecode string

Textschlüssel für die SEPA Überweisung (SEPA Category Purpose Code)

infotext string

Informationstext für den Zahlenden

receiverName string

Kontoinhaber des Empfängerkontos, Zulässige Zeichen: SEPA Zeichensatz

receiverIban string

IBAN des Empfängerkontos

receiverBic string

BIC des Empfängerkontos

format string

Format des GiroCode Grafik in der Antwort. Werte: epc-qr, epc-qr-optimizied, none

resolution int

Auflösung in Pixel (z.B. 250), wenn der GiroCode als Grafik angefordert wird. Maximal 500

Returns

EpcCreateRequest

EpcCreateRequest

createEpcGetRequest(string, string, int)

Abfrage der zu einem GiroCode hinterlegten Daten

public EpcGetRequest createEpcGetRequest(string girocodeReference, string format, int resolution)

Parameters

girocodeReference string

eindeutige GiroCode Referenznummer

format string

Format des GiroCode Grafik in der Antwort. Werte: epc-qr, epc-qr-optimizied, none

resolution int

Auflösung in Pixel (z.B. 250), wenn der GiroCode als Grafik angefordert wird. Maximal 500

Returns

EpcGetRequest

EpcGetRequest

createGiropayBankstatusRequest(string)

Prüft ob die angegebene Bank am giropay-Verfahren teilnimmt.

public GiropayBankstatusRequest createGiropayBankstatusRequest(string bic)

Parameters

bic string

BIC der Käuferbank (8 oder 11-stellig), die geprüft werden soll

Returns

GiropayBankstatusRequest

GiropayBankstatusRequest

createGiropayCancelRequest(string, string)

Giropay Zahlung - Stornierung (REFUND)

public GiropayCancelRequest createGiropayCancelRequest(string merchantTxId, string reference)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

Returns

GiropayCancelRequest

GiropayCancelRequest

createGiropayCaptureRequest(string, int, string, string, string, string, bool?, string)

Giropay Zahlung - Buchen (CAPTURE).

public GiropayCaptureRequest createGiropayCaptureRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string merchantReconciliationReferenceNumber, bool? finalCapture, string kassenzeichen)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

merchantReconciliationReferenceNumber string

Zusatzinformation für die Zahlungszuordnung, die im Verwendungszweck angezeigt wird.

finalCapture bool?

Letzter CAPTURE auf eine Reservierung. Danach kann auf die referenzierte Reservierung kein weiterer CAPTURE mehr erstellt werden.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

GiropayCaptureRequest

GiropayCaptureRequest

createGiropayIDCheckRequest(string, string, string, string, string, string, string, string, string, string, string, string, string, string, string)

Führt eine giropay-Altersverifikation durch.

public 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)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

bic string

BIC der Käuferbank (8 oder 11-stellig)

iban string

IBAN der Kundenbankverbindung ohne Leerzeichen

info1Label string

Bezeichnung 1 / zusätzliche Information für die giropay Überweisungsseiten

info2Label string

Bezeichnung 2 / zusätzliche Information für die giropay Überweisungsseiten

info3Label string

Bezeichnung 3 / zusätzliche Information für die giropay Überweisungsseiten

info4Label string

Bezeichnung 4 / zusätzliche Information für die giropay Überweisungsseiten

info5Label string

Bezeichnung 5 / zusätzliche Information für die giropay Überweisungsseiten

info1Text string

Text 1 / zusätzliche Information für die giropay Überweisungsseiten

info2Text string

Text 2 / zusätzliche Information für die giropay Überweisungsseiten

info3Text string

Text 3 / zusätzliche Information für die giropay Überweisungsseiten

info4Text string

Text 4 / zusätzliche Information für die giropay Überweisungsseiten

info5Text string

Text 5 / zusätzliche Information für die giropay Überweisungsseiten

urlRedirect string

URL, an die der Kunde nach der Transaktion geschickt werden soll

urlNotify string

URL, an die das Transaktionsergebnis gemeldet werden soll

Returns

GiropayIDCheckRequest

GiropayIDCheckRequest

createGiropayIssuerListRequest()

Gibt die Liste aller Banken, die am giropay Verfahren teilnehmen, zurück.

public GiropayIssuerListRequest createGiropayIssuerListRequest()

Returns

GiropayIssuerListRequest

GiropayIssuerListRequest

createGiropayRefundRequest(string, int, string, string, string, string)

Giropay Zahlung - Erstattung (REFUND)

public GiropayRefundRequest createGiropayRefundRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string merchantReconciliationReferenceNumber)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

merchantReconciliationReferenceNumber string

Zusatzinformation für die Zahlungszuordnung, die im Verwendungszweck angezeigt wird.

Returns

GiropayRefundRequest

GiropayRefundRequest

createGiropaySenderInfoRequest(string)

public GiropaySenderInfoRequest createGiropaySenderInfoRequest(string reference)

Parameters

reference string

eindeutige GiroCheckout Transaktions-ID

Returns

GiropaySenderInfoRequest

GiropaySenderInfoRequest

createGiropayTransactionRequest(string, string, int, string, string, string, int?, string, string, string, string, string, string, string, string, string, string, string, string, string, ShoppingCartItem[], string, string, string, string, string)

Führt eine Giropay-Bezahltransaktion durch

public GiropayTransactionRequest createGiropayTransactionRequest(string giropayMerchantId, string merchantTxId, int amount, string currency, string purpose, string type, int? securedAuth, string securedAuthUntil, 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, string giropayCustomerId)

Parameters

giropayMerchantId string

Giropay merchant ID

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen der Betrag in der kleinsten Währungseinheit, z.B. Cent, Penny

currency string

Währung der Transaktion, z.B. EUR = Euro

purpose string

Verwendungszweck der giropay Überweisung

type string

Transaktionsart (siehe Transaktionsarten), SALE = Verkauf wird sofort gebucht (default), AUTH = Reservierung des Betrags.

securedAuth int?

Erlaubt das Anlegen einer gesicherten Vorbestellung. Diese Einstellung macht nur Sinn, wenn type=AUTH ist und wird ansonsten ignoriert.

securedAuthUntil string

Endedatum für die gesicherte Vorbestellung, d.h. das Datum bis wann diese maximal gilt.

shoppingCartType string

Typ des Warenkorbs

shippingAddresseFirstName string

Vorname des Addressaten

shippingAddresseLastName string

Nachname des Addressaten

shippingCompany string

Firmenname

shippingAdditionalAddressInformation string

Addresszusatz

shippingStreet string

Straße des Addressaten

shippingStreetNumber string

Hausnummer des Addressaten

shippingZipCode string

PLZ des Addressaten

shippingCity string

Ort des Addressaten

shippingCountry string

Ländercode (ISO 3166-1)

shippingEmail string

Email-Adresse des Käufers. Dies ist Pflicht bei digitalen Warenkörben (DIGITAL), bei allen anderen optional.

merchantOrderReferenceNumber string

Zusatzinformation für die Zahlungszuordnung, die im Verwendungszweck angezeigt wird (nur bei type=SALE).

cart ShoppingCartItem[]

Alle Elemente des Warenkorbs

deliveryType string

Typ des Versands.

urlRedirect string

URL, an die der Kunde nach der Zahlung geschickt werden soll

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

giropayCustomerId string

Kundennummer, max. Länge: 20.

Returns

GiropayTransactionRequest

GiropayTransactionRequest

createGiropayTransactionWithGiropayIDRequest(string, int, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string)

Führt eine giropay Transaktion mit gleichzeitiger Altersverifiktation durch

public GiropayTransactionWithGiropayIDRequest createGiropayTransactionWithGiropayIDRequest(string merchantTxId, int 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)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen der Betrag in der kleinsten Währungseinheit, z.B. Cent, Penny

currency string

Währung der Transaktion, z.B. EUR = Euro

purpose string

Verwendungszweck der giropay Überweisung

bic string

BIC der Käuferbank (8 oder 11-stellig)

iban string

IBAN der Kundenbankverbindung ohne Leerzeichen

info1Label string

Bezeichnung 1 / zusätzliche Information für die giropay Überweisungsseiten

info2Label string

Bezeichnung 2 / zusätzliche Information für die giropay Überweisungsseiten

info3Label string

Bezeichnung 3 / zusätzliche Information für die giropay Überweisungsseiten

info4Label string

Bezeichnung 4 / zusätzliche Information für die giropay Überweisungsseiten

info5Label string

Bezeichnung 5 / zusätzliche Information für die giropay Überweisungsseiten

info1Text string

Text 1 / zusätzliche Information für die giropay Überweisungsseiten

info2Text string

Text 2 / zusätzliche Information für die giropay Überweisungsseiten

info3Text string

Text 3 / zusätzliche Information für die giropay Überweisungsseiten

info4Text string

Text 4 / zusätzliche Information für die giropay Überweisungsseiten

info5Text string

Text 5 / zusätzliche Information für die giropay Überweisungsseiten

urlRedirect string

URL, an die der Kunde nach der Zahlung geschickt werden soll

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll

Returns

GiropayTransactionWithGiropayIDRequest

GiropayTransactionWithGiropayIDRequest

createGooglePayCancelRequest(string, int?, string, string, string, string, string, string)

Google Pay Zahlung - Stornierung (REFUND)

public GooglePayCancelRequest createGooglePayCancelRequest(string merchantTxId, int? amount, string currency, string purpose, string reference, string kassenzeichen, string basket, string shippingInfo)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int?

Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

basket string

Optionales Feld, das den Warenkorb beschreibt.

shippingInfo string

Optionales Feld, das Informationen zur Lieferung bereit stellt.

Returns

GooglePayCancelRequest

GooglePayCancelRequest

createGooglePayCaptureRequest(string, int, string, string, string, string, string, string)

Google Pay Zahlung - Buchen (CAPTURE).

public GooglePayCaptureRequest createGooglePayCaptureRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string kassenzeichen, string basket, string shippingInfo)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

basket string

Optionales Feld, das den Warenkorb beschreibt.

shippingInfo string

Optionales Feld, das Informationen zur Lieferung bereit stellt.

Returns

GooglePayCaptureRequest

GooglePayCaptureRequest

createGooglePayRefundRequest(string, int, string, string, string, string, string, string)

Google Pay Zahlung - Erstattung (REFUND)

public GooglePayRefundRequest createGooglePayRefundRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string kassenzeichen, string basket, string shippingInfo)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

basket string

Optionales Feld, das den Warenkorb beschreibt.

shippingInfo string

Optionales Feld, das Informationen zur Lieferung bereit stellt.

Returns

GooglePayRefundRequest

GooglePayRefundRequest

createGooglePayTransactionRequest(string, int, string, string, string, string, string, string, string, string, string, string)

Initialisierung einer Google Pay Zahlung.

public GooglePayTransactionRequest createGooglePayTransactionRequest(string merchantTxId, int amount, string currency, string purpose, string type, string urlRedirect, string urlNotify, string billingAddress, string shippingAddress, string customerInfo, string basket, string kassenzeichen)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

type string

Transaktionsart (siehe Transaktionsarten), SALE = Verkauf wird sofort gebucht (default), AUTH = Reservierung des Betrags.

urlRedirect string

URL, an die der Kunde nach der Zahlung weitergeleitet werden soll

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll

billingAddress string

Optionales Feld, das die Rechnungsadresse des Käufers enthalten kann.

shippingAddress string

Optionales Feld, das die Lieferadresse des Käufers enthalten kann.

customerInfo string

Optionales Feld, das zusätzliche Informationen des Käufers enthalten kann.

basket string

Pflichtfeld, das den Warenkorb beschreibt.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

GooglePayTransactionRequest

GooglePayTransactionRequest

createPaydirektCancelRequest(string, string)

Paydirekt Zahlung - Stornierung (REFUND)

public PaydirektCancelRequest createPaydirektCancelRequest(string merchantTxId, string reference)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

Returns

PaydirektCancelRequest

PaydirektCancelRequest

createPaydirektCaptureRequest(string, int, string, string, string, string, bool?, string)

Paydirekt Zahlung - Buchen (CAPTURE).

public PaydirektCaptureRequest createPaydirektCaptureRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string merchantReconciliationReferenceNumber, bool? finalCapture, string kassenzeichen)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

merchantReconciliationReferenceNumber string

Zusatzinformation für die Zahlungszuordnung, die im Verwendungszweck angezeigt wird.

finalCapture bool?

Letzter CAPTURE auf eine Reservierung. Danach kann auf die referenzierte Reservierung kein weiterer CAPTURE mehr erstellt werden.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

PaydirektCaptureRequest

PaydirektCaptureRequest

createPaydirektRefundRequest(string, int, string, string, string, string)

Paydirekt Zahlung - Erstattung (REFUND)

public PaydirektRefundRequest createPaydirektRefundRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string merchantReconciliationReferenceNumber)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

merchantReconciliationReferenceNumber string

Zusatzinformation für die Zahlungszuordnung, die im Verwendungszweck angezeigt wird.

Returns

PaydirektRefundRequest

PaydirektRefundRequest

createPaydirektTransactionRequest(string, int, string, string, string, int?, string, string, string, int?, string, string, string, string, string, string, string, string, string, string, string, int?, string, ShoppingCartItem[], string, string, int?, string, string, string)

Initialisierung einer Paydirekt Zahlung.

public PaydirektTransactionRequest createPaydirektTransactionRequest(string merchantTxId, int amount, string currency, string purpose, string type, int? securedAuth, string securedAuthUntil, string shoppingCartType, string customerId, int? shippingAmount, string shippingAddresseFirstName, string shippingAddresseLastName, string shippingCompany, string shippingAdditionalAddressInformation, string shippingStreet, string shippingStreetNumber, string shippingZipCode, string shippingCity, string shippingCountry, string shippingEmail, string merchantReconciliationReferenceNumber, int? orderAmount, string orderId, ShoppingCartItem[] cart, string invoiceId, string customerMail, int? minimumAge, string urlRedirect, string urlNotify, string kassenzeichen)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

type string

Transaktionsart (siehe Transaktionsarten), SALE = Verkauf wird sofort gebucht (default), AUTH = Reservierung des Betrags.

securedAuth int?

Erlaubt das Anlegen einer gesicherten Vorbestellung. Diese Einstellung macht nur Sinn, wenn type=AUTH ist und wird ansonsten ignoriert.

securedAuthUntil string

Endedatum für die gesicherte Vorbestellung, d.h. das Datum bis wann diese maximal gilt.

shoppingCartType string

Typ des Warenkorbs.

customerId string

Kundennummer

shippingAmount int?

Versandkosten. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

shippingAddresseFirstName string

Vorname des Addressaten.

shippingAddresseLastName string

Nachname des Addressaten.

shippingCompany string

Firmenname

shippingAdditionalAddressInformation string

Addresszusatz

shippingStreet string

Straße des Addressaten

shippingStreetNumber string

Hausnummer des Addressaten

shippingZipCode string

PLZ des Addressaten

shippingCity string

Ort des Addressaten

shippingCountry string

Ländercode (ISO 3166-1)

shippingEmail string

Email-Adresse des K�ufers. Dies ist Pflicht bei digitalen Warenk�rben (DIGITAL), bei allen anderen optional.

merchantReconciliationReferenceNumber string

Zusatzinformation f�r die Zahlungszuordnung, die im Verwendungszweck angezeigt wird (nur bei type=SALE)

orderAmount int?

Betrag der Bestellung (ohne Versandkosten), Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny

orderId string

Bestellnummer, zulässige Zeichen: A-Z a-z 0-9 + ? / - : ( ) . , ' (Blank), maximale Länge: 20

cart ShoppingCartItem[]

Alle Elemente des Warenkorbs

invoiceId string

Rechnungsnummer

customerMail string

E-Mail des Kunden

minimumAge int?

Mindestalter, das der Käufer erreicht haben muss

urlRedirect string

URL, an die der Kunde nach der Zahlung weitergeleitet werden soll

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

PaydirektTransactionRequest

PaydirektTransactionRequest

createPaymentPageCaptureRequest(string, int, string, string, string, string)

Beim Buchen wird das Kundenkonto mit einem Betrag belastet, die Gutschrift erfolgt auf das Händlerkonto. Dieses Modell unterstellt, dass der zugrundeliegende Geschäftsvorfall abgeschlossen ist, z.B. wurde ein Warenkorb angeboten, bestellt und an den Kunden ausgeliefert. Bedingung: nur reservierte Transaktionen können gebucht werden. Betrag: Reservierungsbetrag. Buchung von Teilbeträgen möglich

public PaymentPageCaptureRequest createPaymentPageCaptureRequest(string merchantTxId, int amount, string currency, string reference, string purpose, string txreference)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro

reference string

GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll

purpose string

Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.

txreference string

GiroCheckout Transaktions-ID der konkreten Zahlungstransaktion, für die eine Buchung oder Erstattung durchgeführt werden soll. Diese wurde zuvor im Redirect im reference-Parameter und in der Notification im gcReference-Parameter zurückgeliefert. Dieser Parameter ist nur notwendig, wenn mit dem über 'reference' referenzierten Payment- oder Spendenlink mehr als eine erfolgreiche Zahlung getätigt wurde.

Returns

PaymentPageCaptureRequest

PaymentPageCaptureRequest

createPaymentPageProjectsRequest()

Gibt die Liste aller Projekte, die bei der Payment- oder Spenden-Page verwendet werden, zurück.

public PaymentPageProjectsRequest createPaymentPageProjectsRequest()

Returns

PaymentPageProjectsRequest

PaymentPageProjectsRequest

createPaymentPageRefundRequest(string, int, string, string, string, string)

Eine Erstattung ist zu verwenden, wenn dem Kunden eine vorangegangene Zahlung komplett oder teilweise erstattet werden soll. Bedingung: kann nur auf folgende Transaktionstypen angewendet werden: 1.Reservierung. 2.Reservierung/Buchung. Betrag: Transaktionsbetrag der vormals gesendeten Transaktion.

public PaymentPageRefundRequest createPaymentPageRefundRequest(string merchantTxId, int amount, string currency, string reference, string purpose, string txreference)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro

reference string

GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll

purpose string

Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.

txreference string

GiroCheckout Transaktions-ID der konkreten Zahlungstransaktion, für die eine Buchung oder Erstattung durchgeführt werden soll. Diese wurde zuvor im Redirect im reference-Parameter und in der Notification im gcReference-Parameter zurückgeliefert. Dieser Parameter ist nur notwendig, wenn mit dem über 'reference' referenzierten Payment- oder Spendenlink mehr als eine erfolgreiche Zahlung getätigt wurde.

Returns

PaymentPageRefundRequest

PaymentPageRefundRequest

createPaymentPageRequest(string, int, string, string, string, int?, string, int?, int?, string, string, string, string, string, int?, string, int?, int?, string, string, string, int, int?, string, string, string, string, string, string, string, string, string, string, string, string, string, ShoppingCartItem[], string, string, string, string, string, string, string, string, string, string, string, string, string, int?, string, string, int?, string, string, string, string)

public PaymentPageRequest createPaymentPageRequest(string merchantTxId, int amount, string currency, string purpose, string description, int? pagetype, string expirydate, int? single, int? timeout, string txType, string locale, string paymethods, string payprojects, string organization, int? freeamount, string fixedvalues, int? minamount, int? maxamount, string orderid, string projectlist, string pkn, int test, int? 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, int? mandateSequence, string informationText, string kassenzeichen, int? qrcodeReturn, string billingAddress, string shippingAddress, string customerInfo, string basket)

Parameters

merchantTxId string
amount int
currency string
purpose string
description string
pagetype int?
expirydate string
single int?
timeout int?
txType string
locale string
paymethods string
payprojects string
organization string
freeamount int?
fixedvalues string
minamount int?
maxamount int?
orderid string
projectlist string
pkn string
test int
certdata int?
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 string
paydirektCart ShoppingCartItem[]
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 string
mandateSequence int?
informationText string
kassenzeichen string
qrcodeReturn int?
billingAddress string
shippingAddress string
customerInfo string
basket string

Returns

PaymentPageRequest

createPaypalCaptureRequest(string, int, string, string, string, string)

Beim Buchen wird das Kundenkonto mit einem Betrag belastet, die Gutschrift erfolgt auf das Händlerkonto. Dieses Modell unterstellt, dass der zugrundeliegende Geschäftsvorfall abgeschlossen ist, z.B. wurde ein Warenkorb angeboten, bestellt und an den Kunden ausgeliefert. Bedingung: nur reservierte Transaktionen können gebucht werden. Betrag: Reservierungsbetrag. Buchung von Teilbeträgen möglich

public PaypalCaptureRequest createPaypalCaptureRequest(string merchantTxId, int amount, string currency, string reference, string purpose, string kassenzeichen)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro

reference string

GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll

purpose string

Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

PaypalCaptureRequest

PaypalCaptureRequest

createPaypalRefundRequest(string, int, string, string, string)

Eine Erstattung ist zu verwenden, wenn dem Kunden eine vorangegangene Zahlung komplett oder teilweise erstattet werden soll. Bedingung: kann nur auf folgende Transaktionstypen angewendet werden: 1.Reservierung. 2.Reservierung/Buchung. Betrag: Transaktionsbetrag der vormals gesendeten Transaktion.

public PaypalRefundRequest createPaypalRefundRequest(string merchantTxId, int amount, string currency, string reference, string purpose)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro

reference string

GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll

purpose string

Verwendungszweck der Erstattung. Diese Information erscheint auf der Kreditkartenabrechnung.

Returns

PaypalRefundRequest

PaypalRefundRequest

createPaypalTransactionRequest(string, int, string, string, string, string, string, string)

Initialisierung einer PayPal Zahlung

public PaypalTransactionRequest createPaypalTransactionRequest(string merchantTxId, int amount, string currency, string purpose, string type, string urlRedirect, string urlNotify, string kassenzeichen)

Parameters

merchantTxId string

eindeutige Transaktions-ID des Händlers

amount int

Bei Dezimalwährungen der Betrag in der kleinsten Währungseinheit, z.B. Cent, Penny

currency string

Währung der Transaktion, z.B. EUR = Euro

purpose string

Verwendungszweck der Paypal Zahlung

type string

Transaktionsart

urlRedirect string

URL, an die der Kunde nach der Zahlung geschickt werden soll

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

PaypalTransactionRequest

PaypalTransactionRequest

createShoppingCartItem(string, string, decimal, int?)

Warenkorb-Element.

public ShoppingCartItem createShoppingCartItem(string name, string ean, decimal quantity, int? grossAmount)

Parameters

name string

Artikelname

ean string

Die Internationale Artikel Nummer (EAN bzw. GTIN)

quantity decimal

Menge des Artikels (4 Nachkommastellen)

grossAmount int?

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

ShoppingCartItem

ShoppingCartItem

createSofortUwTransactionRequest(string, int, string, string, string, string, string)

Initialisierung einer SOFORT Zahlung.

public SofortUwTransactionRequest createSofortUwTransactionRequest(string merchantTxId, int amount, string currency, string purpose, string bic, string urlRedirect, string urlNotify)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers

amount int

Betrag in Cent Wenn kind = 2, dann als Betrag 0 angeben

currency string

Währung der Transaktion EUR = Euro (default)

purpose string

Verwendungszweck der SOFORT Überweisung

bic string

BIC der Käuferbank (8 oder 11-stellig)

urlRedirect string

URL, an die der Kunde nach der Zahlung geschickt werden soll.

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll.

Returns

SofortUwTransactionRequest

SofortUwTransactionRequest

createToolsGetTransactionRequest(string)

Abfrage von Transaktionsinformationen

public ToolsGetTransactionRequest createToolsGetTransactionRequest(string reference)

Parameters

reference string

eindeutige GiroCheckout Transaktions-ID

Returns

ToolsGetTransactionRequest

ToolsGetTransactionRequest

createWeroRefundRequest(string, int, string, string, string, string)

Wero Zahlung - Erstattung (REFUND)

public WeroRefundRequest createWeroRefundRequest(string merchantTxId, int amount, string currency, string purpose, string reference, string kassenzeichen)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Betrag oder Teilbetrag. Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

reference string

GiroCheckout Transaktions-ID der zugrundeliegenden AUTH-Transaktion.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

WeroRefundRequest

WeroRefundRequest

createWeroTransactionRequest(string, int, string, string, string, string, string, string)

Initialisierung einer Wero Zahlung.

public WeroTransactionRequest createWeroTransactionRequest(string merchantTxId, int amount, string currency, string purpose, string type, string urlRedirect, string urlNotify, string kassenzeichen)

Parameters

merchantTxId string

Eindeutige Transaktions-ID des Händlers.

amount int

Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B.Cent, Penny.

currency string

Währung der Transaktion, gemäß ISO 4217, EUR = Euro.

purpose string

Verwendungszweck der Transaktion. Diese Information erscheint auf der Abrechnung.

type string

Transaktionsart

urlRedirect string

URL, an die der Kunde nach der Zahlung weitergeleitet werden soll.

urlNotify string

URL, an die der Zahlungsausgang gemeldet werden soll.

kassenzeichen string

Optional field that allows passing an additional reference/identifier for the transaction.

Returns

WeroTransactionRequest

WeroTransactionRequest

getConnectTimeout()

ConnectTimeout

public int getConnectTimeout()

Returns

int

getHash(string)

Kalkuliert den Hashwert für den angegebenen String

public string getHash(string input)

Parameters

input string

String für den der Hashwert kalkuliert werden soll

Returns

string

Hashwert

getId()

Projekt-Id

public int getId()

Returns

int

getMerchant()

Referenz auf das Händlerkonto bei Girosolution / Girocheckout

public Merchant getMerchant()

Returns

Merchant

Merchant

getPassword()

Projekt-Passwort

public string getPassword()

Returns

string

getReadTimeout()

ReadTimeout

public int getReadTimeout()

Returns

int

log(string)

public void log(string msg)

Parameters

msg string

setConnectTimeout(int)

Legt einen Timeout (in Millisekunden) fest, der beim Aufbau der Verbindung verwendet wird. Wird der Timeout überschritten, bevor die Verbindung zustande kommt, wird eine Exception ausgelöst.Ein Wert von 0 bedeutet unendlichen Timeout.

public void setConnectTimeout(int connectTimeout)

Parameters

connectTimeout int

der Verbindungs-Timeout in Millisekunden

setReadTimeout(int)

Legt den Timeout (in Millisekunden) für das Auslesen von Daten aus einer bestehenden Verbindung fest. Ein Wert von 0 bedeutet unendlichen Timeout, ein negativer Wert steht für den Standardwert(20 000 ms).

public void setReadTimeout(int readTimeout)

Parameters

readTimeout int

der Lese-Timeout in Millisekunden