Connect HitPay so your clients can pay invoices online through HitPay. Go to Settings > Integrations > Payment and click Connect on the HitPay card. Paste your HitPay API key and Salt, choose a Currency, and click Save.
In this guide you’ll learn how to:
- Find your HitPay API key and salt
- Connect HitPay to OneSuite
- Choose the currency HitPay uses
- Switch HitPay on for an invoice
Before you start
- You need a HitPay account and access to its Dashboard.
- You need access to Settings. If you can’t see Integrations, ask an admin.
- Your API key and salt are two codes from HitPay. They let OneSuite work with your HitPay account.
- HitPay has separate sandbox and production API keys and salts. Sandbox is a test mode. Production takes real payments.
- Take both values from the same environment.
What does OneSuite ask for when you connect HitPay?
| Field | Where to find it | Required |
|---|---|---|
| API key | In the HitPay Dashboard, open Settings, then Payment Gateway, then API Keys. | Yes |
| Salt | HitPay shows it next to the API key in its dashboard. | Yes |
| Currency | Starts as Singapore Dollar (SGD). OneSuite uses it when an invoice has no currency of its own. | No |
How do I connect HitPay to OneSuite?
- Click your name at the bottom of the sidebar, then click Settings.
- Under Integrations, click Payment.
- On the Payment Methods page, find HitPay and click Connect.
- In the HitPay Dashboard, open Settings, then Payment Gateway, then API Keys.
- Copy the API key.
- Paste it into API key in OneSuite.
- Copy the salt.
- Paste it into Salt in OneSuite.
- Check the Currency.
- Click Save.

How do I check it worked?
The HitPay card on the Payment Methods page now says Connected instead of Not connected. You also see HitPay marked Connected under Invoices > Configure > Getting paid > Online payments.
OneSuite switches a connected gateway on for every new invoice. An invoice you created earlier keeps its own choice. To use HitPay on an older invoice:
- Open the invoice.
- Switch HitPay on in its Payments panel.
- Save the invoice and send it again.
If something goes wrong
Can’t find the API key or salt under Payment Gateway? Follow HitPay’s online payments guide.
FAQs
What is the HitPay salt?
It is the second code that HitPay shows next to your API key. OneSuite asks for both.
Does HitPay need a webhook in OneSuite?
No. A webhook is how a gateway tells OneSuite about a payment. The HitPay dialog shows no webhook URL, so you have nothing to add in HitPay.
Which currency does HitPay use in OneSuite?
The Currency list starts as Singapore Dollar (SGD). OneSuite applies it to any invoice that has none of its own.
What to do next
See every gateway: Browse all the guides in Payment Integration.
Record the money that arrives: Log payments made outside a gateway with How to Record Invoice Payments.