
For Authorize.net configuration, you need individual Receipt and Relay Response URL's. The previous version featured the same URL twice. The Relay Response URL is here updated to reflect proper configuration.
118 lines
4.4 KiB
ReStructuredText
118 lines
4.4 KiB
ReStructuredText
=============
|
|
Authorize.Net
|
|
=============
|
|
|
|
`Authorize.Net <https://www.authorize.net>`__ is a United States-based online payment solution
|
|
provider, allowing businesses to accept **credit cards**.
|
|
|
|
.. image:: media/authorize-net.png
|
|
:align: center
|
|
:alt: Authorize.Net logo
|
|
|
|
This Payment Acquirer offers additional options that are not available for other :doc:`Payment
|
|
Acquirers <payment_acquirers>`, such as the ability to process your customer's payment after
|
|
delivery.
|
|
|
|
Authorize.Net account
|
|
=====================
|
|
|
|
If not done yet, choose a plan and `Sign Up for an Authorize.Net account
|
|
<https://www.authorize.net/sign-up.html>`__.
|
|
|
|
Odoo needs your **API Credentials & Keys** to connect with your Authorize.Net account, which
|
|
comprise:
|
|
|
|
- API Login ID
|
|
- Transaction Key
|
|
- Signature Key
|
|
|
|
To retrieve them, log into your Authorize.Net account, go to :menuselection:`Account --> Security
|
|
Settings --> General Security Settings --> API Credentials & Keys`, and generate your **Transaction
|
|
Key** and **Signature Key**.
|
|
|
|
.. image:: media/authorize-api-keys.png
|
|
:align: center
|
|
:alt: Generate your Transaction Key and Signature Key on your Authorize.Net account
|
|
|
|
.. seealso::
|
|
|
|
- `Authorize.Net: Getting Started Guide
|
|
<https://support.authorize.net/s/article/Authorize-Net-Getting-Started-Guide>`__
|
|
|
|
Payment Acquirer Configuration
|
|
==============================
|
|
|
|
To configure Authorize.Net as Payment Acquirer in Odoo, go to :menuselection:`Accounting -->
|
|
Configuration --> Payment Acquirers`, open **Authorize.Net**, and change the **State** to *Enabled*.
|
|
Don't forget to click on *Save* once you've set everything up.
|
|
|
|
.. note::
|
|
Please refer to the :doc:`Payment Acquirers documentation <payment_acquirers>` to read how to
|
|
configure this payment acquirer.
|
|
|
|
Credentials
|
|
-----------
|
|
|
|
Copy your credentials from your Authorize.Net account (API Login Id, API Transaction Key, and API
|
|
Signature Key), paste them in the related fields under the **Credentials** tab, then click on
|
|
**Generate Client Key**.
|
|
|
|
.. note::
|
|
The **API Client Key** is necessary only if you select *Payment from Odoo* option as
|
|
:ref:`Payment Flow <payment_acquirers/payment_flow>`.
|
|
|
|
.. important::
|
|
If you are trying Authorize.Net as a test, with a *sandbox account*, change the **State** to
|
|
*Test Mode*. We recommend doing this on a test Odoo database, rather than on your main database.
|
|
|
|
Payment Flow
|
|
------------
|
|
|
|
The **Payment Flow** lets you decide if to redirect the user to the payment acquirer's portal to
|
|
authenticate the payment, or if to stay on the current page and authenticate the payment from Odoo.
|
|
This field is under the **Configuration** tab.
|
|
|
|
If you select *Redirection to the acquirer website*, make sure you add a **Default Receipt URL** and
|
|
a **Default Relay Response URL** to your Authorize.net account.
|
|
|
|
To do so, log into your Authorize.Net account, go to :menuselection:`Account --> Transaction Format
|
|
Settings --> Transaction Response Settings --> Response/Receipt URLs`, and set the default links:
|
|
|
|
- | Default Receipt URL:
|
|
| *https://[yourcompany.odoo.com]*/**payment/authorize/return**
|
|
- | Default Relay Response URL:
|
|
| *https://[yourcompany.odoo.com]*/**shop/confirmation**
|
|
|
|
.. note::
|
|
| Failing to complete this step results in the following error:
|
|
| *The referrer, relay response or receipt link URL is invalid.*
|
|
|
|
Capture the payment after the delivery
|
|
--------------------------------------
|
|
|
|
The **Capture Amount Manually** field is under the **Configuration** tab. If enabled, the funds are
|
|
reserved for 30 days on the customer's card, but not charged yet.
|
|
|
|
.. image:: media/authorize-configuration.png
|
|
:align: center
|
|
:alt: Authorize.Net Configuration tab on Odoo
|
|
|
|
To capture the payment, go to the related Sales Order and click on *Capture Transaction*. If the
|
|
order is canceled, you can click on *Void Transaction* to unlock the funds from the customer's card.
|
|
|
|
.. image:: media/authorize-capture.png
|
|
:align: center
|
|
:alt: Hold the credit card payment until you capture or revoke it on Odoo
|
|
|
|
.. warning::
|
|
After **30 days**, the transaction is **voided automatically** by Authorize.net.
|
|
|
|
.. note::
|
|
With other payment acquirers, you can manage the capture in their own interfaces, not from Odoo.
|
|
|
|
.. seealso::
|
|
- `Authorize.Net: Getting Started Guide
|
|
<https://support.authorize.net/s/article/Authorize-Net-Getting-Started-Guide>`__
|
|
- :doc:`payment_acquirers`
|
|
- :doc:`../../ecommerce/shopper_experience/payment_acquirer`
|