Introducing Socket Firewall: Free, Proactive Protection for Your Software Supply Chain.Learn More
Socket
Book a DemoInstallSign in
Socket

n8n-nodes-n8ntools-cashapp

Package Overview
Dependencies
Maintainers
1
Versions
3
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

n8n-nodes-n8ntools-cashapp

N8N Tools - Cash App: Accept payments and manage transactions through Cash App Pay with complete Square API integration for merchant and peer-to-peer payments

latest
Source
npmnpm
Version
1.0.2
Version published
Maintainers
1
Created
Source

N8N Tools - Cash App

npm version npm downloads License: MIT

Accept payments and manage transactions through Cash App Pay with complete Square API integration. This N8N community node provides full integration with Square's Cash App Pay API for merchant and peer-to-peer payments.

✨ Features

  • 💳 Accept Cash App Payments: Create payment requests for Cash App Pay
  • 📋 Manage Transactions: Retrieve transaction history and details
  • 🔄 Refund Payments: Process refunds for Cash App transactions
  • 👥 Customer Management: Create, update, and manage customer profiles
  • 🛍️ Product Catalog: Manage products, services, and inventory
  • 🔁 Subscriptions: Create and manage recurring payment plans
  • 🧾 Invoices: Generate and send professional invoices
  • 🏆 Loyalty Programs: Implement customer loyalty and rewards
  • 🎁 Gift Cards: Sell and manage gift cards
  • 📊 Advanced Reporting: Generate detailed sales and transaction reports
  • 🔒 OAuth 2.0 Authentication: Secure authentication with Square
  • 🔔 Webhook Support: Receive real-time payment notifications

🚀 Quick Start

Installation

Install this node in your N8N instance:

  • Go to Settings > Community Nodes in your N8N interface
  • Click Install a community node
  • Enter n8n-nodes-n8ntools-cashapp
  • Click Install

Via npm

npm install n8n-nodes-n8ntools-cashapp

Setup Credentials

  • Register a new application at Square Developer Portal
  • Get your Application ID and Access Token
  • In N8N, create new Cash App OAuth2 API credentials
  • Enter your Application ID and Access Token

📖 Usage

Supported Resources and Operations

Payment Operations

OperationDescriptionInputOutput
Create PaymentCreate a new Cash App payment requestAmount, currency, redirect URLPayment details
Get TransactionGet details of a specific transactionTransaction IDTransaction details
List TransactionsGet recent transaction historyLimit, cursorTransaction list
Refund PaymentProcess a refund for a paymentPayment ID, amountRefund details

Customer Operations

OperationDescriptionInputOutput
Create CustomerCreate a new customer profileCustomer dataCustomer details
Get CustomerGet customer profile informationCustomer IDCustomer details
Update CustomerUpdate customer profile informationCustomer ID, updated dataCustomer details
Delete CustomerDelete a customer profileCustomer IDDeletion confirmation
List CustomersGet recent customer profilesLimit, cursor, queryCustomer list
Create Customer GroupCreate a new customer groupGroup dataGroup details
Add Customer to GroupAdd customer to a groupCustomer ID, Group IDGroup membership

Product Operations

OperationDescriptionInputOutput
Create ProductCreate a new productProduct dataProduct details
Get ProductGet product detailsProduct IDProduct details
Update ProductUpdate product informationProduct ID, updated dataProduct details
Delete ProductDelete a productProduct IDDeletion confirmation
List ProductsGet product catalogLimit, cursor, typesProduct list
Search ProductsSearch products by criteriaSearch dataProduct list

Inventory Operations

OperationDescriptionInputOutput
Get Inventory CountsGet current inventory levelsCatalog object IDs, location IDsInventory counts
Get Inventory ChangesGet inventory change historyCatalog object IDs, location IDsInventory changes

Subscription Operations

OperationDescriptionInputOutput
Create SubscriptionCreate a new subscriptionSubscription dataSubscription details
Get SubscriptionGet subscription detailsSubscription IDSubscription details
Update SubscriptionUpdate subscription informationSubscription ID, updated dataSubscription details
Cancel SubscriptionCancel a subscriptionSubscription IDCancellation confirmation
Resume SubscriptionResume a paused subscriptionSubscription IDResume confirmation
Pause SubscriptionPause a subscriptionSubscription ID, pause dataPause confirmation
List SubscriptionsGet subscription listLimit, cursor, querySubscription list

Invoice Operations

