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

This node integrates with the Cash App API to manage subscriptions and other related resources such as payments, customers, products, inventory, invoices, loyalty accounts, gift cards, and reports. Specifically for the Subscription resource with the List Subscriptions operation, it retrieves a list of subscriptions from the Cash App system.

Common scenarios where this node is beneficial include:

  • Retrieving active or past subscriptions for reporting or analysis.
  • Paginating through large sets of subscription data.
  • Filtering subscriptions based on search queries.

Practical example:

  • A business wants to fetch all subscriptions matching a customer name or keyword to display in their CRM or billing system.
  • Automating subscription management workflows by listing subscriptions and then performing updates or cancellations programmatically.

Properties

Name Meaning
Limit Number of subscriptions to retrieve (default 50).
Cursor Pagination cursor string to fetch the next page of results (used for paginated requests).
Query Search query string to filter subscriptions by keywords (e.g., customer name).

Output

The output JSON contains the following fields relevant to the List Subscriptions operation:

  • subscriptions: An array of subscription objects retrieved from the API.
  • cursor (optional): A pagination cursor string that can be used to fetch the next page of subscriptions if more results are available.
  • success: Boolean indicating whether the operation was successful.
  • creditsUsed and creditsRemaining: Numeric values indicating API usage credits consumed and remaining.
  • resource: The resource type, here "subscription".
  • operation: The operation performed, here "listSubscriptions".

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

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the external Cash App API service.
  • The node uses an internal helper class (CashAppApi) to perform HTTP requests to the Cash App API endpoints.
  • The node expects the API URL and API key to be provided via credentials configured in n8n.
  • The node sends a validation request before executing the main operation to ensure the API key and operation are valid.

Troubleshooting

  • API Validation Failure: If the initial validation request fails, the node throws an error indicating the API key or operation is invalid. Ensure the API key credential is correctly configured and has permissions for the requested operation.
  • Unknown Operation Error: If an unsupported operation is specified, the node throws an error mentioning the unknown operation. Verify the operation name matches one of the supported options.
  • Pagination Issues: When using the Cursor property, ensure the cursor value is obtained from a previous response's cursor field; otherwise, no further pages will be returned.
  • Empty Results: If the query filter returns no subscriptions, the subscriptions array will be empty. Adjust the query or limit parameters accordingly.
  • API Rate Limits: The node tracks API credit usage. If credits run out, requests may fail. Monitor and manage API usage limits.

Links and References

This summary focuses exclusively on the Subscription resource's List Subscriptions operation as requested.

Discussion