Bizappay icon

Bizappay

Interact with Bizappay API

Actions13

Overview

This node integrates with the Bizappay API to manage billing operations. Specifically, the "Create From Template" operation under the Bill resource allows users to create a new bill using predefined templates such as invoice, subscription, service fee, product sale, or event ticket. This is useful for automating bill generation with consistent formatting and fields, reducing manual entry and errors.

Common scenarios include:

  • Automatically generating invoices for customers based on standard templates.
  • Creating subscription bills monthly with preset terms.
  • Issuing professional service fees or product sales bills quickly.
  • Generating event tickets or registration bills with relevant details.

For example, a business can select the "Invoice Template," provide customer name, email, amount, due date, and other variables, and the node will generate a fully formatted bill ready for sending or further processing.

Properties

Name Meaning
Template Select one of the predefined bill templates: Invoice, Subscription, Service Fee, Product Sale, Event Ticket.
Template Variables Variables to customize the selected template, including:
- Customer Name
- Customer Email
- Customer Phone
- Amount (bill total)
- Due Date (payment deadline)
- Reference Number (external reference)
- Custom Description (additional text appended to the template)

Output

The output JSON contains the response from the Bizappay API after creating the bill. It includes all standard bill data returned by the API, such as bill ID, URLs, status, and other metadata.

Additionally, the node appends a _templateInfo object containing:

  • templateUsed: The template selected for bill creation.
  • variables: The set of template variables used.
  • generatedAt: Timestamp when the bill was generated.

This helps track which template and data were used for each created bill.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Bizappay API via an API key credential configured in n8n.
  • The node uses internal helper functions to send authenticated POST requests to Bizappay endpoints.
  • No additional external dependencies beyond the Bizappay API and n8n environment are needed.

Troubleshooting

  • Missing Required Fields: Ensure all required template variables (e.g., amount, customer email) are provided; otherwise, the API may reject the request.
  • Invalid Data Formats: Dates must be valid ISO datetime strings; emails should be properly formatted.
  • API Errors: Network issues or invalid credentials will cause API request failures. Verify API key validity and network connectivity.
  • Template Not Found: Selecting an unsupported template value will cause errors; use only the listed options.
  • Serialization Issues: If the API response contains non-serializable data, the node will catch and report serialization errors.

If errors occur, check the error message returned by the node for guidance. Common fixes involve correcting input data formats or re-authenticating the API credentials.

Links and References

Discussion