Billplz icon

Billplz

Interact with Billplz payment gateway API
Join our community

Actions7

Overview

This node integrates with the Billplz payment gateway API, allowing users to manage collections, bills, and banking information programmatically within n8n workflows. Specifically, for the Collection - Create operation, it enables creating a new collection by specifying its title. This is useful in scenarios where you want to organize multiple bills or payments under a named group (collection) for easier management and reporting.

Practical examples include:

  • Creating a new collection for a specific campaign or event to group related payment bills.
  • Automating the setup of collections when onboarding new clients or projects.
  • Structuring payment requests dynamically based on workflow data.

Properties

Name Meaning
Title The title of the collection to create. This is a required string input that names the new collection.

Output

The node outputs JSON data representing the newly created collection object as returned by the Billplz API. This typically includes details such as the collection ID, title, creation timestamp, and other metadata provided by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Billplz API via an API key credential configured in n8n.
  • The node uses the Billplz REST API endpoint https://www.billplz.com/api.
  • No additional external dependencies beyond the Billplz API and n8n's HTTP request capabilities.

Troubleshooting

  • Common issues:

    • Missing or invalid API credentials will cause authentication failures.
    • Providing an empty or missing "Title" property will result in validation errors from the API.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • "Unknown collection operation: create" — indicates a misconfiguration of the operation parameter; ensure "Create" is selected.
    • API error messages related to authorization or validation will be passed through; check your API key and input values.

  • Resolution tips:

    • Verify that the API key credential is correctly set up and has necessary permissions.
    • Ensure the "Title" field is not empty and meets any length or character requirements imposed by Billplz.
    • Check network access and proxy settings if requests fail to reach the API.

Links and References

Discussion