Bezahlverfahren konfigurieren

Je nachdem, welcher Bezahldienst genutzt wird, müssen unterschiedliche Felder ausgefüllt werden. Hier zwei Beispiele:

pmPayment

Bitte beachten Sie: Die Angaben bei „Amtlicher Gemeindeschlüssel“, „Passwort“ und „Vorgang“ müssen Ihren Daten bei pmPayment entsprechen. Füllen Sie bei diesen vorgegebenen Pflichtfeldern ein Feld nicht korrekt aus, erhalten Sie die Fehlermeldung "ungültiger Hashwert". „Verwendungszweck“ und „Buchungssatz“ können hier frei gewählt werden.

ePayBL

Bei ePayBL kann das Feld "Beschreibung der Buchung" frei gewählt werden. Die "Beschreibung der Buchung" dient als interner Hinweis/Verwendungszweck für Ihre Kasse oder Finanzverwaltung oder Buchhaltung, um die jeweilige Zahlung zuordnen zu können.

• Bitte beachten Sie den Hinweis zu den zulässigen Zeichen: neben den über dem Textfeld aufgelisteten Sonderzeichen/Ziffern sind nur Großbuchstaben zulässig (außer bei Platzhaltern, dort bitte nur Kleinbuchstaben verwenden).

• Warnung - Der Inhalt ist auf 27 Zeichen begrenzt:
  Hier können Sie auch dynamisch-ausgefüllte Variablen-Platzhalter verwenden (z. B. Antragsnummer oder Antragsdatum). Falls die ausgefüllten Inhalte der Variablen nach der Expandierung (d. h. nach Ersetzung von beispielsweise ${az} durch "EfA-BY-prod.-2248") mehr als 27 Zeichen haben, kommt es zu einer Fehlermeldung beim Bezahlvorgang. Achten Sie daher darauf, dass z. B. bei Verwendung des Platzhalters ${title} der Titel in der Verfahrenskonfiguration mit entsprechend wenig Zeichen gewählt wird oder verzichten Sie auf diesen Platzhalter. Details unter https://docs.efast.digital/bhefast/xbezahldienste-konfiguration-im-antragsverfahren-o

• Hier können dynamisch-ausgefüllte Variablen-Platzhalter (z. B. ${az}) verwendet werden. Beachten Sie bitte den obigen Hinweis zur Längenbeschränkung.

XBezahldienste

Die Client-Id und der Client-Secret sind im Bezahlsystem unter “Autorisierung” zu finden. Der Verwendungszweck der Buchung wird auf 27 Zeichen gekürzt. Es sind nur Großbuchstaben, Kleinbuchstaben, Zahlen, Leerzeichen und das Minuszeichen zulässig.

Variablen

Durch die Nutzung von Variablen können Sie freie Felder bei Bezahlverfahren dynamisch gestalten, bei pmPayment  beispielsweise den "Verwendungszweck" und den "Buchungssatz", bei ePayBL die "Beschreibung der Buchung". Variablen und statischer Text lassen sich beliebig kombinieren. Folgende Variablen stehen zur Auswahl:

• ${title} - Antragstitel

• ${az} - Von der Plattform vergebene Auftragsnummer

• ${datum} - Antragssdatum

• ${as.vorname} - Vorname des an der Plattform angemeldeten, registrierten Nutzers

• ${as.nachname} - Nachname des an der Plattform angemeldeten, registrierten Nutzers

• ${as.email} - E-Mail des an der Plattform angemeldeten, registrierten Nutzers

Bei anonymen Nutzern bleiben ${as.vorname}, ${as.nachname} und ${as.email} ohne Inhalt, da keine Daten aus dem Benutzerprofil übernommen werden können. Die Daten des Antragstellers liegen nur dann vor, wenn der Antrag von einem registriertem Benutzer abgesendet wird. Die Registrierung wird verpflichtend, wenn als Authentifikationslevel "niedrig" oder "höher" gewählt wird.

Nehmen wir als Beispiel die frei wählbaren Felder  "Verwendungszweck" und "Buchungssatz" von pmPayment. Die Namen der Variablen sind frei wählbar. Der "Verwendungszweck", hier beispielsweise das Datum, erscheint in der Bezahlung des Antragstellers unter „description“. Der Verwendungszweck ist auf 27 Zeichen begrenzt. Überschreitet der für den Verwendungszweck vorgesehene Text diese Grenze, wird er abgeschnitten.

Die im "Buchungssatz" möglichen Felder wie Titel, Auftragsnummer, Datum, Vorname, Nachname und E-Mail-Adresse sieht man in der in diesem Beispiel simulierten Bezahlübersicht unter „accountingRecord“:

Für eine eindeutige Zuordnung des Zahlungseingangs zum jeweiligen Antrag ist die Auftragsnummer sehr gut geeignet.