Billwerk

Automate your subscription business with billwerk

Actions27

Accounting Export Actions
- Get Download Link
Contract Actions
Customer Actions
Invoice Actions
Metered Usage Actions
Order Actions
Payment Actions
Report Actions
- Get Download Link

Overview

The Billwerk node for n8n automates payment creation in the Billwerk subscription management platform. Specifically, when using the Payment resource with the Create operation, this node allows you to record a new payment, refund, or chargeback associated with a contract. This is useful for integrating payment events from external systems (such as e-commerce platforms, accounting software, or custom payment gateways) into your Billwerk account, ensuring that all financial transactions are accurately tracked and reconciled.

Practical examples:

Automatically log successful payments received via Stripe or PayPal into Billwerk.
Record refunds or chargebacks processed externally.
Sync payment data from your ERP or CRM system to Billwerk.

Properties

Name	Type	Meaning
Contract ID	String	The unique identifier of the contract to which the payment should be linked.
Amount	Number	The amount of the payment. Positive for received payments; negative for refunds/chargebacks.
Currency	String	The currency code in ISO format (e.g., EUR, CHF, GBP).
Description	String	A description or note about the payment.
Booking Date	DateTime	The date and time when the payment was booked.

Output

The node outputs a JSON object representing the created payment. While the exact structure depends on the Billwerk API response, typical fields may include:

{
  "id": "string",                  // Unique payment identifier
  "contractId": "string",          // Associated contract ID
  "amount": number,                // Payment amount
  "currency": "string",            // Currency code
  "description": "string",         // Payment description
  "bookingDate": "string",         // Booking date/time (ISO format)
  // ...other Billwerk-specific fields
}

If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Dependencies

External Service: Requires access to the Billwerk API.
API Credentials: You must configure the billwerkApi credential in n8n with valid API keys or authentication details for your Billwerk account.

Troubleshooting

Common Issues:

Missing or Invalid Contract ID: Ensure the provided Contract ID exists in Billwerk.
Invalid Amount or Currency: The amount must be a valid number, and the currency must be a supported ISO code.
Authentication Errors: If credentials are missing or incorrect, the node will fail to connect to Billwerk.
Date Format Issues: The booking date must be in a valid datetime format.

Error Messages:

"error": "Request failed with status code 401" – Check your API credentials.
"error": "Contract not found" – Verify the Contract ID.
"error": "Invalid currency" – Use a valid ISO currency code (e.g., EUR).
"error": "Amount must be a number" – Ensure the amount property is numeric.