---
title: How to Connect HitPay to OneSuite
description: "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…"
url: "https://help.onesuite.io/docs/how-to-connect-hitpay-to-onesuite/"
updated: "2026-11-16"
category: Payment Integration
---

# How to Connect HitPay to OneSuite

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?

1. Click your name at the bottom of the sidebar, then click **Settings**.
2. Under **Integrations**, click **Payment**.
3. On the **Payment Methods** page, find **HitPay** and click **Connect**.
4. In the HitPay Dashboard, open **Settings**, then **Payment Gateway**, then **API Keys**.
5. Copy the API key.
6. Paste it into **API key** in OneSuite.
7. Copy the salt.
8. Paste it into **Salt** in OneSuite.
9. Check the **Currency**.
10. Click **Save**.

![](https://help.onesuite.io/wp-content/uploads/2026/11/open-payment-settings-in-onesuite-1-925x1024.png)

## 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:

1. Open the invoice.
2. Switch HitPay on in its **Payments** panel.
3. 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](https://docs.hitpayapp.com/apis/guide/online-payments).

## 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](https://help.onesuite.io/docs-category/payment-integration/).

**Record the money that arrives:** Log payments made outside a gateway with [How to Record Invoice Payments](https://help.onesuite.io/docs/how-to-record-invoice-payments/).
