UddoktaPay for FluentCart

Accept bKash, Nagad, Rocket, and Upay payments in your FluentCart store through UddoktaPay's unified payment gateway API.

Customers are redirected to a secure, hosted UddoktaPay checkout page to complete payment, then automatically returned to your store with their order confirmed — no need to integrate each mobile banking provider separately.

Trademark notice: UddoktaPay is a trademark of its respective owner. This is an independent, third-party integration and is not officially affiliated with, endorsed by, or sponsored by UddoktaPay.

Features

• One gateway for bKash, Nagad, Rocket, and Upay
• Secure hosted checkout — payment details never touch your server
• Automatic payment verification on return redirect, with webhook backup confirmation
• Independent sandbox/live mode switching and gateway activation toggle
• Encrypted API key storage

Requirements

• WordPress with FluentCart installed and active
• A UddoktaPay account (sandbox or live) with an API key

Installation

1. Download or clone this repository into wp-content/plugins/uddoktapay-for-fluentcart.
2. Activate BD UddoktaPay Gateway for FluentCart from the WordPress Plugins screen.
3. Go to FluentCart → Settings → Payment Methods → UddoktaPay.
4. Select the Live or Test tab and enter the matching API key and API base URL.
5. Toggle Payment Activation on to make the gateway available at checkout.

Configuration

Setting	Description
Live/Test tabs	Only the selected tab's credentials are used at checkout, regardless of which tabs are filled in
Payment Activation	Independent on/off switch controlling whether the gateway appears at checkout at all
API Key	Your UddoktaPay RT-UDDOKTAPAY-API-KEY, encrypted at rest
API Base URL	Your UddoktaPay instance's checkout endpoint, e.g. https://sandbox.uddoktapay.com/api/checkout-v2

Webhook URL (optional)

A backup confirmation channel, in case a customer closes their browser before the return redirect completes:

https://yourdomain.com/?fluent-cart=fct_payment_listener_ipn&method=uddoktapay

This is shown in the plugin settings page and can be added to your UddoktaPay instance if desired. It's not required for normal operation.

How it works

1. Customer places an order and selects UddoktaPay at checkout.
2. The plugin creates a payment via UddoktaPay's checkout-v2 API and redirects the customer to UddoktaPay's hosted payment page.
3. After paying, the customer is redirected back with an invoice_id.
4. The plugin verifies the payment via UddoktaPay's verify-payment API and updates the order/transaction status.
5. The customer lands on the order receipt page, reflecting completed or pending status as appropriate.

Project structure

uddoktapay-for-fluentcart/
├── uddoktapay-for-fluentcart.php   # Plugin bootstrap, registers gateway with FluentCart
├── includes/
│   ├── class-uddoktapay-settings.php  # Settings storage (extends BaseGatewaySettings)
│   ├── class-uddoktapay-api.php       # UddoktaPay API wrapper
│   └── class-uddoktapay-gateway.php   # Gateway logic (extends AbstractPaymentGateway)
└── assets/
    ├── js/checkout.js              # Checkout-page redirect notice
    └── images/                     # Gateway logo/icon

License

GPLv2 or later, consistent with WordPress plugin conventions.

Support

For issues specific to this integration, open an issue in this repository. For UddoktaPay account or API issues, contact UddoktaPay support directly.