Girocheckout API

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Zuletzt angesehen:
girocheckout:paypage:start

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Letzte Überarbeitung Beide Seiten der Revision
girocheckout:paypage:start [2023/03/24 20:39]
michaelheumann 		girocheckout:paypage:start [2023/05/08 03:54]
michaelheumann
Zeile 148: Zeile 148:
 ^Name           ^Pflicht  ^Type      ^Beschreibung   ^ ^Name           ^Pflicht  ^Type      ^Beschreibung   ^
 |rc             |Ja       |Integer   |[[girocheckout:errorcodes|Fehlernummer]] | |rc             |Ja       |Integer   |[[girocheckout:errorcodes|Fehlernummer]] |
-|msg            |Ja       |String    |Zusätzliche Informationen im Fehlerfall |+|msg            |Ja       |String(255)    |Zusätzliche Informationen im Fehlerfall |
 |projects       |Optional |Array     |Liste der GiroCockpit-Projekte bestehend aus der Id (id), dem Projektnamen (name), der Nummer der zugehörigen Zahlungsart (paymethod, s. [[girocheckout:paypage:start#unterstuetzte_zahlungsarten|Liste der Zahlungsarten]]) und dem Modus (mode) = TEST oder LIVE. | |projects       |Optional |Array     |Liste der GiroCockpit-Projekte bestehend aus der Id (id), dem Projektnamen (name), der Nummer der zugehörigen Zahlungsart (paymethod, s. [[girocheckout:paypage:start#unterstuetzte_zahlungsarten|Liste der Zahlungsarten]]) und dem Modus (mode) = TEST oder LIVE. |
 ^HEADER Parameter^^^^ ^HEADER Parameter^^^^
-|hash           |Ja       |String    |HMAC MD5 hash über alle Werte der Rückmeldung. Siehe [[girocheckout:general:start#uebermittlung_von_daten_ueber_einen_schnittstellenaufruf_an_den_haendler|hash der Rückantwort]] |+|hash           |Ja       |String(32)    |HMAC MD5 hash über alle Werte der Rückmeldung. Siehe [[girocheckout:general:start#uebermittlung_von_daten_ueber_einen_schnittstellenaufruf_an_den_haendler|hash der Rückantwort]] |
  
 == Beispiel == == Beispiel ==
Zeile 180: Zeile 180:
 |organization   |Optional |String(70)|Name des Anbieters der Bezahl- oder Spendenseite.  Wenn nicht angegeben, wird der Name aus dem GiroCockpit verwendet.| |organization   |Optional |String(70)|Name des Anbieters der Bezahl- oder Spendenseite.  Wenn nicht angegeben, wird der Name aus dem GiroCockpit verwendet.|
 |freeamount     |Optional |Integer   |Gibt an, ob der Anwender einen freien Betrag eingeben darf (=1) oder nicht (=0, Defaultwert). | |freeamount     |Optional |Integer   |Gibt an, ob der Anwender einen freien Betrag eingeben darf (=1) oder nicht (=0, Defaultwert). |
-|fixedvalues    |Optional |String    |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! |+|fixedvalues    |Optional |JSON-String    |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      |Optional |Integer   |Mindestwert, wenn ein freier Betrag eingegeben werden darf, also freeamount=1 ist. Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny, ohne Nachkommastellen. Fehlt dieser Wert, ist der Default 100, also z.B. 1,00 EUR. | |minamount      |Optional |Integer   |Mindestwert, wenn ein freier Betrag eingegeben werden darf, also freeamount=1 ist. Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny, ohne Nachkommastellen. Fehlt dieser Wert, ist der Default 100, also z.B. 1,00 EUR. |
 |maxamount      |Optional |Integer   |Maximalwert, wenn ein freier Betrag eingegeben werden darf, also freeamount=1 ist. Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny, ohne Nachkommastellen. | |maxamount      |Optional |Integer   |Maximalwert, wenn ein freier Betrag eingegeben werden darf, also freeamount=1 ist. Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny, ohne Nachkommastellen. |
 |orderid        |Optional |String(20) |Wird nur bei Zahlungsart Paydirekt verwendet, wenn leer wird die orderid aus dem Purpose erzeugt. Es sind nur SEPA-konforme Zeichen zulässig (s. [[girocheckout:paypage:start#sepa-konforme_zeichen|SEPA-konforme Zeichen]]) | |orderid        |Optional |String(20) |Wird nur bei Zahlungsart Paydirekt verwendet, wenn leer wird die orderid aus dem Purpose erzeugt. Es sind nur SEPA-konforme Zeichen zulässig (s. [[girocheckout:paypage:start#sepa-konforme_zeichen|SEPA-konforme Zeichen]]) |
 |projectlist    |Optional |String    |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. \\ Example: ["School in Namibia","Wildlife protection Southafrica","Childcare Honduras"] | |projectlist    |Optional |String    |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. \\ Example: ["School in Namibia","Wildlife protection Southafrica","Childcare Honduras"] |
-|pkn            |Optional |String    |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. |+|pkn            |Optional |String(50)    |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           |Ja  |Integer     |1 = Zahlarten im Test-Modus werden angezeigt \\ 0 = Zahlarten im LIVE-Modus werden angezeigt | |test           |Ja  |Integer     |1 = Zahlarten im Test-Modus werden angezeigt \\ 0 = Zahlarten im LIVE-Modus werden angezeigt |
 |certdata       |Optional  | Integer | 1 = Formular für Abfrage der Spendenbescheinigungsdaten anbieten \\ 0 = Formular nicht anbieten (default) | |certdata       |Optional  | Integer | 1 = Formular für Abfrage der Spendenbescheinigungsdaten anbieten \\ 0 = Formular nicht anbieten (default) |
-|otherpayments  |Optional  | String  | 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. [[girocheckout:paypage:start#unterstuetzte_zahlungsarten|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):** \\ <nowiki>[{"id":14, "url": "https://www.paypal.de/process/123456&param1=48399", "position":1}, {"id":11, "url":"https://www.visa.com/wasauchimmer", "position":2}]</nowiki> | +|otherpayments  |Optional  | JSON-String  | 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. [[girocheckout:paypage:start#unterstuetzte_zahlungsarten|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):** \\ <nowiki>[{"id":14, "url": "https://www.paypal.de/process/123456&param1=48399", "position":1}, {"id":11, "url":"https://www.visa.com/wasauchimmer", "position":2}]</nowiki> | 
-|paydirektShoppingCartType |Optional | String    |Typ des Warenkorbs für giropay- und paydirekt-Zahlungen (nur neue giropay-Zahlungen). Folgende Werte sind zulässig: \\ PHYSICAL = Alle Waren im Warenkorb sind physischer Natur, \\ DIGITAL = Alle Waren im Warenkorb sind digitaler Natur (benötigen also keinen Versand), \\ MIXED = Der Warenkorb enthält sowohl physische als auch digitale Waren (dies ist der Default-Wert, wenn der Parameter nicht angegeben wird), \\ ANONYMOUS_DONATION = Es handelt sich um eine anonyme Spende (keine Adressdaten notwendig), \\ AUTHORITIES_PAYMENT = Es handelt sich um eine Behördenzahlung (keine Adressdaten notwendig). \\ Wird der Wert nicht angegeben, der Kunde wählt aber giropay oder paydirekt als Zahlungsart, wird folgendes Verfahren angewendet, um einen Defaultwert zu ermitteln: \\ 1) Handelt es sich um eine Spendenseite (pagetype=2), wird ANONYMOUS_DONATION gesetzt. \\ 2) Ist der Händler bei S-Public Services als Kommune registriert, wird AUTHORITIES_PAYMENT genommen. \\ 3) Sind die paydirekt-Adressfelder für Vorname, Nachname, PLZ, Ort und Land gesetzt, wird MIXED gesetzt. \\ 4) Trifft keiner der Fälle 1-3 zu, wird MIXED als Defaultwert genommen und die Felder, die oben unter MIXED angegeben sind, auch als Parameter erwartet. | +|paydirektShoppingCartType |Optional | String(19)    |Typ des Warenkorbs für giropay- und paydirekt-Zahlungen (nur neue giropay-Zahlungen). Folgende Werte sind zulässig: \\ PHYSICAL = Alle Waren im Warenkorb sind physischer Natur, \\ DIGITAL = Alle Waren im Warenkorb sind digitaler Natur (benötigen also keinen Versand), \\ MIXED = Der Warenkorb enthält sowohl physische als auch digitale Waren (dies ist der Default-Wert, wenn der Parameter nicht angegeben wird), \\ ANONYMOUS_DONATION = Es handelt sich um eine anonyme Spende (keine Adressdaten notwendig), \\ AUTHORITIES_PAYMENT = Es handelt sich um eine Behördenzahlung (keine Adressdaten notwendig). \\ Wird der Wert nicht angegeben, der Kunde wählt aber giropay oder paydirekt als Zahlungsart, wird folgendes Verfahren angewendet, um einen Defaultwert zu ermitteln: \\ 1) Handelt es sich um eine Spendenseite (pagetype=2), wird ANONYMOUS_DONATION gesetzt. \\ 2) Ist der Händler bei S-Public Services als Kommune registriert, wird AUTHORITIES_PAYMENT genommen. \\ 3) Sind die paydirekt-Adressfelder für Vorname, Nachname, PLZ, Ort und Land gesetzt, wird MIXED gesetzt. \\ 4) Trifft keiner der Fälle 1-3 zu, wird MIXED als Defaultwert genommen und die Felder, die oben unter MIXED angegeben sind, auch als Parameter erwartet. | 
-|paydirektShippingFirstName |Optional  | String(100)  | Vorname für die Lieferadresse (nur für giropay- und paydirekt-Zahlung, **Pflicht** bei Warenkorbtypen PHYSICAL, DIGITAL und MIXED, optional bei ANONYMOUS_DONATION und AUTHORITIES_PAYMENT) |  +|paydirektShippingFirstName |Optional  | String(100)  | Vorname für die Lieferadresse (nur für giropay- und paydirekt-Zahlung, **Pflicht** bei Warenkorbtypen PHYSICAL, DIGITAL und MIXED, optional bei ANONYMOUS_DONATION und AUTHORITIES_PAYMENT). Zulässige Zeichen: Alle Buchstaben (UTF-8, auch ausländisch), 0-9, die Zeichen %% .-!#$%&'*+/=?^_’`´{|}~"(),:;<>@[] %%, außerdem Leerzeichen und Zeilenumbruch. |  
-|paydirektShippingLastName  |Optional  | String(100)  | Nachname für die Lieferadresse (nur für giropay- und paydirekt-Zahlung, **Pflicht** bei Warenkorbtypen PHYSICAL, DIGITAL und MIXED, optional bei ANONYMOUS_DONATION und AUTHORITIES_PAYMENT) | +|paydirektShippingLastName  |Optional  | String(100)  | Nachname für die Lieferadresse (nur für giropay- und paydirekt-Zahlung, **Pflicht** bei Warenkorbtypen PHYSICAL, DIGITAL und MIXED, optional bei ANONYMOUS_DONATION und AUTHORITIES_PAYMENT). Zulässige Zeichen s. paydirektShippingFirstName. | 
-|paydirektShippingCompany      |Optional   |String    | Firmenname (nur für giropay- und paydirekt-Zahlungen) | +|paydirektShippingCompany      |Optional   |String(100)    | Firmenname (nur für giropay- und paydirekt-Zahlungen). Zulässige Zeichen s. paydirektShippingFirstName. | 
-|paydirektShippingAdditionalAddressInformation |Optional       |String | Addresszusatz (nur für giropay- und paydirekt-Zahlungen) | +|paydirektShippingAdditionalAddressInformation |Optional       |String(100) | Addresszusatz (nur für giropay- und paydirekt-Zahlungen). Zulässige Zeichen s. paydirektShippingFirstName. | 
-|paydirektShippingStreet       |Optional      |String    | Straße des Addressaten (nur für giropay- und paydirekt-Zahlungen) | +|paydirektShippingStreet       |Optional      |String(100)    | Straße des Addressaten (nur für giropay- und paydirekt-Zahlungen). Zulässige Zeichen s. paydirektShippingFirstName. | 
-|paydirektShippingStreetNumber |Optional    |String    | Hausnummer des Addressaten (nur für giropay- und paydirekt-Zahlungen) | +|paydirektShippingStreetNumber |Optional    |String(10)    | Hausnummer des Addressaten (nur für giropay- und paydirekt-Zahlungen). Zulässige Zeichen s. paydirektShippingFirstName. | 
-|paydirektShippingZipCode  |Optional  | String(10)  | Postleitzahl für die Lieferadresse (nur für giropay- und paydirekt-Zahlungen, **Pflicht** bei Warenkörben der Typen PHYSICAL und MIXED, optional bei DIGITAL, ANONYMOUS_DONATION und AUTHORITIES_PAYMENT) | +|paydirektShippingZipCode  |Optional  | String(10)  | Postleitzahl für die Lieferadresse (nur für giropay- und paydirekt-Zahlungen, **Pflicht** bei Warenkörben der Typen PHYSICAL und MIXED, optional bei DIGITAL, ANONYMOUS_DONATION und AUTHORITIES_PAYMENT). Zulässige Zeichen s. paydirektShippingFirstName. | 
-|paydirektShippingCity  |Optional  | String(100)  | Ort für die Lieferadresse (nur für giropay- und paydirekt-Zahlungen, **Pflicht** bei Warenkörben der Typen PHYSICAL und MIXED, optional bei DIGITAL, ANONYMOUS_DONATION und AUTHORITIES_PAYMENT) |+|paydirektShippingCity  |Optional  | String(100)  | Ort für die Lieferadresse (nur für giropay- und paydirekt-Zahlungen, **Pflicht** bei Warenkörben der Typen PHYSICAL und MIXED, optional bei DIGITAL, ANONYMOUS_DONATION und AUTHORITIES_PAYMENT). Zulässige Zeichen s. paydirektShippingFirstName. |
 |paydirektShippingCountry  |Optional  | String(2)  | Ländercode (ISO 2-stellig) für die Lieferadresse (nur für giropay- und paydirekt-Zahlungen, **Pflicht** bei Warenkörben der Typen PHYSICAL und MIXED, optional bei DIGITAL, ANONYMOUS_DONATION und AUTHORITIES_PAYMENT) | |paydirektShippingCountry  |Optional  | String(2)  | Ländercode (ISO 2-stellig) für die Lieferadresse (nur für giropay- und paydirekt-Zahlungen, **Pflicht** bei Warenkörben der Typen PHYSICAL und MIXED, optional bei DIGITAL, ANONYMOUS_DONATION und AUTHORITIES_PAYMENT) |
-|paydirektShippingEmail    |Optional  |String    | Email-Adresse des Käufers (nur für giropay- und paydirekt-Zahlungen, **Pflicht** bei digitalen Warenkörben (DIGITAL), bei allen anderen optional) |+|paydirektShippingEmail    |Optional  |String(255)    | Email-Adresse des Käufers (nur für giropay- und paydirekt-Zahlungen, **Pflicht** bei digitalen Warenkörben (DIGITAL), bei allen anderen optional) |
 |paydirektMerchantOrderReferenceNumber  |Optional         |String(20)    | Zusatzinformation für die Zahlungszuordnung für giropay- und paydirekt-Zahlungen, die im Verwendungszweck angezeigt wird (nur bei type=SALE).  Nur SEPA-konforme Zeichen sind hier zulässig (s. [[girocheckout:paypage:start#sepa-konforme_zeichen|SEPA-konforme Zeichen]]) | |paydirektMerchantOrderReferenceNumber  |Optional         |String(20)    | Zusatzinformation für die Zahlungszuordnung für giropay- und paydirekt-Zahlungen, die im Verwendungszweck angezeigt wird (nur bei type=SALE).  Nur SEPA-konforme Zeichen sind hier zulässig (s. [[girocheckout:paypage:start#sepa-konforme_zeichen|SEPA-konforme Zeichen]]) |
-|paydirektCart           |Optional      |JSON String | Nur für giropay- und paydirekt-Zahlungen: Alle Elemente des Warenkorbs im folgenden Format: s. weiter unten:  [[girocheckout:paydirekt:start#cart-element|Beschreibung cart-Element]] | +|paydirektCart           |Optional      |JSON-String | Nur für giropay- und paydirekt-Zahlungen: Alle Elemente des Warenkorbs im folgenden Format: s. weiter unten:  [[girocheckout:paydirekt:start#cart-element|Beschreibung cart-Element]] | 
-|paydirektDeliveryType |Optional | String    |Nur für giropay- und paydirekt-Zahlungen: Typ des Versands. Folgende Werte sind zulässig: \\ STANDARD = Die Ware wird an eine normale Postadresse versandt (dies ist der Default-Wert, wenn der Parameter nicht angegeben wird), \\ PACKSTATION = Die Waren werden an eine Selbstbedienungs-Packstation für Pakete geliefert, \\ STORE_PICKUP = Die Waren werden in der Geschäftsstelle des Verkäufers abhgeholt. | +|paydirektDeliveryType |Optional | String(12)    |Nur für giropay- und paydirekt-Zahlungen: Typ des Versands. Folgende Werte sind zulässig: \\ STANDARD = Die Ware wird an eine normale Postadresse versandt (dies ist der Default-Wert, wenn der Parameter nicht angegeben wird), \\ PACKSTATION = Die Waren werden an eine Selbstbedienungs-Packstation für Pakete geliefert, \\ STORE_PICKUP = Die Waren werden in der Geschäftsstelle des Verkäufers abhgeholt. | 
-|successUrl     |Optional  |String      |URL, an die der Kunde nach erfolgreicher Zahlung weitergeleitet wird. | +|successUrl     |Optional  |String(2048)      |URL, an die der Kunde nach erfolgreicher Zahlung weitergeleitet wird. | 
-|backUrl        |Optional  |String      |URL, an die der Kunde weitergeleitet wird, wenn er auf Zurück klickt. | +|backUrl        |Optional  |String(2048)      |URL, an die der Kunde weitergeleitet wird, wenn er auf Zurück klickt. | 
-|failUrl        |Optional  |String      |URL, an die der Kunde nach erfolgloser Zahlung weitergeleitet wird. | +|failUrl        |Optional  |String(2048)      |URL, an die der Kunde nach erfolgloser Zahlung weitergeleitet wird. | 
-|notifyUrl      |Optional  |String      |URL, an die in einer Server-to-Server-Verbindung die Payment Notification geschickt wird. | +|notifyUrl      |Optional  |String(2048)      |URL, an die in einer Server-to-Server-Verbindung die Payment Notification geschickt wird. | 
-|tds2Address |Optional |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.  | +|tds2Address |Optional |String(50) | 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 |Optional |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.  | +|tds2Postcode |Optional |String(10) | 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 |Optional |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.  | +|tds2City |Optional |String(50) | 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 |Optional |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. | +|tds2Country |Optional |String(2) | 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 |Optional |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 [[girocheckout:paypage:start#d_secure_20_optionale_felder_tds2optional|3D Secure 2.0 Optionale Felder (tds2Optional)]] zu finden|+|tds2Optional |Optional |JSON-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 [[girocheckout:paypage:start#d_secure_20_optionale_felder_tds2optional|3D Secure 2.0 Optionale Felder (tds2Optional)]] zu finden|
 |mandateReference | Optional |String(35)  |Mandatsreferenz \\ Wird keine angegeben, wird eine eindeutige Mandatsreferenz generiert. Die Mandatsreferenz ist in der Antwort enthalten.  \\ |mandateReference | Optional |String(35)  |Mandatsreferenz \\ Wird keine angegeben, wird eine eindeutige Mandatsreferenz generiert. Die Mandatsreferenz ist in der Antwort enthalten.  \\
     Ziffern: 0 – 9       Ziffern: 0 – 9  
Zeile 227: Zeile 227:
 |kassenzeichen  |Optional |String(255)  |Optionales Feld für die Übergabe eines Kassenzeichens.  Dieses wird dann im GiroCockpit in den Transaktionsdetails angezeigt (und bald auch exportiert) und es kann dort auch danach gesucht werden. Zulässige Zeichen sind alle UTF-8-Zeichen. | |kassenzeichen  |Optional |String(255)  |Optionales Feld für die Übergabe eines Kassenzeichens.  Dieses wird dann im GiroCockpit in den Transaktionsdetails angezeigt (und bald auch exportiert) und es kann dort auch danach gesucht werden. Zulässige Zeichen sind alle UTF-8-Zeichen. |
 |qrcodeReturn  |Optional |Integer      |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). | |qrcodeReturn  |Optional |Integer      |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). |
-|hash           |Ja  |String      |HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |+|hash           |Ja  |String(32)      |HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
  
 === SEPA-konforme Zeichen === === SEPA-konforme Zeichen ===
Zeile 256: Zeile 256:
  
 ^Name           ^Datentyp     ^Beschreibung   ^ ^Name           ^Datentyp     ^Beschreibung   ^
-|email |String | E-Mail-Adresse des Karteninhabers, Format A-Z, a-z, 0-9, [_.+-@], max. 254. |+|email |String(254) | E-Mail-Adresse des Karteninhabers, Format A-Z, a-z, 0-9, [_.+-@], max. 254. |
 |addressesMatch |Boolean  | Lieferadresse entspricht Rechnungsadresse, ja="true", nein="false", kein Unterobjekt sondern Feld direkt im Hauptobjekt. | |addressesMatch |Boolean  | Lieferadresse entspricht Rechnungsadresse, ja="true", nein="false", kein Unterobjekt sondern Feld direkt im Hauptobjekt. |
 ^**//billingAddress//**  ^^^ ^**//billingAddress//**  ^^^
-|billingAddress.line2 |String | Zeile 2 der Rechnungsadresse. Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50 | +|billingAddress.line2 |String(50) | Zeile 2 der Rechnungsadresse. Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50 | 
-|billingAddress.line3 |String | Zeile 3 der Rechnungsadresse. Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50 | +|billingAddress.line3 |String(50) | Zeile 3 der Rechnungsadresse. Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50 | 
-|billingAddress.state |String | Bundesland der Rechnungsadresse o.ä. Format A-Z, max. 3, Kürzel gemäß ISO 3166-2 |+|billingAddress.state |String(3) | Bundesland der Rechnungsadresse o.ä. Format A-Z, max. 3, Kürzel gemäß ISO 3166-2 |
 ^**//shippingAddress//**  ^^^ ^**//shippingAddress//**  ^^^
-|shippingAddress.line1 |String | Zeile 1 der Lieferadresse. Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50 | +|shippingAddress.line1 |String(50) | Zeile 1 der Lieferadresse. Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50 | 
-|shippingAddress.line2 |String | Zeile 2 der Lieferadresse. Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50 | +|shippingAddress.line2 |String(50) | Zeile 2 der Lieferadresse. Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50 | 
-|shippingAddress.line3 |String | Zeile 3 der Lieferadresse. Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50 | +|shippingAddress.line3 |String(50) | Zeile 3 der Lieferadresse. Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50 | 
-|shippingAddress.postcode |String |Postleitzahl der Lieferadresse, Format A-Z, a-z, 0-9, Blank, [-], max. 11 | +|shippingAddress.postcode |String(10) |Postleitzahl der Lieferadresse, Format A-Z, a-z, 0-9, Blank, [-], max. 11 | 
-|shippingAddress.city |String | Ort der Lieferadresse, Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50 | +|shippingAddress.city |String(50) | Ort der Lieferadresse, Format A-Z, a-z, 0-9, Blank, [-/().,&'], max. 50 | 
-|shippingAddress.state |String | Bundesland der Lieferadresse o.ä. Format A-Z, max. 3, Kürzel gemäß ISO 3166-2 | +|shippingAddress.state |String(50) | Bundesland der Lieferadresse o.ä. Format A-Z, max. 3, Kürzel gemäß ISO 3166-2 | 
-|shippingAddress.country |String | Land der Lieferadresse, Format A-Z, max. 2. Zweibuchstabiges Länderkürzel nach dem aktuell gültigen Standard ISO 3166. |+|shippingAddress.country |String(2) | Land der Lieferadresse, Format A-Z, max. 2. Zweibuchstabiges Länderkürzel nach dem aktuell gültigen Standard ISO 3166. |
 ^**//homePhoneNumber//**  ^^^ ^**//homePhoneNumber//**  ^^^
 |homePhoneNumber.country |Integer | Ländervorwahl der Heim-Telefonnummer, Format 0-9, max. 3. z.B. 49 für Deutschland. | |homePhoneNumber.country |Integer | Ländervorwahl der Heim-Telefonnummer, Format 0-9, max. 3. z.B. 49 für Deutschland. |
-|homePhoneNumber.regional |String | Rest der der Heim-Telefonnummer, Format 0-9, max. 15, ohne führende Nullen, z.B. 73482984938. |+|homePhoneNumber.regional |String(15) | Rest der der Heim-Telefonnummer, Format 0-9, max. 15, ohne führende Nullen, z.B. 73482984938. |
 ^**//mobilePhoneNumber//**  ^^^ ^**//mobilePhoneNumber//**  ^^^
 |mobilePhoneNumber.country |Integer | Ländervorwahl der Mobil-Telefonnummer, Format 0-9, max. 3. z.B. 49 für Deutschland. | |mobilePhoneNumber.country |Integer | Ländervorwahl der Mobil-Telefonnummer, Format 0-9, max. 3. z.B. 49 für Deutschland. |
-|mobilePhoneNumber.regional |String | Rest der der Mobil-Telefonnummer, Format 0-9, max. 15, ohne führende Nullen, z.B. 73482984938. |+|mobilePhoneNumber.regional |String(15) | Rest der der Mobil-Telefonnummer, Format 0-9, max. 15, ohne führende Nullen, z.B. 73482984938. |
 ^**//workPhoneNumber//**  ^^^ ^**//workPhoneNumber//**  ^^^
 |workPhoneNumber.country |Integer | Ländervorwahl der Arbeits-Telefonnummer, Format 0-9, max. 3. z.B. 49 für Deutschland. | |workPhoneNumber.country |Integer | Ländervorwahl der Arbeits-Telefonnummer, Format 0-9, max. 3. z.B. 49 für Deutschland. |
-|workPhoneNumber.regional |String | Rest der der Arbeits-Telefonnummer, Format 0-9, max. 15, ohne führende Nullen, z.B. 73482984938. |+|workPhoneNumber.regional |String(50) | Rest der der Arbeits-Telefonnummer, Format 0-9, max. 15, ohne führende Nullen, z.B. 73482984938. |
 ^**//cardholderAccountInfo//**  ^^^ ^**//cardholderAccountInfo//**  ^^^
-|cardholderAccountInfo.accountAgeIndicator |String | Alter des Kundenkontos. Mögliche Werte: "never" - Kunde hat kein Kundenkonto, kauft z.B. als Gast ein, "now" - Kunde hat während des aktuellen Einkaufs ein Konto angelegt, "less30" - Konto ist weniger als 30 Tage alt, "more30less60" - Konto ist mindestens 30 aber weniger als 60 Tage alt, "more60" - Kundenkonto ist mindestens 60 Tage alt. | +|cardholderAccountInfo.accountAgeIndicator |String(12) | Alter des Kundenkontos. Mögliche Werte: "never" - Kunde hat kein Kundenkonto, kauft z.B. als Gast ein, "now" - Kunde hat während des aktuellen Einkaufs ein Konto angelegt, "less30" - Konto ist weniger als 30 Tage alt, "more30less60" - Konto ist mindestens 30 aber weniger als 60 Tage alt, "more60" - Kundenkonto ist mindestens 60 Tage alt. | 
-|cardholderAccountInfo.passwordChangeIndicator |String | Gibt an, wann das Passwort des Kundenkontos zuletzt geändert oder zurückgesetzt wurde. Mögliche Werte: "never" - Kunde hat nie sein Passwort geändert, "now" - Kunde hat während des aktuellen Einkaufs sein Passwort geändert, "less30" - Passwort wurde vor weniger als 30 Tagen geändert, "more30less60" - Passwort wurde vor mindestens 30 aber weniger als 60 Tagen geändert, "more60" - Passwort wurde seit mindestens 60 Tagen nicht geändert. | +|cardholderAccountInfo.passwordChangeIndicator |String(12) | Gibt an, wann das Passwort des Kundenkontos zuletzt geändert oder zurückgesetzt wurde. Mögliche Werte: "never" - Kunde hat nie sein Passwort geändert, "now" - Kunde hat während des aktuellen Einkaufs sein Passwort geändert, "less30" - Passwort wurde vor weniger als 30 Tagen geändert, "more30less60" - Passwort wurde vor mindestens 30 aber weniger als 60 Tagen geändert, "more60" - Passwort wurde seit mindestens 60 Tagen nicht geändert. | 
-|cardholderAccountInfo.paymentAccountAgeIndicator |String | Gibt an, wann das Zahlungskonto des Kunden angelegt wurde. Mögliche Werte: "never" - Kunde hat kein Zahlungskonto, kauft z.B. als Gast ein, "now" - Kunde hat das Zahlungskonto während des aktuellen Einkaufs angelegt, "less30" - Zahlungskonto wurde vor weniger als 30 Tagen angelegt, "more30less60" - Zahlungskonto wurde vor mindestens 30 aber weniger als 60 Tagen angelegt, "more60" - Zahlungskonto wurde vor mindestens 60 Tagen angelegt. | +|cardholderAccountInfo.paymentAccountAgeIndicator |String(12) | Gibt an, wann das Zahlungskonto des Kunden angelegt wurde. Mögliche Werte: "never" - Kunde hat kein Zahlungskonto, kauft z.B. als Gast ein, "now" - Kunde hat das Zahlungskonto während des aktuellen Einkaufs angelegt, "less30" - Zahlungskonto wurde vor weniger als 30 Tagen angelegt, "more30less60" - Zahlungskonto wurde vor mindestens 30 aber weniger als 60 Tagen angelegt, "more60" - Zahlungskonto wurde vor mindestens 60 Tagen angelegt. | 
-|cardholderAccountInfo.accountChange |String | Gibt an, wann das Kundenkonto im Shop zuletzt geändert wurde, z.B. Adressänderung oder neue Zahlungsdaten. Mögliche Werte: "now" - Kunde hat während des aktuellen Einkaufs sein Konto geändert, "less30" - Konto wurde vor weniger als 30 Tagen geändert, "more30less60" - Konto wurde vor mindestens 30 aber weniger als 60 Tagen geändert, "more60" - Kundenkonto wurde seit mindestens 60 Tagen nicht geändert. | +|cardholderAccountInfo.accountChange |String(12) | Gibt an, wann das Kundenkonto im Shop zuletzt geändert wurde, z.B. Adressänderung oder neue Zahlungsdaten. Mögliche Werte: "now" - Kunde hat während des aktuellen Einkaufs sein Konto geändert, "less30" - Konto wurde vor weniger als 30 Tagen geändert, "more30less60" - Konto wurde vor mindestens 30 aber weniger als 60 Tagen geändert, "more60" - Kundenkonto wurde seit mindestens 60 Tagen nicht geändert. | 
-|cardholderAccountInfo.shippingAddressAgeIndicator |String | Gibt an, wann der Kunde die aktuelle Lieferadresse zum ersten Mal benutzt hat. Mögliche Werte: "now" - Kunde benutzt die Lieferadresse zum ersten Mal, "less30" - Lieferadresse wurde vor weniger als 30 Tagen zum ersten Mal benutzt, "more30less60" - Lieferadresse wurde vor mindestens 30 aber weniger als 60 Tagen zuerst benutzt, "more60" - Lieferadresse wurde vor mindestens 60 Tagen zuerst benutzt. | +|cardholderAccountInfo.shippingAddressAgeIndicator |String(12) | Gibt an, wann der Kunde die aktuelle Lieferadresse zum ersten Mal benutzt hat. Mögliche Werte: "now" - Kunde benutzt die Lieferadresse zum ersten Mal, "less30" - Lieferadresse wurde vor weniger als 30 Tagen zum ersten Mal benutzt, "more30less60" - Lieferadresse wurde vor mindestens 30 aber weniger als 60 Tagen zuerst benutzt, "more60" - Lieferadresse wurde vor mindestens 60 Tagen zuerst benutzt. | 
-|cardholderAccountInfo.shippingNameIndicator |String | Gibt an, ob der Name des Karteninhabers und der Name der Lieferadresse identisch sind. Mögliche Werte: "identical" - Namen sind identisch, "different" - Namen sind unterschiedlich. |+|cardholderAccountInfo.shippingNameIndicator |String(9) | Gibt an, ob der Name des Karteninhabers und der Name der Lieferadresse identisch sind. Mögliche Werte: "identical" - Namen sind identisch, "different" - Namen sind unterschiedlich. |
 |cardholderAccountInfo.suspiciousAccountActivity |Boolean | Gibt an, ob für diesen Kunden verdächtige Aktivitäten beobachtet wurden. Mögliche Werte: "false" - nein, "true" - ja. | |cardholderAccountInfo.suspiciousAccountActivity |Boolean | Gibt an, ob für diesen Kunden verdächtige Aktivitäten beobachtet wurden. Mögliche Werte: "false" - nein, "true" - ja. |
 |cardholderAccountInfo.provisioningDayCount |Integer | Anzahl der "Karte hinzufügen" Versuche in den letzten 24 Stunden. Format 0-9, max. 3. | |cardholderAccountInfo.provisioningDayCount |Integer | Anzahl der "Karte hinzufügen" Versuche in den letzten 24 Stunden. Format 0-9, max. 3. |
 ^**//tdsMerchantRiskIndicators//**  ^^^ ^**//tdsMerchantRiskIndicators//**  ^^^
-|tdsMerchantRiskIndicators.deliveryTimeframe |String | Zeitraum, in dem die Ware an den Kunden geliefert wird. Mögliche Werte: "electronic" - sofortige elektronische Lieferung, "moreThanOneDay" - mehr als ein Tag, "overnight" - über Nacht, "sameDay" - am selben Tag. | +|tdsMerchantRiskIndicators.deliveryTimeframe |String(4) | Zeitraum, in dem die Ware an den Kunden geliefert wird. Mögliche Werte: "electronic" - sofortige elektronische Lieferung, "moreThanOneDay" - mehr als ein Tag, "overnight" - über Nacht, "sameDay" - am selben Tag. | 
-|tdsMerchantRiskIndicators.deliveryEmailAddress |String | Liefer-E-Mail-Adresse des Kunden im Fall einer elektronischen Lieferung. Format A-Z, a-z, 0-9, [_.+-@], max. 254. |+|tdsMerchantRiskIndicators.deliveryEmailAddress |String(254) | Liefer-E-Mail-Adresse des Kunden im Fall einer elektronischen Lieferung. Format A-Z, a-z, 0-9, [_.+-@], max. 254. |
 |tdsMerchantRiskIndicators.giftCardAmount |Integer | Betrag der Geschenkkarte in größter Währungseinheit, z.B. 123 bei 123,45 EUR. Format 0-9, max. 10. | |tdsMerchantRiskIndicators.giftCardAmount |Integer | Betrag der Geschenkkarte in größter Währungseinheit, z.B. 123 bei 123,45 EUR. Format 0-9, max. 10. |
 |tdsMerchantRiskIndicators.giftCardCount |Integer | Anzahl der gekauften Geschenkkarten. Format 0-9, max. 2. | |tdsMerchantRiskIndicators.giftCardCount |Integer | Anzahl der gekauften Geschenkkarten. Format 0-9, max. 2. |
 |tdsMerchantRiskIndicators.giftCardCurrency |Integer | Währungscode der Geschenkkarte gemäß ISO 4217. Format A-Z, max. 3. | |tdsMerchantRiskIndicators.giftCardCurrency |Integer | Währungscode der Geschenkkarte gemäß ISO 4217. Format A-Z, max. 3. |
 |tdsMerchantRiskIndicators.preOrderDate |Date | Im Fall einer Vorbestellung: Datum, an dem die Ware voraussichtlich verfügbar ist. Format JJJJ-MM-TT. | |tdsMerchantRiskIndicators.preOrderDate |Date | Im Fall einer Vorbestellung: Datum, an dem die Ware voraussichtlich verfügbar ist. Format JJJJ-MM-TT. |
-|tdsMerchantRiskIndicators.preOrderPurchaseIndicator |String | Mögliche Werte: "available" - die Ware ist bereits verfügbar, "future" - die Ware ist erst in der Zukunft verfügbar. | +|tdsMerchantRiskIndicators.preOrderPurchaseIndicator |String(9) | Mögliche Werte: "available" - die Ware ist bereits verfügbar, "future" - die Ware ist erst in der Zukunft verfügbar. | 
-|tdsMerchantRiskIndicators.reorderItemsIndicator |String | Gibt an, ob der Kunde Artikel bereits zuvor bestellt hat. Mögliche Werte: "first" - erste Bestellung, "reordered" - erneute Bestellung. | +|tdsMerchantRiskIndicators.reorderItemsIndicator |String(9) | Gibt an, ob der Kunde Artikel bereits zuvor bestellt hat. Mögliche Werte: "first" - erste Bestellung, "reordered" - erneute Bestellung. | 
-|tdsMerchantRiskIndicators.shippingIndicator |String | Gibt an, wohin die Ware geliefert wird. Mögliche Werte: "digital" - digitale Lieferung, "billingAddress" - an die Rechnungsadresse, "differentAddress" - an eine andere Adresse, "verifiedAddress" - an eine geprüfte Adresse, "store" - in ein Geschäft, "other" - sonstiges. |+|tdsMerchantRiskIndicators.shippingIndicator |String(16) | Gibt an, wohin die Ware geliefert wird. Mögliche Werte: "digital" - digitale Lieferung, "billingAddress" - an die Rechnungsadresse, "differentAddress" - an eine andere Adresse, "verifiedAddress" - an eine geprüfte Adresse, "store" - in ein Geschäft, "other" - sonstiges. |
 ^**//tdsRequestorAuthenticationInformation//**  ^^^ ^**//tdsRequestorAuthenticationInformation//**  ^^^
-|tdsRequestorAuthenticationInformation.authenticationData |String | Authentifizierungsdaten des Kunden. Format A-Z, a-z, 0-9 [!"#$%$'()*+,./:;<=>?@[\]%%^%%`{%%|%%}~-], max. 2048 |+|tdsRequestorAuthenticationInformation.authenticationData |String(2048) | Authentifizierungsdaten des Kunden. Format A-Z, a-z, 0-9 [!"#$%$'()*+,./:;<=>?@[\]%%^%%`{%%|%%}~-], max. 2048 |
 |tdsRequestorAuthenticationInformation.authenticationTimestamp |DateTime | Datum und Uhrzeit, wann sich der Kunde im Shop authentifiziert hat. Format JJJJ-MM-TTTHH:mm:ss | |tdsRequestorAuthenticationInformation.authenticationTimestamp |DateTime | Datum und Uhrzeit, wann sich der Kunde im Shop authentifiziert hat. Format JJJJ-MM-TTTHH:mm:ss |
-|tdsRequestorAuthenticationInformation.authenticationMethod |String | Gibt an, wie sich der Kunde in Ihrem Shop authentifiziert hat. Mögliche Werte: "none" - gar nicht, z.B. Kunde kauft als Gast ein, "ownCredentials" - Kunde ist mit seinen Daten, z.B. Login-Name und Passwort angemeldet, "federatedId" - föderierte Identität, "issuerCredentials", "thirdParty", "fido", "fidoSigned", "srcAssurance". |+|tdsRequestorAuthenticationInformation.authenticationMethod |String(17) | Gibt an, wie sich der Kunde in Ihrem Shop authentifiziert hat. Mögliche Werte: "none" - gar nicht, z.B. Kunde kauft als Gast ein, "ownCredentials" - Kunde ist mit seinen Daten, z.B. Login-Name und Passwort angemeldet, "federatedId" - föderierte Identität, "issuerCredentials", "thirdParty", "fido", "fidoSigned", "srcAssurance". |
 ^**//tdsTransactionAttributes//**  ^^^ ^**//tdsTransactionAttributes//**  ^^^
 |tdsTransactionAttributes.purchaseInstalmentData |Integer | Maximal erlaubte Anzahl von Autorisierungen bei Ratenzahlungen. Format 0-9, max. 3, Wert muss > 1 sein. | |tdsTransactionAttributes.purchaseInstalmentData |Integer | Maximal erlaubte Anzahl von Autorisierungen bei Ratenzahlungen. Format 0-9, max. 3, Wert muss > 1 sein. |
 |tdsTransactionAttributes.recurringExpiry |Date | Datum, nach dem keine weiteren Autorisierungen mehr stattfinden sollen. Format JJJJ-MM-TT. | |tdsTransactionAttributes.recurringExpiry |Date | Datum, nach dem keine weiteren Autorisierungen mehr stattfinden sollen. Format JJJJ-MM-TT. |
 |tdsTransactionAttributes.recurringFrequency |Integer | Minimale Anzahl von Tagen zwischen zwei Autorisierungen. Format 0-9, max. 4. | |tdsTransactionAttributes.recurringFrequency |Integer | Minimale Anzahl von Tagen zwischen zwei Autorisierungen. Format 0-9, max. 4. |
-|tdsTransactionAttributes.type |String | Art der 3-D Secure 2.0 Zahlung. Mögliche Werte: "purchase" - Einkauf, "checkAcceptance", "accountFunding", "quasiCash", "prepaidActivation". |+|tdsTransactionAttributes.type |String(17) | Art der 3-D Secure 2.0 Zahlung. Mögliche Werte: "purchase" - Einkauf, "checkAcceptance", "accountFunding", "quasiCash", "prepaidActivation". |
  
 == Beispiel eines tds2Optional-Strings (zu Demonstrationszwecken formatiert, sollte normalerweise in einer Zeile angegeben werden) == == Beispiel eines tds2Optional-Strings (zu Demonstrationszwecken formatiert, sollte normalerweise in einer Zeile angegeben werden) ==
Zeile 382: Zeile 382:
 ^Name           ^Pflicht  ^Type      ^Beschreibung   ^ ^Name           ^Pflicht  ^Type      ^Beschreibung   ^
 |rc             |Ja       |Integer   |[[girocheckout:errorcodes|Fehlernummer]] | |rc             |Ja       |Integer   |[[girocheckout:errorcodes|Fehlernummer]] |
-|msg            |Ja       |String    |zusätzliche Informationen im Fehlerfall | +|msg            |Ja       |String(255)    |zusätzliche Informationen im Fehlerfall | 
-|reference      |Optional |String    |eindeutige Payment Page ID | +|reference      |Optional |String(36)    |eindeutige Payment Page ID | 
-|url            |Optional |String    |URL zur Payment Page, an die der Kunde weitergeleitet werden muss.| +|url            |Optional |String(255)    |URL zur Payment Page, an die der Kunde weitergeleitet werden muss.| 
-|qrcode         |Optional |String    |Base64-codierter String, der eine PNG-Datei mit dem QR-Code der URL (s. vorheriges Feld) enthält. Dieses Feld ist nur vorhanden, wenn bei der Initialisierung der Parameter "qrcodeReturn" angegeben wurde.  Die Größe des QR-Codes wird dabei durch den dort angegebenen numerischen Wert zwischen 1-20 bestimmt. |+|qrcode         |Optional |String(255)    |Base64-codierter String, der eine PNG-Datei mit dem QR-Code der URL (s. vorheriges Feld) enthält. Dieses Feld ist nur vorhanden, wenn bei der Initialisierung der Parameter "qrcodeReturn" angegeben wurde.  Die Größe des QR-Codes wird dabei durch den dort angegebenen numerischen Wert zwischen 1-20 bestimmt. |
 ^HEADER Parameter^^^^ ^HEADER Parameter^^^^
-|hash           |Ja       |String    |HMAC MD5 hash über alle Werte der Rückmeldung. Siehe [[girocheckout:general:start#uebermittlung_von_daten_ueber_einen_schnittstellenaufruf_an_den_haendler|hash der Rückantwort]] |+|hash           |Ja       |String(32)    |HMAC MD5 hash über alle Werte der Rückmeldung. Siehe [[girocheckout:general:start#uebermittlung_von_daten_ueber_einen_schnittstellenaufruf_an_den_haendler|hash der Rückantwort]] |
  
 == Beispiel im Erfolgsfall == == Beispiel im Erfolgsfall ==
Zeile 399: Zeile 399:
  
 ^Name           ^Pflicht        ^Type        ^Beschreibung   ^ ^Name           ^Pflicht        ^Type        ^Beschreibung   ^
-|name           |Ja             |String      | Artikelname | +|name           |Ja             |String(100)      | Artikelname | 
-|ean            |Optional       |String      | Die Internationale Artikel Nummer (EAN bzw. GTIN) | +|ean            |Optional       |String(100)      | Die Internationale Artikel Nummer (EAN bzw. GTIN) | 
-|quantity       |Ja             |Dezimal     | Menge des Artikels (Ganzzahl) |+|quantity       |Ja             |Integer     | Menge des Artikels (Ganzzahl) |
 |grossAmount    |Optional       |Integer     | 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 | |grossAmount    |Optional       |Integer     | 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 |
  
Zeile 437: Zeile 437:
 ^Name             ^Pflicht    ^  Typ        ^Beschreibung   ^ ^Name             ^Pflicht    ^  Typ        ^Beschreibung   ^
 |gcPaymethod      |Ja       |Integer     | ID der Zahlungsart der Transaktion, s. [[girocheckout:paypage:start#unterstuetzte_zahlungsarten|Zahlungsarten]] | |gcPaymethod      |Ja       |Integer     | ID der Zahlungsart der Transaktion, s. [[girocheckout:paypage:start#unterstuetzte_zahlungsarten|Zahlungsarten]] |
-|gcType           |Ja       |String      | Transaktionsart: \\ SALE \\ AUTH | +|gcType           |Ja       |String(4)      | Transaktionsart: \\ SALE \\ AUTH | 
-|gcProjectId      |Ja       |String      | GiroCheckout Projekt-Id, über die die Transaktion abgewickelt wurde. | +|gcProjectId      |Ja       |String(10)     | GiroCheckout Projekt-Id, über die die Transaktion abgewickelt wurde. | 
-|gcReference      |Ja       |String      | GiroCheckout Transaktions-ID | +|gcReference      |Ja       |String(36)      | GiroCheckout Transaktions-ID | 
-|gcMerchantTxId   |Ja       |String      | Händler Transaktions-ID | +|gcMerchantTxId   |Ja       |String(255)      | Händler Transaktions-ID | 
-|gcBackendTxId    |Ja       |String      | Zahlungsabwickler Transaktions-ID |+|gcBackendTxId    |Ja       |String(36)      | Zahlungsabwickler Transaktions-ID |
 |gcAmount         |Ja       |Integer     | bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny | |gcAmount         |Ja       |Integer     | bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny |
-|gcCurrency       |Ja       |String      | Währung |+|gcCurrency       |Ja       |String(3)      | Währung |
 |gcResultPayment  |Ja       |Integer     | [[girocheckout:resultcodes#zahlungsausgang|Ergebniscodes der Zahlung]]| |gcResultPayment  |Ja       |Integer     | [[girocheckout:resultcodes#zahlungsausgang|Ergebniscodes der Zahlung]]|
-|gcPkn            |Optional |String      | Pseudokartennummer, wenn pkn aktiv | +|gcPkn            |Optional |String(50)      | Pseudokartennummer, wenn pkn aktiv | 
-|gcCardnumber     |Optional |String      | Maskierte Kreditkartennummer, wenn pkn aktiv | +|gcCardnumber     |Optional |String(19)      | Maskierte Kreditkartennummer, wenn pkn aktiv | 
-|gcCardExpDate    |Optional |String      | Gültigkeitsdatum der Kreditkarte im Format Monat/Jahr, wenn pkn aktiv | +|gcCardExpDate    |Optional |String(8)      | Gültigkeitsdatum der Kreditkarte im Format Monat/Jahr, wenn pkn aktiv | 
-|gcAccountHolder  |Optional |String      | Kontoinhaber bei Lastschrift, wenn pkn aktiv | +|gcAccountHolder  |Optional |String(255)      | Kontoinhaber bei Lastschrift, wenn pkn aktiv | 
-|gcIban           |Optional |String      | IBAN bei Lastschrift, wenn pkn aktiv | +|gcIban           |Optional |String(36)      | IBAN bei Lastschrift, wenn pkn aktiv | 
-|gcHash           |Ja       |String      | HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |+|gcHash           |Ja       |String(32)      | HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
  
 === Redirect === === Redirect ===
Zeile 516: Zeile 516:
 |currency       |Ja       |String(3)   |Währung der Transaktion, gemäß [[http://de.wikipedia.org/wiki/ISO_4217#Aktuell_g.C3.BCltige_W.C3.A4hrungen|ISO 4217]].\\ EUR = Euro | |currency       |Ja       |String(3)   |Währung der Transaktion, gemäß [[http://de.wikipedia.org/wiki/ISO_4217#Aktuell_g.C3.BCltige_W.C3.A4hrungen|ISO 4217]].\\ EUR = Euro |
 |purpose        |Optional |String(27)  |Verwendungszweck der Erstattung oder des Capture. Diese Information erscheint auf der Kreditkartenabrechnung. | |purpose        |Optional |String(27)  |Verwendungszweck der Erstattung oder des Capture. Diese Information erscheint auf der Kreditkartenabrechnung. |
-|reference      |Ja       |String      |GiroCheckout Transaktions-ID der Payment-Page-Transaktion, für die eine Buchung oder Erstattung durchgeführt werden soll. | +|reference      |Ja       |String(36)      |GiroCheckout Transaktions-ID der Payment-Page-Transaktion, für die eine Buchung oder Erstattung durchgeführt werden soll. | 
-|txreference    |Optional |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. | +|txreference    |Optional |String(36)      |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. | 
-|hash           |Ja       |String      |HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |+|hash           |Ja       |String(32)      |HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
  
 == Beispiel == == Beispiel ==
Zeile 529: Zeile 529:
 ^Name             ^Pflicht  ^Type        ^Beschreibung   ^ ^Name             ^Pflicht  ^Type        ^Beschreibung   ^
 |rc             |Ja       |Integer   |[[girocheckout:errorcodes|Fehlernummer]] | |rc             |Ja       |Integer   |[[girocheckout:errorcodes|Fehlernummer]] |
-|msg            |Ja       |String    |zusätzliche Informationen im Fehlerfall | +|msg            |Ja       |String(255)    |zusätzliche Informationen im Fehlerfall | 
-|reference      |Ja       |String      | GiroCheckout Transaktions-ID | +|reference      |Ja       |String(36)      | GiroCheckout Transaktions-ID | 
-|referenceParent      |Ja       |String      | GiroCheckout Transaktions-ID der zugrundeliegenden Ursprungstransaktion | +|referenceParent      |Ja       |String(36)      | GiroCheckout Transaktions-ID der zugrundeliegenden Ursprungstransaktion | 
-|merchantTxId   |Ja       |String      | Händler Transaktions-ID | +|merchantTxId   |Ja       |String(255)      | Händler Transaktions-ID | 
-|backendTxId    |Ja       |String      | Zahlungsabwickler Transaktions-ID |+|backendTxId    |Ja       |String(36)      | Zahlungsabwickler Transaktions-ID |
 |amount         |Ja       |Integer     | bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny | |amount         |Ja       |Integer     | bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny |
-|currency       |Ja       |String      | Währung |+|currency       |Ja       |String(3)      | Währung |
 |resultPayment  |Ja       |Integer     | [[girocheckout:resultcodes#zahlungsausgang|Ergebnis der Transaktion]]| |resultPayment  |Ja       |Integer     | [[girocheckout:resultcodes#zahlungsausgang|Ergebnis der Transaktion]]|
-|hash           |Ja       |String      | HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |+|hash           |Ja       |String(32)      | HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
  
 == Beispiel im Erfolgsfall == == Beispiel im Erfolgsfall ==
girocheckout/paypage/start.txt · Zuletzt geändert: 2023/05/08 04:11

Seiten-Werkzeuge