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 Cash App Pay via an extensible Square API to manage payments and related financial operations. Specifically, the Create Payment operation allows users to generate a new payment request through Cash App, facilitating seamless payment acceptance in workflows.

Common scenarios where this node is beneficial include:

  • E-commerce platforms automating payment requests for orders.
  • Service providers generating payment links for clients.
  • Subscription or invoicing systems requiring on-demand payment creation.

For example, after a customer places an order, this node can create a payment request with the specified amount and currency, then redirect the customer to complete the payment.

Properties

Name Meaning
Amount Payment amount in the smallest currency unit (e.g., cents for USD). Required.
Currency Three-letter currency code (e.g., USD). Required.
Redirect URL URL to which the user will be redirected after completing the payment. Required.
Note Optional description or note about the payment (e.g., "Payment for service").
Customer ID Optional identifier for the customer associated with the payment.

Output

The node outputs a JSON object containing details of the created payment under the payment key. The structure typically includes information such as payment identifiers, status, amount, currency, and any relevant metadata returned by the Cash App API.

Example output snippet:

{
  "success": true,
  "creditsUsed": 1,
  "creditsRemaining": 99,
  "payment": {
    "id": "payment_123456789",
    "amount": 2500,
    "currency": "USD",
    "status": "pending",
    "redirectUrl": "https://yoursite.com/return",
    "note": "Payment for service",
    "customerId": "customer_123456789"
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authentication with the external N8N Tools API.
  • The node internally uses the Cash App API client wrapped in the bundled cashapp-api module.
  • Proper configuration of the API URL and API key in the node credentials is necessary.
  • The node sends validation requests to the N8N Tools API before performing operations to ensure permissions and quota.

Troubleshooting

  • Validation Failure: If the node throws an error indicating "N8N Tools API validation failed," verify that the API key credential is valid and has sufficient permissions.
  • Unknown Operation Error: Errors like Unknown payment operation: createPayment suggest a mismatch between the selected operation and supported ones; ensure the correct operation is chosen.
  • API Request Failures: Network issues or incorrect API URLs can cause HTTP request failures. Confirm network connectivity and credential settings.
  • Continue On Fail Behavior: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output JSON.

Links and References

Discussion