documentation/content/applications/finance/payment_providers/xendit.rst
nni-odoo b81c06ecef [IMP] payment_xendit: tokenization
Tokenization is introduced in https://github.com/odoo/odoo/pull/158445 and needs extra configuration to setup for credit card payment.
We require optional 3DS to be enabled and dynamic 3DS to be disabled

closes odoo/documentation#10248

X-original-commit: bd06b95cbe
Signed-off-by: Audrey Vandromme (auva) <auva@odoo.com>
Signed-off-by: Nigel Nicholas (nni) <nni@odoo.com>
2024-07-19 15:01:53 +00:00

50 lines
2.6 KiB
ReStructuredText

======
Xendit
======
`Xendit <https://www.xendit.co>`_ is an Indonesian-based payment solution provider that covers
several Southeast Asian countries. It allows businesses to accept credit cards as well as several
local payment methods.
.. _payment_providers/xendit/configure_dashboard:
Configuration on the Xendit Dashboard
=====================================
#. Create a Xendit account if necessary and log in to the `Xendit Dashboard
<https://dashboard.xendit.co>`_.
#. Check your account mode in the top left corner of the page. Use the :guilabel:`Test Mode` to try
the integration without charging your customers. Switch to :guilabel:`Live Mode` once you are
ready to accept payments.
#. Navigate to :menuselection:`Configuration: Settings` in the left part of the application page.
In the :guilabel:`Developers` section, click
`API Keys <https://dashboard.xendit.co/settings/developers#api-keys>`_.
#. Click :guilabel:`Generate Secret Key`. In the popup box, enter any :guilabel:`API key name`,
select :guilabel:`Write` for the :guilabel:`Money-in Products` permission and :guilabel:`None`
for all other permissions then click :guilabel:`Generate key`.
#. Confirm your password to display your API key. Copy or download the key and **save
this information securely for later**. This is the only time the API key can be viewed or
downloaded.
#. Once completed, scroll down the page to the
`Webhooks <https://dashboard.xendit.co/settings/developers#webhooks>`_ section to generate
the webhook token.
#. Under :guilabel:`Webhook verification token`, click :guilabel:`View Webhook Verification Token`,
then confirm your password to display the token. Save it for later.
#. In the :guilabel:`Webhook URL` section, enter your Odoo database's URL, followed by
`/payment/xendit/webhook` (e.g., `https://example.odoo.com/payment/xendit/webhook`) in the field
:guilabel:`Invoices paid` and click the :guilabel:`Test and save` button next to it.
#. Navigate to the `Card Settings page <https://dashboard.xendit.co/settings/payment-methods/cards-configuration>`_
and ensure that :guilabel:`Optional 3DS` is enabled while :guilabel:`Dynamic 3DS` is disabled.
Configuration on Odoo
=====================
#. :ref:`Navigate to the payment provider Xendit <payment_providers/add_new>` and change its state
to :guilabel:`Enabled`.
#. Fill in the :guilabel:`Secret Key` and :guilabel:`Webhook Token` fields with the
information saved at the step :ref:`payment_providers/xendit/configure_dashboard`.
#. Configure the rest of the options to your liking.
.. seealso::
:doc:`../payment_providers`