Zum Inhalt springen

Wiki-Quellcode von Payment

Zuletzt geändert von MACH formsolutions am 13.03.2026
Zeige letzte Bearbeiter
1 Mit der Hilfe von Bezahlsystemen kann beispielsweise eine durch den Ausfüllassistenten bestellte Dienstleistung direkt online bezahlt werden. Um ein solches Bezahlsystem nutzen zu können, müssen im Vorfeld beim Mandanten spezielle Konfigurationen vorgenommen werden.
2
3 {{icon name="far fa-info-circle" size="3"/}} //**Hinweis:**//
4
5 1. Der Mandant des Benutzers benötigt die [[Mandantenrechte>>Main.07_Einstellungen-Fachadministration.01_Mandanten.01_Rechte]] „Payment“ und „Modulkonfiguration“ sowie der Benutzer das [[Benutzerrecht>>Main.07_Einstellungen-Fachadministration.02_Benutzer.01_Benutzerrollen]] „Ressourcen verwalten“ um die Funktion nutzen zu können.
6 1. Zusätzlich muss mit dem jeweiligen gewünschten Payment-Anbieter ein Vertrag vorliegen. Die jeweiligen Konfigurations-Daten erhalten Sie vom jeweiligen Bezahlverfahrensanbieter.
7
8 == Statische und variable Werte für Verwendungszweck und Betrag ==
9
10 Es gibt mehrere Möglichkeiten Verwendungszweck und Betrag zu definieren.
11
12 === Statisch ===
13
14 Eine Variante ist, feste Werte in der Veröffentlichungskonfiguration für Betrag und Verwendungszweck zu hinterlegen. Weitere Details können sie den jeweiligen Abschnitten für die einzelnen Paymentprovider entnehmen.
15
16 === Variabel ===
17
18 Variable Werte des Betrags und/oder Verwendungszwecks können dynamisch aus dem Assistenten übergeben werden. Dazu fügen Sie in dem Assistenten jeweils eine zusätzliche Komponente ein.
19 Die „Bezeichnung technisch“ der Komponente für den Betrag muss „betrag“ und für den Verwendungszweck „verwendungszweck“ lauten. Steuerungsfelder dürfen nur einmal vorkommen. Es darf kein weiteres Feld mit „Bezeichnung technisch“ „betrag“ oder „verwendungszweck“ im selben Assistenten vorkommen.
20
21 === Steuerung ob ein Zahlungsvorgang stattfindet ===
22
23 Durch das Steuerungsfeld "betrag" können SIe dynamisch aus dem Assistenten heraus festlegen ob eine Zahlung angefordert wird:
24
25 * Betragsfeld mit einem Wert befüllen – der Zahlungsvorgang wird mit diesem Wert als Betrag vorgenommen
26 * Betragsfeld mit dem Wert 0 befüllen – der Zahlungsvorgang wird nicht angestoßen
27 * Betragsfeld über Aktivierungsregeln ausblenden oder leer lassen – die Zahlungsdetails aus der Veröffentlichungskonfiguration werden übernommen
28
29 == Erweiterte Modulkonfiguration ==
30
31 Nachdem der Mandant und der Benutzer die entsprechenden Rechte zugewiesen bekommen haben, steht dem Benutzer in der [[Einzel Mandantenverwaltung>>Main.07_Einstellungen-Fachadministration.01_Mandanten]] der Menüpunkt „Module“, mit der dieser in die sogenannte „Modulkonfiguration“ gelangt, zur Verfügung. In der Modulkonfiguration befindet sich in dem Menüpunkt „Übersicht“ die Schaltfläche „Erweiterte Modulkonfiguration“. Nach dem Betätigen der Schaltfläche öffnet sich die „Erweiterte Modulkonfiguration“. Hier können unter der Rubrik „Bezahlverfahrensanbieter“ die Konfigurationsdaten für die jeweiligen Bezahlsysteme hinterlegt werden.
32
33 {{icon name="far fa-info-circle" size="3"/}} //**Hinweis:**//
34
35 1. Die „Erweiterte Modulkonfiguration“ kann auch über die Schaltfläche „Webserviceverwaltung“ im [[Formulareditor>>Main.05_Assistenten]] geöffnet werden. 1.
36 1. Jede Bezahlart, die dem Bürger angeboten werden soll, muss durch die Checkbox „Konfiguration freischalten“ aktiviert werden. 1.
37 1. Es wird empfohlen bei einem Wechsel des Bezahlverfahrensanbieters die Konfiguration im Modul zu deaktivieren.
38
39 == Zertifikatsanforderungen für Bezahldienstanbieter ==
40
41 Einige Bezahldienstanbieter setzen die Hinterlegung eines Zertifikats in der Modulkonfiguration voraus. Wir unterstützen Zertifikate im JKS-Format. Falls Sie Ihr Zertifikat in einem anderen Format vorliegen haben, können Sie es mithilfe unseres [[Java-Keystore Konverter Tools>>https://jks-konverter.machproforms.de/]] unkompliziert in das JKS-Format umwandeln.
42
43 Um Ihre Zertifikatsdatei zu konvertieren gehen Sie wie folgt vor:
44
45 * Optional: Wählen Sie ein Service-Zertifikat im Format .cer aus.
46 * Wählen Sie den Schlüsselspeicher im Format .p12 oder .pfx aus.
47 * Geben Sie das Passwort für den Schlüsselspeicher ein.
48 * Klicken Sie auf „Konvertieren“, um den Vorgang abzuschließen.
49
50 Die von Ihnen hochgeladenen Daten werden ausschließlich im Arbeitsspeicher gespeichert.
51 Die erzeugte JKS-Datei wird aus Sicherheitsgründen automatisch nach 30 Minuten gelöscht.
52
53
54 == Folgende Bezahlsysteme stehen zur Verfügung: ==
55
56 **Inhaltsverzeichnis**
57
58 {{toc depth="4" scope="LOCAL" start="3"/}}
59
60 === GiroCheckout [[image:@PaymentGirosolutions.jpg||alt="Logo Girosolutions"]] ===
61
62 (% style="float:right" %)
63 (((
64 [[image:@PaymentGiroCheckoutModule.jpg||alt="Modulkonfiguration GiroCheckout" data-xwiki-image-style-alignment="end" height="116" width="200"]]
65
66 [[image:@PaymentVeröffentlichungGiroCheckout.jpg||alt="Veröffentlichungsprozess GiroCheckout" data-xwiki-image-style-alignment="end" height="148" width="200"]]
67 )))
68
69 Das Bezahlsystem GiroCheckout ist eine einfache, schnelle und sichere Komplettlösung für die Integration verschiedener Bezahlverfahren in Online-Verwaltungsdienste der Firma [[Girosolution>>https://www.girosolution.de/]]. In der Kooperation mit Girocheckout werden die folgenden Bezahlvarianten angeboten:
70
71 * Lastschrift
72 * Kreditkarte
73 * PayPal
74 * Apple Pay
75 * Google Pay
76 * WERO
77 * Direktüberweisung
78 * Klarna
79 * giropay (abgekündigt)
80 * PayDirekt (abgekündigt)
81
82 Für jedes der Bezahlvarianten muss zwingend in der Payment-Konfiguration die Werte „Verkäufer-ID“, „Projekt-ID“ und „Passwort“ hinterlegt werden. Diese Konfigurationsdaten erhält der Mandant seitens Girocheckout entweder über einen Vertrag oder die Konfigurationsdaten können beim Anlegen eines neuen Bezahlprojekts innerhalb des Cockpits von GiroSolutions selbst angelegt werden.
83
84 Für die Veröffentlichung eines [[Assistenten>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]]/[[PDF-Formulars>>Main.06_PDF-Formulare.01_PDF-FormulareVeröffentlichung]] mit dem Bezahlsystem müssen in der Veröffentlichung auf der ersten Seite im „Formularkonfigurations-Assistent“ der Haken bei „Bezahlen mit GiroCheckout“ gesetzt werden. Daraufhin kann auf der zweiten Seite im „Formularkonfigurations-Assistent“ die entsprechenden „Bezahlverfahren“ ausgewählt und einen fixer „Betrag“ sowie ein fixer „Verwendungszweck“ eingetragen werden. Die Felder sind Pflichtfelder und das Feld Verwendungszweck ist auf eine Zeichenanzahl von maximal 27 Zeichen begrenzt und es werden keine Umlaute akzeptiert. Diese Werte werden dann für als Bezahlwerte an das Bezahlsystem übergeben.
85
86 {{html}}
87 <br style="clear:both" />
88 {{/html}}
89
90 ----
91
92 === Ecash (Elbe) [abgekündigt zum 31.12.2025] ===
93
94 {{comment}}
95 Das Bezahlsystem Ecash (Elbe) der [GKD Recklinghausen](https://www.gkd-re.de/Inhalte/Start/Leistungen/Produkte/index.asp?seite=angebot&id=1295) ist ein elektronisches Bezahlsystem, das mittels Lastschrifteinzug eine sichere elektronische Bezahlung kommunaler Dienstleistungen im Internet ermöglicht. Durch die spätere Veröffentlichung kann entschieden werden, ob eine direkte Buchung erzeugt wird oder der Sachbearbeiter in der Kommune die Zahlung durch eine Bestätigung auslöst. Für die Konfiguration des Bezahlsystems müssen in der Payment-Konfiguration die Werte „Elbe-Key“ als Verschlüsselungswert und die „Gläubiger-ID“ des Mandanten zwingend hinterlegt werden.
96
97 ![[Modulkonfiguration ECash|@PaymentECashModule.jpg]]
98
99 Für die Veröffentlichung eines [[Assistenten|Main.05_Assistenten.02_VeröffentlichungvonAssistenten]]/[[PDF-Formulars|Main.06_PDF-Formulare.01_PDF-FormulareVeröffentlichung]] mit dem Bezahlsystem müssen in der Veröffentlichung auf der ersten Seite im „Formularkonfigurations-Assistent“ der Haken bei „Bezahlen mit eCash“ (für ohne Genehmigungsprozess) oder „Bezahlen mit eCash/Genehmigungsprozess“ (für mit Genehmigungsprozess) gesetzt werden. Daraufhin kann auf der zweiten Seite im „Formularkonfigurations-Assistent“ ein fixer „Betrag“ sowie ein fixer „Verwendungszweck“ eingetragen werden. Die Felder sind Pflichtfelder und das Feld Verwendungszweck ist auf eine Zeichenanzahl von maximal 27 Zeichen begrenzt und es werden keine Umlaute akzeptiert. Weiterhin können in den Feldern Beschreibung (maximal 100 Zeichen) und Gebührenart ein frei wählbarer Wert zum Vorgang eingetragen werden.
100
101 ![[Veröffentlichungsprozess ECash|@PaymentVeröffentlichungECash.jpg]]
102 {{/comment}}
103
104 ----
105
106 === EpaymentKiv [[image:@PaymentEpaymentKiv.jpg||alt="Logo EpaymeentKiv"]] ===
107
108 (% style="float:right" %)
109 (((
110 [[image:@PaymentEpaymentKivModule.jpg||alt="Modulkonfiguration EpaymentKiv" data-xwiki-image-style-alignment="end" height="148" width="200"]]
111
112 [[image:@PaymentVeröffentlichungEPaymentKIV.jpg||alt="Veröffentlichungsprozess EpaymentKiv" data-xwiki-image-style-alignment="end" height="148" width="200"]]
113 )))
114
115 EpaymentKiv ist eine Bezahlsystemlösung der Datenzentrale Baden-Württemberg um eine vollständige digitale und medienbruchfreie Bezahlabwicklung der angebotenen Online-Dienste zu ermöglichen. Das Bezahlverfahren wird hierbei über eine OAuth-Schnittstelle angebunden. Folgende Bezahlvarianten stehen aktuell für das Bezahlsystem zur Verfügung:
116
117 * Kreditkarte
118 * Lastschrift
119 * giropay (abgekündigt)
120
121 Für jedes der Bezahlvarianten muss zwingend in der Payment-Konfiguration die Werte für „Client-ID“, „Client Secret“, „URI für die ID-Datenanfrage“, „URI für die Autorisierungsanfrage“, „URI für die Anfrage temporärer Credentails“, „URI für die Anfrage eines Tokens“ sowie der „Scope“ hinterlegt werden. Die entsprechenden Konfigurationsparameter erhält der Mandant direkt von der [[KIVBF>>http://www.kivbf.de/,Lde/start/Loesungen/e-payment_kiv.html]].
122
123
124 Für die Veröffentlichung eines [[Assistenten>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]]/[[PDF-Formulars>>Main.06_PDF-Formulare.01_PDF-FormulareVeröffentlichung]] mit dem Bezahlsystem müssen in der Veröffentlichung auf der ersten Seite im „Formularkonfigurations-Assistent“ der Haken bei „Bezahlen mit EpaymentKiv“ gesetzt werden. Daraufhin kann auf der zweiten Seite im „Formularkonfigurations-Assistent“ die entsprechenden „Bezahlverfahren“ ausgewählt und ein fixer „Betrag“ sowie ein fixer „Verwendungszweck“ eingetragen werden. Die Felder sind Pflichtfelder und das Feld Verwendungszweck ist auf eine Zeichenanzahl von maximal 27 Zeichen begrenzt und es werden keine Umlaute akzeptiert.
125
126 {{html}}
127 <br style="clear:both" />
128 {{/html}}
129
130 ----
131
132 === PMPayment [[image:@PaymentGovConnect.jpg||alt="Logo GovConnect"]] ===
133
134 (% style="float:right" %)
135 (((
136 [[image:@PaymentPMPaymentModule.jpg||alt="Modulkonfiguration PMPayment" data-xwiki-image-style-alignment="end" height="115" width="200"]]
137
138 [[image:@PaymentVeröffentlichungPMPayment.jpg||alt="Veröffentlichungsprozess PMPayment" data-xwiki-image-style-alignment="end" height="148" width="200"]]
139 )))
140
141 Das Bezahlsystem PMPayment der [[GovConnect>>https://www.govconnect.de/cms/software/pmpayment/kurzbeschreibung.php]] ist Bezahlsystem für alle Online-Bezahlvorgänge in der Verwaltung. Für das Bezahlverfahren wird eine Vielzahl an Bezahlvarianten angeboten, welche stetig erweitert werden. Für die Konfiguration des Bezahlsystems müssen in der Payment-Konfiguration die Werte für „Url zum Bezahlsystem“, „Verschlüsselungspasswort“ und „Gemeindekennziffer“ oder „Kundennummer“ hinterlegt werden.
142
143 Für die Veröffentlichung eines [[Assistenten>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]]/[[PDF-Formulars>>Main.06_PDF-Formulare.01_PDF-FormulareVeröffentlichung]] mit dem Bezahlsystem müssen in der Veröffentlichung auf der ersten Seite im „Formularkonfigurations-Assistent“ der Haken bei „Bezahlen mit PMPayment“ gesetzt werden. Daraufhin kann auf der zweiten Seite im „Formularkonfigurations-Assistent“ ein fixer „Betrag“, ein fixer „Verwendungszweck“ sowie der vom Bezahlanbieter vorgegebene Wert „Verfahren“ eingetragen werden. Die Felder sind Pflichtfelder und das Feld Verwendungszweck ist auf eine Zeichenanzahl von maximal 27 Zeichen begrenzt und es werden keine Umlaute akzeptiert. Beim Feld „generischer Buchungsdatensatz“ kann ein frei wählbar Wert, der zu Steuerung der Verbuchung dient, eingetragen werden.
144
145 {{html}}
146 <br style="clear:both" />
147 {{/html}}
148
149 ----
150
151 (% style="float:right" %)
152 (((
153 [[image:Main.07_Einstellungen-Fachadministration.03_Module.01_Payment.WebHome@PaymentInfomaModule.jpg||alt="Modulkonfiguration Infoma" data-xwiki-image-style-alignment="end" height="156" width="200"]]
154
155 [[image:Main.07_Einstellungen-Fachadministration.03_Module.01_Payment.WebHome@PaymentVeröffentlichungInfoma.jpg||alt="Veröffentlichungsprozess Infoma" data-xwiki-image-style-alignment="end" height="148" width="200"]]
156 )))
157
158 === Infoma ===
159
160 Infoma ist eine ePayment-Lösung der Firma [[Axians Infoma>>https://www.axians-infoma.de/]].
161
162 **MACH formsolutions** bietet die Anbindung von **Infoma 1.0** und **Infoma 2.0** an.
163
164 Um Bezahlung mit Infoma an Ihre Assistenten anzubinden, benötigen Sie Daten aus Ihrem Kundenbereich bei Infoma und die MACH formsolutions Lizenz Paymentschnittstelle.
165
166
167 Weitere Informationen finden Sie im Artikel [[**Infoma**>>doc:.Infoma.WebHome]]
168
169 {{html}}
170 <br style="clear:both" />
171 {{/html}}
172
173 ----
174
175 === CitkoPortal Payment (Citkomm) [[image:@PaymentCitkoPortalPayment.jpg||alt="Logo CitkoPortal Payment"]] ===
176
177 (% style="float:right" %)
178 (((
179 [[image:@PaymentCitkoPortalModule.jpg||alt="Modulkonfiguration citkoPortal" data-xwiki-image-style-alignment="end" height="119" width="200"]]
180
181 [[image:@PaymentVeröffentlichungCitkoPortal.jpg||alt="Veröffentlichungsprozess citkoPortal" data-xwiki-image-style-alignment="end" height="148" width="200"]]
182 )))
183
184 CitkoPortal Payment ist eine ePayment-Lösung der Firma [[citkomm>>https://www.citkomm.de/produkte/citkoportal/]]. Für die Konfiguration des Bezahlsystems müssen in der Payment-Konfiguration die Werte für „Url zum Bezahlsystem“, „Verkäufer-Id“ und „Passwort“ angegeben werden. Die Konfigurationsdaten erhält der Mandant seitens citkomm.
185
186 Für die Veröffentlichung eines [[Assistenten>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]]/[[PDF-Formulars>>Main.06_PDF-Formulare.01_PDF-FormulareVeröffentlichung]] mit dem Bezahlsystem müssen in der Veröffentlichung auf der ersten Seite im „Formularkonfigurations-Assistent“ der Haken bei „Bezahlen mit citkoPortal Payment“ gesetzt werden. Daraufhin muss auf der zweiten Seite im „Formularkonfigurations-Assistent“ ein fixer „Betrag“ und kann ein variabler Wert unter „Beschreibung“ eingetragen werden.
187
188
189 {{html}}
190 <br style="clear:both" />
191 {{/html}}
192
193 ----
194
195 === ePay21 [[image:@Payment_ekom21.jpg||alt="Logo ekom21"]] ===
196
197 (% style="float:right" %)
198 (((
199 [[image:@Paymentepay21Module.jpg||alt="Modulkonfiguration epay21" data-xwiki-image-style-alignment="end" height="115" width="200"]]
200
201 [[image:@PaymentVeröffentlichungepay21.jpg||alt="Veröffentlichungsprozess epay21" data-xwiki-image-style-alignment="end" height="148" width="200"]]
202 )))
203
204 ePay21 ist eine ePayment-Lösung der Firma [[ekom21>>https://www.ekom21.de/Seiten/default.aspx]] und bietet folgende Bezahlvarianten an:
205
206 * PayPal
207 * Kreditkarte
208 * Lastschrift
209 * Direktüberweisung
210 * Wero
211 * Apple Pay
212 * Google Pay
213
214 Für die Konfiguration des Bezahlsystems müssen in der Payment-Konfiguration die Werte für „URL zum Bezahlsystem“, „Benutzername“, „Passwort“ und die „Mandantennummer“ hinterlegt werden.
215
216 Für die Veröffentlichung eines [[Assistenten>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]]/[[PDF-Formulars>>Main.06_PDF-Formulare.01_PDF-FormulareVeröffentlichung]] mit dem Bezahlsystem müssen in der Veröffentlichung auf der ersten Seite im „Formularkonfigurations-Assistent“ der Haken bei „Bezahlen mit epay21“ gesetzt werden. Daraufhin kann auf der zweiten Seite im „Formularkonfigurations-Assistent“ ein fixer „Betrag“, ein fixer „Verwendungszweck“ sowie der vom Bezahlanbieter vorgegebene Wert „Verfahren“ eingetragen werden. Die Felder sind Pflichtfelder und das Feld Verwendungszweck ist auf eine Zeichenanzahl von maximal 27 Zeichen begrenzt und es werden keine Umlaute akzeptiert. Beim Feld „Beschreibung“ kann ein frei wählbar Wert eingetragen werden. Diese Angabe darf keine Sonderzeichen enthalten.
217
218
219
220 {{html}}
221 <br style="clear:both" />
222 {{/html}}
223
224 ----
225
226 === ePayBL [[image:@PaymentEpaymentKiv.jpg||alt="Logo EpaymeentKiv"]] ===
227
228 (% style="float:right" %)
229 (((
230 [[image:@PaymentePayBLModule.jpg||alt="Modulkonfiguration epayBl" data-xwiki-image-style-alignment="end" height="131" width="200"]]
231
232 [[image:@PaymentVeröffentlichungePayBL.jpg||alt="Veröffentlichungsprozess ePayBL" data-xwiki-image-style-alignment="end" height="148" width="200"]]
233 )))
234
235 ePayBL ist eine ePayment-Lösung der Entwicklergemeinschaft von Bund und Ländern und bietet folgende Bezahlvarianten an:
236
237 * Kreditkarte
238 * Lastschrift
239 * PayPal
240 * giropay (abgekündigt)
241 * PayDirekt (abgekündigt)
242
243 Für jedes der Bezahlvarianten muss zwingend in der Payment-Konfiguration die Werte für „URL zum Bezahlsystem“, „Mandantennummer“, ein „Zertifikat“ und ein „Passwort“ für das Zertifikat hinterlegt werden.
244
245 Für die Veröffentlichung eines [[Assistenten>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]]/[[PDF-Formulars>>Main.06_PDF-Formulare.01_PDF-FormulareVeröffentlichung]] mit dem Bezahlsystem müssen in der Veröffentlichung auf der ersten Seite im „Formularkonfigurations-Assistent“ der Haken bei „Bezahlen mit epayBl“ gesetzt werden.
246 Daraufhin muss auf der zweiten Seite im „Formularkonfigurations-Assistent“ die entsprechenden „Bezahlverfahren“ ausgewählt und jeweils ein fixer Wert für „Betrag“, „Verwendungszweck“, „Bewirtschafter“, „Haushaltsstelle“ und „Mahnkennzeichen“ eingetragen werden.
247 Das Feld Verwendungszweck ist auf eine Zeichenanzahl von maximal 27 Zeichen begrenzt und es werden keine Umlaute akzeptiert.
248 Die Felder „Objektnummer“ und „Zusätzliche Kontierungsangaben“ sind frei wählbar.
249 Das Feld "Zusätzliche Kontierungsangaben" kann dynamisch im Assistenten gesetzt werden durch ein Steuerfeld mit der Bezeichnung technisch: "additionalAllocationData".