From b65cfc12ddc0643b86fe37b707a5f0ec23e7bc12 Mon Sep 17 00:00:00 2001 From: LoredanaLrpz Date: Wed, 18 May 2022 14:50:08 +0000 Subject: [PATCH] [ADD] pos: adyen payment terminal Task ID: 2808584 Do not Forward port r+ closes odoo/documentation#2333 X-original-commit: 85b5374995b686de02454904d1535fdff922c6c4 Signed-off-by: Antoine Vandevenne (anv) Signed-off-by: Perazzo Loredana (lrpz) --- .../sales/point_of_sale/payment.rst | 1 + .../sales/point_of_sale/payment/adyen.rst | 77 +++++++++++++++++++ .../sales/point_of_sale/payment/ingenico.rst | 4 +- .../sales/point_of_sale/payment/vantiv.rst | 4 +- 4 files changed, 82 insertions(+), 4 deletions(-) create mode 100644 content/applications/sales/point_of_sale/payment/adyen.rst diff --git a/content/applications/sales/point_of_sale/payment.rst b/content/applications/sales/point_of_sale/payment.rst index fa0227665..2a091e385 100644 --- a/content/applications/sales/point_of_sale/payment.rst +++ b/content/applications/sales/point_of_sale/payment.rst @@ -7,6 +7,7 @@ Payment Terminals .. toctree:: :titlesonly: + payment/adyen payment/ingenico payment/vantiv payment/six diff --git a/content/applications/sales/point_of_sale/payment/adyen.rst b/content/applications/sales/point_of_sale/payment/adyen.rst new file mode 100644 index 000000000..28d331125 --- /dev/null +++ b/content/applications/sales/point_of_sale/payment/adyen.rst @@ -0,0 +1,77 @@ +===== +Adyen +===== + +Connecting an **Adyen payment terminal** allows you to offer a fluid payment flow to your customers +and ease the work of your cashiers. + +Configuration +============= + +Start by creating your Adyen account on `Adyen's website `_. Then, board +your terminal following the steps described on your terminal's screen. + +.. seealso:: + - `Adyen Docs - Payment terminal quickstart guides + `_. + +Configure the payment method +---------------------------- + +First, go to :menuselection:`Point of Sale --> Configuration --> Settings --> Payment Terminals`, +and enable :guilabel:`Adyen`. +Then, go to :menuselection:`Configuration --> Payment Methods` and create a new payment method. +Select :guilabel:`Adyen` in the :guilabel:`Use a Payment Terminal` field. + +.. note:: + The selected journal **must** be a bank journal for the :guilabel:`Use a payment terminal` field + to appear. + +Finally, fill the mandatory fields with an :guilabel:`Adyen API key`, and an :guilabel:`Adyen +Terminal Identifier`. + +Generate an Adyen API key +~~~~~~~~~~~~~~~~~~~~~~~~~ + +The **Adyen API key** is a key used to authenticate your requests. To generate an API key, go to +your **Adyen account**. + +Then, go to :menuselection:`Developers --> API credentials`. Create a new credential or click on an +existing one. + +Click on :guilabel:`Generate an API key` and copy-paste that key onto the Odoo mandatory field. + +.. seealso:: + - `Adyen Docs - API credentials + `_. + +Locate the Adyen terminal identifier +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The **Adyen Terminal Identifier** is your terminal's serial number, which is used to identify the +hardware. + +To find this number, go to your **Adyen account**. Then, go to :menuselection:`Point of Sale +--> Terminals`, select the terminal to link, and copy-paste its serial number onto the Odoo +mandatory field. + +Add a new payment method +======================== + +To add a new **payment method** to a point of sale, go to :menuselection:`Point of Sale --> +Configuration --> Point of Sale`. Then, select the POS and go to :menuselection:`Payments --> +Payment Methods`, and add your new method for Adyen. + +Pay with a payment terminal +=========================== + +When processing a payment, select :guilabel:`Adyen` as the payment method. Check the amount and +click on :guilabel:`Send`. Once the payment is successful, the status changes to :guilabel:`Payment +Successful`. + +.. note:: + - | In case of connexion issues between Odoo and the payment terminal, force the payment by + clicking on :guilabel:`Force Done`, which allows you to validate the order. + | This option is only available after receiving an error message informing you that the + connection failed. + - To cancel the payment request, click on :guilabel:`cancel`. \ No newline at end of file diff --git a/content/applications/sales/point_of_sale/payment/ingenico.rst b/content/applications/sales/point_of_sale/payment/ingenico.rst index 9387d43c4..c3397e496 100644 --- a/content/applications/sales/point_of_sale/payment/ingenico.rst +++ b/content/applications/sales/point_of_sale/payment/ingenico.rst @@ -2,8 +2,8 @@ Ingenico ======== -Connecting a payment terminal allows you to offer a fluid payment flow -to your customers and ease the work of your cashiers. +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. diff --git a/content/applications/sales/point_of_sale/payment/vantiv.rst b/content/applications/sales/point_of_sale/payment/vantiv.rst index 98633c2e5..d541df71c 100644 --- a/content/applications/sales/point_of_sale/payment/vantiv.rst +++ b/content/applications/sales/point_of_sale/payment/vantiv.rst @@ -2,8 +2,8 @@ Vantiv ====== -Connecting a Vantiv payment terminal allows you to offer a fluid payment -flow to your customers and ease the work of your cashiers. +Connecting a Vantiv payment terminal allows you to offer a fluid payment flow to your customers and +ease the work of your cashiers. .. note:: Please note MercuryPay only operates with US and Canadian banks, making