Kiwify

Consumir API Kiwify

Actions3

Overview

This node integrates with the Kiwify API to manage sales data. Specifically, the "Consultar Venda" (Consult Sale) operation allows users to retrieve detailed information about a specific sale by its ID. This is useful for scenarios where you need to fetch and process individual sales records, such as verifying order details, tracking sales status, or integrating sales data into other systems.

Practical examples include:

  • Fetching a sale's details after receiving a notification of a new purchase.
  • Automating customer support workflows by retrieving sale information based on a provided sale ID.
  • Synchronizing sales data with external CRMs or databases.

Properties

Name Meaning
ID da Venda The unique identifier of the sale to be retrieved. This must be provided to consult a specific sale.

Output

The node outputs a JSON object representing the sale details returned by the Kiwify API. This includes all available information about the sale identified by the given ID, such as buyer information, products purchased, payment status, dates, and other metadata.

If the node supports binary data output, it is not used in this operation.

Dependencies

  • Requires an API key credential for authenticating with the Kiwify API. This credential must provide an access token and an account ID.
  • The node makes HTTP requests to the Kiwify public API endpoints.
  • Proper configuration of the API credentials within n8n is necessary for successful execution.

Troubleshooting

  • Common issues:

    • Invalid or expired API tokens will cause authentication failures.
    • Providing an incorrect or non-existent sale ID will result in errors or empty responses.
    • Network connectivity problems can prevent the node from reaching the Kiwify API.

  • Error messages:

    • Errors returned from the API are passed through; typical messages might indicate unauthorized access or resource not found.
    • If the node throws an error related to missing credentials, ensure that the API key credential is properly set up and linked.

  • Resolutions:

    • Verify that the API credentials are valid and have not expired.
    • Double-check the sale ID input for correctness.
    • Ensure network access to the Kiwify API endpoint is available.

Links and References

Discussion