Fauran Pay with JazzCash for WooCommerce
| 开发者 | devmubs |
|---|---|
| 更新时间 | 2026年7月23日 10:09 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Credit/Debit Card (Visa, Mastercard, via JazzCash's MPGS-powered hosted page, including 3-D Secure)
- JazzCash Mobile Account (mobile wallet balance)
- Over-the-Counter Voucher (cash payment at any JazzCash outlet)
- PCI-DSS friendly by design. Card and mobile account credentials are entered on JazzCash's own hosted payment page — your server never receives, stores, or transmits cardholder data.
- Secure Hash on every request and response. Every outgoing request and every inbound callback is signed and verified with HMAC-SHA256, exactly as specified in the JazzCash integration guide. Responses that fail verification are rejected and never applied to an order.
- Sandbox Mode built in. Flip a single checkbox per gateway to test end-to-end against the JazzCash Sandbox before going live — no code changes required.
- Clean, modern codebase. 100% object-oriented, PSR-4 autoloaded, namespaced, and built strictly against the WordPress Plugin/WooCommerce Payment Gateway APIs. No inline CSS/JS, no direct file access, all output escaped, all input sanitized and validated.
- HPOS ready. Declares compatibility with WooCommerce's High-Performance Order Storage. Uses the classic (shortcode) checkout — the block-based Cart/Checkout is not yet supported, so gateways will not appear there until a dedicated Blocks integration ships in a future release.
- The customer chooses Card, Mobile Account, or Voucher at WooCommerce checkout.
- They're redirected to JazzCash's secure hosted page to authorize payment (or, for vouchers, to receive a 12-digit voucher number by SMS).
- JazzCash posts the signed result back to your store, the Secure Hash is verified, and the order is updated automatically — no manual reconciliation.
- For vouchers paid later at a JazzCash outlet, an Instant Payment Notification (IPN) webhook updates the order the moment JazzCash confirms settlement.
- WooCommerce 7.0+
- A JazzCash Merchant account (Sandbox account is free — see Getting Started)
- Store currency set to PKR
- The classic (shortcode) checkout. If your theme/setup uses the WooCommerce Cart & Checkout Blocks, switch that page back to the classic
[woocommerce_checkout]shortcode — block-based Blocks checkout support is not yet included in this release.
安装:
- Upload the plugin files to
/wp-content/plugins/fauran-pay-with-jazzcash-for-woocommerce, or install the zip via Plugins > Add New > Upload Plugin. - Activate the plugin through the Plugins screen in WordPress.
- Go to WooCommerce > Settings > Payments and enable the JazzCash gateway(s) you want to offer.
- Click into each gateway and enter your Sandbox credentials (Merchant ID, Password, Integrity Salt) from the JazzCash Sandbox Portal, keeping Sandbox Mode enabled while testing.
- Add the store's Return URL / IPN URL shown in each gateway's description to your JazzCash Merchant/Sandbox Portal configuration.
- Place a test order to confirm the full round trip.
- When ready to accept real payments, enter your Live credentials and disable Sandbox Mode.
屏幕截图:
常见问题:
Does this plugin store customer card numbers?
No. Card and mobile-account entry happens entirely on JazzCash's hosted payment page. This plugin only ever handles the order total, a transaction reference number, and the signed pass/fail result — never a PAN, CVV, or MPIN.
Where do I find my Merchant ID, Password, and Integrity Salt?
Register for a free account at the JazzCash Sandbox Portal to get Sandbox credentials, and complete merchant verification on the live JazzCash Merchant Portal to get Live credentials.
What URL do I give JazzCash for the Return URL / IPN URL?
Each gateway's settings screen displays the exact URLs to configure. They follow the pattern https://yourstore.com/?wc-api=jazzcash_return and https://yourstore.com/?wc-api=jazzcash_ipn.
My orders aren't updating after payment — what should I check?
Enable Debug Log on the gateway and review WooCommerce > Status > Logs (source: jazzcash). Most issues trace back to a mismatched Integrity Salt, an incorrect Merchant ID for the selected mode (Sandbox vs Live), or a firewall/security plugin blocking the inbound callback.
Is this plugin affiliated with JazzCash or Mobilink Microfinance Bank?
No. This is an independent, third-party integration built against JazzCash's published API documentation.
Why don't the JazzCash options appear at checkout even though the currency and credentials are correct?
Check whether your Checkout page is using the WooCommerce Cart & Checkout Blocks. This plugin currently supports the classic (shortcode) checkout only; block-based checkout support is not yet included. Edit the Checkout page and confirm it uses the classic [woocommerce_checkout] shortcode rather than the Checkout block.
更新日志:
- Renamed from "JazzCash Payment Gateway for WooCommerce" to "Fauran Pay with JazzCash for WooCommerce" prior to first public release.
- Initial release: Card, Mobile Account, and Over-the-Counter Voucher gateways.
- Sandbox/Live mode toggle per gateway.
- HMAC-SHA256 Secure Hash generation and verification on all requests/responses.
- Return URL and IPN webhook handlers with automatic order status updates.
- High-Performance Order Storage (HPOS) compatibility declaration. Classic (shortcode) checkout only in this release — block-based Cart/Checkout is not yet supported.