To connect HitPay, go to Settings › Integrations in the EasyBiz Console, click Connect on HitPay, open your country's row in the HitPay accounts window, and paste your HitPay API key and webhook salt. Then switch HitPay methods on for your counter and your Online Store.
What You Need Before Starting
A HitPay account for each country you sell in (instructions below). For example, a business with outlets in Singapore and Malaysia connects a Singapore HitPay account and a Malaysia HitPay account.
Access to your EasyBiz Console
Step 1 — Create a HitPay Account
If you already have a HitPay account, skip to Step 2.
- Go to HitPay and click Sign Up / Get started for free
Enter your email address and create a password
Check your email for a verification code and enter it
Fill in your business details — select the category that best matches your business (e.g. Retail, Laundry, or use Other if nothing fits exactly)
Complete the onboarding steps until you reach your HitPay dashboard
Step 2 — Open Your HitPay Account in EasyBiz
Start in EasyBiz so you have the HitPay window open. You will copy values into it from HitPay in the next two steps.
In your EasyBiz Console, click Settings. Under Administration, click Integrations
Find HitPay in the list and click Connect
A window titled HitPay accounts opens. It has one row for each country you sell in, such as Singapore. A country you haven't connected yet says Not connected
If you sell in more than one country, click the row of the country you are connecting. If you only sell in one country, its row is already open
The row shows an API Key field, a Webhook Setup box with your webhook URL, and a Webhook Salt field
In the Webhook Setup box, click Copy next to the webhook URL. You will paste it into HitPay in Step 4
Keep this window open while you work through Steps 3 and 4 in your HitPay dashboard.
Step 3 — Get Your HitPay API Key
The API key is what lets EasyBiz communicate securely with your HitPay account.
In your HitPay dashboard, click Developers in the left menu
Click the API Keys tab
Click Copy next to your API key
Go back to the EasyBiz window and paste it into the API Key field. Under the field, EasyBiz tells you whether it is a live key or a sandbox (
test_) key. Use the webhook and Salt from the same HitPay environment as the key
Step 4 — Set Up a Webhook in HitPay
A webhook is how HitPay notifies EasyBiz when a payment is completed or fails. You need to set this up so EasyBiz knows when a customer has paid.
In your HitPay dashboard, click Developers → Webhook Endpoints tab
Click + New Webhook
Fill in the following:
Webhook Name — enter anything you like, for example: EasyBiz
Webhook URL — paste the webhook URL you copied from the EasyBiz window in Step 2
Under Payment Request, tick both Completed and Failed
Click Save
Your new webhook now appears in the list with a Salt value next to it. Copy this Salt
Step 5 — Save the Connection in EasyBiz
Go back to the EasyBiz window you left open in Step 2. If you closed it, go back to Settings → Integrations, click Connect on HitPay (it says Manage once another country is connected), and click your country's row.
Check the API Key field contains the key you copied in Step 3
Paste the Salt you copied in Step 4 into the Webhook Salt field
Optional: use the Send HitPay receipt email to customer switch to control whether HitPay emails its own payment receipt to your customer
Click Save
You're All Set
Once you click Save, that country's HitPay account is connected. Its row in the HitPay accounts window shows which key you saved and the webhook's status, for example Live key · webhook not verified yet, with a Check webhook label. After HitPay sends its first payment update to EasyBiz, the row says webhook verified and the label changes to Takes payments.
The HitPay card on the Integrations page shows the same status, such as Live key · webhook verified. If you connected more than one country, it lists each one, for example Singapore: Live key · Malaysia: Sandbox key. The card's button now says Manage.
To connect another country later, click Manage on the HitPay card, click that country's row, and repeat Steps 3 to 5 with that country's HitPay account. Each HitPay account has its own webhook, so each country gets its own Salt.
Connecting HitPay does not switch any method on by itself. Choose where customers can use it:
At your counter: add HitPay's PayNow to your POS, or DuitNow QR for your Malaysia shops. See Setting Up Your Payment Methods at POS.
On your Online Store and Mobile App: switch HitPay methods on in the store editor's Payment page. See Taking Payments on Your Online Store.
Use HitPay on Your Online Store
Go to Settings › Sales Channels › Online Store & Mobile App.
On the store card, click Edit Online Store. The button says Edit Mobile App or Edit Online Store & Mobile App when those are on.
Under Pages, click Payment.
Under Third Party, switch on each method you want customers to use, such as PayNow or Card, and choose HitPay as its provider. Drag the rows into the order customers should see.
Preview your store, then publish it. See Edit, Preview and Publish Your Online Store.
Requiring a saved card
Customers can save a card with HitPay when they book. The card is charged automatically once the order is ready. To make a saved card a condition of booking for a business unit, set its Payment row on the store editor's Checkout page to Card on file required.
This needs a HitPay account that can save cards. If the Payment row asks you to, click Check HitPay. If it says your account can't save cards (GIRO only), customers can't add a card when they book: ask HitPay to turn on cards for recurring billing, then check again.
If you later save a different API key, click Check HitPay again before you publish.
HitPay keeps each saved card under the customer's email. A customer with no email on their account sees "Add your email in Contact details to save a card."
For the full Online Store payment setup, see Taking Payments on Your Online Store.
If It Didn't Work
A payment was made, but the order in EasyBiz doesn't show it as paid.
This almost always means HitPay could not notify EasyBiz. Check three things:
The webhook URL is correct. In your HitPay dashboard, go to Developers → Webhook Endpoints and compare the URL character-for-character with the one shown in the EasyBiz Webhook Setup box. Use the Copy buttons on both sides — do not retype it.
Both events are ticked. The webhook must have Completed and Failed ticked under Payment Request.
The Salt matches. If you created more than one webhook, each has its own Salt. Copy the Salt from the exact webhook that carries the EasyBiz URL, paste it into the Webhook Salt field of the right country's row in EasyBiz, and click Save again.
The HitPay card or a country's row says "webhook signature failing".
The Salt saved in EasyBiz does not match the webhook HitPay is calling. Copy the Salt again from the same HitPay environment as your API key (live or sandbox), paste it into Webhook Salt, and click Save. Until the Salt matches, PayNow payments still complete, but 15 to 35 minutes later.
EasyBiz shows an error when taking a HitPay payment.
Open Settings → Integrations, click Manage on the HitPay card, click your country's row and re-paste the API key from HitPay's Developers → API Keys page. A key that was cut off or has an extra space in front or behind will fail. If you regenerated your API key in HitPay, the old key stored in EasyBiz stops working — paste the new one and save.
Still stuck?
In your HitPay dashboard, check the webhook's delivery status on the Webhook Endpoints page — if HitPay shows failed deliveries, delete the webhook, create it again with the copied EasyBiz URL, and update the new Salt in EasyBiz. If payments still don't confirm, contact EasyBiz support with your order number and the approximate payment time.
What's Next?
Now that HitPay is connected, you can start accepting payments at the counter and on your Online Store. To make HitPay available as a payment method at your counter, see Setting Up Your Payment Methods at POS. To learn how customers pay through HitPay, see HitPay Overview.