PayPal

Paypal is an American online payment provider available worldwide and one of the few that does not charge a subscription fee.

Note

While PayPal is available in over 200 countries/regions, only a selection of currencies are supported.

Configuration in PayPal

  1. Log into your PayPal Developer Dashboard.

  2. Click Apps & Credentials and click Create App.

  3. Enter an App Name and click Create App.

  4. Copy the Client ID and Secret and save them for later.

Important

If you use customer names or addresses that include accented or non-Latin characters, you must configure the encoding format of the payment request sent by Odoo to PayPal to avoid transaction failures without notice. To do so, access the PayPal button language encoding setting, click More Options, and set the Encoding field to UTF-8.

If you are trying PayPal as a test, access your PayPal Sandbox account and configure the encoding format for your sandbox account.

Tip

For encrypted website payments & EWP_SETTINGS errors, please check the PayPal documentation.

Configuration in Odoo

  1. Navigate to the payment provider PayPal.

  2. In the Credentials tab, enter the Email linked to your PayPal account, then fill in the Client ID and Client Secret fields with the values you saved at the step Configuration in PayPal.

  3. Click Generate your webhook to create the Webhook ID.

  4. Set the State field to Enabled, and make sure the PayPal payment provider is Published.

  5. Configure the remaining options as desired.

Testing

PayPal provides two sandbox accounts that you can use to simulate live transactions:

  • A business account (to use as the merchant account, e.g., ab-1abc12345678@business.example.com);

  • A default personal account (to use as the shopper account, e.g., ba-9cba87654321@personal.example.com).

To test the PayPal payment workflow in Odoo:

  1. Log into the Paypal Developer Site using your PayPal credentials and go to Testing Tools ‣ Sandbox Accounts.

  2. Click the (ellipsis) icon next to the sandbox business account and select View/Edit account.

  3. Copy the Email, Client ID, and Secret and save them for the next step.

  4. In Odoo, configure the PayPal payment provider with the values saved at the previous step and set the State field to Test Mode.

You can then run a test transaction from Odoo using the sandbox personal account.

See also