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 allows you to adjust loyalty points on a specified loyalty account within the Cash App ecosystem. It is useful for scenarios where you need to manually correct or update the points balance of a customer's loyalty account, such as compensating for errors, applying manual bonuses, or deducting points due to returns or penalties.

Practical examples include:

  • Increasing a customer's loyalty points after a special promotion.
  • Decreasing points when a customer redeems rewards or returns items.
  • Correcting point balances due to system discrepancies.

Properties

Name Meaning
Account ID The unique identifier of the loyalty account whose points you want to adjust.
Points The number of points to adjust. Can be positive (to add points) or negative (to subtract points).

Output

The node outputs a JSON object containing the result of the points adjustment operation under the field loyaltyEvent. This typically includes details about the adjustment event such as updated points balance and metadata related to the transaction.

Example output structure snippet:

{
  "success": true,
  "creditsUsed": 1,
  "creditsRemaining": 99,
  "resource": "loyalty",
  "operation": "adjustPoints",
  "loyaltyEvent": {
    "id": "event_123456789",
    "accountId": "account_123456789",
    "pointsAdjusted": 100,
    "newBalance": 1500,
    "timestamp": "2024-01-01T12:00:00Z"
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authentication with the external Cash App API service.
  • The node uses an HTTP POST request to validate the operation before execution.
  • The node depends on the "N8nToolsApi" credentials which must be configured in n8n with a valid API URL and API key.
  • The node internally uses a helper class to interact with the Cash App API endpoints.

Troubleshooting

  • Common issues:

    • Invalid or missing Account ID will cause the operation to fail.
    • Providing zero points or no points value may result in no change or error.
    • API key misconfiguration or expired keys will lead to authentication failures.
    • Network connectivity issues can prevent successful API calls.

  • Error messages:

    • "N8N Tools API validation failed" indicates that the initial validation request to the API did not succeed. Check API key validity and permissions.
    • "Unknown loyalty operation: adjustPoints" would indicate a code or configuration mismatch but should not occur if using the node as provided.
    • "Cash App operation failed: <message>" wraps any other errors from the API or internal processing. Review the message for specific causes.

  • Resolution tips:

    • Verify that the Account ID exists and is correct.
    • Ensure the API key credential is properly set up and has required permissions.
    • Confirm that the points value is a valid number (positive or negative).
    • Enable "Continue On Fail" option in the node settings to handle errors gracefully during batch executions.

Links and References

Discussion