---
title: How to Connect Billplz to OneSuite
description: "To connect Billplz, go to **Settings** > **Integrations** > **Payment** and click **Connect** on the Billplz card. Paste your **API Secret Key**, **Collection ID** and **X Signature Key**, and click **Save**. Billplz takes payments in Malaysian Ringgit (MYR) only. **In this guide you'll learn how to:** - Find your Billplz API secret key,…"
url: "https://help.onesuite.io/docs/how-to-connect-billplz-to-onesuite/"
updated: "2026-11-16"
category: Payment Integration
---

# How to Connect Billplz to OneSuite

To connect Billplz, go to **Settings** > **Integrations** > **Payment** and click **Connect** on the Billplz card. Paste your **API Secret Key**, **Collection ID** and **X Signature Key**, and click **Save**. Billplz takes payments in Malaysian Ringgit (MYR) only.

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

- Find your Billplz API secret key, collection ID and X Signature key
- Keep X Signature Payment enabled so payments are recorded
- Connect Billplz to OneSuite
- Switch Billplz on for an invoice

## Before you start

- You need access to **Settings**. If you can't see **Integrations**, ask an admin.
- You need a Billplz account and access to the Billplz dashboard.
- Keep X Signature Payment enabled in Billplz under Settings, Keys & Integration. If it is off, payments cannot be recorded.
- Accounts opened since September 2018 have X Signature Payment on by default.
- Your API secret key is a private code from Billplz. It lets OneSuite work with your Billplz account.
- Your X Signature key is a secret code. It shows that a payment message really came from Billplz.
- Billplz's guides say sandbox and production have separate keys, accounts and collection IDs. Sandbox is for testing. Production is for real payments.
- Take every value from the same one, sandbox or production.

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

| Field | Where to find it | Required |
| --- | --- | --- |
| **API Secret Key** | In the Billplz dashboard, open **Settings**, then **Keys & Integration**. Copy the API Secret Key. | Yes |
| **Collection ID** | In the Billplz dashboard, open **Collections**. Open the collection your invoices should be paid into and copy its ID. | Yes |
| **X Signature Key** | In the Billplz dashboard, open **Settings**, then **Keys & Integration**. Copy the X Signature Key. X Signature Payment must be enabled. | Yes |
| **Currency** | The list starts as **Malaysian Ringgit (MYR)**. Billplz takes this currency only. | No |

## How do I connect Billplz 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 **Billplz** and click **Connect**.
4. In the Billplz dashboard, open **Settings**, then **Keys & Integration**.
5. Copy the API Secret Key into **API Secret Key** in OneSuite.
6. On the same Billplz page, check that X Signature Payment is enabled.
7. Copy the X Signature Key into **X Signature Key** in OneSuite.
8. In Billplz, open **Collections**.
9. Open the collection your invoices should be paid into.
10. Copy its ID into **Collection ID** in OneSuite.
11. 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 Billplz card on the **Payment Methods** page now says **Connected** instead of **Not connected**. You also see Billplz 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 Billplz on an older invoice:

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

## If something goes wrong

**Payments are not recorded.** In Billplz, open **Settings**, then **Keys & Integration**. Check that X Signature Payment is enabled. Billplz's guide to [enabling X Signature](https://support.billplz.com/guide/enable-x-signature-key) shows the checkbox.

## FAQs

### Which currency does Billplz use in OneSuite?

Only Malaysian Ringgit (MYR). Billplz does not take other currencies.

### What is the Billplz Collection ID?

It is the ID of the collection that your invoices are paid into. In the Billplz dashboard, open **Collections**, open that collection, and copy its ID. Billplz's guide to [creating a collection ID](https://support.billplz.com/guide/create-a-collection-id) shows where to find it.

### Why are my Billplz payments not recorded?

Payments cannot be recorded when X Signature Payment is off in Billplz. Turn it on under **Settings** > **Keys & Integration**.

## 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/).
