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?
- Click your name at the bottom of the sidebar, then click Settings.
- Under Integrations, click Payment.
- On the Payment Methods page, find CHIP and click Connect.
- In the CHIP Merchant Portal, open Developers, then Brands. Copy your Brand ID.
- Open Developers, then Keys. Copy your secret key.
- Paste your Brand ID into Brand ID in OneSuite.
- Paste your secret key into Secret key.
- Check the Currency.
- Click Save.

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:
- Open the invoice.
- Switch CHIP on in its Payments panel.
- 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 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.
Record the money that arrives: Log payments made outside a gateway with How to Record Invoice Payments.