Payment Plug-In for shop system
Transcrição
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