Kobana icon

Kobana

Interact with Kobana API - Quick access to common operations
Join our community

Actions215

Overview

This node integrates with the Kobana API to manage financial installments and related resources. Specifically, for the V1 > Installments resource with the Create operation, it allows users to create new installment records by sending a JSON request body to the Kobana API.

Typical use cases include automating the creation of payment installments in billing or subscription workflows, such as splitting a customer's total charge into multiple payments or scheduling recurring installment payments.

For example, you might use this node to:

  • Create an installment plan for a customer after a sale.
  • Automate installment creation when processing subscriptions.
  • Integrate installment management into your financial system workflows.

Properties

Name Meaning
Request Body The JSON object representing the data for the new installment to be created. This must contain all required fields as per the Kobana API specification for creating installments.
Additional Fields A JSON object allowing you to specify extra optional fields for the request. Useful for including any additional parameters supported by the API that are not explicitly exposed as separate properties.

Output

The node outputs the JSON response returned by the Kobana API after creating the installment. This typically includes details about the newly created installment such as its ID, status, amounts, due dates, and other metadata.

The output is structured as an array of JSON objects, each corresponding to an input item processed. Each object contains the full API response for that particular create request.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Kobana API credential configured in n8n, which provides authentication tokens necessary to access the Kobana API.
  • The node dynamically selects the API base URL depending on whether the environment is production or sandbox.
  • Network connectivity to https://api.kobana.com.br (production) or https://api-sandbox.kobana.com.br (sandbox) is required.

Troubleshooting

  • Invalid JSON in Request Body or Additional Fields: If the JSON provided in the "Request Body" or "Additional Fields" is malformed, the node will throw a parsing error. Ensure valid JSON syntax.
  • Authentication Errors: If the API credentials are missing, invalid, or expired, the node will fail with authentication errors. Verify that the Kobana API credential is correctly set up and has proper permissions.
  • API Validation Errors: The Kobana API may reject requests if required fields are missing or values are invalid. Review the API documentation for required fields and correct data formats.
  • Network Issues: Connectivity problems to the Kobana API endpoints will cause request failures. Check network settings and firewall rules.
  • Continue On Fail Behavior: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output JSON.

Links and References

Discussion