[IMP] Payment providers: advertise and document the "demo" provider

New page to document the new features of the demo payment provider, and
modifications to related pages

task id: 2982367

closes odoo/documentation#3088

X-original-commit: a1f4c3704b
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
This commit is contained in:
Tom Aarab (toaa) 2022-09-14 14:32:35 +00:00 committed by Jonathan Castillo (jcs)
parent 0e22a3c582
commit 77a70dc8bf
4 changed files with 91 additions and 14 deletions

View File

@ -14,6 +14,7 @@ Payment providers (credit cards, online payments)
payment_providers/asiapay
payment_providers/authorize
payment_providers/buckaroo
payment_providers/demo
payment_providers/flutterwave
payment_providers/mercado_pago
payment_providers/mollie
@ -63,83 +64,96 @@ Online payment providers
:widths: auto
* -
- Payment flow
- Payment flow from
- :ref:`Tokenization <payment_providers/features/tokenization>`
- :ref:`Manual capture <payment_providers/features/manual_capture>`
- :ref:`Refunds <payment_providers/features/refund>`
- :ref:`Express checkout <payment_providers/features/express_checkout>`
- :ref:`Extra fees <payment_providers/features/extra_fees>`
* - :doc:`Adyen <payment_providers/adyen>`
- Payment from Odoo
- Odoo
- |V|
- Full only
- Full and partial
-
-
* - :doc:`Amazon Payment Services <payment_providers/amazon_payment_services>`
- Payment from the provider website
- The provider website
-
-
-
-
-
* - :doc:`AsiaPay <payment_providers/asiapay>`
- Payment from the provider website
- The provider website
-
-
-
-
-
* - :doc:`Authorize.Net <payment_providers/authorize>`
- Payment from Odoo
- Odoo
- |V|
- Full only
- Full only
-
-
* - :doc:`Buckaroo <payment_providers/buckaroo>`
- Payment from the provider website
- The provider website
-
-
-
-
-
* - :doc:`Flutterwave <payment_providers/flutterwave>`
- Payment from the provider website
- The provider website
- |V|
-
-
-
-
* - :doc:`Mercado Pago <payment_providers/mercado_pago>`
- Payment from the provider website
- The provider website
-
-
-
-
-
* - :doc:`Mollie <payment_providers/mollie>`
- Payment from the provider website
- The provider website
-
-
-
-
-
* - :doc:`PayPal <payment_providers/paypal>`
- Payment from the provider website
- The provider website
-
-
-
-
- |V|
* - :doc:`Razorpay <payment_providers/razorpay>`
- Payment from the provider website
- The provider website
-
- Full only
- Full and partial
-
-
* - :doc:`SIPS <payment_providers/sips>`
- Payment from the provider website
- The provider website
-
-
-
-
-
* - :doc:`Stripe <payment_providers/stripe>`
- Payment from the provider website
- The provider website
- |V|
- Full only
- Full and partial
- |V|
-
.. |V| replace::
@ -150,6 +164,12 @@ Online payment providers
added and configured on your Accounting app to do a bank reconciliation, which is an accounting
control process.
.. tip::
In addition to the regular payment providers that integrate with an API such as Stripe, PayPal,
or Adyen, Odoo bundles the :doc:`Demo payment provider <payment_providers/demo>`. This payment
provider allows you to make demo payments to test business flows involving online payments. No
credentials are required as the demo payments are fake.
.. _payment_providers/bank_payments:
Bank payments
@ -251,7 +271,7 @@ Express checkout
If your payment provider supports this feature, customers can use the **Google Pay** and **Apple
Pay** buttons to pay their eCommerce orders in one click without filling the contact form. Using one
of those buttons, they'll go straight from the cart to the confirmation page, stopping by the
of those buttons, customers go straight from the cart to the confirmation page, stopping by the
payment form of Google or Apple to validate the payment.
Enable this feature by navigating to the :guilabel:`Configuration` tab from your payment provider
@ -260,6 +280,23 @@ and by ticking the :guilabel:`Allow Express Checkout` checkbox.
.. note::
All prices shown in the express checkout payment form are always taxes included.
.. _payment_providers/features/extra_fees:
Extra Fees
----------
If supported by the payment provider, you can add **extra fees** to online transactions. Fees can be
configured either as **fixed** amounts and percentages, **variable** amounts and percentages, or
*both* simultaneously. These can be applied according to **domestic** or **international**
geolocation.
To enable fees, from the *eCommerce* or *Accounting* app, head to :menuselection:`Configuration
--> Payment Providers` and select the desired supported provider. Click on the :guilabel:`Fees` tab
and check the :guilabel:`Add Extra Fees` box. Configure the settings to your needs.
.. note::
Fees are calculated on the tax-included price.
.. _payment_providers/configuration:
Configuration
@ -387,6 +424,7 @@ payment method... What best suit your needs.
- :doc:`payment_providers/authorize`
- :doc:`payment_providers/asiapay`
- :doc:`payment_providers/buckaroo`
- :doc:`payment_providers/demo`
- :doc:`payment_providers/mercado_pago`
- :doc:`payment_providers/mollie`
- :doc:`payment_providers/ogone`

View File

@ -0,0 +1,39 @@
====
Demo
====
Odoo's **Demo Payment Provider** allows you to test business flows involving online transactions
without requiring real banking credentials.
Configuration
=============
.. seealso::
:ref:`payment_providers/add_new`
.. important::
Switch the state to :guilabel:`Test Mode`.
Payment outcome
===============
Upon checkout or when paying a bill online, you can choose the payment outcome when using the demo
payment provider. To do so, click on the :guilabel:`Payment Status` drop-down menu and select the
desired outcome.
.. image:: demo/demo-payment-outcome.png
:align: center
:alt: Payment status outcomes.
Transaction state
=================
If you selected :guilabel:`Pending` as **payment outcome**, you can change the state of the
transaction straight from its form view. To access a transaction's form view, activate the
:ref:`developer mode <developer-mode>`, and go to :menuselection:`Accounting / Website -->
Configuration --> Payment Transactions`. Then, change the status of a transaction by clicking on the
state bar (:guilabel:`Draft, Pending, Authorized, Confirmed, Canceled, Error`).
.. image:: demo/demo-view-form.png
:align: center
:alt: Transaction's status bar.

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.2 KiB