Retail:NEXO Payment Provider
Contents |
Introduction
Web POS and Self-checkout payment provider for NEXO Spec v2.0 by https://www.nexo-standards.org/
Openbravo for Retail modules
 | Note: The Web POS and Self-checkout NEXO Payment Provider modules are available since 3.0RR20Q1 |
First install the NEXO Payment Integration modules required. In case it is only needed the NEXO Payment Provider for Web POS install the module Nexo Provider. For Self-checkout install also the module Nexo Provider for Self-checkout.
How to install modules is described in detail in the document Modules Management.
Configuration
Once it is installed it needs to be configured. Login in Openbravo as administrator.
In the window Channel- Touchpoint, select the terminal to configure and edit the field Hardware URL. This value indicates the address of the Hardware Manager connected to the Touchpoint. This is the same address used for the receipt printer, customer display, ...
Scroll down and go to the section Nexo Payment Information. Here fill in the following fields:
- POIID: POIID value for the till specified by ACI software.
- EFT Host: Hostname or IP data eSocket.POS is located (usually localhost).
- EFT Port: Listening port of eSocket.POS software (usually 40001).
The NEXO Payment Provider contains default templates for receipts and refunds that includes in the payment details the information provided in the Nexo payment transaction. This information includes fields like the card number, check number, ... depending on the payment instrument used by the customer.
To configure the default receipt templates, go to the window Organization, go to the section Web POS Formats and select the value Default NEXO Receipt Template for Print Ticket Template and Default NEXO Return Template for Return Template. Below you have an example.
To configure the Provider Group for NEXO and Payment Methods, follow the guide Retail:Payment Methods grouping by Provider User Guide to configure it. The Provider availables to use in the Provider Group window are Nexo Card Provider and Nexo Check Provider.
The payment method Search Key and Preferences should follow this table for each type of payment method type defined:
| Payment provider | Payment Method Type | Payment Method name | Payment Method SearchKey | Preference Name |
| Nexo Card Provider | BNPP | BNP Paribas | NEXO_bnpp.card | Nexo BNPP card |
| Nexo Card Provider | BNPPOnline | BNP Paribas Online | NEXO_bnpp.online.card | Nexo BNPP Online card |
| Nexo Card Provider | BRED | BRED Banque populaire | NEXO_bred.card | Nexo BRED card |
| Nexo Card Provider | BREDOnline | BRED Banque populaire Online | NEXO_bred.online.card | Nexo BRED online card |
| Nexo Card Provider | Card | Generic Card | NEXO_generic.card | Nexo generic card |
| Nexo Card Provider | CB | Co-operative Bank | NEXO_cb.card | Nexo CB card |
| Nexo Card Provider | CBOnline | Co-operative Bank Online | NEXO_co.online.card | Nexo CB online card |
| Nexo Card Provider | CE | Natixis | NEXO_ce.card | Nexo CE card |
| Nexo Card Provider | CEOnline | Natixis Online | NEXO_ce.online.card | Nexo CE online card |
| Nexo Card Provider | LBP | Land Bank of the Philippines | NEXO_lbp.card | Nexo LBP card |
| Nexo Card Provider | LBPOnline | Land Bank of the Philippines Online | NEXO_lbp.online.card | Nexo LBP online card |
| Nexo Card Provider | Mastercard | Mastercard | NEXO_mastercard.card | Nexo Mastercard card |
| Nexo Card Provider | Visa | Visa | NEXO_visa.card | Nexo Visa card |
| Nexo Card Provider | UNDEFINED | UNDEFINED | NEXO_undefined.card | Nexo undefined card |
| Nexo Check Provider | BNPPCheck | BNP Paribas Check | NEXO_bnpp.check | Nexo BNPP check |
| Nexo Check Provider | UNDEFINED | UNDEFINED | NEXO_undefined.check | Nexo undefined check |
Web POS operations
The Nexo Payment integration for Web POS support card and check payments, and card refunds. Check refunds are not supported.
Transactions can be aborted from the Web POS terminal. During the transaction the dialog that appears has a button Abort Transaction. If pressed by the cashier, an abort request will be sent to Nexo.
After the transaction has been properly processed. A receipt for the customer and other for the cashier will be printed.
Card payments and refunds
To process card payments and refunds using NEXO just open the configured terminal, create a receipt and add a payment with the payment method configured to use cards. Then follow the instructions of the point of sale.
Card payments cannot be voided. If you try to remove a processed card payment the message Nexo payments cannot be removed will appear.
Check payments
To process check payments using NEXO just open the configured terminal, create a receipt and add a payment with the payment method configured to use checks. Then follow the instructions of the point of sale.
To void the payment press the remove button in the payment line, confirm the removal and follow the instructions. Usually to remove a processed payment will require the authorization of the sales manager.
Last transaction
To recall the details of the last nexo transaction, execute the menu option Last NEXO Transaction. A dialog with the details will be displayed to the cashier.
Self-checkout operations
The Nexo Payment integration for Web POS support card and check payments, and card refunds. Check refunds are not supported.
Transactions can be aborted from the Web POS terminal. During the transaction the dialog that appears has a button Abort Transaction. If pressed by the cashier, an abort request will be sent to Nexo.
Card payments
To process card payments and refunds using NEXO just open the configured terminal, create a receipt and add a payment with the payment method configured to use cards. Then follow the instructions of the point of sale.
In case a dialog requires to be displayed to the cashier, an authorization window will be displayed to the customer asking for a sales assistant.
Then after the sales a sales assistant enters his user name and password. The dialog will be displayed to the sales assistant and the process can continue.