OperationDescriptionInputOutput
Create InvoiceCreate a new invoiceInvoice dataInvoice details
Get InvoiceGet invoice detailsInvoice IDInvoice details
Update InvoiceUpdate invoice informationInvoice ID, updated dataInvoice details
Delete InvoiceDelete an invoiceInvoice IDDeletion confirmation
Publish InvoicePublish an invoiceInvoice ID, versionPublishing confirmation
Cancel InvoiceCancel an invoiceInvoice ID, versionCancellation confirmation
List InvoicesGet invoice listLimit, cursor, queryInvoice list

Loyalty Operations

OperationDescriptionInputOutput
Create Loyalty AccountCreate a new loyalty accountAccount dataAccount details
Get Loyalty AccountGet loyalty account detailsAccount IDAccount details
Update Loyalty AccountUpdate loyalty account informationAccount ID, updated dataAccount details
Accumulate PointsAdd points to loyalty accountAccount ID, pointsPoints accumulation
Adjust PointsAdjust loyalty pointsAccount ID, adjustment dataPoints adjustment

Gift Card Operations

OperationDescriptionInputOutput
Create Gift CardCreate a new gift cardGift card dataGift card details
Get Gift CardGet gift card detailsGift card IDGift card details
Update Gift CardUpdate gift card informationGift card ID, updated dataGift card details
Get BalanceGet gift card balanceGift card IDBalance information
Load Gift CardAdd funds to gift cardGift card ID, amountLoading confirmation
Unload Gift CardRemove funds from gift cardGift card ID, amountUnloading confirmation

Report Operations

OperationDescriptionInputOutput
Get Payment ReportsGet payment transaction reportsStart date, end datePayment reports
Get Settlement ReportsGet settlement reportsStart date, end dateSettlement reports
Get Item Sales ReportsGet item sales reportsStart date, end dateItem sales reports
Get Customer Sales ReportsGet customer sales reportsStart date, end dateCustomer sales reports

Example Workflow

[HTTP Trigger] → [Cash App Create Payment] → [Redirect User to Cash App] → [Webhook Receiver]

Configuration Example

Create Cash App Payment:

{
  "resource": "payment",
  "operation": "createPayment",
  "amount": 2500,
  "currency": "USD",
  "redirectUrl": "https://yoursite.com/return",
  "note": "Payment for service"
}

⚙️ Node Parameters

Resource Selection

  • Payment: Payment-related operations
  • Customer: Customer management operations
  • Product: Product catalog operations
  • Inventory: Inventory management operations
  • Subscription: Subscription management operations
  • Invoice: Invoice management operations
  • Loyalty: Loyalty program operations
  • Gift Card: Gift card operations
  • Report: Reporting operations

Payment Operations

Create Payment Parameters

  • Amount: Payment amount in smallest currency unit (cents for USD)
  • Currency: Three-letter currency code (USD, CAD, etc.)
  • Redirect URL: URL to redirect user after payment
  • Note: Description of payment
  • Customer ID: Optional customer identifier

Get Transaction Parameters

  • Transaction ID: ID of the transaction to retrieve

List Transactions Parameters

  • Limit: Number of transactions to retrieve (default: 50)
  • Cursor: Pagination cursor for next page of results

Refund Payment Parameters

  • Payment ID: ID of the payment to refund
  • Amount: Refund amount in smallest currency unit
  • Currency: Three-letter currency code
  • Reason: Reason for refund

Customer Operations

Get Customer Parameters

  • Customer ID: ID of the customer to retrieve

Update Customer Parameters

  • Customer ID: ID of the customer to update
  • Customer Data: Updated customer information

Delete Customer Parameters

  • Customer ID: ID of the customer to delete

List Customers Parameters

  • Limit: Number of customers to retrieve (default: 50)
  • Cursor: Pagination cursor for next page of results
  • Query: Search query to filter customers

Create Customer Group Parameters

  • Group Name: Name of the customer group

Add Customer to Group Parameters

  • Customer ID: ID of the customer to add to group
  • Group ID: ID of the group to add customer to

Product Operations

Get Product Parameters

  • Product ID: ID of the product to retrieve

Update Product Parameters

  • Product ID: ID of the product to update
  • Product Data: Updated product information

Delete Product Parameters

  • Product ID: ID of the product to delete

List Products Parameters

  • Limit: Number of products to retrieve (default: 50)
  • Cursor: Pagination cursor for next page of results
  • Types: Product types to filter

Search Products Parameters

  • Search Data: Search criteria

Inventory Operations

Get Inventory Counts Parameters

  • Catalog Object IDs: Comma-separated list of catalog object IDs
  • Location IDs: Comma-separated list of location IDs
  • Limit: Number of inventory counts to retrieve
  • Cursor: Pagination cursor for next page of results

Get Inventory Changes Parameters

  • Catalog Object IDs: Comma-separated list of catalog object IDs
  • Location IDs: Comma-separated list of location IDs
  • Types: Change types to filter
  • Limit: Number of inventory changes to retrieve
  • Cursor: Pagination cursor for next page of results

