KobanaInstall

Overview

This node integrates with the Kobana API to manage PIX payments under the "Payment > PIX" resource, specifically supporting the "Create" operation. It allows users to create a new PIX payment by sending a JSON-formatted request body to the Kobana API.

Common scenarios where this node is beneficial include automating the creation of PIX payments in financial workflows, integrating payment processing into business applications, or triggering PIX payments based on events in an n8n workflow.

For example, a user can configure this node to create a PIX payment by providing the necessary payment details in JSON format, enabling seamless payment initiation without manual intervention.

Properties

Output

The node outputs the JSON response returned by the Kobana API after creating the PIX payment. This typically includes details about the newly created PIX payment such as its ID, status, amount, timestamps, and any other metadata provided by the API.

If the API returns binary data (not typical for this operation), it would be included accordingly, but for PIX payment creation, the output is expected to be purely JSON.

Dependencies

• Requires an active Kobana API credential configured in n8n with appropriate permissions to create PIX payments.
• The node dynamically selects the API base URL depending on the environment (production or sandbox).
• No other external dependencies are needed beyond the Kobana API access.

Troubleshooting

• Invalid JSON in Request Body: If the JSON provided in the "Request Body" or "Additional Fields" is malformed, the node will throw a parsing error. Ensure that the JSON syntax is correct.
• API Authentication Errors: If the API key or credentials are invalid or missing, the node will fail authentication. Verify that the Kobana API credential is correctly set up 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 fields are included.
• Network or API Endpoint Issues: If the node cannot reach the Kobana API endpoint, check network connectivity and whether the environment setting (sandbox vs production) matches your intended usage.
• Error Responses from API: The node passes through error messages from the Kobana API. Review these messages to understand issues like invalid parameters or permission problems.

Links and References

• Kobana API Documentation (official API docs for detailed request/response schemas)
• PIX Payment Information (Central Bank of Brazil's PIX system overview)

This summary focuses exclusively on the "Payment > PIX" resource and the "Create" operation as requested.