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 financial and business operations, including payments, customers, products, subscriptions, invoices, loyalty programs, gift cards, inventory, and reports. Specifically, for the Gift Card resource with the Load Gift Card operation, this node allows users to add funds to an existing gift card by specifying the gift card ID and the amount to load.

This functionality is useful in scenarios such as:

  • Adding value to a customer's gift card balance.
  • Managing promotional or refund credits on gift cards.
  • Automating gift card top-ups within workflows.

For example, a retail business could use this node to automatically load funds onto a gift card after a customer makes a purchase or redeems a promotion.

Properties

Name Meaning
Gift Card ID The unique identifier of the gift card to which funds will be added (e.g., giftcard_123456789).
Amount The amount to load onto the gift card, specified in the smallest currency unit (e.g., cents for USD).

Output

The node outputs a JSON object containing details about the loaded gift card after the operation completes successfully. The output structure includes:

  • resource: The resource type, here "giftCard".
  • operation: The operation performed, here "loadGiftCard".
  • success: A boolean indicating if the operation was successful.
  • creditsUsed and creditsRemaining: Information about API usage credits.
  • giftCard: An object representing the updated gift card details returned from the API after loading funds.

No binary data output is involved in this operation.

Example output snippet:

{
  "resource": "giftCard",
  "operation": "loadGiftCard",
  "success": true,
  "creditsUsed": 1,
  "creditsRemaining": 99,
  "giftCard": {
    "id": "giftcard_123456789",
    "balance": 5000,
    "currency": "USD",
    ...
  }
}

Dependencies

  • Requires an API key credential for authenticating requests to the external Cash App API service.
  • The node uses an internal helper class to interact with the Cash App API endpoints.
  • Proper configuration of the API URL and API key is necessary in the node credentials.
  • The node sends validation requests to ensure the resource and operation are supported before executing the main logic.

Troubleshooting

  • Common issues:

    • Invalid or missing Gift Card ID: Ensure the gift card ID provided exists and is correctly formatted.
    • Insufficient permissions or invalid API key: Verify that the API key credential has the required access rights.
    • Loading an amount exceeding allowed limits: Check the amount value and any restrictions imposed by the Cash App API.
    • Network or connectivity problems: Confirm that the API URL is reachable from the n8n environment.

  • Error messages:

    • "N8N Tools API validation failed": Indicates the resource-operation combination is not valid or the API key lacks permission.
    • "Unknown gift card operation: loadGiftCard": Suggests a mismatch in operation naming or unsupported operation.
    • "Cash App operation failed: <message>": General failure message; check the detailed error message for specifics.

To resolve errors, verify input parameters, credentials, and network connectivity. Use the node's "Continue On Fail" option to handle errors gracefully in workflows.

Links and References

Discussion