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 business operations such as payments, customers, products, subscriptions, invoices, and more. Specifically for the Publish Invoice operation under the Invoice resource, this node publishes an existing invoice by its ID and version number.

This operation is useful in scenarios where you have created or updated an invoice and want to make it officially available or sent to the customer through Cash App's system. For example, after preparing an invoice draft, you can use this node to publish it so that the customer can view and pay it.

Practical examples:

  • Automating invoice publishing after invoice creation in your workflow.
  • Publishing updated invoices after modifications.
  • Integrating invoice management into broader payment and accounting workflows.

Properties

Name Meaning
Invoice ID The unique identifier of the invoice you want to publish (e.g., invoice_123456789).
Version The version number of the invoice to publish. This ensures you are publishing the correct revision of the invoice.

Output

The node outputs a JSON object containing details about the published invoice under the key invoice. This typically includes all relevant invoice data returned from the Cash App API after publishing, such as status, amounts, customer info, and timestamps.

Example output structure snippet:

{
  "success": true,
  "creditsUsed": 1,
  "creditsRemaining": 99,
  "resource": "invoice",
  "operation": "publishInvoice",
  "invoice": {
    "id": "invoice_123456789",
    "version": 1,
    "status": "PUBLISHED",
    "amount": 10000,
    "currency": "USD",
    "customerId": "customer_987654321",
    "createdAt": "2024-01-01T12:00:00Z",
    ...
  }
}

No binary data output is involved in this operation.

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 a specific validation endpoint before performing operations.

Troubleshooting

  • Validation Failure: If the node throws an error indicating "N8N Tools API validation failed," check that your API key and URL are correctly configured and valid.
  • Unknown Operation or Resource: Errors like Unknown invoice operation: publishInvoice or Unknown resource: invoice indicate misconfiguration of the resource or operation parameters.
  • Version Mismatch: Providing an incorrect or outdated invoice version number may cause the publish operation to fail. Ensure the version matches the current invoice state.
  • API Rate Limits or Quotas: The node tracks credits used and remaining; hitting limits may cause failures. Monitor usage and adjust accordingly.
  • Network Issues: Connectivity problems to the API endpoint will result in request failures. Verify network access and endpoint availability.

Links and References

Discussion