FinRelay Payment Gateway for Odoo 17
Premium FinRelay payment provider integration for Odoo eCommerce checkout.
Overview
FinRelay Payment Gateway adds a dedicated payment provider to Odoo 17. Customers can place an order from the Odoo website checkout, get redirected to FinRelay Hosted Payment Page, and return to Odoo after payment processing.
Main Features
- Native Odoo 17 payment provider integration.
- Redirect checkout flow to FinRelay Hosted Payment Page.
- UAT and Production environment configuration.
- Webhook secret validation.
- Optional FinRelay API verification before updating Odoo payment status.
- Support for transaction references and Odoo payment status updates.
- Configurable FinRelay credentials from the Odoo payment provider screen.
- Works with Odoo Website Sale checkout.
Requirements
- Odoo 17.
- Website Sale app installed.
- Valid FinRelay merchant account and API credentials.
- Public HTTPS domain configured in Odoo using the correct
web.base.url. - Webhook secret configured in both Odoo and FinRelay.
Configuration
- Install the module in Odoo 17.
- Open Website or Accounting payment providers.
- Select FinRelay.
- Select Test/UAT or Production environment.
- Enter Merchant ID, Terminal ID, Merchant Client Key, OIDC Client ID, and OIDC Client Secret.
- Configure webhook validation and the status lookup path provided by FinRelay.
- Configure the return and webhook URLs in your FinRelay merchant panel.
- Run a test payment before enabling production payments.
Payment Flow
The module creates a FinRelay payment session from Odoo checkout, redirects the customer to the hosted payment page, receives the customer return, and updates the Odoo transaction from validated webhook data.
FinRelay URLs
Use your real Odoo domain when configuring FinRelay:
- Return URL:
https://your-domain.com/payment/finrelay/return - Webhook URL:
https://your-domain.com/payment/finrelay/webhook
Support
Installation and configuration services are not included unless explicitly agreed with the vendor. Customers must provide their own FinRelay merchant credentials.
License
Commercial license for one Odoo database unless otherwise agreed in writing. Redistribution, resale, sublicensing, or sharing with third parties is not permitted.
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
eCommerce (website_sale)
• Discuss (mail) • Website (website) • Invoicing (account) |
| Lines of code | 693 |
| Technical Name |
finrelay_payment |
| License | OPL-1 |
| Website | https://www.finrelay.io |
FinRelay Payment Gateway for Odoo 17
FinRelay Payment Gateway adds a native Odoo 17 payment provider for Website Sale checkout. Customers are redirected from Odoo checkout to the FinRelay Hosted Payment Page and then returned to Odoo after payment processing.
Main Features
- Native Odoo 17 payment provider integration.
- Hosted Payment Page redirect checkout flow.
- Test/UAT and Production environment selector.
- Configurable Merchant ID, Terminal ID, Merchant Client Key, OIDC Client ID, and OIDC Client Secret.
- Webhook secret validation.
- Optional FinRelay API verification before updating Odoo transaction status.
- Payment status handling for approved, declined, canceled, pending, and expired payments.
- Public error messages designed to avoid exposing sensitive payloads, tokens, or headers.
Requirements
- Odoo 17.
- Website Sale installed.
- Active FinRelay merchant account.
- Public HTTPS domain.
- Correct Odoo web.base.url.
- FinRelay API credentials and webhook secret.
Installation
Copy the finrelay_payment folder to your Odoo custom addons directory, restart Odoo, update the app list, and install FinRelay Payment Gateway.
Configuration
Open the Odoo Payment Providers screen, select FinRelay, choose Test/UAT or Production, enter the credentials provided by FinRelay, and configure the return and webhook URLs in your FinRelay merchant panel.
Recommended URLs
Use your real Odoo domain when configuring FinRelay:
- Return URL: https://your-domain.com/payment/finrelay/return
- Webhook URL: https://your-domain.com/payment/finrelay/webhook
Production Checklist
Before enabling production payments, run a UAT payment and verify token retrieval, checkout redirect, customer return, webhook delivery, webhook validation, status lookup, paid order confirmation, declined payment handling, and canceled payment handling.
License and Support
This module is sold under a commercial license for one Odoo database unless otherwise agreed in writing. Installation, configuration, and support services are not included unless explicitly purchased.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module