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

Tamara Payment Gateway Plugin for Botble CMS

(Martfury / Shofy / Farmart / Nest Only)

Split purchases into 4 interest-free installments with Tamara Buy Now, Pay Later.

Overview

The Tamara Payment Gateway Plugin for Botble CMS integrates Tamara’s Buy Now, Pay Later service into your ecommerce store, allowing customers to split their purchases into four interest-free installments.
This plugin is built specifically for Botble CMS stores using Martfury, Shofy, Farmart, and Nest themes.

It supports UAE, Saudi Arabia, Bahrain, and Kuwait, and provides a seamless checkout experience with automatic payment authorization, capture, refunds, and webhook handling.

Version: 1.0.0

Minimum Botble Core Version: 7.3.0

Required Plugin: botble/payment

Developer

Maryam International LLC

🌐 Website: www.codeupp.xyz

📧 Email: maryaminternationalllc@gmail.com

📱 WhatsApp: +971 55 368 2656

Key Features

Pay in 4 Installments
Customers can split their orders into four interest-free payments using Tamara.

Product Page Widget
Automatically displays installment pricing on product detail pages (price ÷ 4).

Checkout Integration
Tamara appears as a payment option during checkout with secure redirection.

Automatic Authorization & Capture
Orders are authorized and payments are captured automatically after successful checkout.

Webhook & Notification Handling
Fully supports Tamara webhook events and notification callbacks.

Refund Support
Refunds can be processed directly from the Botble admin panel.

Multi-Country Support
Works in UAE (AED), KSA (SAR), Bahrain (BHD), and Kuwait (KWD).

Sandbox & Live Mode
Easily switch between test and production environments.

Arabic & English Support
Locale-aware checkout experience (ar_SA / en_US).

Theme Compatibility
Fully compatible with Martfury, Shofy, Farmart, and Nest themes.

Installation

Copy the plugin folder to:
platform/plugins/tamara

Go to Admin → Plugins and activate Tamara Payment Gateway

Navigate to Admin → Payments → Settings and configure Tamara

Configuration

In the Tamara payment settings, provide the following details:

Field

Description

API Token

Tamara API token from the Partners Portal

Public Key

Tamara public key from the Partners Portal

Notification Key

Notification key for webhook authentication

Mode

Test (Sandbox) or Live (Production)

Tamara API Endpoints

Mode

API URL

Sandbox

https://api-sandbox.tamara.co

Production

https://api.tamara.co

Sandbox Testing

Set Mode to Test (Sandbox) in the admin panel

Use sandbox credentials from the Tamara Partners Portal

Place a test order and select Tamara at checkout

You will be redirected to Tamara’s sandbox checkout page

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

Customer selects Tamara at checkout

Plugin creates a checkout session via Tamara API

Customer is redirected to Tamara to complete payment

Tamara redirects back to the callback URL

Order is authorized with Tamara

Payment is captured automatically

Order status is marked as Completed in Botble

Support

For support, issues, or custom development:

Maryam International LLC
🌐 www.codeupp.xyz
📧 maryaminternationalllc@gmail.com
📱 WhatsApp: +971 55 368 2656

License

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