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 integrates with the Cash App API to manage gift cards, specifically allowing users to unload (remove) funds from a specified gift card. The "Unload Gift Card" operation deducts a specified amount from the balance of an existing gift card.

Common scenarios where this node is beneficial include:

  • Managing gift card balances in retail or e-commerce workflows.
  • Automating refunds or balance adjustments on gift cards.
  • Integrating gift card fund management into broader payment or customer service automations.

For example, after a customer returns a product, you could use this node to unload the returned amount from their gift card automatically.

Properties

Name Meaning
Gift Card ID The unique identifier of the gift card from which funds will be unloaded (e.g., giftcard_123456789).
Amount The amount to unload from 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 unload operation under the giftCard field. This typically includes updated gift card information reflecting the new balance after unloading the specified amount.

Example output structure snippet:

{
  "success": true,
  "creditsUsed": 1,
  "creditsRemaining": 99,
  "resource": "giftCard",
  "operation": "unloadGiftCard",
  "giftCard": {
    "id": "giftcard_123456789",
    "balance": 7500,
    "status": "active",
    ...
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential and API URL configuration for the external Cash App API service.
  • The node uses HTTP POST requests to communicate with the Cash App API endpoints.
  • Proper OAuth2 or API key credentials must be configured in n8n for authentication.

Troubleshooting

  • Validation Failure: If the API validation fails, the node throws an error indicating that the API key or request parameters might be invalid. Ensure your API credentials are correct and have sufficient permissions.
  • Unknown Operation or Resource: Errors occur if unsupported operations or resources are selected. Confirm that "Gift Card" resource and "Unload Gift Card" operation are chosen.
  • Insufficient Balance: Attempting to unload more than the available gift card balance may cause an error from the API. Verify the gift card balance before unloading.
  • Network Issues: Connectivity problems with the Cash App API endpoint can cause request failures. Check network access and API availability.

Links and References

Discussion