Integration
Grundlagen
FAQ
eps
giropay
iDEAL
Kreditkarte
Lastschrift
Bluecode
Maestro
Payment Page
PayPal
Tools
Fehlernummern
Ergebniscode
Testdaten
Seitenleiste
de
engirocheckout:giropay-overview:start
Inhaltsverzeichnis
giropay
Durch die Fusion von giropay mit paydirekt, erfährt die giropay-Schnittstelle derzeit diverse Änderungen. Auf dieser Seite erhalten Sie alle notwendigen Informationen hierzu, die Ihnen dabei helfen werden, einzuschätzen, ob Sie auf Ihrer Seite Anpassungen machen müssen und wenn dann welche.
Links zu Schnittstellenbeschreibungen
- Sie finden die Dokumentation zur aktuellen/neuen Schnittstelle hier: Neue Schnittstellenbeschreibung
- Die alte Dokumentation zur bisherigen giropay-Schnittstelle befindet sich hier: Alte Schnittstellenbeschreibung
- Eine Übersicht der Unterschiede zwischen alter und neue Schnittstelle finden Sie hier: Unterschiede und Gemeinsamkeiten der beiden Schnittstellen
Migrationsleitfaden
Wir beschreiben Ihnen im Folgenden, was Sie beachten müssen, wenn Sie Ihr System für das neue giropay fit machen wollen.
Wählen Sie dazu Ihren Themenbereich:
Was ändert sich an der GiroCheckout-API für giropay?
Änderungen an den Feldern
- Die Felder bic, iban und Infofelder (info1Label, info1Text usw.) stehen nicht mehr zur Verfügung.
Die notwendigen Informationen zur Bank werden direkt auf giropay- bzw. Bankseite abgefragt und nicht mehr bei der Initialisierung mitgesendet. Entfernen Sie bitte diese Felder aus Ihrer Anfrage, falls Sie sie aktuell noch verwenden. - Warenkorbinformationen können optional im Feld cart mitgegeben werden.
shoppingCartType
- Der shoppingCartType sollte bei einer giropay Transaktion mitgeliefert werden.
- Das Feld ist optional, hat allerdings Auswirkungen auf weitere Felder der Schnittstelle.
- Mögliche Werte:
- PHYSICAL = Alle Waren im Warenkorb sind physischer Natur: shippingAddresseFirstName, shippingAddresseLastName, shippingZipCode, shippingCity und shippingCountry sind Pflicht.
Alle anderen Felder können optional mitgegeben werden (siehe API-Dokumentation). - DIGITAL = Alle Waren im Warenkorb sind digitaler Natur (benötigen also keinen Versand): Vorname, Nachname und E-Mail Adresse sind Pflicht.
Alle anderen Felder können optional mitgegeben werden (siehe API-Dokumentation). - MIXED = Der Warenkorb enthält sowohl physische als auch digitale Waren (dies ist der Default-Wert, wenn der Parameter nicht angegeben wird): shippingAddresseFirstName, shippingAddresseLastName, shippingZipCode, shippingCity und shippingCountry sind Pflicht.
Alle anderen Felder können optional mitgegeben werden (siehe API-Dokumentation). - ANONYMOUS_DONATION = Es handelt sich um eine anonyme Spende: Hier sind keine Adressdaten notwendig.
Alle anderen Felder können optional mitgegeben werden (siehe API-Dokumentation). - AUTHORITIES_PAYMENT = Es handelt sich um eine Behördenzahlung: Hier sind keine Adressdaten notwendig.
Alle anderen Felder können optional mitgegeben werden (siehe API-Dokumentation).
Anbindung über ein SDK
Die SDKs (PHP, Java, .NET) befinden sich bereits auf dem aktuellen Stand und unterstützen das neue giropay. Sie finden die Dokumentationen dazu unter:
Kommunale Kunden: Was ist bei Behördenzahlungen zu beachten?
Zusammenfassung
Transaktionen mit dem shoppingCartType „AUTHORITIES_PAYMENT“ (Behördenzahlungen) müssen keine weiteren Pflichtfelder übergeben.
Kommunale Kunden: Was ist bei Anbindung über die Payment Page bei Behördenzahlungen zu beachten?
Zusammenfassung
Transaktionen mit dem shoppingCartType „AUTHORITIES_PAYMENT“ (Behördenzahlungen) von kommunalen Kunden, müssen keine weiteren Pflichtfelder mit übergeben.
Händler-Kunden: Was ist bei einer Anbindung über die neue API-Schnittstelle zu beachten?
Änderungen an den Feldern
- Die Felder bic, iban und Infofelder (info1Label, info1Text usw.) stehen nicht mehr zur Verfügung.
Die notwendigen Informationen zur Bank werden direkt auf giropay- bzw. Bankseite abgefragt und nicht mehr bei der Initialisierung mitgesendet. Entfernen Sie bitte diese Felder aus Ihrer Anfrage, falls Sie sie aktuell noch verwenden. - Warenkorbinformationen können optional im Feld cart mitgegeben werden.
shoppingCartType
- Der shoppingCartType sollte bei einer giropay Transaktion mitgeliefert werden.
- Das Feld ist optional, hat allerdings Auswirkungen auf weitere Felder der Schnittstelle.
- Mögliche Werte:
- PHYSICAL = Alle Waren im Warenkorb sind physischer Natur: shippingAddresseFirstName, shippingAddresseLastName, shippingZipCode, shippingCity und shippingCountry sind Pflicht.
Alle anderen Felder können optional mitgegeben werden (siehe API-Dokumentation). - DIGITAL = Alle Waren im Warenkorb sind digitaler Natur (benötigen also keinen Versand): Vorname, Nachname und E-Mail Adresse sind Pflicht.
Alle anderen Felder können optional mitgegeben werden (siehe API-Dokumentation). - MIXED = Der Warenkorb enthält sowohl physische als auch digitale Waren (dies ist der Default-Wert, wenn der Parameter nicht angegeben wird): shippingAddresseFirstName, shippingAddresseLastName, shippingZipCode, shippingCity und shippingCountry sind Pflicht.
Alle anderen Felder können optional mitgegeben werden (siehe API-Dokumentation). - ANONYMOUS_DONATION = Es handelt sich um eine anonyme Spende: Hier sind keine Adressdaten notwendig.
Alle anderen Felder können optional mitgegeben werden (siehe API-Dokumentation). - AUTHORITIES_PAYMENT = Es handelt sich um eine Behördenzahlung: Hier sind keine Adressdaten notwendig.
Alle anderen Felder können optional mitgegeben werden (siehe API-Dokumentation).
Händler-Kunden: Was ist bei einer Anbindung über die Payment Page zu beachten?
Zusammenfassung
Es sind in diesem Falle keine Besonderheite zu beachten.
Vergleich alte und neue Schnittstelle
An overview of the mappings between the APIs
| GiroCheckout giropay | GiroCheckout Payment Page | Mandatory | Comment |
|---|---|---|---|
| merchantId (8) | merchantId (8) | Yes | GiroCheckout authentication |
| projectId (8) | projectId (8) | Yes | GiroCheckout authentication |
| merchantTxId (255) | merchantTxId (255) | Yes | |
| amount (7) | amount (7) | Yes | Amount in cents |
| currency (3) | currency (3) | Yes | Only EUR allowed |
| purpose (27) | purpose (50) | Yes | Same as before, 27 characters for giropay |
| shoppingCartType | shoppingCartType | Optional | Type of the shopping cart. The following values are allowed: PHYSICAL = All goods in the cart are of a physical nature, DIGITAL = All goods in the cart are of a digital nature (require no shipping), MIXED = The cart contains both physical and digital goods (this is the default value should the parameter not be given), ANONYMOUS_DONATION = This is an anonymous donation and not a commercial transaction (no address data necessary), AUTHORITIES_PAYMENT = This is a payment for local authorities (no address data necessary). |
| shippingAddresseFirstName(100) | paydirektShippingFirstName (100) | Yes / Optional | First name of shipping address, mandatory for shoppingCartTypes PHYSICAL, DIGITAL and MIXED, optional for ANONYMOUS_DONATION and AUTHORITIES_PAYMENT. |
| shippingAddresseLastName (100) | paydirektShippingLastName (100) | Yes / Optional | Last name of shipping address, mandatory for shoppingCartTypes PHYSICAL, DIGITAL and MIXED, optional for ANONYMOUS_DONATION and AUTHORITIES_PAYMENT. |
| shippingCompany (100) | paydirektShippingCompany (100) | Optional | Company name |
| shippingAdditionalAddressInformation (100) | paydirektShippingAdditionalAddressInformation (100) | Optional | Additional address info |
| shippingStreet (100) | paydirektShippingStreet (100 | Optional | Street |
| shippingStreetNumber (100) | paydirektShippingStreetNumber (100) | Optional | House number |
| shippingZipCode (10) | paydirektShippingZipCode (10) | Yes / Optional | Postal code of the shipping address. Mandatory for shoppingCartTypes PHYSICAL and MIXED, optional for DIGITAL, ANONYMOUS_DONATION and AUTHORITIES_PAYMENT. |
| shippingCity (100) | paydirektShippingCity (100) | Yes / Optional | City of the shipping address. Mandatory for shoppingCartTypes PHYSICAL and MIXED, optional for DIGITAL, ANONYMOUS_DONATION and AUTHORITIES_PAYMENT. |
| shippingCountry (2) | paydirektShippingCountry (2) | Yes / Optional | 2-letter country code (ISO 3166-1). Mandatory for shoppingCartTypes PHYSICAL and MIXED, optional for DIGITAL, ANONYMOUS_DONATION and AUTHORITIES_PAYMENT. |
| shippingEmail (255) | paydirektShippingEmail (255) | Yes / Optional | Email address of the buyer. Mandatory for shoppingCartType DIGITAL, optional for all others. |
| merchantReconciliationReferenceNumber (30) | merchantReconciliationReferenceNumber (30) | Optional (30) | Additional information for the payment settlement that is displayed in the purpose of the bank statement. |
| cart | cart | Optional | Shopping cart |
| deliveryType | deliveryType | Optional | The destination of a shipment. The default value is STANDARD. STANDARD: The goods are delivered to an ordinary postal address.PACKSTATION: The goods are delivered to a self-service parcel terminal. STORE_PICKUP: The goods are collected from the store. |
| bic (8-11) | Optional | No longer supported | |
| iban (12-32) | Optional | No longer supported | |
| info1Label (30) | Optional | No longer supported | |
| info1Text (80) | Optional | No longer supported | |
| info2Label (30) | Optional | No longer supported | |
| info2Text (80) | Optional | No longer supported | |
| info3Label (30) | Optional | No longer supported | |
| info3Text (80) | Optional | No longer supported | |
| info4Label (30) | Optional | No longer supported | |
| info4Text (80) | Optional | No longer supported | |
| info5Label (30) | Optional | No longer supported | |
| info5Text (80) | Optional | No longer supported | |
| urlRedirect | Yes | Redirect to the integrator | |
| urlNotify | Yes | Notification to the integrator | |
| hash | Yes | GiroCheckout authentication |
Settlement
FAQ
Die aktuelle Version unserer häufig gestellten Fragen (FAQ) und deren Antworten, steht Ihnen auf Deutsch sowie auf Englisch unter den unten aufgeführten Links zur Verfügung.
girocheckout/giropay-overview/start.txt · Zuletzt geändert: 2022/08/30 04:48