Kategorien

Saferpay is the easy, flexible, secure and comprehensive e-payment solution from SIX Payment Services for easier and more secure payment in your online shop.

Worldline [Euronext: WLN] is the European leader in the payments and transactional services industry and #4 player worldwide. With its global reach and its commitment to innovation, Worldline is the technology partner of choice for merchants, banks and third- party acquirers as well as public transport operators, government agencies and industrial companies in all sectors. Powered by over 20,000 employees in more than 50 countries, Worldline provides its clients with sustainable, trusted and secure solutions across the payment value chain, fostering their business growth wherever they are

SIX Payment Services has been part of Worldline since the end of 2018, making it Europe's largest technology partner for banks and merchants. The tailor-made solutions from SIX Payment Services include a broad portfolio of payment terminals and the acceptance and processing of national and international payments with credit, debit and prepaid cards as well as the smartphone.  

The purpose of providing an extension for Saferpay Payment Solution for SAP Commerce Cloud is to aid the integration of Saferpay into a Hybris implementation. Hybris Store accelerator will use the newly developed extension to interact with Saferpay. The extension will transform the Hybris cart model to Saferpay data structures. The payment result from Saferpay is captured in Hybris and relevant messages if any are displayed to the storefront.  

The Saferpay Payment Solution for SAP Commerce Cloud extension provides a configurable spring component which helps shorten the implementation cycle and reduce system development, testing efforts and maintenance costs for payment integration. The extension package contains most of the backend code needed for integrating Saferpay into the hybris commerce platform. The Merchants can use the Saferpay Payment Solution for SAP Commerce Cloud extension with their hybris project to integrate Saferpay. 

It supports the following payment methods of saferpay to work with SAP commerce cloud plugin.

This plugin supports all the features of online payment methods like payment capturing, refunding & cancellation. All these payment operations are done in the Sap Commerce Cloud backend & will be synced to Saferpay account also. 

In our Hybris backoffice, we can see the Saferpay Account section, which shows the accounts. You can create any number of Saferpay accounts in the system. But only one account can be active at a time.

Figure 1: Saferpay account section in the backoffice view

Figure 2: Saferpay account section edit mode

Figure 3: Payment modes section inside Saferpay account

Configure saferpay account from Account -> Saferpay Account

The following configurations are available in Saferpay Account

Figure 4: Saferpay Accounts

Figure 5: Saferpay fields access token generation button

Figure 6: Saferpay Account licence configuration

Individual payment methods which comes under Saferpay plugin can be configured from Sap Commerce backoffice under Price settings → Payment modes. You can also add new Saferpay standard payment modes.

Figure 7: List of payment modes

Settings of each payment modes can be easily configured by double clicking, editor area will be opened.

Figure 8: Payment mode editor

Saferpay payment method specific configuration is explained in detail below:

You can see the list of all the transactions, that has been initiated from the hybris. By selecting each transaction, you will be able to see: 

Figure 9: Transaction

When the “Capturing” is set to “Manual Capture”, the merchant will have the option to Capture or Cancel transactions. If we click Capture, the transaction will be captured.

Only authorized transactions can be manually captured or cancelled from our backoffice.

Figure 10: Capture cancel button

By clicking on the capture action, you will be prompted to confirm the capturing. In addition, you can provide a lower amount to capture along with a description also. A transaction may only be captured once, also eliminating the option of a cancel.

Figure 11: Capture pop up window

On clicking on the cancel action, you will be prompted to confirm the cancellation. 

Figure 12: Cancel pop up window

Just like Saferpay transactions, you can also see/manage the Saferpay refund transactions. This is an item type derived from the Saferpay transaction thus all above mentioned attributes are also available here.  

Figure 13: Refund transaction

A captured transaction is refundable. 

Figure 14: Refund

Refund action can only be initiated for a captured transaction. On clicking on the action, you will be prompted with a confirmation popup. It also allows you to enter a lesser amount along with a description. Thus, you can initiate another refund for the remaining amount if you choose a lesser amount previously. The refund transactions can be seen in the Saferpay refund transaction section. 

