Antoine Vandevenne (anv)
8722ea902e
Since odoo/documentation#903, the guideline for the location of new resource (images, downloadable files, RST includes...) files is to place those inside the directory of the RST page that references them. For example, if `doc1.rst` has a reference to `image.png` and to `download.zip`, the file structure should look like this: ├── parent_doc/ │ └── doc1/ │ │ └── image.png │ │ └── download.zip │ └── doc1.rst │ └── doc2.rst ├── parent_doc.rst Before this commit, most of the resource files were still located inside 'media' directories holding all the resource files referenced by RST pages located at the same level as these directories. In the example above, a single 'media' directory would hold all the resource files referenced by both `doc1.rst` and `doc2.rst`. Doing so prevented us from figuring out easily which resource file was referenced by which RST page and, thus, lead to unused resource files piling up in the repository. It also made it more complicated to define codeowners regex rules because a team could not simply be assigned to `/some_page.*` but needed to be assigned to both `/some_page\.rst` and to the location of 'media'. In order to help new content writers figure out the guideline when taking examples from other RST pages, this commit retroactively applies the guideline to existing resource files and 'media' directories. The left-over resource files that are not referenced by any RST page are removed. task-2497965 Part-of: odoo/documentation#2068
81 lines
2.8 KiB
ReStructuredText
81 lines
2.8 KiB
ReStructuredText
================================================
|
||
Connect an Ingenico Payment Terminal to your PoS
|
||
================================================
|
||
|
||
Connecting a payment terminal allows you to offer a fluid payment flow
|
||
to your customers and ease the work of your cashiers.
|
||
|
||
Please note that Ingenico is currently only available for customers in the
|
||
Benelux.
|
||
|
||
Configuration
|
||
=============
|
||
|
||
Connect an IoT Box
|
||
------------------
|
||
|
||
Connecting an Ingenico Payment Terminal to Odoo is a feature that
|
||
requires an IoT Box. For more information on how to connect an IoT Box
|
||
to your database, please refer to the :doc:`IoT documentation </applications/productivity/iot/config/connect>`.
|
||
|
||
Configure the Lane/5000 for Ingenico BENELUX
|
||
--------------------------------------------
|
||
|
||
Click on the F button of the terminal, then go in the
|
||
:menuselection:`PoS Menu --> Settings` and enter the settings password.
|
||
|
||
Now, click on connection change and TCP/IP. Type the IP of your *IoT
|
||
Box* (you can find it on the form view of your IoT Box). Then, enter
|
||
9000 as port. The terminal will restart. Once it is done, go on your
|
||
*IoT Box* form in Odoo and verify that the terminal has been found.
|
||
|
||
.. image:: ingenico/payment_terminal_02.png
|
||
:align: center
|
||
|
||
Configure the payment method
|
||
----------------------------
|
||
|
||
First, go in the general settings of the POS app, and activate the
|
||
Ingenico setting.
|
||
|
||
.. image:: ingenico/payment_terminal_03.png
|
||
:align: center
|
||
|
||
Go back in :menuselection:`Point of Sale --> Configuration --> Point of Sale`,
|
||
go in the payments section and access your payment methods. Create a new
|
||
payment method for Ingenico, select the payment terminal option Ingenico, and
|
||
select your payment terminal device.
|
||
|
||
.. image:: ingenico/payment_terminal_04.png
|
||
:align: center
|
||
|
||
Pay with a payment terminal
|
||
===========================
|
||
|
||
In your *PoS interface*, when processing a payment, select a *Payment
|
||
Method* using a payment terminal. Check that the amount in the tendered
|
||
column is the one that has to be sent to the payment terminal and click
|
||
on *Send*. When the payment is successful, the status will change to
|
||
*Payment Successful*.
|
||
|
||
.. image:: ingenico/payment_terminal_05.png
|
||
:align: center
|
||
|
||
If you want to cancel the payment request, click on cancel. You can
|
||
still retry to send the payment request.
|
||
|
||
If there is any issue with the payment terminal, you can still force the
|
||
payment using the *Force Done*. This will allow you to validate the
|
||
order in Odoo even if the connection between the terminal and Odoo has
|
||
issues.
|
||
|
||
.. note::
|
||
This option will only be available if you received an error message
|
||
telling you the connection failed.
|
||
|
||
Once your payment is processed, on the payment record, you’ll find the
|
||
type of card that has been used and the transaction ID.
|
||
|
||
.. image:: ingenico/payment_terminal_06.png
|
||
:align: center
|