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 to manage loyalty accounts, specifically allowing users to accumulate points in a loyalty account. This operation is useful for businesses that want to reward customers by adding points to their loyalty accounts based on purchases or other activities.

Typical use cases include:

  • Adding reward points to a customer's loyalty account after a purchase.
  • Automating loyalty point accumulation as part of a customer engagement workflow.
  • Integrating loyalty programs with other systems to keep points updated in real-time.

For example, after a successful sale, this node can be used to add a specified number of points to the buyer's loyalty account automatically.

Properties

Name Meaning
Account ID The unique identifier of the loyalty account to which points will be added.
Points The number of points to accumulate (add) to the specified loyalty account.

Output

The node outputs a JSON object containing details about the loyalty points accumulation event under the field loyaltyEvent. This typically includes information confirming the points were successfully added and any relevant metadata returned by the Cash App API.

Example output structure snippet:

{
  "success": true,
  "creditsUsed": 1,
  "creditsRemaining": 99,
  "resource": "loyalty",
  "operation": "accumulatePoints",
  "loyaltyEvent": {
    // Details of the points accumulation event from the API response
  }
}

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the external Cash App API service.
  • The node uses the "N8N Tools API" endpoint configured via credentials to validate and perform operations.
  • Proper configuration of the API URL and API key in n8n credentials is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Account ID: Ensure the loyalty account ID provided exists and is correct.
    • Points value errors: Points must be a valid number; negative values are not accepted for accumulation.
    • API authentication failures: Verify that the API key credential is correctly set up and has sufficient permissions.
    • Network or connectivity problems with the external API.

  • Error messages:

    • "N8N Tools API validation failed": Indicates the API key or request parameters failed validation. Check credentials and input parameters.
    • "Unknown loyalty operation: accumulatePoints": Should not occur if the operation is selected properly; indicates possible internal misconfiguration.
    • General HTTP or network errors: Check internet connection and API availability.

To resolve errors, verify all input parameters, ensure credentials are valid, and consult API documentation for limits or restrictions.

Links and References

Discussion