Figure 15: Refund popup

All the refunds for an order will be diplayed in Order section.

Figure 16: Refund list 

Alias Manager allows your customer to save the credit card information in his account and to use for the future payments.

Saferpay Secure Card Data or SCD in short, is a service for saving sensitive payment means information in the certified Saferpay data centre. By using SCD the payment data is separated from the merchant application and no longer comes in contact with it. The stored Secure Card Data can be referred from future payments initiated via "Transaction” interface.

This feature is available for payment methods that supports secure card data. Sensitive payment data is stored only in certified Saferpay data centre. If the settings ‘Is Save Card Available?’ is active in Payment method configuration page, then logged in customers can save and use their card for future transactions. 

Figure 17: Payment method selection page

In addition to this, customer can manage the saved cards from his customer account in My account section. A tab “Payment details” is added in My account page from which customers can add, update and delete cards from his account.

For saving Twint and Postcard you need to select respective field from the drop down. For all other cards you can choose Cards from the drop down.

Figure 18: Payment details page in my account

Error Log section provides information about transactions performed by Saferpay that could not be completed successfully.  

Error details provided by payment gateway will be logged and displayed in Saferpay Transactions under ‘Error Status’.  

Figure 19: Error status in Saferpay Transactions

Installing the Saferpay Payment Solution for SAP Commerce Cloud extension will provide you with most of the payment modes. You can see that in our backoffice. You can also add new Saferpay standard payment modes.

Figure 20: Payment modes

The following payment methods are supported in SAP Commerce 2211 :

Klarna Payments is a 3rd party payment method, that is split into three ways of payment: 

Figure 21: Klarna payment

Read More

Other than general settings some additional settings need to be configured to use Saferpay credit card/Saferpay Fields:

Figure 22: Saferpay fields additional settings

Figure 23: Saferpay Fields Settings in backoffice

Read More

Other than general settings, additional settings such as bank accounts are available for Saferpay iDeal payment method. Here admin able to add /remove bank account. Customer able to select added bank account by admin during checkout

Figure 24: Ideal bank section

Refer: 

User can see all the Orders in the Orders tab, once the user open Orders tab user can view the all the orders which are listed in a table with columns 

Figure 25 : Refund action confirmation

User can open and view the order details by double clicking each order, order details were shown under various tabs naming 

Figure 26: Orders page

Order status of each orders placed gets updated in the ‘Order status’ column. The order status is changed based on the transaction status.

Figure 27:Order status

This Software License Agreement ("Agreement") is between you (both the individual downloading and/or installing the Software and any legal entity for or on behalf of which the individual is acting) ("You" or "Your") and PIT Solutions AG. ("Licensor").

THIS LICENCE AGREEMENT CONTAINS THE TERMS AND CONDITIONS TO USE SOFTWARE. BY CLICKING ON THE “ACCEPT” BUTTON, YOU ARE CONSENTING TO BE BOUND BY AND ARE BECOMING A PARTY TO THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF THIS AGREEMENT, CLICK THE “DO NOT ACCEPT” BUTTON WHICH WILL STOP YOUR ACCESS AND USE OF THE SOFTWARE. IF YOU HAVE ALREADY INSTALLED THE SOFTWARE BUT DO NOT AGREE TO ANY TERM OR CONDITION IN THIS AGREEMENT, THEN PLEASE UNINSTALL THE SOFTWARE IMMEDIATELY.

TAKING ANY STEP TO SET UP, DOWNLOAD OR INSTALL THE SOFTWARE MEANS THAT YOU ACCEPT ALL OF THE TERMS OF THIS LICENSE AGREEMENT. PERMISSION TO DOWNLOAD, INSTALL AND/OR USE THE SOFTWARE IS EXPRESSLY CONDITIONED ON YOU AGREEING TO AND FOLLOWING THESE TERMS.

