Tamara Payment Gateway For Botble ecommerce (UAE, BAHRAIN, KUWAIT, SAUDI ARABIA)

# Tamara Payment Gateway Plugin for Botble CMS

**Split purchases into interest-free installments with Tamara.**


---

## About

Tamara Buy Now Pay Later payment gateway integration for Botble CMS (Shofy, Nest, Farmart & Martfury themes). Allows customers to split their purchases into 4 interest-free installments. Supports UAE, KSA, Bahrain & Kuwait.
 

**Version:** 1.1.0

**Minimum Core Version:** 7.3.0

**Requires:**`botble/payment`

---

## Developed By

**Maryam International LLC**

- 🌐 Website: [www.codeupp.xyz](https://www.codeupp.xyz)

- 📧 Email: maryaminternationalllc@gmail.com

- 📱 WhatsApp: +971553682656

---

## Features

-**Pay in 4 Installments** — Customers split their order into 4 interest-free payments

-**Product Detail Widget** — Dynamic installment price display on product pages (price ÷ 4)

-**Checkout Integration** — Tamara payment method at checkout with redirect to Tamara

-**Auto Authorise & Capture** — Automatic order authorisation and payment capture on success

-**Webhook & Notification** — Handles Tamara webhook events and notification callbacks

-**Refund Support** — Process refunds directly from Botble admin panel

-**Multi-Country** — UAE (AED), KSA (SAR), Bahrain (BHD), Kuwait (KWD)

-**Sandbox / Live Toggle** — Easy switch between Test Mode and Live Mode in admin settings

-**Arabic & English** — Locale-aware checkout (ar_SA / en_US)

-**Works on Shofy , Nest, Farmart & Martfury** — Compatible with both Botble CMS themes

---

## Installation

1. Copy the plugin folder to `platform/plugins/tamara` in your Botble CMS installation

2. Go to **Admin → Plugins** and activate **Tamara Payment Gateway**

3. Go to **Admin → Payments → Settings** and configure Tamara

---

## Configuration

In the admin payment settings, fill in the following fields:

| Field | Description |

|--------------------|--------------------------------------------------|

| **API Token** | Your Tamara API token from the Partners Portal |

| **Public Key** | Your Tamara public key from the Partners Portal |

| **Notification Key** | Your Tamara notification key for webhook auth |

| **Mode** | 🟡 Test Mode (Sandbox) or 🟢 Live Mode (Production) |

### Tamara API Endpoints

| Mode | API URL |

|------------|----------------------------------|

| Sandbox | `https://api-sandbox.tamara.co` |

| Production | `https://api.tamara.co` |

---

## Sandbox Testing

1. Set **Mode** to **🟡 Test Mode (Sandbox)** in admin settings

2. Use your sandbox API credentials from Tamara Partners Portal

3. Place a test order and select Tamara at checkout

4. You will be redirected to Tamara's sandbox checkout page

5. Complete the test payment flow

---

## Plugin Structure

```

tamara/

├── helpers/

│ └── constants.php

├── plugin.json

├── public/

│ └── images/

│ └── tamara.png

├── resources/

│ └── views/

│ ├── detail.blade.php

│ ├── instructions.blade.php

│ ├── methods.blade.php

│ └── partials/

│ └── product-detail-tamara.blade.php

├── routes/

│ └── web.php

└── src/

├── Forms/

│ └── TamaraPaymentMethodForm.php

├── Http/

│ └── Controllers/

│ └── TamaraController.php

├── Plugin.php

├── Providers/

│ ├── HookServiceProvider.php

│ └── TamaraServiceProvider.php

└── Services/

├── Abstracts/

│ └── TamaraPaymentAbstract.php

└── Gateways/

└── TamaraPaymentService.php

```

---

## Routes

| Method | URL | Description |

|--------|------------------------------|----------------------------|

| GET | `/payment/tamara/callback` | Customer return from Tamara |

| POST | `/payment/tamara/webhook` | Tamara webhook events |

| POST | `/payment/tamara/notification` | Tamara notification callback |

> Webhook and notification routes are excluded from CSRF verification.

---

## Payment Flow

1. Customer selects **Tamara** at checkout

2. Plugin creates a checkout session via Tamara API

3. Customer is redirected to Tamara to complete payment

4. On success, Tamara redirects back to callback URL

5. Plugin authorises the order with Tamara

6. Plugin captures the payment

7. Order is marked as **Completed** in Botble

---

## Changelog

### Version 1.1.0 (2 September 2026)

-**Fixed:** Tamara Payment Logs. The plugin now properly logs all API payloads and responses securely to Botble's Admin Payment Logs menu, perfectly matching the behavior of core plugins like Stripe.

-**Fixed:** BNPL Rejection Error Messages. Customers are now properly informed via a user-friendly error message ("Your Tamara payment was not approved") when their BNPL application is rejected, instead of the system returning a generic checkout error.

-**Enhanced:** Deep Scalability Optimization. Cleaned up backend service instantiation loops to prevent session data loss.

-**Improved:** General codebase data optimization and faster API response handling to seamlessly handle high checkout volumes.

### Version 1.0.0

- Initial Release of the Tamara Payment Gateway integration.

---

## Support

For any issues or questions regarding this plugin:

**Maryam International LLC**

🌐 [www.codeupp.xyz](https://www.codeupp.xyz)

📧 maryaminternationalllc@gmail.com

📱 WhatsApp: [+971553682656](https://wa.me/971553682656)

---

## License

Proprietary — Developed by Maryam International LLC. All rights reserved.