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 charge accounts under the "Charge > PIX Accounts" resource. Specifically, the Create operation allows users to create new PIX charge accounts by sending a JSON-formatted request body to the Kobana API.

Use cases include automating the creation of PIX accounts for receiving payments via the PIX system in Brazil, which is widely used for instant payments. This node is beneficial for financial teams or applications that need to programmatically manage PIX accounts without manual intervention.

Example scenarios:

  • Automatically creating a new PIX account when onboarding a new client.
  • Integrating PIX account creation into a larger payment processing workflow.
  • Managing multiple PIX accounts dynamically based on business rules.

Properties

Name Meaning
Request Body The JSON object representing the details of the PIX account to be created. This must contain all required fields as per the Kobana API specification for creating PIX accounts.
Additional Fields A JSON object allowing inclusion of extra optional fields in the request. Useful for passing any additional parameters supported by the API beyond the main request body.

Output

The node outputs the JSON response returned by the Kobana API after creating the PIX account. This typically includes details about the newly created PIX account such as its ID, status, and configuration data.

The output is structured as an array of JSON objects, each corresponding to an input item processed. Each object contains the full API response under the json property.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Kobana API credential configured in n8n with appropriate permissions to create PIX accounts.
  • The node dynamically selects the API base URL depending on the environment (production or sandbox).
  • Network connectivity to the Kobana API endpoints is necessary.

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 valid JSON syntax.
  • API Authentication Errors: Missing or incorrect API credentials will cause authentication failures. Verify that the Kobana API credential is correctly set up.
  • Missing Required Fields: The API may reject requests missing mandatory fields. Consult the Kobana API documentation to ensure all required data is included.
  • Network Issues: Timeouts or connection errors can occur if the Kobana API is unreachable. Check network settings and API availability.
  • API Error Responses: The node returns API error messages in the output JSON under an error key if the request fails. Review these messages for troubleshooting.

Links and References

Discussion