QFPay

QFPay is a payment service that offers payment solutions through the HaoJin App for customer transactions with a physical terminal.

Important

  • QFPay payment terminals do not require an IoT Box to operate.

  • QFPay terminals are exclusively for Hong Kong.

QFPay configuration

To configure a QFPay payment terminal, follow these steps:

  1. Create a QFPay account on the QFPay website.

  2. Request activation of Asynchronous Notifications from the application email.

  3. Provide the Odoo server address on the QFPay portal, followed by /qfpay/notify, and copy the notification key provided by QFPay.

  4. Set up the QFPay terminal by connecting the HaoJin App to the QFPay account as instructed by QFPay, then copy the terminal’s IP address.

  5. Request a self-signed certificate from QFPay linked to the terminal’s IP address, and import it into the relevant POS in Odoo.

  6. Generate a POS-KEY from the HaoJin App: go to Haojin App ‣ My ‣ Settings ‣ Pos Call Up Key ‣ Reset Key. Then, copy the generated POS-KEY.

Note

  • The Asynchronous Notifications are automated messages confirming successful payments or refunds by QFPay.

  • Write the server address as follows: https://yourdomain.odoo.com/qfpay/notify.

  • If the terminal’s IP address changes, update it in the Odoo POS settings and request a new self-signed certificate from QFPay.

  • If a QFPay account already exists, contact technical.support@qfpay.com with the merchant information and server address.

Tip

Alternatively, retrieve the POS-KEY from the MMS (Merchant Management System) portal: go to MMS portal ‣ Settings ‣ Device Settings.

Odoo POS configuration

To connect the QFPay terminal with Odoo Point of Sale, follow these steps:

  1. Go to Point of Sale ‣ Configuration ‣ Settings, scroll down to the Payment Terminals section, enable the QFPay terminal, and click Save.

  2. Go to Point of Sale ‣ Configuration ‣ Payment Methods and create a payment method.

  3. Set the Journal field to Bank.

  4. Select the desired point of sale in the Point of Sale field.

  5. Set the Integration field to Terminal.

  6. Set the Integrate with field to QFPay.

  7. Paste the copied information from QFPay into the corresponding fields:

    • Terminal IP

    • POS Key

    • Notification Key