---
title: How to Connect CHIP to OneSuite
description: "Connect CHIP so your clients can pay invoices online through it. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the CHIP card. Paste your CHIP **Brand ID** and **Secret key**, choose a **Currency**, and click **Save**. **In this guide you'll learn how to:** - Find your CHIP Brand ID and…"
url: "https://help.onesuite.io/docs/how-to-connect-chip-to-onesuite/"
updated: "2026-11-16"
category: Payment Integration
---

# How to Connect CHIP to OneSuite

Connect CHIP so your clients can pay invoices online through it. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the CHIP card. Paste your CHIP **Brand ID** and **Secret key**, choose a **Currency**, and click **Save**.

**In this guide you'll learn how to:**

- Find your CHIP Brand ID and secret key
- Connect CHIP to OneSuite
- Choose the currency CHIP uses
- Switch CHIP on for an invoice

## Before you start

- You need a CHIP merchant account and access to the CHIP Merchant Portal.
- You need access to **Settings**. If you can't see **Integrations**, ask an admin.
- Your secret key is a private code from CHIP. It lets OneSuite work with your CHIP account. Keep it private.
- CHIP's portal gives you separate test keys and live keys. Test keys are for practice and never move real money. Use live keys to take real payments.

## What does OneSuite ask for when you connect CHIP?

| Field | Where to find it | Required |
| --- | --- | --- |
| **Brand ID** | In the CHIP Merchant Portal, open **Developers**, then **Brands**. | Yes |
| **Secret key** | In the CHIP Merchant Portal, open **Developers**, then **Keys**. | Yes |
| **Currency** | Starts as **Malaysian Ringgit (MYR)**. OneSuite uses it when an invoice has no currency of its own. | No |

## How do I connect CHIP 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 **CHIP** and click **Connect**.
4. In the CHIP Merchant Portal, open **Developers**, then **Brands**. Copy your Brand ID.
5. Open **Developers**, then **Keys**. Copy your secret key.
6. Paste your Brand ID into **Brand ID** in OneSuite.
7. Paste your secret key into **Secret key**.
8. Check the **Currency**.
9. Click **Save**.

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

## How do I check if it worked?

The CHIP card on the **Payment Methods** page now says **Connected** instead of **Not connected**. You also see CHIP 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 CHIP on an older invoice:

1. Open the invoice.
2. Switch CHIP on in its **Payments** panel.
3. Save the invoice and send it again.

## FAQs

### Where do I find my CHIP Brand ID?

In the CHIP Merchant Portal, open **Developers**, then **Brands**. CHIP's [authentication guide](https://docs.chip-in.asia/chip-collect/overview/authentication) explains where your keys and Brand ID come from.

### Does CHIP need a webhook in OneSuite?

No. A webhook is a web address your payment provider uses to tell OneSuite that a client has paid. The CHIP dialog shows no webhook URL, so you have nothing to add in CHIP.

### Which currency does CHIP use in OneSuite?

The **Currency** list starts as Malaysian Ringgit (MYR). OneSuite uses this currency for 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/).
