Skip to main content

​
Account Setup

Before you begin integrating HitPay payments into your Odoo Store or POS, you need to set up your HitPay account and ensure some prerequisites are met:
  1. If you haven’t already, create an account on HitPay.
  2. Ensure that you have the necessary payment methods activated in your HitPay account.
  3. Make sure the payment methods you want to offer are enabled in your Odoo sales channel.

​
Odoo eCommerce Integration

​
Installation

- Odoo 18: Click on this LINK to install HitPay on your Odoo Store.
- Odoo 17: Click on this LINK to install HitPay on your Odoo Store.
- Odoo 16: Click on this LINK to install HitPay on your Odoo Store.
- Odoo 15: Click on this LINK to install HitPay on your Odoo Store.
 After following the installation guide on Odoo, ensure that you complete your Integration Settings for Odoo to complete the integration to your website: Odoo Integration

​
Odoo POS Integration

Integrate HitPay into your Odoo Point of Sale (POS) to accept in-person payments using a card reader.

​
Supported Versions

The HitPay POS plugin is supported on the following Odoo versions:
  • Odoo POS 16
  • Odoo POS 18
  • Odoo POS 19

​
Installation

The HitPay plugin for Odoo POS can be found at: https://github.com/hit-pay/odoo-extension/tree/16.0/pos_hitpay Follow the installation instructions provided in the GitHub repository.

​
Configuration in Odoo Admin

After installing the plugin, follow these steps to configure HitPay in your Odoo admin:
  1. Go to the “Point of Sale Admin” tab.
  2. In the “Configuration” section, click on the “Payment Methods” menu.
  3. Click the New button to add HitPay POS as a payment method.
  4. Enter the following details:
    • Title for the Payment option
    • Set Payment Journal as Bank
    • Select “Use a Payment Terminal” as ‘HitPay Payment Gateway’
    • Enter the HitPay Payment Gateway credentials
    • Enter the hitpay terminal ID from your HitPay dashboard
  5. Navigate to the Settings page.
  6. In the Point of Sale settings page, add ‘HitPay Payment Gateway POS’ to the available payment methods for POS Checkout.
  7. Return to the “Point of Sale Admin” tab and click “New Session” to start using HitPay POS.

​
Processing Refunds

To process refunds using HitPay POS:
  1. In the order view page, click the “Return Products” button.
  2. Click the Payment Button.
  3. In the popup, select “Hitpay Payment Gateway POS” as the refund payment method.
  4. Click the ‘Make Payment’ button.
  5. Enter the amount to refund (the amount should be negative).
Ensure that you have the necessary permissions and have configured your HitPay account to process refunds before attempting this process.

​
Support

If you encounter any issues or have questions about the HitPay Odoo integration, please contact our support team. That’s it! You’re all set up with HitPay on Odoo. 🎉