n8n-nodes-moov

[Velocity BPA Licensing Notice]

This n8n node is licensed under the Business Source License 1.1 (BSL 1.1).

Use of this node by for-profit organizations in production environments requires a commercial license from Velocity BPA.

For licensing information, visit https://velobpa.com/licensing or contact [email protected].

A comprehensive n8n community node for the Moov payment platform, providing seamless integration with Moov's payment infrastructure for account management, transfers, bank accounts, cards, wallets, and more.

Features

• 26 Resource Categories - Complete coverage of Moov's payment API
• 150+ Operations - Full CRUD operations across all resources
• Real-time Webhooks - MoovTrigger node for event-driven workflows
• Multi-Environment - Production and Sandbox support
• OAuth 2.0 - Secure authentication with scoped access tokens
• TypeScript - Full type safety and IntelliSense support

Installation

Community Nodes (Recommended)

1. Open n8n
2. Go to Settings → Community Nodes
3. Click Install
4. Enter n8n-nodes-moov
5. Click Install

Manual Installation

# Navigate to your n8n installation
cd ~/.n8n

# Install the package
npm install n8n-nodes-moov

# Restart n8n

Development Installation

# Clone and build
git clone https://github.com/Velocity-BPA/n8n-nodes-moov.git
cd n8n-nodes-moov
npm install
npm run build

# Create symlink
mkdir -p ~/.n8n/custom
ln -s $(pwd) ~/.n8n/custom/n8n-nodes-moov

# Restart n8n
n8n start

Credentials Setup

Moov API Credentials

| Field | Description | |-------|-------------| | Environment | Production or Sandbox | | Account ID | Your Moov Facilitator Account ID | | Public Key | API public key from Moov Dashboard | | Secret Key | API secret key from Moov Dashboard | | Webhook Secret | (Optional) Secret for webhook signature verification |

Moov OAuth Credentials

| Field | Description | |-------|-------------| | Client ID | OAuth client ID | | Client Secret | OAuth client secret | | Scopes | Comma-separated list of OAuth scopes |

Resources & Operations

Account

Manage Moov accounts (individuals and businesses)

• Create, Get, Update, List accounts
• Get/Request/Disable capabilities
• Terms of Service management
• Country assignments

Capability

Control account capabilities

• Get capabilities and requirements
• Request new capabilities
• Check capability status

Representative

Manage business representatives (for business accounts)

• Create, Get, Update, Delete representatives
• List all representatives

Bank Account

Link and manage bank accounts

• Link bank accounts
• Initiate/Complete micro-deposit verification
• Get instant verification links
• Delete bank accounts

Card

Link and manage payment cards

• Link cards (credit/debit)
• Update card details
• Apple Pay domain registration
• Get card brand information

Wallet

Manage Moov wallets

• Get wallet details and balance
• List wallets
• Get wallet transactions

Payment Method

View available payment methods

• Get payment method details
• List payment methods by account

Transfer

Move money between accounts

• Create transfers (ACH, card, wallet)
• Get transfer details and options
• Cancel, refund, reverse transfers
• Patch transfer metadata

Transfer Options

Explore available transfer methods

• Get source/destination options
• Check available payment rails

Refund

Process refunds

• Create full/partial refunds
• Track refund status

Dispute

Handle payment disputes

• List and get disputes
• Accept disputes
• Submit/Upload/Delete evidence

Underwriting

Manage risk assessment

• Get underwriting details
• Update underwriting information
• Request underwriting review

Verification

Identity and document verification

• Initiate verification
• Complete verification steps
• Get verification status

Document

Manage documents for compliance

• Upload documents (ID, business docs)
• Get document details
• Delete documents

Institution

Look up financial institutions

• Search by name or routing number
• Get ACH/Wire participants

File

Manage file uploads

• Upload files
• Download files
• Get file metadata

Industry

Industry classification codes

• List industries
• Search by name
• Get MCC/NAICS codes

Avatar

Account avatars/logos

• Upload, Get, Delete avatars

Enrichment

Data enrichment services

• Enrich addresses
• Enrich profiles

Analytics

Payment analytics and reporting

• Transfer analytics
• Account analytics
• Volume reports

Schedule

Scheduled/recurring transfers

• Create, Update, Cancel schedules
• Get occurrences

Webhook

Webhook management

• Create, Update, Delete webhooks
• Ping webhooks
• Enable/Disable webhooks

Event

Event history and monitoring

• List events
• Get event details
• Filter by resource type

Access Token

OAuth token management

• Create scoped tokens
• Revoke tokens
• List available scopes

Onboarding

Account onboarding

