Settings SaferPay Interface

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

PropertyData typeRequiredDefaultDescription

apiBaseUrl

Stringx
Basis URL für den SaferPay REST-Service

paymentCurrencyValue

String
Wert kann in Formular/Workflow überschrieben werden

Währung für Bezahlung

apiUsername

Stringx
Username SaferPay API

apiPassword

Stringx
Passwort SaferPay API

customerId

Stringx
Customer-ID SaferPay API

terminalId

Stringx
Terminal-ID SaferPay API

paymentMethods

Listex
Payment methods SaferPay API

clientCallbackSuccess

Stringx
Callback URL for Client-Confirmation (iFrame)

clientCallbackFail

Stringx
Callback URL for Client-Error (iFrame)

serverCallback

Stringx
Callback URL for Server-Confirmation (REST)

instantBatchClose

Boolean
falseBatch Closing after each Transaktion (instead of daily Closing)


payment-settings.xml 
<?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>

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

SequenceLocationExample
1SaferPay  Configuration file (XML)resources/FMS-BL/settings.xml
2Workflow transitionStandardSIDZRVWorkflowWithPayment, submitPay, Features
3Form definitionSID_Zivilrechtsverwaltung_Grundbuchauszug, Features

Context

SequenceNameFormatExample KeyExample Value
1[Variable]Formula expressionpaymentAmountnodeValue("amount")
2[Variable]XpathXPathpaymentAmountXpathamount
3[Variable]ValueValuepaymentAmountValue25.20

Variablen

NameRequiredDatentypDescriptionDefaultSaferPay
paymentAmountxDoublePayment amount
Payment process, Backoffice
paymentCurrencyxStringPayment currency
Payment process, Backoffice
paymentOrderDescriptionxStringPayment description
Payment process
paymentOrderId
StringPayment reference numberForm GUIDBackoffice
paymentOrderData
StringAdditional data for the identification of a payment (e.g. without an existing order)NULLN/A

Example

UsageVariableExampleResults
Amount for payment 1paymentAmountnodeValue("amount") + 100135 (amount=35)
Amount for payment 2paymentAmountXpathamount35 (amount=35)
Amount for payment 3paymentAmountValue3535
Data for identification 1paymentOrderDatanodeValue("vorname") + " " + nodeValue("nachname")Hans Muster (firstname=Hans, name=Muster)
Data for identification 2paymentOrderDataXpathemailh.muster@gmail.com (email=h.muster@gmail.com)
Data for identification 3paymentOrderDataValueForm with test dataForm with test data

JEP function for VDL

UsageExampleDescriptionResults
PreconditionisPaymentForm() == 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
  • Keine Stichwörter