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 PIX payment batches within a financial or payment processing workflow. Specifically, the Payment > PIX Batches resource with the Create operation allows users to create new PIX payment batches by sending a JSON request body describing the batch details.

Use cases include automating the creation of PIX payment batches for bulk payments, streamlining payment workflows, and integrating PIX batch creation into larger automation processes such as invoicing or payroll.

For example, a business could use this node to programmatically create a batch of PIX payments to multiple suppliers at once, reducing manual effort and ensuring consistent data submission to the payment system.

Properties

Name Meaning
Request Body The JSON object representing the details of the PIX batch to be created. This is required and must contain all necessary fields as per the Kobana API specification for creating PIX batches.
Additional Fields A collection allowing the user to add extra JSON fields to the request if needed. This can be used to include optional or advanced parameters supported by the API that are not explicitly exposed in the UI.

Output

The node outputs the JSON response returned by the Kobana API after creating the PIX batch. This typically includes details about the newly created batch such as its unique identifier, status, creation timestamp, and any other metadata provided by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Kobana API via an API key credential configured in n8n.
  • The node dynamically selects the API base URL depending on the environment (production or sandbox).
  • Proper permissions and valid API credentials are necessary to perform the create operation on PIX batches.

Troubleshooting

  • Invalid JSON in Request Body: If the JSON provided in the "Request Body" property is malformed, the node will throw a parsing error. Ensure the JSON syntax is correct before execution.
  • API Authentication Errors: If the API key credential is missing, invalid, or lacks permissions, the node will fail with authentication errors. Verify the credential configuration in n8n.
  • Missing Required Fields: The API may reject requests missing mandatory fields in the request body. Consult the Kobana API documentation to ensure all required data is included.
  • Network or Endpoint Issues: Connectivity problems or incorrect environment selection (sandbox vs production) can cause failures. Confirm network access and environment settings.

Links and References

Discussion