Package Information
Available Nodes
Documentation
@nmhafiz/n8n-nodes-billplz
This is an n8n community node that lets you use Billplz payment gateway in your n8n workflows.
Billplz is a Malaysian payment gateway that allows businesses to accept online payments from customers.
n8n is a fair-code licensed workflow automation platform.
Installation
Operations
Credentials
Compatibility
Usage
Resources
Installation
Community Nodes (Recommended)
For users on n8n v0.187+, your instance owner can install this node from Community Nodes.
- Go to Settings > Community Nodes.
- Select Install.
- Enter
@nmhafiz/n8n-nodes-billplz
in Enter npm package name. - Agree to the risks of using community nodes: select I understand the risks of installing unverified code from a public source.
- Select Install.
After installing the node, you can use it like any other node. n8n loads it automatically.
Manual Installation
To get started install the package in your n8n root directory:
npm install @nmhafiz/n8n-nodes-billplz
For Docker-based deployments, add the following line before the font installation command in your n8n Dockerfile:
RUN cd /usr/local/lib/node_modules/n8n && npm install @nmhafiz/n8n-nodes-billplz
Operations
Collection
- Create: Create a new collection
- Get: Retrieve a specific collection
- Get Many: List all collections
Bill
- Create: Create a new bill
- Get: Retrieve a specific bill
- Delete: Delete a bill
Transaction
- Get Many: Get transactions for a specific bill
Banking
- Get FPX Banks: Get list of available FPX banks
Credentials
To use this node, you need to set up Billplz API credentials:
- Environment: Choose between
production
orsandbox
- API Secret Key: Your Billplz API Secret Key
- X-Signature Key (Optional): For webhook signature verification
Getting Your API Keys
- Sandbox: Sign up at Billplz Sandbox
- Production: Sign up at Billplz
- Navigate to your account settings to find your API Secret Key
Compatibility
This node has been tested with n8n version 0.187+ and requires Node.js 16+.
Usage
Creating a Bill
- Add the Billplz node to your workflow
- Select Bill as the resource
- Select Create as the operation
- Fill in the required fields:
- Collection ID
- Customer Email
- Customer Name
- Amount (in cents)
- Callback URL
- Description
Getting Collections
- Add the Billplz node to your workflow
- Select Collection as the resource
- Select Get Many as the operation
- Configure pagination options if needed