User Guide for Tabby

This guide provides step-by-step instructions for installing, configuring, and using the Tabby Buy Now, Pay Later (BNPL) payment gateway integration with Odoo.

---

1. Introduction

The Odoo-Tabby Payment Integration module seamlessly integrates Tabby’s flexible BNPL options into your Odoo e-commerce site. It enables customers to split payments or pay later, improving the checkout experience and boosting conversions.

---

2. Prerequisites

• Active Odoo instance (Community or Enterprise)
• Tabby Merchant Account
• Tabby API Credentials:
  • Public Key
  • Secret Key
  • Merchant Code

---

3. Installation

1. Upload the Module: Place the module into your custom addons path.
2. Update Apps List: Go to Apps > Update Apps List.
3. Install the Module: Search for "Tabby Payment Connector" and install.

---

4. Configuration

4.1 Configure Tabby Payment Acquirer

1. Go to Invoicing > Configuration > Payment Acquirers.
2. Edit or create a new acquirer and select Tabby as the provider.
3. Enter your API credentials:
   • Public Key
   • Secret Key
   • Merchant Code
4. Set State: Test or Enabled.
5. Click Register Webhook to enable real-time transaction updates.

4.2 Website Settings

1. Go to Website > Configuration > Settings.
2. Select your website and scroll to the Payment Tabby section.
3. Configure the following:
   • Product Widget: Show BNPL details on product pages.
   • No of Installments: Choose 2–12.
   • Installment Min/Max Amount
   • Installment Available Amount

---

5. Usage

5.1 Customer Checkout Process

• Tabby appears as a payment method during checkout.
• Customer is redirected to Tabby for payment authorization.
• Upon success, they return to Odoo, and the order is confirmed.

5.2 Backend Transaction Management

1. Access Sales Orders or Payment Transactions.
2. Manual Capture for authorized payments via sales order or transaction record.
3. Partial Refunds through credit notes or refund button.
4. Voids/Cancellations before capture via the order or transaction screen.
5. Status Tracking: Monitor states like Authorized, Captured, Refunded, Canceled, Declined directly in Odoo.

User Guide for Tamara

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

1. Download the Module: Obtain the odoo-tamara-payment module from the Odoo App Store or GitHub.
2. Copy to Addons: Place the module in your Odoo custom addons directory.
3. Update App List: In Odoo, go to Apps > Update Apps List.
4. Install: Search for "Tamara Payment Connector" and click Install.

---

3. Configuration

3.1 Payment Acquirer Setup

1. Navigate to Invoicing > Configuration > Payment Acquirers.
2. Create or edit a record and set the Provider to Tamara.
3. Enter the following credentials from your Tamara dashboard:
   • Merchant Token (Public Key)
   • Notification Token (Secret Key)
4. Select State: Test or Enabled.
5. API URL is set automatically depending on environment (sandbox or production).
6. Save the record.

3.2 Company Settings

1. Navigate to Settings > Tamara section (or General Settings).
2. 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

1. Go to the Invoice or Payment related to the transaction.
2. Create a credit note (partial or full).
3. 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.