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 enables processing refunds for payments made through Cash App Pay, integrated via an extensible Square API. It allows users to refund a specified amount of a payment by providing the payment ID, amount, currency, and optionally a reason for the refund.

Common scenarios include:

  • Refunding customers who returned products or canceled services.
  • Handling partial or full refunds automatically in workflows.
  • Managing payment reversals without manual intervention.

Practical example:

  • After detecting a customer return in your e-commerce system, use this node to refund the original payment amount or a partial amount with a reason like "Product return".

Properties

Name Meaning
Payment ID The unique identifier of the payment to refund (e.g., payment_123456789).
Amount The refund amount expressed in the smallest currency unit (e.g., cents for USD).
Currency The three-letter ISO currency code for the refund (e.g., USD).
Reason Optional text describing the reason for the refund (e.g., "Customer request").

Output

The node outputs a JSON object containing details about the refund operation under the refund field. This typically includes confirmation data from the Cash App API about the refunded payment.

Example output structure:

{
  "success": true,
  "creditsUsed": 1,
  "creditsRemaining": 99,
  "resource": "payment",
  "operation": "refundPayment",
  "refund": {
    // Refund details returned by the Cash App API
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for accessing the external N8N Tools API service.
  • The node uses HTTP POST requests to validate operations and perform the refund via the Cash App API integration.
  • Proper configuration of the API URL and API key in the node credentials is necessary.

Troubleshooting

  • Validation failure: If the node throws an error indicating validation failed, ensure that the API key credential is correctly configured and has permissions for refund operations.
  • Unknown payment operation: This error occurs if an unsupported operation is requested; verify that the operation is set to "Refund Payment".
  • Invalid Payment ID or amount: Ensure the payment ID exists and the refund amount does not exceed the original payment.
  • API errors: Network issues or invalid credentials can cause failures; check connectivity and credential validity.
  • Use the "Continue On Fail" option to handle errors gracefully within workflows.

Links and References

Discussion