Subscription Operations

Get Subscription Parameters

  • Subscription ID: ID of the subscription to retrieve

Update Subscription Parameters

  • Subscription ID: ID of the subscription to update
  • Subscription Data: Updated subscription information

Cancel Subscription Parameters

  • Subscription ID: ID of the subscription to cancel

Resume Subscription Parameters

  • Subscription ID: ID of the subscription to resume

Pause Subscription Parameters

  • Subscription ID: ID of the subscription to pause
  • Pause Data: Pause information

List Subscriptions Parameters

  • Limit: Number of subscriptions to retrieve (default: 50)
  • Cursor: Pagination cursor for next page of results
  • Query: Search query to filter subscriptions

Invoice Operations

Get Invoice Parameters

  • Invoice ID: ID of the invoice to retrieve

Update Invoice Parameters

  • Invoice ID: ID of the invoice to update
  • Invoice Data: Updated invoice information

Delete Invoice Parameters

  • Invoice ID: ID of the invoice to delete

Publish Invoice Parameters

  • Invoice ID: ID of the invoice to publish
  • Version: Invoice version number

Cancel Invoice Parameters

  • Invoice ID: ID of the invoice to cancel
  • Version: Invoice version number

List Invoices Parameters

  • Limit: Number of invoices to retrieve (default: 50)
  • Cursor: Pagination cursor for next page of results
  • Query: Search query to filter invoices

Loyalty Operations

Get Loyalty Account Parameters

  • Account ID: ID of the loyalty account to retrieve

Update Loyalty Account Parameters

  • Account ID: ID of the loyalty account to update
  • Account Data: Updated account information

Accumulate Points Parameters

  • Account ID: ID of the loyalty account to accumulate points
  • Points: Number of points to accumulate

Adjust Points Parameters

  • Account ID: ID of the loyalty account to adjust points
  • Adjustment Data: Points adjustment information

Gift Card Operations

Get Gift Card Parameters

  • Gift Card ID: ID of the gift card to retrieve

Update Gift Card Parameters

  • Gift Card ID: ID of the gift card to update
  • Gift Card Data: Updated gift card information

Get Balance Parameters

  • Gift Card ID: ID of the gift card to check balance

Load Gift Card Parameters

  • Gift Card ID: ID of the gift card to load
  • Amount: Amount to load in smallest currency unit

Unload Gift Card Parameters

  • Gift Card ID: ID of the gift card to unload
  • Amount: Amount to unload in smallest currency unit

Report Operations

Get Payment Reports Parameters

  • Start Date: Start date for report
  • End Date: End date for report
  • Location ID: Optional location ID to filter
  • Sort Order: Sort order (ASC or DESC)

Get Settlement Reports Parameters

  • Start Date: Start date for report
  • End Date: End date for report
  • Location ID: Optional location ID to filter
  • Sort Order: Sort order (ASC or DESC)

Get Item Sales Reports Parameters

  • Start Date: Start date for report
  • End Date: End date for report
  • Location ID: Optional location ID to filter
  • Sort Order: Sort order (ASC or DESC)

Get Customer Sales Reports Parameters

  • Start Date: Start date for report
  • End Date: End date for report
  • Location ID: Optional location ID to filter
  • Sort Order: Sort order (ASC or DESC)

📤 Output Data

Create Payment Result

{
  "success": true,
  "resource": "payment",
  "operation": "createPayment",
  "payment": {
    "id": "payment_123456789",
    "amount": 2500,
    "currency": "USD",
    "status": "pending",
    "createdAt": "2025-08-22T14:30:00Z",
    "checkoutUrl": "https://cash.app/pay/abc123"
  }
}

Get Transaction Result

{
  "success": true,
  "resource": "payment",
  "operation": "getTransaction",
  "transaction": {
    "id": "payment_123456789",
    "amount": 2500,
    "currency": "USD",
    "status": "completed",
    "createdAt": "2025-08-22T14:30:00Z",
    "completedAt": "2025-08-22T14:32:00Z",
    "customerId": "customer_987654321"
  }
}

List Transactions Result

{
  "success": true,
  "resource": "payment",
  "operation": "listTransactions",
  "transactions": [
    {
      "id": "payment_123456789",
      "amount": 2500,
      "currency": "USD",
      "status": "completed",
      "createdAt": "2025-08-22T14:30:00Z"
    }
  ],
  "cursor": "next_page_cursor"
}

Create Customer Result

