N8N Tools - Cash App icon

N8N Tools - Cash App

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

Actions38

Payment → Refund Payment

AI-generated

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