THE SOFTWARE IS TO BE USED SOLELY IN CONNECTION WITH THE THIRD PARTY SOFTWARE AND YOU MUST SATISFY YOURSELF THAT THIS SOFTWARE IS SUITABLE FOR YOUR NEEDS AND THAT YOUR SYSTEM SATISFIES THE REQUIREMENTS FOR THE USE OF THIS SOFTWARE AS SET OUT IN THE DOCUMENTATION.

PARTIES, THEREFORE, AGREE AS FOLLOWS:

“Agreement” - means this Licence Agreement and any documents referred to in this Agreement;

"Documentation"  - means written documentation, specifications and help content made generally available by Licensor to aid in installing and using the Software, or otherwise provided by Licensor to you in connection with the Software.

“Software” - means Saferpay Payment Solution for SAP Commerce Cloud, the data supplied with such software, executable program modules thereof, computer readable associated media, upgrades and updates of the software provided to you by the Licensor.

“Third Party Software” - includes the third party software with which the Software is designed to be used, as described in the Documentation .

For downloading the Software, you may have to provide your name, email address, address, and telephone number to the Licensor which will be subject to the terms in the Privacy Policy.

Licensor does not own or control Third Party Software or other software which are placed in the same environment as that of the Third Party Software. Likewise, Licensor does not own or control any websites within which the Third Party Software or other related software is placed.

Accordingly, all your access and use of the Third Party Software and third party websites is at your own risk and costs. Licensor is not liable for any loss or damage caused to you by your access or use of Third Party Software or third party websites.

Your acceptance of this Agreement will signify your unconditional agreement to all the terms and conditions contained in this Agreement. Upon your acceptance of this Agreement, you will be permitted to download a copy of the Software for Your use in accordance with the Documentation.

SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" WITHOUT AN REPRESENTATIONS OR WARRANTIES, AND YOU AGREE TO USE THEM AT YOUR SOLE RISK. TO THE FULLEST EXTENT PERMISSIBLE BY LAW. SIX Payment Services V1.4 36 | 38 LICENSOR EXPRESSLY DISCLAIMS ALL WARRANTIES OF ANY KIND WITH RESPECT TO THE SOFTWARE AND DOCUMENTATION, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, SATISFACTORY QUALITY, ACCURACY, TITLE OR NON-INFRINGEMENT OF THIRD PARTY RIGHTS.

IN NO EVENT WILL LICENSOR OR ITS AFFILIATES BE LIABLE IN CONNECTION WITH THIS AGREEMENT OR ITS SUBJECT MATTER, UNDER ANY THEORY OF LIABILITY, FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES, OR DAMAGES FOR LOST PROFITS, REVENUE, BUSINESS, INFORMATION, SAVINGS, DATA, USE, INTERRUPTION TO BUSINESS, OR COST OF SUBSTITUTE PROCUREMENT, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR IF SUCH DAMAGES ARE FORESEEABLE.

IN NO EVENT WILL LICENSOR’S LIABILITY FOR ALL DAMAGES EXCEED THE AMOUNTS ACTUALLY PAID BY YOU TO LICENSOR FOR THE SOFTWARE OR IF NO AMOUNT IS PAID, THEN AN AMOUNT OF $100.

YOU SHALL NOT INSTITUTE ANY ACTION IN ANY FORM ARISING OUT OF THIS AGREEMENT MORE THAN ONE (1) YEAR AFTER THE CAUSE OF ACTION HAS ARISEN.

This Agreement is effective from the time you download or start using the Software and will remain valid until terminated. Licensor may terminate this Agreement at any time upon Your breach of any provision. If this Agreement is terminated, you will stop using the Software, permanently delete it from the equipment where it resides, and destroy all copies of the Software and Documentation in Your possession, confirming to Licensor in writing that You have done so. Sections 2, 3, 4, 5, 6, 7, 9, and 10 will continue in effect after this Agreement's termination.