{
  "success": true,
  "resource": "customer",
  "operation": "createCustomer",
  "customer": {
    "id": "customer_123456789",
    "createdAt": "2025-08-22T14:30:00Z",
    "updatedAt": "2025-08-22T14:30:00Z",
    "givenName": "John",
    "familyName": "Doe",
    "emailAddress": "john.doe@example.com",
    "phoneNumber": "+1-555-123-4567"
  }
}

Create Product Result

{
  "success": true,
  "resource": "product",
  "operation": "createProduct",
  "product": {
    "id": "product_123456789",
    "createdAt": "2025-08-22T14:30:00Z",
    "updatedAt": "2025-08-22T14:30:00Z",
    "name": "Premium Service",
    "description": "High-quality service package",
    "productType": "REGULAR",
    "categories": ["Services"],
    "availableOnline": true,
    "availableForPickup": false,
    "availableElectronically": true
  }
}

🛠️ Advanced Use Cases

E-commerce Integration

[Order Created] → [Create Cash App Payment] → [Send Payment Link] → [Webhook: Payment Completed] → [Fulfill Order]

Subscription Management

[Schedule Trigger] → [Create Recurring Payment] → [Process Payment] → [Update Subscription Status]

Payment Notifications

[Cash App Webhook] → [Payment Received] → [Send Confirmation Email] → [Update Database]

Refund Processing

[Customer Request] → [Refund Payment] → [Process Refund] → [Notify Customer]

Customer Loyalty Program

[Purchase Completed] → [Accumulate Loyalty Points] → [Check Reward Threshold] → [Award Reward]

Inventory Management

[Product Sold] → [Update Inventory Count] → [Check Low Stock] → [Send Restock Alert]

Invoice Generation

[Service Completed] → [Create Invoice] → [Send to Customer] → [Track Payment Status]

Gift Card Sales

[Gift Card Purchase] → [Create Gift Card] → [Send Digital Card] → [Activate Gift Card]

Reporting Dashboard

[Schedule Trigger] → [Generate Sales Reports] → [Compile Analytics] → [Send Daily Summary]

🔐 Security & Privacy

OAuth 2.0 Flow

  • User authenticates with Square through OAuth 2.0
  • Access token is securely stored in N8N credentials
  • All API calls include authentication headers
  • Tokens are refreshed automatically when expired

Data Protection

  • No sensitive financial data is stored by this node
  • All communication with Square API is encrypted (HTTPS)
  • Access tokens are stored securely in N8N's credential system

💸 Pricing & Limits

This node itself is free to use, but Square may have:

  • Transaction fees for processed payments
  • Rate limits on API requests
  • Account verification requirements

🚨 Error Handling

Common errors and solutions:

// Authentication error
{
  "error": "Invalid or expired access token",
  "success": false,
  "suggestion": "Re-authenticate with Square in your credentials"
}

// Insufficient funds
{
  "error": "Payment declined - insufficient funds",
  "success": false,
  "suggestion": "Customer needs to add funds to their Cash App account"
}

// Transaction not found
{
  "error": "Transaction not found",
  "success": false,
  "suggestion": "Verify the transaction ID is correct"
}

// Customer not found
{
  "error": "Customer not found",
  "success": false,
  "suggestion": "Verify the customer ID is correct"
}

// Product not found
{
  "error": "Product not found",
  "success": false,
  "suggestion": "Verify the product ID is correct"
}

📋 Requirements

  • N8N version 0.174.0 or higher
  • Square Developer account with Cash App Pay enabled
  • Node.js 18+ (for development)

📁 Examples

You can find example workflows in the examples directory:

🚀 Future Enhancements

This node is designed to be extensible and can be enhanced with additional Square API capabilities:

Planned Expansions:

  • Team Management:

    • Manage employee profiles
    • Assign roles and permissions
    • Track employee performance
  • Location Management:

    • Manage multiple business locations
    • Track location-specific data
    • Handle multi-location reporting
  • Advanced Booking Systems:

    • Appointment scheduling
    • Resource allocation
    • Staff scheduling
  • Marketing Automation:

    • Email campaign integration
    • SMS notifications
    • Social media posting
  • Advanced Analytics:

    • Predictive sales forecasting
    • Customer behavior analysis
    • Market trend identification

Integration Opportunities:

  • E-commerce Platforms: Shopify, WooCommerce, Magento
  • Accounting Software: QuickBooks, Xero, FreshBooks
  • CRM Systems: HubSpot, Salesforce, Zoho CRM
  • Inventory Management: TradeGecko, Cin7, Fishbowl

These enhancements would allow users to build comprehensive business workflows that integrate Cash App Pay with other essential business tools.

🆘 Support

📄 License

MIT License - see LICENSE file for details.

Part of the N8N Tools ecosystemWebsiteAll Packages

Keywords

n8n

FAQs

Package last updated on 16 Sep 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts