Projects:Retail Payment Providers/Ingenico

Contents 1 Introduction 2 Implemented transaction types 2.1 Configuration 2.2 Ingenico credit card sale 2.3 User Guide 2.4 User Stories 3 Hardware Manager 4 Ingenico's Card Reader

Introduction

This document describes the specific details related to the implementation of the Ingenico ICT220 payment device in Openbravo. This device is connected to the computer using Serial interface and it handles directly the communication with the payment gateway.

To use this development is needed to have org.openbravo.paymentgateway.ingenico module installed and Ingenico's plugin for the Hardware Manager.

Implemented transaction types

• Sales
• Refunds

Configuration

Go to the window POS Terminal Type and modify the following value for the payment method you want to configure to process payments using Ingenico:

• Payment Provider: Select Ingenico Credit Card Sale.

Ingenico credit card sale

Process a payment or a refund using a credit card read by a Ingenico iCT220 reader.

User Guide

Once the backend has been configured properly the WebPOS user will see the payment method on the keyboard.

When that payment gets selected a popup will rise.

If you try to void the previous transaction an error message will rise since it is not possible. If voiding a sale is wanted a refund should be done instead voiding the transaction.

User Stories

Story 1:

1. François, the WebPOS user, is closing a sale.
2. He selects the Ingenico Payment method and pays the whole ticket.
3. A popup rises with the information of the payment.
4. The customer inserts its card on the Ingenico device and enters the PIN.
5. When the process gets finished, the popup disappears and the payment gets complete.

Story 2:

1. A customer asks François, the WebPOS user, to refund a ticket.
2. He selects the Ingenico Payment method and refunds the whole ticket.
3. A popup rises with the information of the refund.
4. The customer inserts its card on the Ingenico device.
5. When the process gets finished, the popup disappears and the refund gets complete.

Story 3:

1. François, the WebPOS user, is closing a sale.
2. He selects the Ingenico Payment method and pays the whole ticket.
3. A popup rises with the information of the payment.
4. The customer click the cancel button of the device by mistake.
5. The popup disappears and the payment has not been done.

Hardware Manager

openbravohw.properties needs to be modified in order to use Ingenico Card Reader.

machine.payment = ingenico:parameter1,parameter2

parameter1 is the serial port where the device is plugged and parameter2 is the seconds that the device will be waiting to complete the process (if there is no parameter2 it will wait 120s).

Is possible to test the Ingenico device trough the Hardware Manager. Open the HW and go to Payment tab. If openbravohw.properties has been configured properly you can test the device without WebPOS.

Ingenico's Card Reader

It is needed to have the device connected to the net in order to make the transactions since the device will send the request to the payment server.

Also, the device must have installed the Concert Protocol