Actions215
- V1 > Bank Billets Actions
- V1 > Bank Billet Accounts Actions
- V1 > Bank Billet Batches Actions
- V1 > Bank Billet Batch Exports Actions
- V1 > Bank Billet Discharges Actions
- V1 > Bank Billet Payments Actions
- V1 > Bank Billet Registrations Actions
- V1 > Bank Billet Remittances Actions
- V1 > Customers Actions
- V1 > Customer Subscriptions Actions
- V1 > Discharges Actions
- V1 > Email Deliveries Actions
- V1 > Events Actions
- V1 > Imports Actions
- V1 > Installments Actions
- V1 > Remittances Actions
- V1 > Reports Actions
- V1 > SMS Deliveries Actions
- V1 > User Info Actions
- V1 > Webhook Deliveries Actions
- V1 > Webhooks Actions
- Admin > Users Actions
- Admin > Connections Actions
- Admin > Certificates Actions
- Admin > Subaccounts Actions
- Charge > PIX Actions
- Charge > PIX Accounts Actions
- Data > Bank Billet Queries Actions
- EDI > EDI Boxes Actions
- Financial > Accounts Actions
- Financial > Balances Actions
- Financial > Commands Actions
- Financial > Statement Transactions Actions
- Financial > Transaction Imports Actions
- Financial > Providers Actions
- Payment > Bank Billets Actions
- Payment > Bank Billet Batches Actions
- Payment > Batches Actions
- Payment > DARFs Actions
- Payment > DARF Batches Actions
- Payment > PIX Actions
- Payment > PIX Batches Actions
- Payment > Utilities Actions
- Payment > Utility Batches Actions
- Transfer > Batches Actions
- Transfer > Internal Actions
- Transfer > Internal Batches Actions
- Transfer > PIX Actions
- Transfer > PIX Batches Actions
- Transfer > TED Actions
- Transfer > TED Batches Actions
Overview
This node integrates with the Kobana API to manage utility payment batches within a payment system. Specifically, the Payment > Utility Batches resource with the Create operation allows users to create new batches of utility payments programmatically.
Typical use cases include:
- Automating the creation of grouped utility bill payments for customers.
- Streamlining batch processing of multiple utility payments in financial workflows.
- Integrating utility payment batch creation into larger automation pipelines for billing or accounting.
For example, a company could use this node to automatically generate a batch of utility payments every month by providing the necessary payment details in JSON format, reducing manual effort and errors.
Properties
| Name | Meaning |
|---|---|
| Additional Fields | A JSON object containing any extra fields to include in the request beyond the required body. This allows customization of the API call with optional parameters. |
| Request Body | The main JSON payload representing the utility batch details to be created. This is required and must contain all necessary data as per the Kobana API specification for creating utility payment batches. |
Output
The node outputs the JSON response returned by the Kobana API after creating the utility payment batch. This typically includes details about the newly created batch such as its ID, status, included payments, timestamps, and other metadata.
No binary data output is indicated for this operation.
Dependencies
- Requires an active Kobana API credential configured in n8n with appropriate permissions.
- The node dynamically selects the API base URL depending on whether the environment is production or sandbox.
- The node uses HTTP requests authenticated via the provided Kobana API credentials.
Troubleshooting
- Invalid JSON in Request Body or Additional Fields: Since the node expects JSON strings for these inputs, malformed JSON will cause parsing errors. Ensure that the JSON syntax is correct before running the node.
- Authentication Errors: If the Kobana API credentials are missing, invalid, or lack required permissions, the node will fail to authenticate. Verify the API key/token and its access rights.
- API Endpoint or Parameter Errors: Providing incorrect or incomplete data in the request body may result in API errors. Consult the Kobana API documentation for required fields and valid values.
- Network Issues: Connectivity problems to the Kobana API endpoints (production or sandbox) can cause timeouts or failures. Check network settings and endpoint availability.
Links and References
- Kobana API Documentation (general reference for API endpoints and payload structures)
- n8n Documentation on Creating Custom Nodes
- JSON validation tools (e.g., https://jsonlint.com/) to verify input JSON correctness
