How to connect Billplz to take FPX payments in Malaysia.
Billplz is the usual choice for a business in Malaysia. Customers pay on the Billplz page by FPX online banking, and the money goes to the bank account linked to your Billplz account, never through Timeo.
- Who it is for
- Owners and admins
- Plan
- Every plan (Basic, Advance and Team)
Connect Billplz
- Open Settings > Payments. The page is called Payment gateways.
- In the Providers list, find Billplz and tap Configure.
- Paste your API key. In Billplz it is under Settings, then API keys: copy the Secret Key.
- Paste your X-Signature key. In Billplz it is under Settings, then X Signature Key. Switch it on there first if it is off.
- Paste your Collection ID. In Billplz it is under Billing, then Collections. You can paste the ID or its full link.
- Leave Sandbox mode off for a live Billplz account. Only switch it on for test keys from billplz-sandbox.com, or Billplz will reject your live key.
- Tap Save credentials. Timeo checks the keys with Billplz straight away and shows the result.
- Check the Billplz row now shows Active · Live. If another gateway is active, tap Set as active on Billplz.
Pass the Billplz fee on to customers (optional)
Below the providers there is an Online payment fee card. Switch on Pass the Billplz fee on to customers, enter the Fee per payment (RM) and tap Save fee. The fee is added to online payments made through Billplz (packages, coupons and shop orders) and shown to the customer as a separate line. Counter sales, cash and your own DuitNow QR are never charged.
Card network rules do not allow surcharging card payments. If your customers can pick a card on the Billplz page, consider leaving this off.
What your customers see
- A Pay online option when they buy a plan, a package or a shop order, which opens the Billplz payment page.
- If you turned on the online payment fee, a separate fee line before they pay.
Common problems
- Billplz says my key is wrong after I save.
- The most common cause is Sandbox mode being on with a live key, or off with a sandbox key. Open Configure again, set Sandbox mode to match your Billplz account, paste the keys and tap Save credentials.
- Customers do not see Pay online.
- Check the Billplz row says Active. If it says Inactive, tap Set as active. The page header also tells you which gateway new charges route through.
- The row says Active but a payment failed.
- A key rotated or a collection closed inside Billplz still looks active in Timeo. Tap Test on the Billplz row to check the saved keys against Billplz now, then update them with Update if the test fails.
Related guides
- How to choose, test and switch your active payment gateway
- How to accept DuitNow QR transfers and check the receipt
- Payments and invoices
More in Payments and invoices, or start with the getting started guide. Still stuck? Contact us.