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

Package Information

Released: 9/16/2025

Downloads: 17 weekly / 142 monthly

Latest Version: 1.0.2

Author: N8N Tools

Available Nodes

N8N Tools - Cash App

No description available

Documentation

N8N Tools - Cash App

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:

Via Community Nodes (Recommended)

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

Operation	Description	Input	Output
Create Payment	Create a new Cash App payment request	Amount, currency, redirect URL	Payment details
Get Transaction	Get details of a specific transaction	Transaction ID	Transaction details
List Transactions	Get recent transaction history	Limit, cursor	Transaction list
Refund Payment	Process a refund for a payment	Payment ID, amount	Refund details

Customer Operations

Operation	Description	Input	Output
Create Customer	Create a new customer profile	Customer data	Customer details
Get Customer	Get customer profile information	Customer ID	Customer details
Update Customer	Update customer profile information	Customer ID, updated data	Customer details
Delete Customer	Delete a customer profile	Customer ID	Deletion confirmation
List Customers	Get recent customer profiles	Limit, cursor, query	Customer list
Create Customer Group	Create a new customer group	Group data	Group details
Add Customer to Group	Add customer to a group	Customer ID, Group ID	Group membership

Product Operations

Operation	Description	Input	Output
Create Product	Create a new product	Product data	Product details
Get Product	Get product details	Product ID	Product details
Update Product	Update product information	Product ID, updated data	Product details
Delete Product	Delete a product	Product ID	Deletion confirmation
List Products	Get product catalog	Limit, cursor, types	Product list
Search Products	Search products by criteria	Search data	Product list

Inventory Operations

Operation	Description	Input	Output
Get Inventory Counts	Get current inventory levels	Catalog object IDs, location IDs	Inventory counts
Get Inventory Changes	Get inventory change history	Catalog object IDs, location IDs	Inventory changes

Subscription Operations

Operation	Description	Input	Output
Create Subscription	Create a new subscription	Subscription data	Subscription details
Get Subscription	Get subscription details	Subscription ID	Subscription details
Update Subscription	Update subscription information	Subscription ID, updated data	Subscription details
Cancel Subscription	Cancel a subscription	Subscription ID	Cancellation confirmation
Resume Subscription	Resume a paused subscription	Subscription ID	Resume confirmation
Pause Subscription	Pause a subscription	Subscription ID, pause data	Pause confirmation
List Subscriptions	Get subscription list	Limit, cursor, query	Subscription list

Invoice Operations

Operation	Description	Input	Output
Create Invoice	Create a new invoice	Invoice data	Invoice details
Get Invoice	Get invoice details	Invoice ID	Invoice details
Update Invoice	Update invoice information	Invoice ID, updated data	Invoice details
Delete Invoice	Delete an invoice	Invoice ID	Deletion confirmation
Publish Invoice	Publish an invoice	Invoice ID, version	Publishing confirmation
Cancel Invoice	Cancel an invoice	Invoice ID, version	Cancellation confirmation
List Invoices	Get invoice list	Limit, cursor, query	Invoice list

Loyalty Operations

Operation	Description	Input	Output
Create Loyalty Account	Create a new loyalty account	Account data	Account details
Get Loyalty Account	Get loyalty account details	Account ID	Account details
Update Loyalty Account	Update loyalty account information	Account ID, updated data	Account details
Accumulate Points	Add points to loyalty account	Account ID, points	Points accumulation
Adjust Points	Adjust loyalty points	Account ID, adjustment data	Points adjustment

Gift Card Operations

Operation	Description	Input	Output
Create Gift Card	Create a new gift card	Gift card data	Gift card details
Get Gift Card	Get gift card details	Gift card ID	Gift card details
Update Gift Card	Update gift card information	Gift card ID, updated data	Gift card details
Get Balance	Get gift card balance	Gift card ID	Balance information
Load Gift Card	Add funds to gift card	Gift card ID, amount	Loading confirmation
Unload Gift Card	Remove funds from gift card	Gift card ID, amount	Unloading confirmation

Report Operations

Operation	Description	Input	Output
Get Payment Reports	Get payment transaction reports	Start date, end date	Payment reports
Get Settlement Reports	Get settlement reports	Start date, end date	Settlement reports
Get Item Sales Reports	Get item sales reports	Start date, end date	Item sales reports
Get Customer Sales Reports	Get customer sales reports	Start date, end date	Customer 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"
}

🔗 Related Packages

Square Node: Official Square integration (when available)
HTTP Request Node: For custom API integrations

📋 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

📧 Email: support@n8ntools.io
📖 Documentation: docs.n8ntools.io
💬 Community: Discord
🐛 Issues: GitHub

📄 License

MIT License - see LICENSE file for details.

Part of the N8N Tools ecosystem • Website • All Packages