Who Is This For?
StoreHub merchants in the Philippines who want to accept QR Ph payments on their POS, and backoffice admins who manage payment settings.
Overview
This article covers everything you need to accept QR Ph payments with StoreHub, from registering for QR Ph and setting it up in BackOffice, to processing payments on your POS, handling refunds and cancellations, tracking manually approved transactions, and editing or removing QR Ph settings. QR Ph is the Philippines' national QR code standard, enabling fast, secure, and contactless payments across banks and e-wallets.
Before You Begin
A StoreHub BackOffice account with access to 'Settings'.
A stable internet connection.
POS devices updated to version 1.83.1 or above (e.g. Sunmi D3 Pro, iMin Falcon 1).
An Activation Code from your QR Ph registration (you will get this via email after approval. See the registration steps below).
Notes:
QR Ph does not support direct refunds or cancellations. Refunds must be processed through a different payment method, such as cash.
If you choose to test transactions with QR Ph, an MDR charge will apply and the payment cannot be refunded. For this reason, testing is strongly discouraged.
Step-by-Step Guide
Register for QR Ph
1. Visit the QR Ph Landing Page to sign up.
2. Fill out the registration form with your business details.
3. Submit the form for processing.
Note:
KYC processing usually takes up to 3 working days. You will receive your Activation Code via email once your account is approved. If it has been more than 3 days, contact the QR Ph support team (see the Troubleshooting section below).
Set Up QR Ph in BackOffice
1. In your BackOffice, go to 'Settings', then 'Payment Options'.
2. Click 'Add Payment Option'.
3. Select 'QR Code' as the payment type.
4. Choose 'Modulus Labs - QR Ph' as the provider.
5. Select 'Dynamic QR Code' as the QR type.
6. Select the stores and registers where you want QR Ph to be available.
7. Enter your Activation Code (the code you received by email after registration).
8. Click 'Save' to finish the setup.
Notes:
You can enable QR Ph for multiple stores and registers at the same time.
You cannot save without entering an Activation Code.
If you have not received your code, contact StoreHub Customer Care or the QR Ph support team.
9. On your POS, sync the device to pull in the new payment option.
10. Confirm that the QR Ph payment option now appears on the POS checkout page.
Accept a QR Ph Payment on POS
1. At checkout, select 'QR Ph' as the payment method.
2. A dynamic QR code will appear on your screen. The display differs depending on your setup:
a. On the Cashier-Facing Screen:
b. On the Customer-Facing Display App:
3. The customer scans the QR code using their banking or e-wallet app.
4. Once payment is successful, the transaction is automatically marked as complete.
Note:
To find out which banks and e-wallets QR Ph supports, check the Sender section of the official QR Ph participants list here.
Manually Approve a QR Ph Payment
If the payment status is not confirmed (for example, due to internet issues), you can manually approve the transaction on the POS.
Note:
Before manually approving, always check the payment status on the customer's phone or payment app to confirm the payment went through. Incorrect approvals can lead to financial discrepancies.
1. On the POS transaction screen, tap the '...' menu at the top right.
2. Tap on 'Approve Manually'.
3. Add a note and reason for manual approval (this is required for audit purposes).
Note:
We recommend including the payment reference number from the customer's payment app or bank confirmation in your note. This makes it easier to verify and trace the transaction later.
4. Confirm the approval.
Track Manually Approved Transactions
1. In BackOffice, go to 'Offline Transactions'.
2. Find the manually approved QR Ph transaction in the list.
3. Open the transaction to view the details. The following fields are shown:
Approved Manually At: the date and time the transaction was manually approved.
Approved Manually By: the name or ID of the staff member who approved it.
Reason for Manual Approval: the explanation given during approval.
Cancel a QR Ph Transaction
Since QR Ph does not support direct refunds, cancellations are processed with a cash refund.
1. On POS, open the transaction you want to cancel.
2. Select the reason for the cancellation.
3. A prompt will appear: "QR Ph does not support refunds of transactions to customer's e-Wallet, you will have to refund by cash. Proceed to cancel?"
4. Tap 'OK' to confirm the cancellation and proceed with a cash refund to the customer.
Notes:
The 'Cancel Transaction' feature is available on the POS but blocked in BackOffice for QR Ph transactions.
When issuing a refund, QR Ph will not be available as a refund payment method. Refunds must be processed through cash or another payment method.
Edit QR Ph Settings
1. In BackOffice, go to 'Settings', then 'Payment Options'.
2. Find the QR Ph payment option and click 'Edit'.
3. Update the Activation Code, store selection, register selection, or other settings as needed.
4. Click 'Save' to apply your changes.
Delete QR Ph Settings
1. In BackOffice, go to 'Settings', then 'Payment Options'.
2. Find the QR Ph payment option and click 'Delete'.
3. Confirm the deletion when prompted.
Troubleshooting
Issue | Solution |
Dynamic QR code fails to generate | Check your internet connection. Verify that the Activation Code is correctly entered in BackOffice. Make sure your POS device is on version 1.83.1 or above. |
Payment status not confirmed after customer scans | Check the payment status on the customer's phone first. If the payment went through, manually approve the transaction on the POS (see 'Manually Approve a QR Ph Payment' above). |
QR Ph not showing on POS | Confirm that QR Ph is enabled for the correct store and register in BackOffice. Sync your POS device after making changes. |
Customer scans the QR code but the transaction does not complete | Check the payment status on the customer's phone. If the payment is not confirmed on their end, ask the customer to try again. If the issue continues, contact the QR Ph support team. |
Error code 10000001: Account Locked | Contact the QR Ph support team to unlock your account. |
Error code 10000002: Account is not active | Contact the QR Ph support team to activate your account. |
Error code 10000003: Account not found | Verify that your registration was completed and approved. Contact the QR Ph support team if the issue persists. |
Activation Code not received after 3 working days | Contact the QR Ph support team: Call, SMS, Viber, or WhatsApp at +63 968 391 3872 (service hours: 9:30 AM – 9:30 PM). |
FAQs
1. What is QR Ph and how does it work?
QR Ph is the Philippines' national QR code payment standard. It lets customers scan a QR code using their banking or e-wallet app to pay, no cash or card needed. When enabled on your StoreHub POS, a dynamic QR code is displayed at checkout for the customer to scan.
2. Which banks and e-wallets support QR Ph?
Here's a list of QRPh Supported Banks and E-wallets for your easier reference.
Banks
Asia United Bank Corporation (AUB)
Bank of the Philippine Islands (BPI)
BDO Unibank Inc.
Metropolitan Bank and Trust Company (MetroBank)
Philippine National Bank (PNB)
Rizal Commercial Banking Corporation (RCBC)
Robinsons Bank Corporation
Security Bank Corporation
Union Bank of the Philippines (UBP)
China Banking Corporation
Land Bank of the Philippines
AllBank (A Thrift Bank), Inc.
Queen City Development Bank, Inc. or QueenBank, A Thrift Bank
Sterling Bank of Asia, Inc. (A Savings Bank)
Philippine Savings Bank
Cebuana Lhuillier Rural Bank, Inc.
Rural Bank of Guinobatan, Inc.
SeaBank Philippines Inc. (A Rural Bank)
GoTyme Bank Corporation
E-Wallets
GCash (G-Xchange, Inc.)
Maya Philippines, Inc.
ShopeePay Philippines, Inc.
Other issuers
GrabPay (Gpay Network PH, Inc.)
PPS-PEPP Financial Services Corporation
Starpay Corporation
TayoCash, Inc.
Traxion Pay, Inc.
USSC Money Services, Inc.
Zybi Tech, Inc.
CIS Bayad Center, Inc.
DCPAY Philippines, Inc.
3. Can I enable QR Ph for multiple stores and registers?
Yes. During setup in BackOffice, you can select multiple stores and registers to enable QR Ph on all of them at once.
4. Can I use QR Ph for online orders?
Yes. QR Ph can be selected as a payment option for both offline and online orders on the POS.
5. Can I refund a QR Ph transaction back to the customer's e-wallet?
No. QR Ph does not support direct refunds. Refunds must be processed manually through a different payment method such as cash.
6. What should I do if the dynamic QR code fails to generate?
Check your internet connection and try again. If you see an error code, refer to the Troubleshooting section above. Make sure your POS is on version 1.83.1 or above.
7. What are the fees for using QR Ph?
For details on QR Ph fees and MDR charges, contact StoreHub Support or the QR Ph support team.
8. What should I do if I do not receive my Activation Code?
KYC processing usually takes up to 3 working days. If you have not received your code after 3 days, contact the QR Ph support team at +63 968 391 3872 (Call, SMS, Viber, or WhatsApp), available 9:30 AM – 9:30 PM.
9. How are QR Ph transactions shown in Z-Reading and X-Reading reports?
QR Ph appears as a separate payment method in your Z-Reading and X-Reading reports, similar to how other payment methods are displayed.
10. What happens if the internet goes down during a QR Ph payment?
The customer can still complete the payment on their end. However, the POS may not receive confirmation automatically. Check the payment status on the customer's phone, then manually approve the transaction on the POS if needed.
Need Help?
Contact StoreHub Support via live chat in your StoreHub app or email [email protected].
For QR Ph-specific issues (error codes, activation, account issues), contact the QR Ph support team:
Service hours: 9:30 AM – 9:30 PM
Call, SMS, Viber, or WhatsApp: +63 968 391 3872
Was This Article Helpful?
Let us know below or contact support for further assistance.