Skip to Content

Payment Provider: Alfa & JazzCash Payment Gateway (Pakistan, PK)

by
Odoo

$ 138.48

v 19.0 Third Party
Live Preview
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Lines of code 720
Technical Name eis_gateway_alpha
LicenseOPL-1
Websitehttps://expertpk.com
Versions 17.0 18.0 19.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Lines of code 720
Technical Name eis_gateway_alpha
LicenseOPL-1
Websitehttps://expertpk.com
Versions 17.0 18.0 19.0
expertpk.com logo
Community
Enterprise
Odoo.sh

Alfa Payment Gateway & JazzCash for Odoo

Your Ultimate Payment Solution for Pakistan with JazzCash Support

Introduction to Alfa Payment Gateway with JazzCash

Seamless Integration with Bank Alfalah and JazzCash

The Alfa Payment Gateway module for Odoo 19 includes support for JazzCash through Bank Alfalah’s redirect payment gateway. This module integrates Alfa Payment Gateway (APG) into Odoo’s native payment provider flow, enabling businesses to accept payments securely from customers across Pakistan. Whether your customers prefer Alfa Wallet, Bank Alfalah accounts, credit/debit cards, Alfa BNPL, or JazzCash, this module offers a unified payment solution.

Setting up an Alfa merchant account is simple – register online in minutes at Bank Alfalah’s Merchant Signup. No additional configuration is needed for JazzCash; when redirected to the Alfa Payment Gateway, customers will see JazzCash as a payment option. With over 1.6 million Alfa Wallet users, 1.7 million Bank Alfalah account holders, and millions of JazzCash users, this module is the ultimate choice for e-commerce in Pakistan.

Why Choose Alfa Payment Gateway with JazzCash?

Pakistan-Focused

Leverages Bank Alfalah’s extensive user base and JazzCash’s 48M+ users for maximum reach.

Comprehensive Odoo Integration

The only Odoo module supporting Alfa Payment Gateway and JazzCash for Pakistan.

Easy Setup

Quick online registration with Bank Alfalah; no extra setup for JazzCash.

Supported Payment Methods

Flexible Options Including JazzCash

Alfa Wallet

Enable Alfa Wallet payments through Bank Alfalah’s secure hosted payment flow.

Alfalah Bank Account

Secure payments from Bank Alfalah account holders through Alfa’s hosted payment flow.

Credit/Debit Card

Supports Visa and Mastercard (local/international) via Alfa’s secure redirect flow.

JazzCash

Seamlessly integrated via Alfa Payment Gateway, allowing payments from 48M+ JazzCash users without additional setup.

Key Features

Enhanced Functionality for Your Business

Secure Transactions

Uses AES/CBC/PKCS7 encryption for all API requests, ensuring data protection.

Odoo 19 Payment Flow

Uses Odoo 19 redirect forms, payment transactions, status page, and post-processing flow.

Seamless Integration

Built for Odoo 19, integrating with Alfa and JazzCash redirect payment flows.

Wide Reach

Access millions of Alfa Wallet, Bank Alfalah, and JazzCash users in Pakistan.

Currency Conversion (Enterprise)

Enable currency conversion in Odoo Enterprise to accept international payments in non-PKR currencies, converted to PKR.

Configuration Guide

Setting Up Alfa Payment Gateway and JazzCash

Configure the module in Odoo by entering your Alfa Payment Gateway credentials (Merchant ID, Store ID, Hash, Username, Password, Key1, Key2) in the payment provider settings. No additional setup is required for JazzCash – when customers are redirected to the Alfa Payment Gateway, they will automatically see JazzCash as a payment option alongside Alfa Wallet, Bank Account, and Credit/Debit Card.

International Payments (Odoo Enterprise)

For Odoo Enterprise users, enable the "Convert Currency to PKR" option in the payment provider settings to accept payments from international clients in non-PKR currencies. This feature automatically converts transactions to PKR using up-to-date exchange rates. Additionally, remove PKR from the supported currencies for credit/debit card payment methods to allow seamless processing of international card payments. Note: We do not recommend enabling currency conversion in Odoo Community, as it does not automatically update currency rates, which may lead to inaccurate conversions.

Steps to Enable Currency Conversion (Enterprise Only)

  1. Go to Odoo’s Payment Providers settings.
  2. Select the Alfa Payment Gateway provider.
  3. Check the "Convert Currency to PKR" option.
  4. Clear PKR from the supported currencies for credit/debit card payment methods.
  5. Save the settings to enable international payment processing.

Version Information

Built for Odoo 19

Current Version: 19.0.1.0.1
Released: June 2026
Compatibility: Odoo 19 Community and Enterprise editions
This module is actively maintained and supports both Alfa Payment Gateway and JazzCash. Note that it is not an official module.

Screenshots

Explore the Module in Action

Payment Option Selection

Supported Payment Methods

Support Alfa Wallet, Bank Account, Credit/Debit Card, and JazzCash.

Payment Option Selection

Payment Option Selection

Customers choose from Alfa Wallet, Bank Account, Credit/Debit Card, or JazzCash at checkout.

Hosted Alfa Payment Flow

Hosted Alfa Payment Flow

Customers complete sensitive payment steps on Bank Alfalah’s secure hosted pages.

Card Redirect Flow

Card and JazzCash Redirect Flow

Redirect to Alfa’s secure page for Visa/Mastercard or JazzCash payments.

Payment Success

Payment Success

Confirmation page after a successful transaction.

Provider Settings

Provider Settings

Configure APG credentials, test/live mode, and currency conversion settings.

Transaction Dashboard

Transaction Dashboard

Monitor all transactions, including JazzCash, with detailed status updates.

Support

We’re Here to Help

Need assistance with Alfa Payment Gateway or JazzCash integration? Contact our dedicated support team:

