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?
- Click your name at the bottom of the sidebar, then click Settings.
- Under Integrations, click Payment.
- On the Payment Methods page, find Billplz and click Connect.
- In the Billplz dashboard, open Settings, then Keys & Integration.
- Copy the API Secret Key into API Secret Key in OneSuite.
- On the same Billplz page, check that X Signature Payment is enabled.
- Copy the X Signature Key into X Signature Key in OneSuite.
- In Billplz, open Collections.
- Open the collection your invoices should be paid into.
- Copy its ID into Collection ID in OneSuite.
- Click Save.

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