User Manual for Ingenico ePayments Shopware Plugin¶
Shopware versions: from 5.2.x
Plugin version: 1.5.0
Plugin language : german, english
This manual shows you step by step how to install the plugin to your online shop. Please test the installation and the configuration of the plugin on a test system before installing it on your live shop.
- Table of contents
- User Manual for Ingenico ePayments Shopware Plugin
- The Plugin
- StatusCodeMapping
- AfterSale
- Adding an own payment method
- Credit Cards - Hosted Tokenization
- Scoring and PayID in Orderlist
- Configuration in Ingenico backend
The Plugin¶
The Ingenico ePayments plugin for Shopware provides the opportunity to handle with all payment methods, which are offered by Ingenico.
Choose your favoured payment methods and add them easily to your shopware shop.
Following default payment methods will supported by our plugin:
- Credit cards
- PostFinance Card
- giropay
- Sofortüberweisung.de
- iDEAL
- PostFinance E-Finance
- eps Österreich
- Debit DE
- Debit NL
- PayPal
- mPass
- BillPay
- Mister Cash
In addition, the plugin provides the possibility to add further payment methods, which has to be supported by Ingenico.
Please contact Ingenico to get required options (like for e.g. DirectLink) activated.
NOTE: We already support the new mandatory 3D Security v.2 standard, or so called PSD2.
Plugin Installation¶
Before you start with the installation process, backup your database and your online shop. If you have concerns about installing the plugin, let this job be done by a professional, or feel free to contact us for help. Please, follow this instruction carefully for an undisturbed use.
Shopware Plugin Manager¶
- Log in to your shop backend.
- Go to: Configuration > Plugin Manager > My Extensions > Community Extensions.
- Click the button add Plugin manually.
- Choose your directory, which has the plugin and upload it.
FTP Plugin Upload¶
- Build a connection to your webserver, i.e. via FTP.
- Copy the content of the directory MoptIngenico to your shop directory engine/Shopware/Plugins/Community/Core.
Plugin Activation¶
Activate the plugin in Configuration > Plugin Manager > My Extensions > Community Extensions. by clicking the Activate plugin button. Fill in your credentials and security data, choose your configuration and save the plugin settings.
Plugin Configuration¶
Credentials:
- PSP-ID: The payment service provider id is the given user name of your company for your Ingenico* account.
- API-User ID: Name of your API-User, check up your existing API-users in Configuration/Users in your Ingenico* account.
- API-User Password: Password of your API-User.
Security:
- SHA-IN: Registered security key(SHA-IN), check up your key in Configuration/Technical information/Data and origin verification..
- SHA-OUT: Registered security key(SHA-OUT), check up your key in Configuration/Technical information/Transaction feedback..
Configuration:
- Live-Modus: Choose between test and live mode.
- Transaktionsmodus: Choose your transaction mode. Set your specified settings under Configuration/Technical information/Global security parameter. Not every payment method supports Sale.
- Log Level: Choose your log level. For productive mode we suggest `error` as log level.
- Logging Rotation Time: Choose the number of days, which log files should be saved.
Payment Template:
- Logo: The choosen logo will be displayed on the payment page.(Only https)
- Template Title: Title on the payment page.
- Background Color: Table background colour on the payment page.
- Text Color: Table text colour on the payment page.
- Table Background Color: Table background colour on the payment page.
- Table Text Color: Table text colour on the payment page.
- Button Background Color: Button background colour on the payment page.
- Button Text Color: Button text colour on the payment page.
- Button Font Type: Font type/family used on the payment page.(Arial)
Hint: All hexcodes will be supported (e.g. #0088FF sky-blue)
Expert Options:
- Show Expert Fraud Detection Show Scoring value of the customer in the order list*
Actions:
-
Download Logfile: Logfile can be downloaded using built-in Shopware logfile manager.
In backend: Open Configuration > Logfile > the tab System log > in the file click on the drop-down list > choose any logfile started with mopt_ingenico.
StatusCodeMapping¶
- Before using the Ingenico plugin, you have to configure the Ingenico status mapping.
- Open Configuration > Ingenico > Ingenico Config. A list will show you the current configuration of the states
- You have to decide, which response of Ingenico will be allowed to create an order. After a payment the customer will be either redirected to your finish site or back to the checkout overview depending on the acception of the state.
- Additionally you can map each Ingenico state to one of your shopware states, which will change the payment state to the last response of Ingenico.
AfterSale¶
- For capture and refund actions, open Customers > Orders.
- Choose your order, which you want to edit and then click on the position tab and mark all positions, which should be influenced by this action.
- Now use the capture or refund position action.
- A window will open with an information of the amount of your marked positions.
- You can manually change the amount and add shipping costs additional to the amount of your action.
- Choose between an action, which can be repeated several times or end the possibility to repeat this action again.
Hint: If you change the amount of the action, taxes will not be included
Adding an own payment method¶
- Open in your shop backend Configuration > Payment methods.
- Choose an Ingenico payment method and duplicate that payment method. (Important: only duplicate the payment methods with action: MoptIngenico/index)
- Now there exists a copy of a payment method with the same attributes as the chosen method except an additional number on the name attribute.
- Change the name of the copy (name with number) to the desired payment method, using our name convention (mopt_ingenico__type__brand).
- Now adapt the description and other important attributes and test the payment method.
- Do not forget to map the shipping methods to the new active payment methods. (shopware backend -> Configuration -> shipping costs)
- For Creditcards as redirect method* mopt_ingenico__creditcards.tpl is added in the template field, otherwise let it empty
- Hint: You can only add a payment method which is supported by Ingenico and was activated in your Ingenico Account.
* for the redirect method, no alias creation is required and no in-page form for the credit card details will be available, instead the client has to choose the card brand in the payment information and upon making an order he will be forwarded to the credit card payment page.
- Example: If you want to add the credit card payment method Visa, edit the name to mopt_ingenico__CreditCard__VISA
- Template: mopt_ingenico__creditcards.tpl
- Action: MoptIngenico/index
Credit Cards - Hosted Tokenization¶
Make sure that Alias-Management is activated on ingenico side.
Our Plugin provides the Ingenico Hosted Tokenization Page for all common credit cards.
On the shipping-payment page the customer will always have to introduce his card details onto the Hosted Tokenization page. In this way, the card details never pass through your own web server. Its advantage is that the customer will stay on your page and build a complete One Page Check-out experience.
All major credit card brands (VISA, MasterCard, American Express, Diners) are supported.
Activate the payment method credit card (with hosted tokenization template) in your backend and change the labeling to your preferred description.
Scoring and PayID in Orderlist¶
Our plugin supports the Expert Fraud Detection by Ingenico.
You have to configure the fraud detection on the Ingenico backend.
If you enable "Show Expert Fraud Detection" in our plugin, you will see for each successful order a color code for each customer in the order list to check their credit rating.
The Ingenico reference id will be displayed always in the order list.
Configuration in Ingenico backend¶
Global transaction parameters¶
Settings for a sandbox account of Ingenico will be done on https://secure.ogone.com/Ncol/Test/BackOffice/login/. For the production Ingenico account use https://secure.ogone.com/Ncol/Prod/Backoffice/login.
The settings will be done on Configuration > Technical Information. Perform the settings on the basis of the illustrations.
Global security parameters¶
We only support SHA-512 hashing and the default character encoding nowadays is UTF-8. If you notice an issue on displaying special character, change the character encoding to solve that problem.
Data and origin verification¶
Choose your SHA-IN pass phrase and use the same SHA-IN in the Ingenico plugin on the shopware backend.
Transaction feedback¶
Enter your shop url + /MoptIngenico/deferredFeedback into the "Direct HTTP server-to-server request" and "the HTTP request for status changes" form.
Choose your SHA-OUT pass phrase and use the same value for the Ingenico plugin on the shopware backend.
We suggest to select all dynamic parameters for a flawless launch