Benutzer-Werkzeuge

Webseiten-Werkzeuge


girocheckout:paypage:start

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

Link zu dieser Vergleichsansicht

girocheckout:paypage:start [2019/12/11 20:53]
michaelheumann
girocheckout:paypage:start [2020/07/10 18:24] (aktuell)
michaelheumann
Zeile 7: Zeile 7:
 **Beispiel** **Beispiel**
  
-{{:​girocheckout:​paypage:​paypage_example.png?​600|Beispiel Payment Page}}+ 
 +{{:​girocheckout:​paypage:​paypage_example.png?​800|Beispiel Payment Page}}
  
 ===== Unterstützte Zahlungsarten ===== ===== Unterstützte Zahlungsarten =====
Zeile 22: Zeile 23:
 | Lastschrift mit Sperrdatei | 7 | | Lastschrift mit Sperrdatei | 7 |
 | Garantierte Lastschrift | 8 | | Garantierte Lastschrift | 8 |
 +| Bluecode | 26 |
 | Maestro | 33 | | Maestro | 33 |
 | PayPal | 14 | | PayPal | 14 |
Zeile 119: Zeile 121:
 |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 ​        |Ja  ​|Integer ​    |Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny |+|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). |
Zeile 133: 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"​] |
Zeile 140: Zeile 142:
 |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> ​ |
 |paydirektShippingFirstName |Optional ​ | String(100) ​ | Vorname für die Lieferadresse (nur für paydirekt PHYSICAL-Bestellungen) |  |paydirektShippingFirstName |Optional ​ | String(100) ​ | Vorname für die Lieferadresse (nur für paydirekt PHYSICAL-Bestellungen) | 
 |paydirektShippingLastName ​ |Optional ​ | String(100) ​ | Nachname für die Lieferadresse (nur für paydirekt PHYSICAL-Bestellungen) | |paydirektShippingLastName ​ |Optional ​ | String(100) ​ | Nachname für die Lieferadresse (nur für paydirekt PHYSICAL-Bestellungen) |
Zeile 221: Zeile 224:
  
   * successUrl: Hierher wird weitergeleitet,​ wenn die Zahlung erfolgreich war.   * successUrl: Hierher wird weitergeleitet,​ wenn die Zahlung erfolgreich war.
-  * failUrl: Hierher wird weitergeleitet,​ wenn die Zahlung nicht erfolgreich war. +  * failUrl: Hierher wird weitergeleitet,​ wenn die Zahlung nicht erfolgreich war oder auf der Seite des Zahlungsanbieters (Bank, Kreditkartenbetreiber usw.) abgebrochen wurde
-  * backUrl: Hierher wird weitergeleitet,​ wenn der Käufer auf den Zahlungsseiten ​beschließt,​ den Vorgang abzubrechen und auf den entsprechenden ​Button klickt.+  * backUrl: Hierher wird weitergeleitet,​ wenn der Käufer auf der Payment Page beschließt,​ den Vorgang abzubrechen und auf den Zurück-Button klickt ​(nicht zu verwechseln mit dem Abbruch der Zahlung im entsprechenden Zahlungsformular NACH Auswahl der Zahlart, denn dieser Abbruch entspricht dann einem Transaktionsabbruch,​ der an die failUrl weitergeleitet wird).
  
-Alle 3 URLs werden mit der POST-Methode aufgerufen und erhalten ​als Parameter ​die selben ​Werte wie oben beim Notify angegeben.+Die success- und failUrl ​werden mit der POST-Methode aufgerufen und erhalten die selben ​Parameter ​wie oben beim Notify angegeben.  Bei der backUrl wurde ja noch keine Zahlungsart ausgewählt und auch keine Transaktion initialisiert,​ somit wird hier lediglich ein Browser-Redirect ohne weitere Parameter durchgeführt.
    
girocheckout/paypage/start.1576094021.txt.gz · Zuletzt geändert: 2019/12/11 20:53 von michaelheumann

Seiten-Werkzeuge