billplz

Package Information

Released: 7/5/2025
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.2
Author: nmhafiz

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.

  1. Go to Settings > Community Nodes.
  2. Select Install.
  3. Enter @nmhafiz/n8n-nodes-billplz in Enter npm package name.
  4. Agree to the risks of using community nodes: select I understand the risks of installing unverified code from a public source.
  5. 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:

  1. Environment: Choose between production or sandbox
  2. API Secret Key: Your Billplz API Secret Key
  3. X-Signature Key (Optional): For webhook signature verification

Getting Your API Keys

  1. Sandbox: Sign up at Billplz Sandbox
  2. Production: Sign up at Billplz
  3. 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

  1. Add the Billplz node to your workflow
  2. Select Bill as the resource
  3. Select Create as the operation
  4. Fill in the required fields:
    • Collection ID
    • Customer Email
    • Customer Name
    • Amount (in cents)
    • Callback URL
    • Description

Getting Collections

  1. Add the Billplz node to your workflow
  2. Select Collection as the resource
  3. Select Get Many as the operation
  4. Configure pagination options if needed

Resources

License

MIT

Discussion