Fauran Pay for JazzCash WooCommerce

Fauran Pay for JazzCash WooCommerceconnects your WooCommerce store to JazzCash, Pakistan's leading mobile financial services provider. It lets your customers pay using three methods, right from your normal WooCommerce checkout:

• Credit/Debit Card— Visa and Mastercard, via JazzCash's secure hosted payment page (including 3-D Secure).
• JazzCash Mobile Account — customers pay directly from their JazzCash mobile wallet balance.
• Over-the-Counter Voucher — customers receive a 12-digit voucher number and pay in cash at any JazzCash outlet.

Who this plugin is for: WooCommerce store owners in Pakistan (or selling to Pakistani customers) who want to accept local payment methods without handling any cardholder data on their own server, and without paying for a third-party gateway aggregator.

A quick overview of what's included in version 1.0.0.

Make sure your store meets these requirements before installing.

Follow these steps in order. The whole process takes about five minutes.

1. 1

   Upload the plugin

   In your WordPress dashboard, go to Plugins > Add New Plugin > Upload Plugin, choose the plugin ZIP file you downloaded, and click Install Now.

   

2. 2

   Activate the plugin

   Once installed, click Activate Plugin. If WooCommerce isn't active, you'll see a notice asking you to install/activate it first.

   

3. 3

   Open WooCommerce Payment settings

   Go to WooCommerce > Settings > Payments. You'll see three new payment methods: JazzCash - Credit/Debit Card, JazzCash - Mobile Account, and JazzCash - Over-the-Counter Voucher.

   

4. 4

   Enable and configure a gateway

   Click Manage (or the gateway name) next to any method, tick Enable, then fill in your Sandbox credentials — see Getting Started below.

   

The first things to configure right after activation.

1. 1

   Get your Sandbox credentials

   Sign up for a free account at the JazzCash Sandbox Portal to receive a Merchant ID, Password, and Integrity Salt. These are separate from your future live credentials.
2. 2

   Enter your credentials per gateway

   On each gateway's settings screen, Sandbox Mode is enabled by default. Enter your Sandbox Merchant ID, Password, and Integrity Salt in the fields that appear underneath.
3. 3

   Register your callback URLs with JazzCash

   Every gateway's settings screen displays a Return URL and an IPN URL, unique to your site. Copy both into your JazzCash Sandbox/Merchant Portal configuration so JazzCash knows where to send payment results.

   Return URL: https://yourstore.com/?wc-api=jazzcash_return
   IPN URL:    https://yourstore.com/?wc-api=jazzcash_ipn

4. 4

   Place a test order

   Add a product to your cart, check out, and choose a JazzCash payment method. Complete the test transaction using JazzCash's Sandbox test credentials, then confirm the order updates automatically in WooCommerce > Orders.
5. 5

   Go live

   When you're ready to accept real payments: enter your verified Live Merchant ID, Password, and Integrity Salt, then untick Sandbox Mode. The Sandbox Mode checkbox stays visible at all times, so you can always switch back to testing later if needed.

Settings screen, field by field

Every gateway (Card, Mobile Account, Voucher) shares the same core settings:

Gateway-specific fields

The Mobile Account and Voucher gateways additionally have Bank ID and Product ID fields, supplied by JazzCash (Sandbox defaults are TBANK and RETL).

How the payment flow works

1. 1

   Customer chooses a method

   At checkout, the customer selects Card, Mobile Account, or Voucher.
2. 2

   Redirect to JazzCash

   They're sent to JazzCash's secure hosted page to enter their card/wallet details, or to receive a voucher number.
3. 3

   JazzCash reports back

   JazzCash sends a signed result to your store's Return URL. The plugin verifies the Secure Hash before trusting anything in that response.
4. 4

   Order updates automatically

   On success, the order is marked Processing/Completed. On failure, it's marked Failed with the reason recorded as an order note.
5. 5

   Vouchers settle later

   Voucher orders are placed On hold immediately (cash hasn't been paid yet). Once the customer pays at a JazzCash outlet, JazzCash calls your IPN URL and the order is completed automatically — no manual follow-up needed.

Viewing transaction details on an order

Open any order paid via JazzCash in WooCommerce > Orders. A "JazzCash Transaction Details" box appears near the top, showing the Transaction Reference Number, Retrieval Reference Number (RRN) if provided, and the last known response code/message.

Debug logging

Enable Debug Log on any gateway, then check WooCommerce > Status > Logs and choose the log source jazzcash. Passwords, card numbers, CVVs, PINs, and secure hashes are always replaced with ***REDACTED*** — safe to share with support.

Shortcodes, widgets & blocks

None are needed. Once a gateway is enabled, it registers itself automatically as a WooCommerce payment method and appears at checkout on its own. There is nothing to insert into a page or post.

For developers extending the plugin. These are the only custom hooks the plugin exposes — everything else is standard WooCommerce (WC_Payment_Gateway, order status transitions, etc.) and needs no special documentation here.

Example: pointing at a JazzCash-communicated endpoint change

add_filter( 'jazzcash_wc_payment_portal_url', function ( $url, $sandbox ) {
	if ( ! $sandbox ) {
		return 'https://payments.jazzcash.com.pk/CustomerPortal/transactionmanagement/merchantform/';
	}
	return $url;
}, 10, 2 );

Example: replacing a checkout icon

add_filter( 'jazzcash_wc_card_icon', function ( $icon_url ) {
	return get_stylesheet_directory_uri() . '/images/my-custom-card-icon.svg';
} );

Version 1.0.0 — Initial release

• Three payment gateways: JazzCash Card, Mobile Account, and Over-the-Counter Voucher.
• Always-visible Sandbox/Live mode toggle, independent per gateway.
• HMAC-SHA256 Secure Hash generation and verification on every request and response.
• Return URL and IPN webhook handlers with automatic order status updates.
• Order-screen transaction details box (reference number, RRN, response code/message).
• Redacted debug logging via WooCommerce > Status > Logs.
• High-Performance Order Storage (HPOS) compatibility.

Support covers installation help, configuration questions, and fixing genuine bugs in the plugin for the current supported version.

What's not covered: custom development, third-party plugin/theme conflicts outside our control, and issues with your JazzCash merchant account itself (contact JazzCash directly for account-level issues).

This plugin is licensed under the GNU General Public License v2.0 or later, the same license as WordPress itself.

Read the full GPLv2 license text.

Credits

• Built by Usama Saleem — devmubs.com
• No third-party JavaScript or CSS libraries are bundled. jQuery, used by the settings-screen script, is the copy already included with WordPress core — it is never replaced or duplicated.
• Built against JazzCash's publicly published Sandbox API documentation.