Who is this for?
Merchants: Store owners who want to integrate QR Ph payments into their POS system.
Cashiers: Staff responsible for processing transactions at the checkout counter.
Backoffice Admins: Users managing payment settings and reports in the Backoffice.
About QR Ph Payments
QR Ph is the Philippines' national QR code standard, enabling fast, secure, and contactless payments. By integrating QR Ph into StoreHub POS, you can streamline checkout processes, reduce errors, and enhance customer satisfaction.
You can customize settings to:
Enable QR Ph for specific stores and registers.
Set up dynamic QR codes for seamless transactions.
Track QR Ph transactions in sales reports.
When configuring, you can set the following:
Activation Code: A unique reference number provided by the payment provider.
Payment Option Name: Customize how QR Ph appears on receipts and reports.
Store and Register Selection: Choose where QR Ph payments are enabled.
Before You Begin
Setting Up QR Ph Payments:
1. Register for QR Ph: Sign up for QR Ph through the QR Ph Landing Page.
2. Via Backoffice: Configure QR Ph settings directly in the Backoffice.
3. Sync with POS: After setting up QR Ph in the BackOffice, you must sync your POS system to enable the payment option during checkout.
Important Notes:
Ensure your POS devices (e.g., Sunmi D3 Pro, iMin Falcon 1) are updated to version 1.83.1 and above.
QR Ph does not support direct refunds or cancellations. Refunds must be processed manually through different payment methods such as cash.
If the internet connection is lost during a transaction, the customer can still complete the payment. However, you may need to manually approve the transaction on the POS.
Step 1: Register for QR Ph
1. Visit the QR Ph Landing Page:
Sign up for QR Ph by visiting the QR Ph Landing Page.
2. Complete the Registration Form:
Fill out the required details in the registration form.
Ensure all information is accurate to avoid delays in approval.
3. Submit the Form:
Once the form is completed, submit it for processing.
You will receive an Activation Code via email once your account is approved.
Step 2: Set Up QR Ph in Backoffice
Access Payment Options
1. Log in to your StoreHub Backoffice.
2. Navigate to Settings, Payment Options, then click on Add Payment Option.
3. Select QR Code as the payment type.
Configure QR Ph Settings
1. Choose StoreHub Partner - QR Ph as the provider.
2. Select Dynamic QR Code as the QR type.
3. Select the stores and registers where QR Ph will be enabled.
Note: You can enable QR Ph for multiple stores and registers at the same time.
4. Enter the Activation Code (provided by Payment Provider).
Notes:
You will receive your Activation Code via email once your account is activated.
If you don’t have the code, reach out to StoreHub Customer Care for assistance.
5. Save your settings.
Note:
You will not be able to save your settings without entering an Activation Code.
If the QR Ph transaction fails, ensure that the Activation Code is correctly entered in the BackOffice.
Verify Setup
Ensure the QR Ph payment option appears on the POS checkout page.
Step 3: QR Ph Payments on POS
1. At checkout, select QR Ph as the payment method.
2. A dynamic QR code will be displayed on your POS.
On Customer-Facing Display App.
On Customer-Facing Display App.
On Cashier-Facing Screen.
On Cashier-Facing Screen.
3. The customer scans the QR code to complete the payment.
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.
Steps on Manual Approvals:
If the payment status is not confirmed (e.g., due to internet issues), manually approve the transaction on the POS. Click on the "..." at the top right of the screen and select Approve Manually.
Add a note and reason for manual approval for audit purposes.
Notes:
If the dynamic QR code fails to generate, check your internet connection and ensure the Activation Code is correctly entered in the Backoffice.
Verify Payment Status: Before manually approving a transaction, always check the payment status on the customer’s phone or payment app to confirm the payment was successful.
Prevent Misuse: Be cautious when manually approving transactions. Misuse or incorrect approvals can lead to discrepancies and financial losses.
Tracking Manually Approved QR Ph Transactions
Including details such as "Approved Manually At," "Approved Manually By," and "Reason for Manual Approval" in transaction details is crucial for accountability and traceability.
This is especially important when integrating payment methods that require internet connectivity, as manual approvals may be necessary in cases of internet outages or system errors.
How to Track Manually Approved Transactions
1. Go to Backoffice, then click on Offline Transactions.
2. Locate the manually approved QR Ph transaction.
3. In the transaction details, the following information will be displayed:
Approved Manually At: The timestamp when the transaction was manually approved.
Approved Manually By: The name or ID of the staff who approved the transaction.
Reason for Manual Approval: The explanation provided during manual approval.
This ensures transparency, helps in resolving disputes, and supports audit processes.
Handling Refunds and Cancellations for QR Ph Transactions
QR Ph does not support direct refunds or cancellations. You must process refunds or cancellations using alternative payment methods, such as cash.
Cancelling a QR Ph Transaction
1. When a user cancels a transaction:
a. Select the reason for cancellation.
b. 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?"
c. Click on OK to confirm the cancellation and proceed.
Note: To ensure better control and accountability, the Cancel Transaction feature is allowed on the POS but blocked in the Backoffice for QR Ph transactions.
Issuing a Refund for a QR Ph Transaction
1. When a user issues a refund:
QR Ph will not be available as a refund payment method.
Refunds must be processed manually through other payment methods such as cash.
Edit or Delete QR Ph Settings
Edit QR Ph Settings
1. Go to Backoffice, Settings then click on Payment Options.
2. Locate the QR Ph payment option and click Edit.
3. Update the Activation Code, store selection, or other settings as needed.
4. Save your changes.
Delete QR Ph Settings
1. Go to Backoffice, Settings then Payment Options.
2. Locate the QR Ph payment option and click Delete.
3. Confirm the deletion.
Troubleshooting Tips
Possible Error Codes
Code | Description |
10000001 | Account Locked |
10000002 | Account is not active |
10000003 | Account not found |
Need Help?
If you encounter any of the above errors or other API-related issues, please reach out to our partner directly for assistance.
Service Hours: 9:30 AM to 9:30 PM
Contact Us:
Call, SMS, Viber, WhatsApp: +63 968 391 3872
Dynamic QR Code Fails to Generate
Check your internet connection.
Verify that the Activation Code is correctly entered in the Backoffice.
Ensure your POS device is on version 1.83.1 and above.
Payment Status Not Confirmed
Manually approve only after you have check the payment has went through on the customer's side.
Add a note and reason for manual approval in the transaction details.
QR Ph Not Displayed on POS
Verify that QR Ph is enabled for the specific store and register.
Check for any errors in the Backoffice setup.
Customer Scans QR Code but Transaction is Not Completed
Check the payment status on the customer's phone. If the payment is not confirmed, you can manually approve it.
If the issue persists, contact the payment provider for further assistance.
Related Articles
Common Issues and Queries
"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.
"Can I enable QR Ph for multiple stores and registers?"
Yes, you can enable QR Ph for multiple stores and registers during the setup process in the Backoffice.
Next Steps
Train your staff on processing QR Ph payments and handling manual approvals.
Contact StoreHub Support if you encounter any issues during setup.
Note: If you choose to test transactions with QR Ph, please keep in mind that QR Ph does not support refunds and an MDR charge will apply. For these reasons, we strongly discourage testing.
Frequently Asked Questions (FAQs)
1. What is QR Ph, and how does it work?
QR Ph is a national QR code payment standard in the Philippines that enables seamless digital transactions across different banks and e-wallets. It works by allowing users to scan a QR code using their banking or e-wallet app to make payments, eliminating the need for cash or card transactions.
2. Why is the QR Ph option not showing on my POS?
Make sure the QR Ph payment option is correctly assigned to the store and register. Then, sync your POS and check again.
3. What should I do if the payment status is not confirmed?
Check if the payment is confirmed on the customer’s phone and if the money is deducted from their account.
If confirmed, manually approve the transaction on the POS.
4. What happens if the dynamic QR code fails to generate?
Check your internet connection and try again.
If you see an error code, refer to the Possible Error Codes section for more details.
5. How are QR Ph transactions reflected in Z-Reading and X-Reading reports?
It will be reflected as a payment method similar to how other payment methods work
6. What are the fees for using QR Ph?
For more details on the fees for using QR Ph, please reach out to us directly. We'd be happy to assist!
7. What banks and e-wallets does QR Ph support?
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.
8. What should I do if I don’t receive my Activation Code?
KYC processing usually takes up to 3 working days. You’ll receive your Activation Code once your account is activated. If it’s been more than 3 days, give us a shout!
Service Hours: 9:30 AM to 9:30 PM
Contact Us:
Call, SMS, Viber, WhatsApp: +63 968 391 3872
9. What should I do if a QR Ph transaction fails?
If you run into any errors or issues, don’t worry—we’re here to help! Reach out to us directly, and we’ll get it sorted.
Service Hours: 9:30 AM to 9:30 PM
Contact Us:
Call, SMS, Viber, WhatsApp: +63 968 391 3872