N8N Tools - Cash App
Accept payments and manage transactions through Cash App Pay with extensible Square API integration
Actions38
- Payment Actions
- Customer Actions
- Product Actions
- Inventory Actions
- Subscription Actions
- Invoice Actions
- Loyalty Actions
- Gift Card Actions
- Report Actions
Overview
The node integrates with Cash App Pay via an extensible Square API, enabling users to manage payments and transactions programmatically within n8n workflows. Specifically, the List Transactions operation under the Payment resource retrieves recent transaction history from a Cash App account.
This operation is useful for scenarios such as:
- Monitoring recent payment activity.
- Synchronizing transaction data with other systems.
- Generating reports or triggering actions based on new transactions.
For example, a business could use this node to automatically fetch the latest 50 transactions every hour and update their accounting software accordingly.
Properties
| Name | Meaning |
|---|---|
| Limit | Number of transactions to retrieve. |
| Cursor | Pagination cursor for fetching the next page of results (used for paginated responses). |
Output
The output JSON contains the following fields:
resource: The resource type, here"payment".operation: The operation performed, here"listTransactions".success: Boolean indicating if the operation succeeded.creditsUsed: Number of API credits consumed by the request.creditsRemaining: Number of API credits remaining after the request.transactions: An array of transaction objects representing the retrieved payments.cursor(optional): A pagination cursor string to be used in subsequent requests to fetch more transactions if available.
The transactions array holds detailed information about each payment transaction returned by the Cash App API.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authentication with the external N8N Tools API service that proxies or manages Cash App API calls.
- The node uses HTTP POST requests to validate operations and then calls the Cash App API through a helper class.
- Proper configuration of the API URL and API key credential in n8n is necessary.
Troubleshooting
Common issues:
- Invalid or missing API key credential will cause authentication failures.
- Exceeding API rate limits or credit usage may result in errors.
- Providing an invalid cursor string can lead to empty or error responses.
Error messages:
"N8N Tools API validation failed"indicates the operation or resource is not recognized or allowed by the API."Cash App operation failed: <message>"wraps underlying API errors; check the message for details.
Resolutions:
- Verify API credentials are correctly set up and have sufficient permissions.
- Use valid pagination cursors returned from previous calls.
- Handle errors gracefully using the node's "Continue On Fail" option if needed.
Links and References
- Cash App Pay Developer Documentation (for understanding the underlying payment platform)
- Square API Documentation (since Cash App Pay extends Square APIs)
- n8n documentation on Creating Custom Nodes