PayPal : Payment Integration

# PayPal Integration

This acts as acquirer for PayPal business to use PayPal to receive payments.

Table of Contents

• Features
• Configuration
• Usage
• Dependencies
• Limitations, Issues & Bugs
• Development
• Tests

---

## Features

• Integration Signup Process to connect odoo to your PayPal account

---

## Configuration

### Setup credentials to connect Odoo to Paypal

On the partner side which is Much. PayPal MerchantID, Client ID, Client Secret and BN_CODE is needed to use the PayPal Signup Process to connect Odoo to PayPal.

To setup this details in Odoo. 1. Go to Invoicing > Configuration > Settings > PayPal Partner Integration 2. Add the credentials recieve from Much partner here.

### Connect Odoo to Paypal using Paypal Integrated Signup Process.

1. Go to Invoicing > Configuration > Payment Providers
2. Click on PayPal Business Integration to open the record.
3. Click on Connect to PayPal. (make sure credentials from partner is already setup)

---

## Usage

---

## Dependencies

### Odoo modules dependencies

---

## Limitations, Issues & Bugs

### Paypal Partner.js issue.

• https://caniuse.com/?search=postMessage only supported browser
• testing on firefox version 133.0 partner.js fails to hook the onboarded callback.

---

## Development

To use the Integration Signup, when testing for engineer you will need a public url connected to your local odoo environment and odoo base url set to this public URL

---

## Tests

Tests are located in tests/ and cover the core PayPal API client, authentication, orders, refunds, onboarding, logging, and payment processing.

### Tags

All test classes are decorated with:

`python @tagged("post_install", "-at_install", "paypal_integration", "<feature_tag>") `

### Running Tests

```bash # All tests in this module odoo-bin -d <db> -i payment_paypal_integration --test-enable --stop-after-init

# All tests by module tag odoo-bin -d <db> -i payment_paypal_integration --test-enable --test-tags paypal_integration --stop-after-init

# Single feature odoo-bin -d <db> -i payment_paypal_integration --test-enable --test-tags apple_pay --stop-after-init ```

### Writing Tests

1. Create tests/test_<feature>.py and register it in tests/__init__.py.

2. Inherit PayPalCommon from tests/common.py (all tests in this module must use it).

3. Tag every class: ```python from odoo.tests import tagged

   @tagged("post_install", "-at_install", "paypal_integration", "<feature_tag>") class TestMyFeature(PayPalCommon):

   ...

   ```

4. Mock all external API calls — never hit real PayPal endpoints.

5. Keep one feature per file.