| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• eCommerce (website_sale) • Discuss (mail) • Website (website) |
| Lines of code | 1055 |
| Technical Name |
oe_tamara_payment_integration |
| License | AGPL-3 |
| Website | https://odooerp.ae |
| Versions | 16.0 17.0 18.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• eCommerce (website_sale) • Discuss (mail) • Website (website) |
| Lines of code | 1055 |
| Technical Name |
oe_tamara_payment_integration |
| License | AGPL-3 |
| Website | https://odooerp.ae |
| Versions | 16.0 17.0 18.0 |
API Configuration
Module User Guide
This guide provides step-by-step instructions for installing, configuring, and using the Tamara Buy Now, Pay Later (BNPL) payment gateway integration with Odoo.
1. Module Overview
The Odoo-Tamara Payment Connector integrates Tamara’s flexible payment options into your Odoo e-commerce site. It allows customers to pay later or in interest-free installments, improving their checkout experience and potentially increasing sales. Transactions, refunds, and cancellations are managed entirely from the Odoo backend.
2. Installation
- Download the Module: Obtain the
odoo-tamara-paymentmodule from the Odoo App Store or GitHub. - Copy to Addons: Place the module in your Odoo custom addons directory.
- Update App List: In Odoo, go to Apps > Update Apps List.
- Install: Search for "Tamara Payment Connector" and click Install.
3. Configuration
3.1 Payment Acquirer Setup
- Navigate to Invoicing > Configuration > Payment Acquirers.
- Create or edit a record and set the Provider to
Tamara. - Enter the following credentials from your Tamara dashboard:
- Merchant Token (Public Key)
- Notification Token (Secret Key)
- Select State:
TestorEnabled. - API URL is set automatically depending on environment (sandbox or production).
- Save the record.
3.2 Company Settings
- Navigate to Settings > Tamara section (or General Settings).
- Configure:
- Product Widget: Show BNPL widget on product pages.
- Exclude Products: Prevent specific products from using Tamara.
- Disable Installment / Pay Later
- Payment Type: Choose default between "Pay Later" or "Installment".
- Installment Min/Max Amount
- Pay Later Max Amount
- No. of Installments: 2–12 supported.
4. Customer Checkout Experience
- User selects Tamara during checkout.
- They are redirected to Tamara’s payment gateway.
- Upon completion, they're redirected back to Odoo with order confirmation.
5. Backend Transaction Management
5.1 Viewing Transactions
- Go to Sales > Orders or Invoicing > Payments.
- Filter by Provider: Tamara to view related records.
5.2 Transaction Statuses
| Status | Description |
|---|---|
| Approved | Payment is approved by Tamara. |
| Authorized | Waiting for capture. |
| Captured | Payment captured successfully. |
| Canceled | Transaction canceled. |
| Declined | Payment rejected. |
| Expired | Session expired. |
| Pending | Waiting for update. |
| Error | Transaction failed. |
5.3 Capturing Payments
If the acquirer is set to manual, capture must be triggered from the payment record or sales order in Odoo.
5.4 Refunding Payments
- Go to the Invoice or Payment related to the transaction.
- Create a credit note (partial or full).
- The refund request is sent to Tamara and status is updated in Odoo.
5.5 Cancelling Transactions
- Canceling a sales order triggers cancellation in Tamara.
- You may also void a transaction from the Payment Transactions screen.
Note: Make sure your public/secret keys are accurate and Tamara API endpoints are reachable from your server for successful transactions.
Frequently Asked Questions
1. What is the Odoo-Tamara Payment Integration module?
This module allows your Odoo e-commerce store to offer Tamara's Buy Now, Pay Later (BNPL) payment solutions. Customers can choose to pay for their purchases in interest-free installments or defer payment to a later date.
2. What are the prerequisites for using this module?
You need an active Odoo instance (Community or Enterprise) and a valid merchant account with Tamara. You will also require the Public Key (Merchant Token) and Secret Key (Notification Token) provided by Tamara for API integration.
3. How do I install the Tamara Payment Connector module?
Install the module like any other Odoo module: copy the module files to your Odoo custom addons path, update your Odoo apps list, and then install "Tamara Payment Connector" from the Apps menu.
4. How do I configure Tamara as a payment method in Odoo?
Navigate to
Invoicing / Accounting > Configuration > Payment Acquirers. Create or edit the "Tamara" acquirer, then enter your Tamara Merchant Token (Public Key) and Tamara Notification Token (Secret Key). Set the State to "Enabled" for live transactions or "Test" for testing.
5. Can I test the Tamara integration before going live?
Yes, you can set the "State" of the Tamara payment acquirer to "Test" in Odoo's Payment Acquirers configuration. This will use Tamara's sandbox environment for testing transactions.
6. What are the specific settings available for Tamara in Odoo's company configuration?
You can find Tamara-specific settings typically under
Invoicing / Accounting (or Settings) > Configuration > Settings in your company configuration. These include:
- Product Widget: Enable/disable the Tamara widget on product pages.
- Exclude Products: Select products that should not be eligible for Tamara payments.
- Disable Installment: Disable the installment option.
- Disable Paylater: Disable the Pay Later option.
- Payment Type: Set the default preferred payment method (Pay Later or Installment) if both are active. Selecting one will disable the other.
- Installment Minimum/Maximum Amount: Define the price range for orders eligible for installment payments.
- Pay Later Maximum Amount: Set the maximum order value for Pay Later transactions.
- No of Installments: Choose the number of installments offered (e.g., 2, 3, 4, 5, 6, 12).
7. Can I set minimum and maximum amounts for Tamara transactions?
Yes, you can configure "Installment Minimum Amount," "Installment Maximum Amount," and "Pay Later Maximum Amount" in your company's Tamara settings. The module includes validations to ensure the maximum amount is not less than the minimum.
8. Can I disable either "Pay Later" or "Installment" options?
Yes, you have separate checkboxes (
Disable Installment, Disable Paylater) in the company settings to enable or disable these options independently.
9. How are refunds handled for Tamara payments?
The module supports partial refunds. You can process refunds directly from the associated invoice or payment transaction in Odoo. The module will communicate the refund request to Tamara.
10. How are order cancellations processed with Tamara?
If a sales order is canceled in Odoo, or you choose to "Void" a Tamara payment transaction, the module will send a cancellation request to Tamara's API for the corresponding order.
11. Does this module support automatic capture of payments?
The module is configured to support manual capture. This means after a payment is authorized by Tamara, you will need to manually capture it from the Odoo backend to finalize the transaction.
12. Are Tamara API credentials stored securely in Odoo?
The Tamara Merchant Token (Public Key) and Notification Token (Secret Key) are stored in your Odoo database as part of the payment acquirer configuration. Odoo typically encrypts sensitive data, but always ensure your Odoo instance is secured.
13. What happens if a Tamara transaction fails or is declined?
If a transaction fails or is declined by Tamara, the status will be reflected in the Odoo payment transaction and sales order (e.g., "Declined," "Canceled," "Expired," or "Error"), allowing you to take appropriate action.
Module Support & SLA
For any support related to this Odoo module, please contact us at apps@odooerp.ae
Our standard response time (SLA) for support queries is between 12 to 48 hours.
Our standard response time (SLA) for support queries is between 12 to 48 hours.
Please log in to comment on this module