Benutzer-Werkzeuge

Webseiten-Werkzeuge


girocheckout:paypage:start

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

Link zu dieser Vergleichsansicht

girocheckout:paypage:start [2020/05/07 19:07]
michaelheumann [Benachrichtigung über den Transaktionsausgang]
girocheckout:paypage:start [2020/11/18 09:24] (aktuell)
thorstenmarx [Unterstützte Zahlungsarten]
Zeile 22: Zeile 22:
 | Lastschrift | 6 | | Lastschrift | 6 |
 | Lastschrift mit Sperrdatei | 7 | | Lastschrift mit Sperrdatei | 7 |
-| Garantierte Lastschrift | 8 | 
 | Bluecode | 26 | | Bluecode | 26 |
 | Maestro | 33 | | Maestro | 33 |
Zeile 121: Zeile 120:
 |projectId ​     |Ja  |Integer ​    ​|Projekt-ID eines Paypage-Projekts | |projectId ​     |Ja  |Integer ​    ​|Projekt-ID eines Paypage-Projekts |
 |merchantTxId ​  ​|Ja ​ |String(255) |Eindeutige Transaktions-ID des Händlers | |merchantTxId ​  ​|Ja ​ |String(255) |Eindeutige Transaktions-ID des Händlers |
-|amount ​        ​|Optional ​ |Integer ​    |Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny. ​ Dieser Parameter ist PFLICHT, außer es handelt sich um eine Spendenpage mit freier Betragseingabe oder mit mindestens einem fest vorgegebenen Betrag (also optional wenn pagetype == 2 und (freeamount=1 oder fixedvalues nicht leer)). |+|amount ​        ​|Optional ​ |Integer ​    |Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny, also ohne Nachkommastellen.  Dieser Parameter ist PFLICHT, außer es handelt sich um eine Spendenpage mit freier Betragseingabe oder mit mindestens einem fest vorgegebenen Betrag (also optional wenn pagetype == 2 und (freeamount=1 oder fixedvalues nicht leer)). |
 |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 ​       |Ja  |String(27) ​ |Verwendungszweck der Transaktion. Diese Information erscheint auf der Kartenabrechnung bzw. dem Kontoauszug. Es sind nur SEPA-konforme Zeichen zulässig (s. [[girocheckout:​paypage:​start#​sepa-konforme_zeichen|SEPA-konforme Zeichen]]). Wenn pagetype=2 und projectlist nicht leer,  kann der Platzhalter {SPENDENPROJEKT} verwendet werden, der dann mit dem Namen des vom Kunden gewählten Projekts gefüllt wird. \\ Der Inhalt dieses Feldes (erste 20 Zeichen) wird auch verwendet, um die orderid bei der Zahlungsart Paydirekt zu befüllen, wenn diese nicht explizit angegeben ist (s. Parameter orderid). | |purpose ​       |Ja  |String(27) ​ |Verwendungszweck der Transaktion. Diese Information erscheint auf der Kartenabrechnung bzw. dem Kontoauszug. Es sind nur SEPA-konforme Zeichen zulässig (s. [[girocheckout:​paypage:​start#​sepa-konforme_zeichen|SEPA-konforme Zeichen]]). Wenn pagetype=2 und projectlist nicht leer,  kann der Platzhalter {SPENDENPROJEKT} verwendet werden, der dann mit dem Namen des vom Kunden gewählten Projekts gefüllt wird. \\ Der Inhalt dieses Feldes (erste 20 Zeichen) wird auch verwendet, um die orderid bei der Zahlungsart Paydirekt zu befüllen, wenn diese nicht explizit angegeben ist (s. Parameter orderid). |
 |description ​   |Optional |String(120) ​  ​|Beschreibung für die Bezahlung. Wird nur auf der Payment Page angezeigt. Zulässige Zeichen s. [[girocheckout:​paypage:​start#​zulässige_beschreibungszeichen|Zulässige Beschreibungszeichen]] | |description ​   |Optional |String(120) ​  ​|Beschreibung für die Bezahlung. Wird nur auf der Payment Page angezeigt. Zulässige Zeichen s. [[girocheckout:​paypage:​start#​zulässige_beschreibungszeichen|Zulässige Beschreibungszeichen]] |
 |pagetype ​      ​|Optional |Integer |Typ der zu erzeugenden Bezahlseite:​ 0=normale API-Paypage (kompatibel zu früheren Paypages, Defaultwert),​ 1=Bezahlseite,​ 2=Spendenseite | |pagetype ​      ​|Optional |Integer |Typ der zu erzeugenden Bezahlseite:​ 0=normale API-Paypage (kompatibel zu früheren Paypages, Defaultwert),​ 1=Bezahlseite,​ 2=Spendenseite |
-|expirydate ​    ​|Optional |String(10) | Verfallsdatum:​ Leer=Bezahlseite ist immer gültig, JJJJ-MM-TT=Datumsangabe im Format Jahr-Monat-Tag,​ bis zu diesem Datum ist die Bezahlseite gültig. \\ Die Option '​once'​ ist **deprecated**,​ sollte also nicht mehr genutzt werden, weil sie in einer nächsten API-Version nicht mehr zur Verfügung stehen wird. Statt dessen, bitte single=2 verwenden. |+|expirydate ​    ​|Optional |String(10) | Verfallsdatum:​ Leer=Bezahlseite ist immer gültig, JJJJ-MM-TT=Datumsangabe im Format Jahr-Monat-Tag,​ bis zu diesem Datum ist die Bezahlseite gültig. \\ Funktioniert nur bei pagetype 1 oder 2. \\ Die Option '​once'​ ist **deprecated**,​ sollte also nicht mehr genutzt werden, weil sie in einer nächsten API-Version nicht mehr zur Verfügung stehen wird. Statt dessen, bitte single=2 verwenden. |
 |single ​        ​|Optional |Integer ​  ​|Steuert,​ ob und wie der Link wiederverwendet werden darf. \\ 0 = Link is beliebig oft wiederholbar (default) \\ 1 = Erlaubt nur einen einzigen Bezahlversuch für diesen Payment-Link,​ egal ob erfolgreich oder nicht \\ 2 = Bezahlseite kann nur für eine erfolgreiche Bezahlung genutzt werden, danach ungültig. ​ |  |single ​        ​|Optional |Integer ​  ​|Steuert,​ ob und wie der Link wiederverwendet werden darf. \\ 0 = Link is beliebig oft wiederholbar (default) \\ 1 = Erlaubt nur einen einzigen Bezahlversuch für diesen Payment-Link,​ egal ob erfolgreich oder nicht \\ 2 = Bezahlseite kann nur für eine erfolgreiche Bezahlung genutzt werden, danach ungültig. ​ | 
 +|timeout ​       |Optional | Integer | (Verfügbar ab API 2.1.33) Erlaubt die Angabe eines Timeouts für die Auswahl einer Zahlungsart auf der Payment Page. Der Timeout wird in Sekunden angegeben und wird aktiv, sobald die Seite angezeigt wird.  Er wird dort angezeigt und bei Ablauf wird auf eine Fehlermeldung weitergeleitet. ​ Neu Laden der Seite startet den Timeout NICHT neu, nur ein Löschen der Cookies hätte diesen Effekt. Wurde die Payment Page mit Parameter single=1 intialisiert,​ führt ein Ablauf des Timeouts dazu, dass der Link invalidiert wird. Für bestimmte Zahlungsarten (Lastschrift,​ Paypal, Kreditkarte) wird der Timeout ausgesetzt, sobald die Kachel der Zahlungsart aktiviert wird. Im Hintergrund läuft er aber weiter und greift wieder, sobald eine andere Zahlungsart gewählt wird.  Für die genannten 3 Zahlungsarten gibt es separate Timeouts, die für jede Zahlungsart im GiroCockpit konfiguriert werden können (nur durch administrative Mitarbeiter der GS). |
 |type           ​|Optional |String(4) |Transaktionsart (siehe [[girocheckout:​transactiontypes:​start]]),​ SALE = Verkauf wird sofort gebucht (default), AUTH = Reservierung des Betrags (nicht bei allen Zahlarten verfügbar) | |type           ​|Optional |String(4) |Transaktionsart (siehe [[girocheckout:​transactiontypes:​start]]),​ SALE = Verkauf wird sofort gebucht (default), AUTH = Reservierung des Betrags (nicht bei allen Zahlarten verfügbar) |
 |locale ​        ​|Optional |String(4) ​  ​|Sprache der Payment Page \\ de = deutsch (default) \\ en = englisch | |locale ​        ​|Optional |String(4) ​  ​|Sprache der Payment Page \\ de = deutsch (default) \\ en = englisch |
Zeile 135: Zeile 135:
 |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 |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. Fehlt dieser Wert, ist der Default 100, also 1 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. |+|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"​] |
girocheckout/paypage/start.1588871273.txt.gz · Zuletzt geändert: 2020/05/07 19:07 von michaelheumann

Seiten-Werkzeuge