n8n-nodes-treasuryprime

[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 Treasury Prime Banking-as-a-Service (BaaS) platform, providing 25 resources and 200+ operations for complete banking automation including accounts, ACH/wire transfers, card issuing, KYC/KYB compliance, and real-time webhooks.

Features

• 25 Resource Categories: Complete coverage of Treasury Prime BaaS platform
• 200+ Operations: Comprehensive banking operations from account creation to compliance
• Real-time Webhooks: 60+ event types with signature verification
• Multi-environment Support: Production, sandbox, and custom endpoints
• Compliance Ready: Built-in KYC/KYB/AML support with SAR/CTR filing
• Card Issuing: Full card lifecycle management with PIN operations
• ACH & Wire Transfers: Same-day ACH, international wires, and book transfers
• Sandbox Testing: Simulate returns, NOCs, and advance time for testing

Installation

Community Nodes (Recommended)

1. Open n8n
2. Go to Settings > Community Nodes
3. Click Install a community node
4. Enter n8n-nodes-treasuryprime
5. Click Install

Manual Installation

# Navigate to your n8n installation directory
cd ~/.n8n

# Install the node
npm install n8n-nodes-treasuryprime

Development Installation

# Clone or extract the package
cd n8n-nodes-treasuryprime

# Install dependencies
npm install

# Build the project
npm run build

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

# Restart n8n
n8n start

Credentials Setup

Treasury Prime API Credentials

| Field | Description | Required | |-------|-------------|----------| | Environment | Production, Sandbox, or Custom | Yes | | API Key ID | Your Treasury Prime API key ID | Yes | | API Secret Key | Your Treasury Prime API secret | Yes | | Bank ID | Your assigned bank partner ID | Yes | | Webhook Secret | Secret for verifying webhook signatures | No | | Custom Endpoint | Custom API URL (for Custom environment) | Conditional |

Treasury Prime OAuth Credentials

| Field | Description | Required | |-------|-------------|----------| | Client ID | OAuth application client ID | Yes | | Client Secret | OAuth application client secret | Yes | | Authorization URL | OAuth authorization endpoint | Yes | | Token URL | OAuth token endpoint | Yes |

Resources & Operations

Account Resource

Manage bank accounts (checking, savings, money market).

| Operation | Description | |-----------|-------------| | Create | Create a new bank account | | Get | Retrieve account details | | Update | Update account information | | List | List all accounts with filters | | Close | Close an account | | Get Balance | Get current balance | | Get All Balances | Get all balance types | | Get Pending Balance | Get pending balance | | Get Available Balance | Get available balance | | Get Account Numbers | Get routing/account numbers | | Get Statement | Retrieve account statement | | Get Transactions | List account transactions | | Update Status | Change account status |

Account Application Resource

Handle account onboarding applications.

| Operation | Description | |-----------|-------------| | Create | Start new application | | Get | Retrieve application | | Update | Update application data | | List | List all applications | | Submit | Submit for review | | Get Status | Check application status | | Upload Document | Attach required document | | Get Requirements | List required documents |

Person Resource

Manage individual account holders.

| Operation | Description | |-----------|-------------| | Create | Create person record | | Get | Retrieve person details | | Update | Update person information | | List | List all persons | | Get Accounts | List person's accounts | | Get Documents | List person's documents | | Archive | Archive person record |

Business Resource

Manage business/company account holders.

| Operation | Description | |-----------|-------------| | Create | Create business record | | Get | Retrieve business details | | Update | Update business information | | List | List all businesses | | Get Accounts | List business accounts | | Get Documents | List business documents | | Add Officer | Add business officer | | Remove Officer | Remove business officer | | Get Officers | List business officers | | Archive | Archive business record |

Document Resource

Manage identity and verification documents.

| Operation | Description | |-----------|-------------| | Upload | Upload new document | | Get | Retrieve document | | List | List all documents | | Get by Account | Documents for account | | Get by Person | Documents for person | | Get Status | Check processing status | | Delete | Remove document |

ACH Resource

Automated Clearing House transfers.

| Operation | Description | |-----------|-------------| | Create | Initiate ACH transfer | | Get | Retrieve transfer details | | List | List all transfers | | Cancel | Cancel pending transfer | | Get Status | Check transfer status | | Get Return | Get return details | | Get Return Codes | List ACH return codes | | Create Same Day | Same-day ACH transfer | | Get Limits | Get ACH limits | | Create Reversal | Reverse a transfer |

Wire Resource

Domestic and international wire transfers.

| Operation | Description | |-----------|-------------| | Create Domestic | Send domestic wire | | Create International | Send international wire | | Get | Retrieve wire details | | List | List all wires | | Cancel | Cancel pending wire | | Get Status | Check wire status | | Get Fees | Get wire fee schedule | | Get Limits | Get wire limits |

Book Transfer Resource

Internal transfers between accounts.

| Operation | Description | |-----------|-------------| | Create | Create internal transfer | | Get | Retrieve transfer details | | List | List all book transfers | | Get Status | Check transfer status |

Check Resource

Check operations and deposits.

| Operation | Description | |-----------|-------------| | Create | Issue a check | | Get | Retrieve check details | | List | List all checks | | Cancel | Cancel pending check | | Stop Payment | Stop check payment | | Get Status | Check status | | Get Image | Get check image | | Create Deposit | Deposit a check | | Get Deposit | Retrieve deposit details | | Get Deposit Image | Get deposit images |

Card Resource

Debit/credit card issuing and management.

| Operation | Description | |-----------|-------------| | Create | Issue new card | | Get | Retrieve card details | | List | List all cards | | Activate | Activate card | | Lock | Temporarily lock card | | Unlock | Unlock locked card | | Replace | Order replacement card | | Close | Close/cancel card | | Get PIN | Retrieve card PIN | | Set PIN | Set new PIN | | Update Limits | Change spending limits | | Get Transactions | Card transaction history |

Counterparty Resource

External transfer recipients.

| Operation | Description | |-----------|-------------| | Create | Add new counterparty | | Get | Retrieve counterparty | | Update | Update counterparty | | List | List all counterparties | | Delete | Remove counterparty | | Verify | Verify account ownership | | Get by Account Number | Find by account number |

Transaction Resource

Transaction history and search.

| Operation | Description | |-----------|-------------| | Get | Retrieve transaction | | List | List all transactions | | Get by Account | Account transactions | | Get by Date Range | Filter by dates | | Search | Search transactions | | Get Pending | Pending transactions | | Get Posted | Posted transactions | | Export | Export transaction data | | Categorize | Categorize transaction |

Payment Resource

Payment scheduling and management.

| Operation | Description | |-----------|-------------| | Create | Create payment | | Get | Retrieve payment | | List | List all payments | | Cancel | Cancel payment | | Get Status | Check payment status | | Schedule | Schedule future payment | | Get Recurring | List recurring payments | | Create Recurring | Set up recurring payment | | Cancel Recurring | Cancel recurring payment |

Bill Pay Resource

Bill payment operations.

| Operation | Description | |-----------|-------------| | Create | Create bill payment | | Get | Retrieve payment details | | List | List bill payments | | Cancel | Cancel bill payment | | Get Billers | List saved billers | | Search Billers | Search biller directory | | Add Biller | Add new biller | | Remove Biller | Remove saved biller |

Statement Resource

Account statements.

| Operation | Description | |-----------|-------------| | Get | Retrieve statement | | List | List all statements | | Get PDF | Download statement PDF | | Get by Account | Statements for account | | Get Transactions | Statement transactions |

Interest Resource

Interest rate and earnings management.

| Operation | Description | |-----------|-------------| | Get Rate | Current interest rate | | Get Earned | Interest earned | | Get Paid | Interest paid | | Get Settings | Interest settings | | Update Settings | Update interest settings |

Fee Resource

Fee schedule and management.

| Operation | Description | |-----------|-------------| | Get Schedule | Fee schedule | | Create | Create fee charge | | Get | Retrieve fee details | | List | List all fees | | Waive | Waive a fee | | Get by Account | Account fees | | Get Types | Available fee types |

Hold Resource

Balance hold management.

| Operation | Description | |-----------|-------------| | Create | Place balance hold | | Get | Retrieve hold details | | List | List all holds | | Release | Release hold | | Get by Account | Account holds | | Update Amount | Modify hold amount |

Alert Resource

Account alerts and notifications.

| Operation | Description | |-----------|-------------| | Create | Create alert | | Get | Retrieve alert | | List | List all alerts | | Update | Update alert settings | | Delete | Remove alert | | Get by Account | Account alerts | | Get Types | Available alert types |

Webhook Resource

Webhook management.

| Operation | Description | |-----------|-------------| | Create | Register webhook | | Get | Retrieve webhook | | Update | Update webhook URL | | Delete | Remove webhook | | List | List all webhooks | | Test | Send test event | | Get Events | List event types | | Get Deliveries | Delivery history | | Retry | Retry failed delivery | | Verify Signature | Verify webhook signature |

Compliance Resource

KYC/KYB/AML compliance operations.

| Operation | Description | |-----------|-------------| | Get Status | Compliance status | | Submit Data | Submit compliance data | | Get Requirements | Required compliance items | | Get SAR Status | SAR filing status | | Get CTR Status | CTR filing status | | Get OFAC Check | OFAC screening result | | Get Report | Compliance report |

Bank Resource

Bank partner information.

| Operation | Description | |-----------|-------------| | Get Info | Bank information | | Get Routing Number | Bank routing number | | Get Products | Available products | | Get Limits | Transaction limits | | Get Hours | Business hours | | Get Features | Supported features |

Reporting Resource

Generate and download reports.

| Operation | Description | |-----------|-------------| | Generate | Generate new report | | Get | Retrieve report | | List | List all reports | | Download | Download report file | | Schedule | Schedule recurring report | | Get Types | Available report types | | Get Custom | Custom report query |

Sandbox Resource

Testing and simulation tools.

| Operation | Description | |-----------|-------------| | Simulate ACH Return | Simulate ACH return | | Simulate ACH NOC | Simulate NOC | | Simulate Wire Return | Simulate wire return | | Simulate Check Return | Simulate check return | | Simulate Card Transaction | Simulate card txn | | Advance Time | Advance sandbox date | | Reset Sandbox | Reset to initial state |

Utility Resource

Utility operations.

| Operation | Description | |-----------|-------------| | Validate Routing Number | Validate ABA routing | | Validate Account Number | Validate account number | | Get API Status | API health status | | Get Rate Limits | Current rate limits | | Test Connection | Test API connection |

Trigger Node

The Treasury Prime Trigger node provides real-time event notifications.

Supported Events

Account Events: account.created, account.updated, account.closed, account.balance_changed, account.status_changed

Application Events: application.created, application.submitted, application.approved, application.denied, application.document_required

Person/Business Events: person.created, person.updated, business.created, business.updated, kyc.status_changed

ACH Events: ach.initiated, ach.pending, ach.completed, ach.returned, ach.canceled, ach.noc_received

Wire Events: wire.initiated, wire.pending, wire.completed, wire.returned, wire.canceled

Book Transfer Events: book_transfer.created, book_transfer.completed

Check Events: check.created, check.mailed, check.cashed, check.voided, check_deposit.received, check_deposit.cleared, check_deposit.returned

Card Events: card.created, card.activated, card.locked, card.unlocked, card.replaced, card.transaction

Transaction Events: transaction.created, transaction.posted, transaction.pending, transaction.returned

Compliance Events: compliance.alert, compliance.document_required, compliance.review_required

Usage Examples

Create an Account

// Create a new checking account for a person
{
  "resource": "account",
  "operation": "create",
  "accountType": "checking",
  "personId": "psn_abc123",
  "name": "Primary Checking",
  "currency": "USD"
}

Initiate ACH Transfer

// Send an ACH credit transfer
{
  "resource": "ach",
  "operation": "create",
  "accountId": "acct_abc123",
  "counterpartyId": "cpty_xyz789",
  "amount": 15000,  // $150.00 in cents
  "direction": "credit",
  "secCode": "PPD",
  "description": "Payroll deposit"
}

Send Domestic Wire

// Send a same-day wire transfer
{
  "resource": "wire",
  "operation": "createDomestic",
  "accountId": "acct_abc123",
  "amount": 5000000,  // $50,000.00 in cents
  "beneficiaryName": "Acme Corporation",
  "beneficiaryAccountNumber": "123456789",
  "beneficiaryRoutingNumber": "021000021",
  "beneficiaryAddress": "123 Main St, New York, NY 10001",
  "memo": "Invoice #12345 payment"
}

Issue a Debit Card

// Create and ship a new debit card
{
  "resource": "card",
  "operation": "create",
  "accountId": "acct_abc123",
  "personId": "psn_abc123",
  "cardType": "debit",
  "shippingMethod": "standard",
  "dailyLimit": 100000,  // $1,000.00 daily limit
  "monthlyLimit": 500000  // $5,000.00 monthly limit
}

Submit KYC Data

// Submit identity verification data
{
  "resource": "compliance",
  "operation": "submitData",
  "entityType": "person",
  "entityId": "psn_abc123",
  "dataType": "kyc",
  "data": {
    "firstName": "John",
    "lastName": "Doe",
    "dateOfBirth": "1985-06-15",
    "ssn": "123-45-6789",
    "address": {
      "line1": "123 Main St",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001"
    }
  }
}

Sandbox: Simulate ACH Return

// Test ACH return handling in sandbox
{
  "resource": "sandbox",
  "operation": "simulateAchReturn",
  "achId": "ach_abc123",
  "returnCode": "R01",  // Insufficient Funds
  "returnReason": "Account has insufficient funds"
}

Webhook Integration

// Register webhook for account events
{
  "resource": "webhook",
  "operation": "create",
  "url": "https://your-server.com/webhooks/treasury-prime",
  "events": [
    "account.created",
    "account.updated",
    "ach.completed",
    "ach.returned"
  ],
  "active": true
}

Banking Concepts

KYC/KYB (Know Your Customer/Business)

Identity verification requirements for individuals and businesses. Treasury Prime supports CIP (Customer Identification Program), CDD (Customer Due Diligence), and beneficial ownership verification.

ACH SEC Codes

Standard Entry Class codes define the type of ACH transaction:

• PPD: Prearranged Payment and Deposit (consumer)
• CCD: Corporate Credit or Debit (business)
• WEB: Internet-initiated entries
• TEL: Telephone-initiated entries

ACH Return Codes

Common return codes:

• R01: Insufficient Funds
• R02: Account Closed
• R03: No Account/Unable to Locate
• R04: Invalid Account Number
• R08: Payment Stopped
• R10: Customer Advises Unauthorized

ACH NOC Codes (Notification of Change)

Change notification codes:

• C01: Incorrect account number
• C02: Incorrect routing number
• C03: Incorrect routing and account number
• C05: Incorrect transaction code

Compliance Requirements

• SAR: Suspicious Activity Report (suspicious transactions)
• CTR: Currency Transaction Report (transactions >$10,000)
• OFAC: Office of Foreign Assets Control (sanctions screening)
• BSA: Bank Secrecy Act (anti-money laundering)

Error Handling

The node provides detailed error messages for common issues:

| Error Code | Description | Resolution | |------------|-------------|------------| | 400 | Invalid request parameters | Check field values and formats | | 401 | Authentication failed | Verify API credentials | | 403 | Insufficient permissions | Check API key permissions | | 404 | Resource not found | Verify resource ID exists | | 409 | Conflict (duplicate) | Use idempotency key | | 422 | Validation failed | Check required fields | | 429 | Rate limit exceeded | Reduce request frequency | | 500 | Server error | Retry with exponential backoff |

Security Best Practices

1. Credential Storage: Store API credentials in n8n credentials, never in workflow nodes
2. Webhook Verification: Always verify webhook signatures in production
3. Idempotency Keys: Use idempotency keys for all financial operations
4. Audit Logging: Enable logging for compliance and debugging
5. Environment Separation: Use sandbox for testing, production for live operations
6. Rate Limiting: Implement appropriate delays between bulk operations
7. PII Handling: Never log sensitive customer data (SSN, account numbers)

Development

# Install dependencies
npm install

# Run linting
npm run lint

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Build the project
npm run build

# Watch mode for development
npm run dev

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

Please ensure your code:

• Passes all linting checks
• Includes appropriate tests
• Follows existing code style
• Updates documentation as needed

Support

• Documentation: Treasury Prime API Docs
• Issues: GitHub Issues
• Commercial Support: [email protected]

Acknowledgments

• Treasury Prime for their comprehensive BaaS platform
• n8n for the workflow automation platform
• The open-source community for inspiration and best practices