N8N Tools - Cash AppInstall

Overview

This node integrates with the Cash App API to manage various resources such as payments, customers, products, subscriptions, invoices, and more. Specifically, for the Delete Invoice operation, it allows users to delete an existing invoice by providing its unique identifier.

Common scenarios where this node is beneficial include automating financial workflows, managing invoices programmatically, and integrating Cash App payment and invoicing features into broader automation pipelines. For example, a business could automatically delete outdated or canceled invoices from their system without manual intervention.

Practical example:

• Automatically remove an invoice after a refund has been processed or when an invoice is no longer valid, ensuring the invoice records stay clean and up-to-date.

Properties

Output

The output JSON contains information about the result of the delete operation under the invoice field. It includes the response returned by the Cash App API after attempting to delete the specified invoice. Additionally, the output includes metadata fields:

• resource: The resource type, here "invoice".
• operation: The operation performed, here "deleteInvoice".
• success: Boolean indicating if the operation was successful.
• creditsUsed: Number of API credits consumed by the operation.
• creditsRemaining: Remaining API credits after the operation.

If the operation fails and "Continue On Fail" is enabled, the output will contain an error message and success set to false.

No binary data output is produced by this operation.

Example output snippet:

{
  "json": {
    "resource": "invoice",
    "operation": "deleteInvoice",
    "success": true,
    "creditsUsed": 1,
    "creditsRemaining": 99,
    "invoice": {
      // API response details about the deleted invoice
    }
  }
}

Dependencies

• Requires an API key credential for authenticating with the external Cash App API service.
• The node uses an HTTP POST request to validate the requested resource and operation before executing.
• The node depends on the bundled CashAppApi class that handles API calls to Cash App endpoints.
• Proper configuration of the API URL and API key in the credentials is necessary.
• No additional environment variables are explicitly required beyond the API credentials.

Troubleshooting

• Common issues:

  • Invalid or missing Invoice ID: The operation requires a valid invoice identifier; ensure the ID is correct and exists.
  • API authentication failure: Verify that the API key credential is correctly configured and has sufficient permissions.
  • Network or connectivity problems: Ensure the n8n instance can reach the Cash App API endpoint.
  • Exceeding API rate limits or credit usage: Monitor the creditsRemaining field and adjust usage accordingly.

• Error messages:

  • "N8N Tools API validation failed": Indicates the initial validation of resource and operation failed, possibly due to misconfiguration or unsupported operation.
  • "Cash App operation failed: <message>": General failure during the API call; check the detailed message for specifics.
  • "Unknown invoice operation: deleteInvoice": Should not occur if using the provided operation name; indicates a possible code mismatch or typo.

• Resolution tips:

  • Double-check input parameters, especially the Invoice ID.
  • Confirm API credentials are valid and active.
  • Enable "Continue On Fail" to handle errors gracefully in workflows.
  • Review API documentation for any changes or deprecations.

Links and References

• Cash App Developer Documentation (for general API reference)
• Square API Documentation (since Cash App Pay integrates with Square APIs)
• n8n Documentation on Creating Custom Nodes