View source | Discuss this page | Page history | Printable version   
Toolbox
Main Page
Upload file
What links here
Recent changes
Help

PDF Books
Show collection (0 pages)
Collections help

Search

Retail:Adyen Payment Provider

Contents

Introduction

This document describes the installation and configuration of the Openbravo payment integration with Adyen. Adyen is a global payment company that allows business to accept e-commerce, mobile and point-of-sale payments.

This integration takes advantage of the payment methods grouping by provider functionality that allows to use one single payment button in Web POS and select a different payment method depending on the type of card used in the payment transaction: VISA, AMEX,...

This integration supports:

Desktop integration

The Web POS application communicates with the Adyen backend through the Hardware Manager, and it is the Adyen backend who manages the communication with the payment device.

The communication with the Adyen backend is based in HTTP and REST, and uses the Adyen's point-of-sale solution.

This is an overview of the architecture.

Adyenarchitecture.png

Installation

Payment terminal

This integration has been developed and tested with the Verifone V400M model. But it will work with any other supported device by Adyen.

First you need to configure your merchant account and board the device provided by Adyen. This is done in the Adyen customer area in the section Point of sale > Devices. Follow the Adyen Board the terminal documentation to configure your account and board the device.

Openbravo application

As System administrator you need first to install the module Adyen Payment Provider. This module implements the integration. After the module is installed, you can rebuild the application and start the configuration. Follow the Modules_Management documentation for the details to install a new module.

In the case one or more payment terminals need to be configured using the Local Adyen architecture, the Adyen hardware manager plugin and certificates must be installed. Live and test certificates can be downloaded from the Adyen site: Protect local communications.

Certificates must be copied to the root folder of the hardware manager and must be named adyen-terminalfleet-live.pem for Local and adyen-terminalfleet-test.pem for Local (Test certificate).

Also the Hardware Manager configuration file openbravohw.properties must include the following entry:

process.adyen = adyen

For more information about the Adyen architectures read the following document: Choose an integration architecture

Configuration

To configure Openbravo log in Openbravo as Company administrator and follow these steps.

In the window Payment Provider create a new record and select in the field Provider the value Adyen. In Name The label to display in the payment button.

In order to test the Openbravo configuration and simulate payments, refunds, void transactions and card adquisitions without having a payment device or a merchant account you can use the provider Adyen Mock. This provider will simulate a connection error if the amount is 100.01, a user cancellation if the amount is 100.02, a success of a partial amount of 50.00 if the amount is 100.03 and success for the full amount in any other case.


Bulbgraph.png   The Adyen Mock provider does not perform real transactions, just simulate them and must not be used in production environments under any circumstances.


Here you have an example of a 'Payment Provider configuration using Adyen.


Adyenpaymentprovider.png

In the Organization window, select the store to configure, go to the Adyen Payment Provider and fill in the API Key field. This is the value provided by Adyen to you as a merchant. This can be obtained in the Adyen customer area in the section Account > Users. Follow the Adyen How to get the API key documentation for more detail.


Adyenorganization.png


Then complete the payment methods configuration in the windows Channel - Touchpoint and Channel - Touchpoint Type linking in this last window the corresponding payment methods with the Payment Provider created in the previous step and the Payment Method Type assigned to each payment method. For more information about how to configure payment methods using this Payment Provider go to the guide Payment Methods grouping by Provider.

Payment terminals must be registered in Openbravo in the window Adyen Terminal. Create one record for each device with the following fields:

If Local is selected the following fields must be filled in too:

Bulbgraph.png   Local values select the Adyen local architecture. Technically this indicates to perform the payment requests directly to the payment terminal instead of the Adyen main servers. This allows to perform payment requests in case of the payment terminal is offline.
Bulbgraph.png   The Cloud (Testing mode) and Local (Testing certificates) values use the testing Adyen platform. It can be used to verify all configuration is OK but do not perform real transactions, just simulate them and must not be used in production environments under any circumstances.

Here you have an example of a Adyen Terminal record.


Adyenerpterminal.png


Finally in the Channel - Touchpoint window, select the Adyen terminal to be used with each Openbravo POS terminal. Here you must be sure to fill in the Hardware URL field and select in Adyen Terminal one of the terminals registered in the previous step. The field Hardware URL is required. If the cloud architecture is configured, the Adyen integration requires the Hardware Manager running as a proxy for the communications between the POS terminal and the Adyen API. But there is no need to do any configuration in the Hardware Manager. But in case of local architecture, the Hardware Manager is required with the Openbravo Adyen plugin and the correct Adyen certificates as explained in the installation section of the Hardware Manager.

Here you have an example of a POS terminal configured with one Adyen terminal.


Adyenerppos.png

Operation

Once everything is configured, the operation of the POS terminal is as usual. In the moment to process a payment transaction select the button with the Payment Provider name configured and add the payment. In this case, a dialog will appear waiting for the Adyen terminal to process the payment. And after the payment is completed. The terminal will print a customer and merchant copy, the dialog will disappear and the payment line will appear in the Web POS application.

When closing the receipt, the receipt will be printed.

Adyenpospayment.png


If the payment terminal has been configured in Openbravo with the Has Printer field checked. The POS will expect the payment terminal to print the payment receipt, otherwise the POS will print the payment receipt using the main receipt printer configured for the POS touchpoint.

Paymentreceipt.png

Last transaction

If a new copy of the payment receipt is needed you can go to the POS menu and select the option Adyen Last transaction

Diagnostics

To check the status of the payment terminal select the POS menu option Adyen Diagnostics. A receipt will be printed with a detailed status of the payment terminal.

Diagnostics.png

Card acquisition

This integration also allows tokenizing the customer's card for customer identification and payments without the customer's card present. The acquisition of a customer card must be done in a payment process. This means first must be configured the customer to request the card acquisition and in the next payment of this customer using a card, the card will be acquired by Adyen and the token generated stored in Openbravo.

To configure this functionality, the customer information has a new field named Request Card Acquisition, and when this field is selected it must be filled in also the field named Recurring Contract, that has three possible values: Recurring, One click, and One click, Recurring. This last field indicates the type of recurring contract to be used:

Bulbgraph.png   The POS terminal only integrates the process of acquiring the card. It does not integrate the use of the token of the acquired card for future uses.

The customer fields for card acquisition can be edited in the backend:


Adyenerpcustomer.png

Or in the POS terminal:


Adyenposcustomer.png

Once the token of the card acquired has been stored in Openbravo, the field Stored Card will be displayed as checked in the backend and in the POS terminal. With the card stored it is possible to request the card again, just mark the field Request Card Acquisition, and the card will be acquired in the next payment of the customer.

In case you want to delete the stored card token there is a button in the backend, in the window Business Partner, named Remove token, that deletes the token of the stored card of the customer.

Retrieved from "http://wiki.openbravo.com/wiki/Retail:Adyen_Payment_Provider"

This page has been accessed 2,984 times. This page was last modified on 15 December 2020, at 09:58. Content is available under Creative Commons Attribution-ShareAlike 2.5 Spain License.