Skip to main content
The HitPay Terminal app for Shopify POS sends each sale from Shopify POS to your HitPay terminal. Your customer pays by card or a local payment method, and the Shopify order is marked paid and linked to its HitPay payment automatically. Watch how to set up the app and take a payment:

​
Before you begin

You need:
  • A HitPay account that is live and verified. If you don’t have one yet, create an account.
  • A Shopify store that uses Shopify POS.
  • The same currency in Shopify and HitPay. Terminal payments are charged in your HitPay account’s currency, so your Shopify store currency must match it.
  • A supported HitPay terminal:
    • WisePOS E
    • FlexiPOS (Stripe S700 or S710)
    • HitPay All-in-One Ingenico S1F2
    • HitPay All-in-One Ingenico DX4000
    • Verifone V660P (All-in-One)
Don’t have a terminal yet? Order one from the HitPay shop.

​
Set up the app

1

Register for the app

The HitPay Terminal app isn’t listed in the Shopify App Store. To get it, fill in the registration form with your store’s .myshopify.com domain.You can find your .myshopify.com domain in Shopify admin under Settings > Domains.HitPay sends you the install link for your store only after you’ve submitted the form.
2

Install the app

Open the install link while you’re logged in to your Shopify store as the owner, or as a staff member who can install apps. Review the permissions and click Install.
3

Copy your HitPay API key and salt

In your HitPay dashboard, go to Developers > API Keys and copy your API key and salt.
4

Connect HitPay

In Shopify admin, open the HitPay Terminal app. On the Overview page, paste your API key and salt and click Connect HitPay.
Keep your API key and salt private. Paste them only into the app, and never share them by email or chat.
5

Put your terminal in In-Person Payment API mode

On the terminal, switch to In-Person Payment API mode. See Displaying payments on the terminal for the steps.
6

Map your terminals

In the app, open Terminals and click Add a terminal. Choose the Shopify POS location and the terminal it should use, then save. Repeat for each location.
7

Let your staff use the app

In Shopify admin, give your POS staff roles permission to use apps. Without it, the app tells the cashier to ask the store owner for access.

​
Take a payment

1

Ring up the sale

In Shopify POS, add the items to the cart and tap Checkout.
2

Tap Mark unpaid

Choose Mark unpaid. In this app, Mark unpaid means “pay on the HitPay terminal”. Shopify’s label can’t be changed.
3

Choose how the customer pays

The HitPay screen opens automatically with the order total. Tap Card, or a QR method such as PayNow, DuitNow, QR Ph or GCash. The terminal shows the amount, or the QR code to scan.
4

The customer pays

When the payment succeeds, the order is marked paid in Shopify automatically.
The payment shows in your HitPay dashboard with the Shopify order number as its reference, so you can match every HitPay payment to its Shopify order.
The payment methods offered on the terminal are the ones turned on for your HitPay account. Methods your account can’t take aren’t shown.

​
If the customer doesn’t pay

If the customer changes their mind before paying, tap Cancel order on the HitPay screen, then tap it again to confirm. Shopify cancels the order and restocks the items. The customer isn’t charged. You can only cancel an order this way while it’s unpaid. Once a HitPay payment has succeeded, refund it instead.

​
Refund a payment

1

Open the order

In Shopify POS, open the paid order.
2

Refund through HitPay

Tap HitPay, then Refund. The refund goes back to the customer through HitPay, and appears on the Shopify order and in your HitPay dashboard.

​
Customers

If you add a customer to the cart or the order before they pay, the customer is:
  • Added to your HitPay customers, with their name, email and phone.
  • Attached to the HitPay payment.
  • Sent HitPay’s receipt by email, if they have an email address.
If you add a customer after the payment, they’re added to your HitPay customers, but not attached to that payment.
To copy customers, approve the app’s customer permissions when Shopify asks. Until then, payments still work, but customers aren’t copied to HitPay.

​
Optional settings

​
Show HitPay as the payment method on orders

By default, Shopify records terminal payments as Other. To show HitPay – Card, HitPay – PayNow and so on, add manual payment methods with these exact names in Shopify admin under Settings > Payments > Manual payment methods. This makes Shopify’s payment reports easier to reconcile.

​
Charge from the POS home screen

You can also add the HitPay Terminal tile to your Shopify POS home screen. It lets you send the cart total to the terminal before you check out. Most stores only need Mark unpaid.

​
Troubleshooting

Check that the terminal is on, connected to the internet, and in In-Person Payment API mode. Then check that it’s mapped to the POS location you’re using under Terminals in the app.
Your Shopify store currency must match your HitPay account currency. Terminal payments can only be charged in your HitPay account’s currency.
Copy your API key and salt again from Developers > API Keys in the HitPay dashboard, and paste both into the app’s Overview page.
In Shopify admin, give that staff member’s POS role permission to use apps.
Need help? Contact [email protected].
Last modified on October 18, 2026