This module integrates Drupal Commerce with the Konnect.network payment gateway, enabling Tunisian merchants to accept payments via bank cards, E-Dinar, and Flouci wallets. It supports Tunisian Dinar and syncs order information for easy reconciliation.
Commerce Konnect provides a seamless integration between Drupal Commerce and Konnect.network, one of Tunisia's leading payment gateways. This module allows merchants in Tunisia to accept payments via Bank Cards (Visa, Mastercard), E-Dinar, and Flouci wallets.
Features
- Secure Off-site Payment: Redirects customers to Konnect's secure hosted payment page.
- TND Support: Automatically handles Tunisian Dinar (TND) with correct 3-decimal (millimes) precision.
- Full Order Tracking: Syncs Drupal Order IDs with Konnect Transaction IDs for easy reconciliation.
- Asynchronous Notifications: Supports Webhooks to ensure orders are updated even if the customer's browser is closed after payment.
- Sandbox & Live Modes: Easily switch between pre-production and production environments.
- Customer Data Sync: Passes billing information (name and email) to Konnect for enhanced fraud protection and receipting.
Configuration
- Install and enable the module.
- Navigate to Commerce > Configuration > Payment > Payment gateways.
- Add a new gateway and select Konnect.
- Enter your API Key, API Secret, and Receiver Wallet ID provided by your Konnect dashboard.
- Set the API Environment (Sandbox for testing, Live for production).
- Copy the Webhook URL from the gateway settings and paste it into your Konnect merchant portal to enable real-time status updates.
Requirements
- Drupal Commerce 2.x
- A merchant account at Konnect.network
For Issues:
Source code available on Github
Sponsor:
CONVERGENT CLOUD COMPUTING
Depends on
Dependencies of the latest stable release
- Commerce Core commerce_order
- Commerce Core commerce_payment
- Commerce Core commerce_price
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.
Activity
Release Timeline
Releases
| Version | Type | Core | Notes | Release date | |
|---|---|---|---|---|---|
| 1.1.9 | Stable | 9–11 | Restored missing code from previous release. | Jan 8, 2026 | |
| 1.1.8 | Stable | 9–11 | Final stability hotfix for administrative routing and webhook mapping. | Jan 8, 2026 | |
| 1.1.7 | Stable | 9–11 | Corrected `commerce_konnect.routing.yml` to use `PaymentGatewayController::notifyPage`. This resolves the `MethodDoesNotExist` exception caused by using the incorrect checkout controller. | Jan 8, 2026 | |
| 1.1.6 | Stable | 9–11 | Critical maintenance release for Konnect Tunisia integration. Fixes routing exceptions, resolves sandbox connectivity issues, and introduces dynamic multi-currency support for TND, EUR, and USD. | Jan 8, 2026 | |
| 1.1.5 | Stable | 9–11 | Corrected Sandbox URL: Fixed the testing API endpoint to api.sandbox.konnect.network | Jan 8, 2026 | |
| 1.1.4 | Stable | 9–11 | Implemented automatic fraction digit detection (e.g., 3 decimals for TND, 2 for EUR) for cross-border payment accuracy. | Jan 8, 2026 | |
| 1.1.3 | Stable | 9–11 | Critical update for Drupal 10 compatibility. Includes security enhancements for payment validation and aligns the module with the official Konnect SDK/API requirements. | Jan 8, 2026 | |
| 1.1.2 | Stable | 9–11 | Maintenance release fixing a critical TypeError in the Konnect constructor and modernizing dependency injection for Drupal 10/11 compatibility. | Jan 7, 2026 | |
| 1.1.1 | Stable | 9–11 | Release 1.1.1: Webhook support and critical Drupal 10 compatibility fixes. | Jan 7, 2026 | |
| 1.1.0 | Stable | 9–11 | Improved security with ID-switching protection, fixed PSR-4 autoloading compliance, and added duplicate payment prevention. | Jan 7, 2026 | |
| 1.0.x-dev | Dev | 9–11 | Initial commit | Jan 7, 2026 |