N8N Tools - Cash AppInstall

Overview

The node integrates with the Cash App Pay system via an extensible Square API, enabling users to manage payments and transactions programmatically within n8n workflows. Specifically, the Get Transaction operation under the Payment resource retrieves detailed information about a specific payment transaction by its ID.

This operation is useful in scenarios where you need to verify payment details, audit transactions, or trigger downstream processes based on transaction status or metadata. For example, after receiving a webhook notification of a payment, you might use this node to fetch full transaction details for record-keeping or customer notifications.

Properties

Output

The node outputs a JSON object containing the transaction details retrieved from the Cash App API. The output structure includes:

• success: Boolean indicating if the operation was successful.
• creditsUsed: Number of API credits consumed by the request.
• creditsRemaining: Number of API credits remaining after the request.
• transaction: An object containing detailed information about the requested transaction, such as amount, currency, status, timestamps, payer info, and other relevant metadata provided by the Cash App API.

No binary data output is produced by this operation.

Example output snippet (simplified):

{
  "success": true,
  "creditsUsed": 1,
  "creditsRemaining": 99,
  "transaction": {
    "id": "payment_123456789",
    "amount": 2500,
    "currency": "USD",
    "status": "COMPLETED",
    "createdAt": "2024-01-01T12:00:00Z",
    "payer": {
      "name": "John Doe",
      "email": "john@example.com"
    },
    "...": "other transaction details"
  }
}

Dependencies

• Requires an API key credential for authenticating with the external N8N Tools API service that proxies or manages Cash App API calls.
• The node expects the API URL and API key to be configured in the credentials.
• The node internally uses an HTTP POST request to validate the operation before executing it.
• No direct Cash App API credentials are exposed; authentication is handled via the configured API key credential.

Troubleshooting

• Common issues:

  • Invalid or missing Transaction ID will cause the operation to fail.
  • API key misconfiguration or expired credentials can lead to authentication errors.
  • Network connectivity issues may prevent reaching the API endpoint.
  • If the transaction ID does not exist or is incorrect, the API will return an error message.

• Error messages:

  • "N8N Tools API validation failed": Indicates the initial validation call to the API failed, possibly due to invalid credentials or unsupported operation.
  • "Cash App operation failed: <message>": General failure during the operation execution, with <message> providing more detail.
  • "Unknown payment operation: getTransaction": Should not occur if using the correct operation name; indicates internal mismatch.

• Resolution tips:

  • Verify the Transaction ID is correct and exists in your Cash App account.
  • Check that the API key credential is valid and has necessary permissions.
  • Ensure network access to the configured API URL.
  • Use the node's "Continue On Fail" option to handle errors gracefully in workflows.

Links and References

• Cash App Pay Developer Documentation (for understanding underlying payment concepts)
• Square API Documentation (since Cash App Pay extends Square APIs)
• n8n documentation on Creating Custom Nodes (for general context on node development)