You acknowledge that this Agreement and its contents and other information, including, without limitation, information on or about the Software, source code, functionalities, Documentation, other technical SIX Payment Services V1.4 37 | 38 information, know-how, and trade secrets that You receive in connection with this Agreement is Licensor’s confidential information (“Confidential Information”). You will use reasonable diligence, which will in no event be less than the degree of care which You use in respect to Your own
confidential and proprietary information of like nature, to prevent the unauthorized use, disclosure, reproduction, or distribution of Confidential Information to any other individual, corporation or entity. You shall not use the Confidential Information for Yourself except for the limited licence granted under this Agreement.

The purpose of providing an extension for Saferpay Payment Solution for SAP Commerce Cloud is to aid the integration of Saferpay into a Hybris implementation. Hybris Store accelerator will use the newly developed extension to interact with Saferpay. The extension will transform the Hybris cart model to Saferpay data structures. The payment result from Saferpay is captured in Hybris and relevant messages if any are displayed to the storefront.

The Saferpay Payment Solution for SAP Commerce Cloud extension provides a configurable spring component which helps shorten the implementation cycle and reduce system development, testing efforts and maintenance costs for payment integration. The extension package contains most of the backend code needed for integrating Saferpay into the hybris commerce platform. The Merchants can use the Saferpay Payment Solution for SAP Commerce Cloud extension with their hybris project to integrate Saferpay.

This document describes the functionalities and Payment Integration of the Saferpay Payment Solution for SAP Commerce Cloud.

Figure 1: Functional Diagram

This extension is built on top of Hybris version 2211. Thus, make sure you have the project running with version 2211.

The following table summarizes the proposed platform and software recommended for the system hosting.

Table 1: Application Software

Table 2: Development Tools

The following functionalities are covered as part of the “Saferpay Payment Solution for SAP Commerce Cloud Plugin”.

The Payment Page Interface provides a simple and easy integration of Saferpay into e-commerce web shop. The Saferpay Payment Page can be used with a Saferpay e-commerce license as well as with a Saferpay Business license. It allows the processing of all payment methods that are available with Saferpay.

Tokenization allows your customer to save the credit card information in his account and to use for the future payments.

Saferpay Secure Card Data or SCD in short, is a service for saving sensitive payment means information in the certified Saferpay data centre. By using SCD, the payment data is separated from the merchant application and no longer comes in contact with it. The stored Secure Card Data can be referred from future payments initiated via “Transaction” interface.

This feature is available for payment methods that supports secure card data. Sensitive payment data is stored only in certified Saferpay data centre. If the settings ‘Is Save Card Available?’ is Active in Payment method configuration page, then logged in customers can save and use their card for future transactions. Also, they can update or delete the saved card data.

The purpose of providing an extension for Saferpay is to aid integration of Saferpay into a Hybris implementation. This document describes how to install and configure the extension to work with any Hybris implementation.

As Hybris is built on the spring framework this makes it highly customizable and extensible. The extension also utilizes this framework, so can also be easily extended to add specific behavior if required.

This extension is built on top of Hybris version 2211. Thus, make sure you have the project running with version 2211 or later

The plugin is supplied as a zip file. Take the following steps to include the extensioninto your Hybris application:

ant addoninstall -Daddonnames="saferpaycustomaddon"- DaddonStorefront.yacceleratorstorefront="XXXstorefront"

Saferpay uses some properties in order to manage the process. Those properties can be seen in the project.properties. Some of the main properties are listed below:

E.g. In our context, it is ShopInfo:clientInfo = Hybris_2211:PITs_1.10 Those properties have names that speak for itself.

The properties saferpay.paymentPage.orderItemType, saferpay.paymentPage.deliveryType hold the values for product type, delivery type for KLARNA payments.

Possible values for DeliveryType include: EMAIL, SHOP, HOMEDELIVERY, PICKUP, HQ,

Possible values for OrderItemType include: DIGITAL, PHYSICAL, SERVICE, GIFTCARD, DISCOUNT, SHIPPINGFEE, SALESTAX, SURCHARGE.