• Create onboarding links
• Track onboarding status
• Resend invites

Utility

Utility operations

• Test API connection
• Validate routing numbers
• Get supported countries/currencies
• Check rate limits

Trigger Node

The Moov Trigger node enables real-time event-driven workflows:

Event Categories

• Account Events - Created, Updated, Deleted
• Bank Account Events - Created, Verified, Deleted
• Card Events - Created, Updated, Expired
• Transfer Events - Created, Completed, Failed, Canceled
• Refund Events - Created, Completed, Failed
• Dispute Events - Created, Won, Lost, Evidence Required
• Wallet Events - Updated, Balance Changed
• Verification Events - Started, Completed, Failed
• Underwriting Events - Pending, Approved, Rejected
• Schedule Events - Created, Executed, Failed

Usage Examples

Create an Individual Account

// Moov node configuration
{
  "resource": "account",
  "operation": "create",
  "accountType": "individual",
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "phone": "+14155551234"
}

Link a Bank Account

// Moov node configuration
{
  "resource": "bankAccount",
  "operation": "link",
  "accountId": "{{ $json.accountID }}",
  "routingNumber": "021000021",
  "accountNumber": "1234567890",
  "accountType": "checking",
  "holderName": "John Doe"
}

Create a Transfer

// Moov node configuration
{
  "resource": "transfer",
  "operation": "create",
  "amount": 1000,
  "currency": "USD",
  "sourcePaymentMethodId": "{{ $json.sourceWalletId }}",
  "destinationPaymentMethodId": "{{ $json.destBankAccountId }}",
  "description": "Payout"
}

Handle Webhooks

// MoovTrigger node configuration
{
  "eventCategory": "transfer",
  "events": ["transfer.completed", "transfer.failed"]
}

// Downstream nodes can access:
// {{ $json.eventType }}
// {{ $json.data.transferID }}
// {{ $json.data.status }}

Moov Concepts

| Concept | Description | |---------|-------------| | Facilitator | Your platform's main Moov account | | Connected Account | Sub-accounts for your users/merchants | | Capability | Enabled feature (transfers, cards, wallets) | | Payment Method | Funding source (bank, card, wallet) | | Transfer | Money movement between accounts | | Wallet | Moov-held balance account | | Micro-Deposits | Bank verification via small deposits | | Underwriting | Risk assessment for accounts | | Representative | Business owner/officer | | Sweep | Automatic wallet balance disbursement | | Occurrence | Single instance of a scheduled transfer |

Networks

| Network | Description | Use Cases | |---------|-------------|-----------| | ACH | Automated Clearing House | Bank-to-bank transfers | | Push-to-Card | Card network rails | Instant payouts to debit cards | | Wallet | Moov internal ledger | Instant internal transfers | | RTP | Real-Time Payments | Instant bank transfers |

Error Handling

The node provides detailed error information:

// Error response structure
{
  "error": true,
  "message": "Transfer failed: Insufficient funds",
  "statusCode": 400,
  "details": {
    "code": "INSUFFICIENT_FUNDS",
    "field": "source.amount"
  }
}

Common Error Codes

| Code | Description | |------|-------------| | 400 | Bad Request - Invalid parameters | | 401 | Unauthorized - Invalid credentials | | 403 | Forbidden - Insufficient permissions | | 404 | Not Found - Resource doesn't exist | | 409 | Conflict - Duplicate operation | | 422 | Unprocessable - Validation failed | | 429 | Too Many Requests - Rate limited |

Security Best Practices

1. Never log API keys - Use credential management
2. Verify webhooks - Always validate signatures
3. Use HTTPS - All API calls are encrypted
4. Scoped tokens - Request minimal permissions
5. PCI Compliance - Card data is tokenized
6. Audit transfers - Log all money movements
7. Handle PII - Encrypt sensitive data

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint
npm run lint

# Fix lint issues
npm run lint:fix

Author

Velocity BPA

• Website: velobpa.com
• GitHub: Velocity-BPA

Licensing

This n8n community node is licensed under the Business Source License 1.1.

Free Use

Permitted for personal, educational, research, and internal business use.

Commercial Use

Use of this node within any SaaS, PaaS, hosted platform, managed service, or paid automation offering requires a commercial license.

For licensing inquiries: [email protected]

See LICENSE, COMMERCIAL_LICENSE.md, and LICENSING_FAQ.md for details.

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Support

• Documentation: Moov API Docs
• Issues: GitHub Issues
• Email: [email protected]
• Moov Support: moov.io/support

Acknowledgments

• Moov - Payment infrastructure platform
• n8n - Workflow automation platform
• Velocity BPA - Node development and maintenance