aforms

Allgemein

aforms ist ein Unternehmen spezialisiert auf die Erstellung und Verwaltung von digitalen Formularen für E-Government und E-Business. Mit der Software AFS können Behörden und Unternehmen mehrsprachige, barrierefreie und standardkonforme Formulare ohne Programmierkenntnisse erstellen – online, mobil oder als PDF.

Links

• Webseite von aforms

• Formularerstellung mit aforms

Integration

Die folgende Anleitung zeigt Dir, wie Du Payrexx im AFS-Designer von aforms solutions & services einbindest.

Konfiguration von Payrexx

• Navigiere im Hauptmenü Deiner Händler-Administration zu API und Integrationen.

• Scrolle hinunter zu "API-Integration hinzufügen" und klicke auf "API-Schlüssel hinzufügen":

• Gib der Integration einen beliebigen Namen, zum Beispiel "aforms".

• Klicke auf "Hinzufügen":

• Du findest den neuen API-Schlüssel nun unter "Aktive Integrationen".

• Klicke auf "Kopieren", um den API-Schlüssel in die Zwischenablage zu kopieren. Du wirst ihn in einem späteren Schritt benötigen:

Konfiguration von aforms

Formserver Property

• Navigiere im AFS-Designer zu Administration > Ressourcen:

• Suche in der Ressourcenliste eine Formserver-Property oder erstelle mit dem Plus-Symbol eine neue:

• Trage deine Properties ein und speichere mit dem Haken-Symbol:

Beispiele Formserver-Property:

# Payrexx-URLcom.anecon.afs.common.extender.payrexx.url=

Erster Teil (bis zum ersten Punkt) der URL der Payrexx-Administration:

https://aforms2web.payment...com.anecon.afs.common.extender.payrexx.instanceId=xxx

Default API-Key aus der Payrexx-Administration:

com.anecon.afs.common.extender.payrexx.secret=xxx

Währung:

com.anecon.afs.common.extender.payrexx.currency=xxx

Formular, Seite und Block

• Navigiere im Menü zu Formulare und erstelle über das Plus-Symbol ein neues Formular:

• Gib den Formularnamen, die General-ID und die Beschreibung des Formulars ein:

• Lege eine neue Formularseite an, fülle die entsprechenden Felder aus und speichere Deine Einstellungen:

• Erstelle innerhalb der angelegten Formularseite einen neuen Block:

• Füge dem neu erstellen Block die erforderlichen Felder hinzu:

• Erstelle das Layout des Blocks automatisch per Klick auf das Tabellen-Symbol, benenne die Feldnamen und Leittexte für das Layout und speichere den Block:

• So sieht der angelegte Block aus:

• Platziere den neu erstellten Block auf der ersten Seite des Formulars:

• Speichere die Seiten- und Formulardetails per Klick auf das Haken-Symbol. Formular, Seite und Block sind nun bereit für die Anbindung an Payrexx.

Erstellen und Konfigurieren des Extenders

• Erstelle mittels Klick auf das Plus-Symbol einen neuen Extender auf Formularebene:

• Wähle in der Auswahl der Extender die Option "Formular: Payrexx":

• Konfiguriere den Extender gemäss Deinen Anforderungen und speichere ihn per Klick auf das Haken-Symbol:

• Mittels der Bedingung =#V1=="1" (SpeL-Ausdruck) wird der Extender nur ausgeführt, wenn im Formular die Zahlungsmethode "Kreditkarte" gewählt wurde:

• So sieht die Auswahl der Zahlungsmethode im Formular aus:

• Über den Formularbaum können die Felder im Extender zugeteilt werden:

Verwendung der Felder:

• Zahlungsvermerk: Der Zahlungsvermerk setzt sich aus der Reference-ID und dem Formulartitel zusammen und dient der Identifikation der Zahlung in der Inbox/APF.

• Reference-ID: Die Reference-ID ist eine Unique ID, über die die Zahlung identifiziert werden kann.

• Betrag: Transaktionsbetrag

• Vorname: Vorname des Antragstellers

• Nachname: Nachname des Antragstellers

• E-Mail-Adresse für Zahlungsbestätigung: An diese E-Mail-Adresse werden die Rechnung und die Zahlungsbestätigung versandt.

Verwendungszweck in der Rechnung (Produktbeschreibung):

Formularsammlung übertragen

• Mit einem Klick auf das Pfeilsymbol wird die Formularsammlung an den Formserver übermittelt und dadurch online verfügbar gemacht: