Quelle anzeigen

Settings SaferPay Interface

com.jaxforms.fmsbl.payment.saferpay.SaferPayService.*

Property	Data type	Required	Default	Description
apiBaseUrl	String	x		Basis URL für den SaferPay REST-Service
paymentCurrencyValue	String		Wert kann in Formular/Workflow überschrieben werden	Währung für Bezahlung
apiUsername	String	x		Username SaferPay API
apiPassword	String	x		Passwort SaferPay API
customerId	String	x		Customer-ID SaferPay API
terminalId	String	x		Terminal-ID SaferPay API
paymentMethods	Liste	x		Payment methods SaferPay API
clientCallbackSuccess	String	x		Callback URL for Client-Confirmation (iFrame)
clientCallbackFail	String	x		Callback URL for Client-Error (iFrame)
serverCallback	String	x		Callback URL for Server-Confirmation (REST)
instantBatchClose	Boolean		false	Batch Closing after each Transaktion (instead of daily Closing)

<?xml version="1.0" encoding="UTF-8"?>
<?jaxfront version=3.26.1;time=2019-04-11 16:39:07.663;xui=property.xui;xsd=property.xsd?>
<properties xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="property.xsd">
 <property mutable="true">
  <key>com.jaxforms.payment.provider.saferpay.SaferpayService.apiBaseUrlValue</key>
  <value>https://test.saferpay.com/api/Payment/</value>
 </property>
 <property mutable="true">
  <key>com.jaxforms.payment.provider.saferpay.SaferpayService.paymentCurrencyValue</key>
  <value>CHF</value>
 </property>
 <property mutable="true">
  <key>com.jaxforms.payment.provider.saferpay.SaferpayService.apiUsernameValue</key>
  <value>APY_USER</value>
 </property>
 <property mutable="true">
  <key>com.jaxforms.payment.provider.saferpay.SaferpayService.apiPasswordValue</key>
  <value>DEIN_API_KEY</value>
 </property>
 <property mutable="true">
  <key>com.jaxforms.payment.provider.saferpay.SaferpayService.customerIdValue</key>
  <value>123456</value>
 </property>
 <property mutable="true">
  <key>com.jaxforms.payment.provider.saferpay.SaferpayService.terminalIdValue</key>
  <value>123456</value>
 </property>
 <property mutable="true">
  <key>com.jaxforms.payment.provider.saferpay.SaferpayService.configSetValue</key>
  <value>vdl_basic</value>
 </property>
 <property mutable="true">
  <key>com.jaxforms.payment.provider.saferpay.SaferpayService.paymentMethodsValue</key>
  <value>MASTERCARD, VISA, POSTFINANCE, TWINT</value>
 </property>
 <property mutable="true">
  <key>com.jaxforms.payment.provider.saferpay.SaferpayService.clientCallbackSuccessValue</key>
  <value>https://[MANDANT]/formservice/services/rest/publicPage/VDL/de/saferpaySuccess.html</value>
 </property>
 <property mutable="true">
  <key>com.jaxforms.payment.provider.saferpay.SaferpayService.clientCallbackFailValue</key>
  <value>https://[MANDANT]/formservice/services/rest/publicPage/VDL/de/saferpayFailed.html</value>
 </property>
 <property mutable="true">
  <key>com.jaxforms.payment.provider.saferpay.SaferpayService.serverCallbackValue</key>
  <value>https://[MANDANT]/formservice/services/rest/notify/saferpaySuccess/</value>
 </property>
 <property mutable="true">
  <key>com.jaxforms.payment.provider.saferpay.SaferpayService.instantBatchCloseValue</key>
  <value>false</value>
 </property>
 <property mutable="true">
  <key>com.jaxforms.payment.report.PaymentReportSearchManager.formConfig</key>
  <value>{"formIds":["PAYMENT_TEST_1","PAYMENT_TEST_2","PAYMENT_TEST_3"],"tableMappings":[{"formTable":"jax_form","formIdColumn":"ID","formCreatedColumn":"CREATED"},{"formTable":"vdl_form","formIdColumn":"ID","formCreatedColumn":"CREATED"}]}</value>
 </property>
</properties>

Hinweis

Bei der Einrichtung der TEST und PROD Instanzen soll darauf geachtet werden, dass die URLs mit "test" und "www" unterschieden werden.

Quelle: https://saferpay.github.io/jsonapi/#integration

Settings payment process (transaction)

Workflow Action

The e-Payment plugin is included as a workflow action in a form.

SaveFormSaferPayAction

Parameter

Various parameters can be set for the configuration of the e-Payment plugin.

These parameters can be declared using a cascade with combinations of the following locations and contexts.

Ort

Sequence	Location	Example
1	SaferPay Configuration file (XML)	resources/FMS-BL/settings.xml
2	Workflow transition	StandardSIDZRVWorkflowWithPayment, submitPay, Features
3	Form definition	SID_Zivilrechtsverwaltung_Grundbuchauszug, Features

Context

Sequence	Name	Format	Example Key	Example Value
1	[Variable]	Formula expression	paymentAmount	nodeValue("amount")
2	[Variable]Xpath	XPath	paymentAmountXpath	amount
3	[Variable]Value	Value	paymentAmountValue	25.20

Variablen

Name	Required	Datentyp	Description	Default	SaferPay
paymentAmount	x	Double	Payment amount		Payment process, Backoffice
paymentCurrency	x	String	Payment currency		Payment process, Backoffice
paymentOrderDescription	x	String	Payment description		Payment process
paymentOrderId		String	Payment reference number	Form GUID	Backoffice
paymentOrderData		String	Additional data for the identification of a payment (e.g. without an existing order)	NULL	N/A

Example

Usage	Variable	Example	Results
Amount for payment 1	paymentAmount	nodeValue("amount") + 100	135 (amount=35)
Amount for payment 2	paymentAmountXpath	amount	35 (amount=35)
Amount for payment 3	paymentAmountValue	35	35
Data for identification 1	paymentOrderData	nodeValue("vorname") + " " + nodeValue("nachname")	Hans Muster (firstname=Hans, name=Muster)
Data for identification 2	paymentOrderDataXpath	email	h.muster@gmail.com (email=h.muster@gmail.com)
Data for identification 3	paymentOrderDataValue	Form with test data	Form with test data

JEP function for VDL

Usage

Example

Description

Results

Precondition

isPaymentForm() == true

If in an form has the property "paymentAmountXpath", then is an payment form.

Then we need add this new funktion below wokflow "Precondition" the funktion "isPaymentForm()==true"
And on submit button below wokflow "Precondition" we need add "isPaymentForm()==false"

Show only payment submit button