N8N Tools - Cash App icon

N8N Tools - Cash App

Accept payments and manage transactions through Cash App Pay with extensible Square API integration

Overview

The node integrates with the Cash App API to manage loyalty accounts among other resources. Specifically, the "Update Loyalty Account" operation allows users to modify existing loyalty account information by providing the account ID and updated data. This is useful for scenarios where loyalty program details need to be changed, such as updating customer information, status, or preferences within a loyalty account.

Practical examples include:

  • Updating a customer's loyalty account after they change their contact details.
  • Modifying loyalty account attributes based on new marketing campaigns or tier changes.
  • Correcting errors in loyalty account data.

Properties

Name Meaning
Account ID The unique identifier of the loyalty account to update.

Output

The node outputs a JSON object containing the updated loyalty account information under the key loyaltyAccount. The structure reflects the response from the Cash App API after successfully updating the loyalty account.

Example output snippet:

{
  "success": true,
  "resource": "loyalty",
  "operation": "updateLoyaltyAccount",
  "creditsUsed": 1,
  "creditsRemaining": 99,
  "loyaltyAccount": {
    // Updated loyalty account details here
  }
}

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 an HTTP POST request to validate the requested resource and operation before execution.
  • The node depends on the bundled CashAppApi helper class to perform the actual API calls.
  • Proper configuration of the API URL and API key in the node credentials is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Account ID will cause the operation to fail.
    • Incorrect or expired API key credential may result in authentication errors.
    • Providing malformed or incomplete update data can lead to API validation errors.
  • Error messages:

    • "N8N Tools API validation failed" indicates that the resource-operation combination was rejected by the API validation endpoint; verify resource and operation parameters.
    • "Cash App operation failed: <message>" is a generic error wrapper indicating failure during the API call; check the detailed message for specifics.
    • "Unknown loyalty operation: updateLoyaltyAccount" would indicate a code or configuration mismatch but should not occur given the current implementation.
  • Resolution tips:

    • Ensure the Account ID is correct and exists in the system.
    • Verify API credentials and permissions.
    • Confirm that the update data matches the expected schema required by the Cash App API.

Links and References

Discussion