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 various resources such as payments, customers, products, subscriptions, invoices, loyalty accounts, gift cards, and reports. Specifically for the Update Gift Card operation, it allows users to update information related to an existing gift card by providing its ID and the new data.

This node is beneficial in scenarios where businesses need to programmatically manage their Cash App gift cards within automated workflows. For example, updating gift card details after a customer request or correcting information without manual intervention.

Practical example:

  • Automatically update gift card metadata or status when triggered by an external event (e.g., customer support ticket).
  • Sync gift card information from another system into Cash App via automation.

Properties

Name Meaning
Gift Card ID The unique identifier of the gift card to update. This is required to specify which gift card will be updated.
Gift Card Data (implied) The new data or fields to update on the gift card. This is passed as an object but not explicitly listed in the provided properties JSON.

Note: The provided input properties JSON only includes "Gift Card ID" because the update data is expected to be provided as a separate parameter named giftCardData (inferred from code usage), which contains the fields to update.

Output

The output JSON contains a field named giftCard which holds the updated gift card information returned from the Cash App API after the update operation.

Example structure of output JSON:

{
  "json": {
    "resource": "giftCard",
    "operation": "updateGiftCard",
    "success": true,
    "creditsUsed": 1,
    "creditsRemaining": 99,
    "giftCard": {
      "id": "giftcard_123456789",
      "balance": 5000,
      "status": "active",
      "metadata": { ... }
      // other gift card fields as returned by the API
    }
  }
}

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the N8N Tools API endpoint.
  • The node uses the external Cash App API through the N8N Tools API proxy.
  • 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.

Troubleshooting

  • Validation Failure: If the API key or resource-operation combination is invalid, the node throws a validation error with a message like "N8N Tools API validation failed". Ensure the API key is correct and has permissions for gift card updates.
  • Unknown Operation Error: If an unsupported operation is specified, the node throws an error such as "Unknown gift card operation: updateGiftCard". Verify that the operation name matches exactly.
  • Missing Required Parameters: The "Gift Card ID" is required; omitting it will cause errors. Make sure all required parameters are provided.
  • API Errors: Any errors returned by the Cash App API during the update will be surfaced. Check the error message for details and verify the update data format.
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output JSON.

Links and References

If you need further details about the update data structure (giftCardData) or other operations, please provide additional property definitions or source code snippets.

Discussion