← Back to Alfa Payment Gateway overview
Features (Full Detail) — Alfa Payment Gateway
Current version: v1.0.0
Enterprise Bank Alfalah Alfa Payment Gateway integration for Perfex CRM
This page explains module capabilities in depth so new users understand what each feature does, why it matters, and how to use it inside Perfex CRM.
Listing highlights
Quick paste
| Field | File |
|---|---|
| ------- | ------ |
| Name | .../copy/01_item_name.txt |
| Description (HTML) | .../copy/02_description.html |
| How to Use | .../copy/03_how_to_use.txt |
| Tags | .../copy/04_tags.txt |
| Message to Reviewer | .../copy/05_message_to_reviewer.txt |
| Attributes | .../copy/06_attributes_checklist.txt |
| Thumbnail 80×80 | .../images/thumbnail_80x80.jpg |
| Preview 590×300 | .../images/preview_590x300.jpg |
| Screenshots ZIP | .../screenshots/screenshots.zip (replace with real UI screenshots) |
| Main File ZIP | releases/codecanyon/alfapay_gateway-v1.0.0-codecanyon.zip |
Build Main ZIP
bash modules/alfapay_gateway/build_release.sh
Official HTML documentation (feature sections)
Configuration
- Open Setup → Settings → Payment Gateways → Alfa Payment Gateway.
- Enter Merchant ID, Store ID, Merchant Hash, Username, Password, Hash Key 1, Hash Key 2.
- Enable Testing Mode for sandbox, or Production Mode for live.
- Set currencies (example:
PKR,USD) — invoice currency must match. - Copy the displayed Callback / Return / Success / Failed / IPN URLs into your Bank Alfalah merchant portal.
- Optionally click Test Connection.
- Set the gateway to Active.
Note: The gateway cannot be activated until all required credential fields are filled.
How to Use
Client payment flow
- Create an unpaid invoice in a supported currency.
- Client opens the invoice (public link or client area).
- Clicks Pay via Alfa.
- Confirms amount and continues to the Alfa hosted payment page.
- After payment, customer returns to success / failed / pending page.
- Callback / IPN updates the transaction and records the invoice payment.
Admin workflow
- Dashboard — revenue, success rate, charts
- Transactions — list and open payment records
- Refunds — refund paid transactions (permission required)
- Audit Logs — track gateway actions
- Reports — filter and export
Features
- Bank Alfalah Alfa hosted checkout
- Invoice payments from client portal / invoice HTML
- Test & live modes
- Transactions, refunds, audit logs
- Admin dashboard + Perfex dashboard widget
- Client payment history menu
- PDF receipts
- Reports & export
- Email templates (success / failed / pending / refund / admin)
- Granular staff permissions
- Clean uninstall (tables + options removed)
Permissions
Assign under Setup → Staff → Roles:
| Capability group | Actions |
|---|---|
| Alfa Transactions | View, Manage |
| Alfa Refunds | Manage |
| Alfa Reports | View, Export |
| Alfa Settings | Manage |
Uninstall
- Setup → Modules → Deactivate
- Click Uninstall
Removes all alfapay_* tables, module email templates, and gateway options (alfapay_* / paymentmethod_alfapay_*). Core Perfex CRM files are not changed. Existing core invoice payment history is not bulk-deleted by the module.
Related: Quick Start · How to Install · FAQ & Tips · Version & Changelog