invite-frey / is-woo-payment-fps

Woocommerce Payment Gateway for Hong Kong Faster Payment System (FPS). With QR Code generation.

Woocommerce Payment Gateway for Hong Kong Faster Payment System (FPS)

Woocommerce Payment Gateway for Hong Kong FPS.

Features:

• Generates FPS QR Code based on your Woocommerce payment gateway configuration.
• Automatically include payment reference in the QR Code if your FPS account has "Ask to Pay" feature enabled.

Prerequisites

• Wordpress
• Woocommerce
• An FPS enabled Hong Kong bank account.

Installation

• Get the files

$ git clone https://github.com/invite-frey/is-woo-payment-fps.git

1. Move the is-woo-payment-fps directory to your wordpress plugins directory.
2. Activate the plugin from the Wordpress admin plugins section.
3. Configure your FPS account details in Woocommerce -> Settings -> Payments -> Hong Kong Faster Payment System (FPS).
4. Enable the Payment Gateway.

Configuration

• Title, Description and Payment Reference Guide are the customer facing instructions you can set to anything yo want.
• Account Id Type, Account Id and Bank Code identify the Payee Account. The QR Code is generated based on this information.
• Ask to Pay Enabled: If this feature is enabled, a reference number will be automatically generated and included in the QR Code. You need to contact your bank to use this feature. If this feature is NOT enabled the customer is presented with an automatically generated reference code and asked to enter it when completing the payment using the bank's FPS app.

Acknowledgements

• Inspiration for the FPS EMV string generation from https://github.com/nessgor/fps-hk-qrcode
• The QR codes are generated by PHP QR Code, which is included under the terms of its license.

Versioning

1.0

• First Release

1.1

• QR Code quality improved
• Mobile phonen number format example included

1.2

• Invalid QR Code problems fixed

1.3

• Output QR Code at a higher priority during WP startup
• Form validation for the Payment Gateway settings

1.31

• Bug fixes

1.4

• Optional QRCode caching added

1.41

• Bugfix

1.42

• QRCodes always cached to disk due to browser incompatibility issues with dynamic generation.
• Fixed bug preventing headers to be output on some systems

1.43

• Minor bug fixes

1.44

• base64 encoded png qrcode

Donations

Donations are much appreciated if you found this resource useful.

Bitcoin, Lightning Network and most major credit cards available for donations at https://frey.hk.

License

This project is licensed under the LGPL 3 License - see the LICENSE.md file for details