Payment Plug-In for shop system

Payment Plug-In for shop system
Administration Guide
State: 15.05.2013
Page 1 of 7
Contents
1
Installation ....................................................................................................................................... 3
2
Configuration ................................................................................................................................... 4
2.1
Front office-Configuration ....................................................................................................... 4
2.2
Basic Configuration.................................................................................................................. 4
2.3
Credit card configuration ........................................................................................................ 4
2.4
Direct Debit Configuration ...................................................................................................... 5
2.5
PayPal configuration................................................................................................................ 7
2.6
giropay configuration .............................................................................................................. 7
Page 2 of 7
1 Installation
A detailed installation instruction is included in the Readme file
Page 3 of 7
2 Configuration
This chapter describes the configuration of the payment modules.
2.1
Front office-Configuration
Open the view "Configuration>Form Service" and enter the MAC Key you've chosen
into the fields "MAC Key" and "MAC Key - Repetition". Enter the Shop notification
URL into the field "Shop notification URL". The detailed configuration instructions and
the URL to use, can be found in the Readme file
2.2
Basic Configuration
The following table lists the common parameter settings for all payment modules:
Name
Description
Merchant Identifier
Merchant Identifier
MAC-Key
MAC key, as set in the front office.
Merchant Name
Optional. Merchant name to be displayed in the form. If
empty, the merchant name configured in the front office is
displayed.
CSS-URL
Optional. URL of the cascading style sheet (CSS), the form
will be displayed with. If the parameter is not submitted the
URL that is configured in the merchant view will be used.
Notification URL
Optional. If the shop cannot be informed about the outcome
of the payment, a result page with a link to this URL is
displayed to the customer
Log level
Setting for the transaction log level. Allowed values are:
 “Off”, Logging is off
 “Transaction”, transaction data is logged
 “Development”, verbose logging
2.3
Credit card configuration
The following table lists all parameter settings for credit card:
Name
Description
Transaction type
Optional. Either "preauthorization" (reserve) or
"authorization" (reserve and capture). Default is
"preauthorization".
Activate payment method
Activates this payment method for this shop
Test mode
Activates the test mode. Transactions are sent to the
test server.
Page 4 of 7
Autocapture
Accepted issuing countries
Optional
and
only
for
transaction
type
„preauthorization“: Period (in hours) between
reservation and automatic capture. If not set, the
credit card is not automatically charged. Allowed
values: 0-168 hours.
Optional. Comma-separated list of accepted credit
card issuing countries. Two letter country codes
according to the current ISO 3166 standard (cf.
http://www.iso.org/iso/en/prods-services/
iso3166ma/02iso-3166-code-lists/list-en1.html).
If empty: all issuing countries are accepted.
Rejected issuing countries
Optional. Comma-separated list of rejected credit
card issuing countries. Two letter country codes
according to ISO 3166 standard.
If empty: all issuing countries are accepted.
Payment options


"cardholder" states that the form that is shown
to the customer contains a mandatory field for
entering the credit card owner.
"optionalcardholder" means that the form
includes a field for the card owner but the
customer is not required to enter anything
Without this parameter the form will not include an
input field for the credit card owner.

"sslifvisaenrolledu" specifies that, for a Visa
card for which an authorization is not possible,
an SSL transaction without liability shift will be
carried out. If not submitted, the transaction
will be aborted under these circumstances.
If you want to submit more than one payment option,
use a semicolon to separate the individual values,
e.g. " sslifvisaenrolledu;cardholder".
Active in Zone
Zone which this payment method is active in.
Order successful state
State which the order is set to after a successful
transaction.
Sort order
Sort order for the “payment method” view.
Transaktionsreferenz
Optional, only for credit card payments. Transaction
reference that will be shown on the merchant's credit
card statement in place of the shopping basket
number.
2.4
Direct Debit Configuration
The following table lists the settings for the direct debit:
Page 5 of 7
Name
Description
Transaction type
Activate
method
Optional.
Either
"preauthorization"
(reserve)
"authorization" (reserve and capture). Default
"preauthorization".
or
is
payment Activates this payment method for this shop
Test mode
Activates the test mode. Transactions are sent to the test
server.
Mandate prefix
A prefix used to generate the Mandate identifier.
Allowed characters are: letters numbers and +?:/-().,‘
Mandate name
Creditor name
Sequencetype
SEPA- sequence type




Autocapture
Payment options
oneoff, one-off dd sequence
first: First dd sequence
recurring: recurrent dd sequence
final: final dd sequence
Optional and only for transaction type „preauthorization“:
Period (in hours) between preauthorization and automatic
capture. If not set, the charge is not automatically captured.
Allowed values: 0-720 hours.
 "accountholder" states that the direct debit form that
is shown to the customer contains a mandatory field
for entering the account holder.
 "optionalaccountholder" means that the direct debit
form contains a field for the account holder but the
customer is not required to enter anything. Without
this parameter the direct debit form merely contains
input fields for account number and bank code.

"checklist": before the direct debit a blacklist is
checked. Only available if this option has been
activated for your account. If the form is displayed in
German, a sentence is displayed that the customer
consents that payment data is submitted to InterCard.
If you want to submit more than one payment option, use a
semicolon to separate the individual values, e.g. " checklist;
accountholder ".
Active in Zone
Zone which this payment method is active in.
Order successful state
State which the order is set to after a successful transaction.
Sort order
Sort order for the “payment method” view.
Page 6 of 7
2.5
PayPal configuration
The following table lists the parameter settings for Paypal:
Name
Activate
method
Description
payment Activates this payment method for this shop
Test mode
Activates the test mode. Transactions are sent to the test
server.
Active in Zone
Zone which this payment method is active in.
Order successful state
State which the order is set to after a successful transaction.
Sort order
Sort order for the “payment method” view.
2.6
giropay configuration
The following table lists the parameter settings for giropay:
Name
Activate
method
Description
payment Activates this payment method for this shop.
Test mode
Activates the test mode. Transactions are sent to the test
server.
Label0-4
Optional. Label for additional text field on the money transfer
form.
Use only in combination with a corresponding text field (see
below).
Text0-4
Optional. Content of additional text field on the money
transfer form.
Use only in combination with a corresponding label (see
above).
Active in Zone
Zone which this payment method is active in.
Order successful state
State which the order is set to after a successful transaction.
Sort order
Sort order for the “payment method” view.
Age verification
Enabled, a combined age verification and payment. If
disabled, a payment without age verification will be carried
out.
Page 7 of 7