N8N Tools - Cash App icon

N8N Tools - Cash App

Accept payments and manage transactions through Cash App Pay with extensible Square API integration
Join our community

Actions38

Overview

The node integrates with the Cash App API via an extensible Square API integration, enabling users to manage various Cash App resources such as payments, customers, products, subscriptions, invoices, and more. Specifically for the Invoice resource with the List Invoices operation, this node retrieves a list of invoices from the Cash App system.

This operation is useful in scenarios where you want to automate invoice management workflows, such as syncing invoices to a CRM, generating reports, or triggering follow-up actions based on invoice data. For example, you could use it to fetch recent invoices matching a search query or paginate through large sets of invoices for processing.

Properties

Name Meaning
Limit Number of invoices to retrieve. Limits the maximum number of invoices returned per request. Default is 50.
Cursor Pagination cursor token to retrieve the next page of results. Used for paginated requests.
Query Search query string to filter invoices by criteria such as customer name or invoice details.

Output

The output JSON contains the following fields:

  • resource: The resource type, here "invoice".
  • operation: The operation performed, here "listInvoices".
  • success: Boolean indicating if the operation was successful.
  • creditsUsed: Number of API credits consumed by the request.
  • creditsRemaining: Number of API credits remaining after the request.
  • invoices: An array containing the retrieved invoice objects.
  • cursor (optional): A pagination cursor string to be used for fetching the next page of invoices if more results are available.

Each invoice object in the invoices array represents an individual invoice record as returned by the Cash App API.

The node does not output binary data for this operation.

Dependencies

  • Requires an API key credential for authenticating with the external Cash App API service.
  • The node uses an internal helper class to interact with the Cash App API endpoints.
  • Requires configuration of the API base URL and API key in the node credentials.
  • The node sends a validation request before executing the main operation to verify permissions and quota.

Troubleshooting

  • Common issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Exceeding API rate limits or credit quotas may result in errors or throttling.
    • Providing an invalid cursor value can cause pagination errors.
    • Malformed or unsupported query strings might return no results or errors.

  • Error messages:

    • "N8N Tools API validation failed" indicates that the initial API validation request did not succeed; check API key and permissions.
    • "Unknown invoice operation: listInvoices" would indicate a code or configuration mismatch but should not occur here since the operation is supported.
    • Errors related to HTTP requests or network issues should be checked by verifying connectivity and API endpoint availability.

  • Resolution tips:

    • Ensure the API key credential is correctly configured and has sufficient permissions.
    • Use valid pagination cursors returned from previous responses.
    • Validate the query syntax according to the Cash App API documentation.
    • Enable "Continue On Fail" in the node settings to handle partial failures gracefully.

Links and References

Discussion