AsaasInstall

Overview

This node integrates with the Asaas API to manage payments and billing operations. Specifically, for the Cobrança (Payment) resource and the Excluir (Delete) operation, it allows users to delete a specific payment by its unique ID.

Common scenarios where this node is beneficial include:

• Automating the cancellation or removal of erroneous or obsolete payment records.
• Managing payment lifecycle within workflows that require cleanup or reversal of charges.
• Integrating payment deletion as part of broader business processes such as subscription cancellations or customer account management.

Practical example:

• A workflow that automatically deletes a payment record when a refund is issued or when a payment is marked as invalid in an external system.

Properties

Output

The output of the node after deleting a payment is the JSON response from the Asaas API related to the deletion request. Typically, this will confirm the deletion or provide details about the deleted payment.

• The json output field contains the API response object.
• No binary data output is produced by this operation.

Dependencies

• Requires an active connection to the Asaas API via an API key credential.
• The node uses the Asaas API base URL, which switches between sandbox and production environments based on the credential configuration.
• The user must configure the API key credential with appropriate permissions to delete payments.

Troubleshooting

• Common issues:

  • Invalid or missing payment ID: The node requires a valid payment ID; otherwise, the API will reject the request.
  • Authentication errors: If the API key is incorrect or lacks permission, the deletion will fail.
  • Network or connectivity problems may cause timeouts or failed requests.

• Error messages:

  • "O campo Cliente é obrigatório e deve conter um ID válido" — This error appears if a required customer ID is missing in other operations but is not expected here for deletion.
  • API errors related to "not found" or "unauthorized" indicate either the payment does not exist or credentials are invalid.
  • "Este pacote foi removido do npm e não está mais disponível..." — Indicates the node package is deprecated or removed; update or remove the node accordingly.

• Resolution tips:

  • Verify the payment ID is correct and exists in the Asaas system.
  • Check API key validity and permissions.
  • Ensure network connectivity to the Asaas API endpoints.
  • Update the node package if deprecated.

Links and References

• Asaas API Documentation (official API docs for payments)
• n8n Documentation (for general node usage and credential setup)