Need Help?

Send email to get support.

WhatsApp

Send Message on WhatsApp!

+92 300 7888 120

Alfa Payment Gateway with JazzCash

Overview

The Alfa Payment Gateway module for Odoo 19 integrates Bank Alfalah’s Alfa Payment Gateway and JazzCash redirect options, enabling seamless transactions via Alfa Wallet, Alfalah Bank Account, Credit/Debit Card, Alfa BNPL, and JazzCash. It supports secure redirect payment processing for Pakistan’s e-commerce market.

Features

  • Multiple Payment Methods: Supports Alfa Wallet, Alfalah Bank Account, Credit/Debit Card, Alfa BNPL, and JazzCash through a unified Alfa Payment Gateway flow.
  • JazzCash Integration: No additional setup required; JazzCash is available as a payment option within Alfa’s redirect flow.
  • Currency Conversion (Enterprise Only): Convert non-PKR transactions to PKR for international clients (Odoo Enterprise only).
  • Encryption: Uses AES/CBC/PKCS7 padding for secure API requests.
  • Odoo 19 Native Flow: Uses Odoo 19 payment provider redirect forms, payment transactions, post-processing, and provider status pages.

Installation

Note: Requires pycryptodome. Run pip install pycryptodome in your Python environment.

  1. Download the Module: Obtain from the repository or marketplace.
  2. Extract: Unzip to your Odoo addons directory (e.g., /path/to/odoo/addons/eis_gateway_alpha).
  3. Update Modules List: In Odoo, go to Apps > Update Apps List.
  4. Install: Search for "Alfa Payment Gateway" and click Install.

Configuration

Prerequisites

  • Odoo 19 installed and running.
  • Alfa Bank merchant credentials (Merchant ID, Store ID, Hash, Username, Password, Key1, Key2).
  • Access to Alfa Bank’s sandbox or production API endpoints.

Steps

  1. Configure Payment Provider: - Navigate to Settings > Payments > Payment Providers. - Click Edit for an existing provider or create a new one. - Set:

    • Name: Alfa Payment Gateway
    • Code: apg
    • State: Test (for sandbox) or Enabled (for production)
    • Merchant ID: Your Alfa Bank Merchant ID (e.g., 12345)
    • Store ID: Your Alfa Bank Store ID (e.g., 012343)
    • Merchant Hash: Provided by Alfa Bank (e.g., oubasf...)
    • Merchant Username: Your username (e.g., providedbyalfa)
    • Merchant Password: Your password (e.g., providedbyalfa...)
    • Key1: Encryption key 1 (provided by alfa)
    • Key2: Encryption key 2 (provided by alfa)
    • Convert Currency to PKR (Enterprise only): Enable for international payments; leave unchecked for PKR-only transactions.
    • Save the configuration.

  2. Set Up Payment Methods: - Go to Payments > Payment Methods. - Ensure alfa_wallet, alfa_bank, alfa_card, and alfa_jazz_cash are linked to the APG provider. - For international payments (Enterprise only):

    • Enable Convert Currency to PKR in the provider settings.
    • Remove PKR from supported currencies for alfa_card to allow non-PKR card payments.
    • Note: Use currency conversion only when Odoo currency rates are maintained accurately.

  3. JazzCash Configuration: - No additional setup needed. JazzCash is automatically available as a payment option when customers are redirected to Alfa’s payment page.

  4. Test Transactions: - In test mode, use sandbox credentials to simulate payments. - Verify wallet, bank account, card, and JazzCash flows via Alfa’s redirect page.

Usage

  1. Customer Payment Flow: - On the checkout page, select "Alfa Payment Gateway" as the payment option. - Choose a method (Alfa Wallet, Alfalah Bank Account, Credit/Debit Card, Alfa BNPL, or JazzCash). - Odoo creates a payment transaction, performs the Bank Alfalah handshake, redirects the customer to Alfa’s secure payment page, and processes the callback/status response when the customer returns.
  2. International Payments (Enterprise Only): - With Convert Currency to PKR enabled, customers can pay in non-PKR currencies, automatically converted to PKR using Odoo’s updated rates. - Ensure PKR is removed from alfa_card supported currencies to process international card payments.
  3. Admin Monitoring: - Check transaction statuses in Payments > Transactions. - View logs for debugging handshake, callback, and status responses.

Technical Details

Architecture

  • Models: - payment.provider: Extended with convert_currency and APG-specific credential fields. - payment.transaction: Manages transaction states and gateway data (e.g., apg_gateway_reference).
  • Controllers: - /payment/apg/callback: Handles Alfa redirect returns and verifies final transaction status. - /payment/apg/ipn: Handles Bank Alfalah status notifications from trusted Bank Alfalah status URLs.

Security

  • Uses AES/CBC/PKCS7 encryption with merchant-provided keys for API requests.
  • IPN status URLs are restricted to Bank Alfalah sandbox/production hosts before Odoo fetches status data.

Customization

  • Currency Conversion: Enable/disable convert_currency for international payments (Enterprise only).

Troubleshooting

  • Handshake Fails: Verify merchant credentials, API connectivity, AES Key1/Key2 lengths, and test/production mode.
  • Currency Conversion Issues: Ensure PKR is configured and active in Odoo; use Enterprise for automatic rate updates.
  • JazzCash Not Visible: Confirm Alfa merchant account is active and redirect flow is functional.
  • Logs: Enable debug mode (--log-level=debug) to trace issues.

Support

For assistance with Alfa Payment Gateway or JazzCash integration, contact: - Email: support@expertpk.com - WhatsApp: +92 300 7888 120

Note

Ensure Alfa Bank API credentials are correctly configured for sandbox or production use. For international payments, keep Odoo currency rates maintained and test conversion before going live.

Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.