n8n-nodes-lithic

[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 Lithic card issuing platform. Provides 25 resources and 140+ operations for card management, account holders, transactions, payments, digital wallets, 3D Secure authentication, and dispute management.

Features

• Complete Card Management - Create, manage, and control physical and virtual cards
• Account Holder KYC/KYB - Full identity verification workflow support
• Transaction Processing - Real-time authorization, clearing, and settlement
• Digital Wallet Provisioning - Apple Pay, Google Pay, and Samsung Pay support
• 3D Secure Authentication - EMV 3DS authentication flows
• Dispute Management - Create and manage transaction disputes
• Auth Rules & Velocity Limits - Configure spending controls
• Webhook Integration - Real-time event notifications
• Sandbox Support - Full simulation capabilities for testing

Installation

Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your n8n instance
2. Click Install a community node
3. Enter n8n-nodes-lithic
4. Click Install

Manual Installation

# Navigate to your n8n installation
cd ~/.n8n

# Install the package
npm install n8n-nodes-lithic

# Restart n8n

Development Installation

# Clone the repository
git clone https://github.com/Velocity-BPA/n8n-nodes-lithic.git
cd n8n-nodes-lithic

# Install dependencies
npm install

# Build the project
npm run build

# Link to n8n
mkdir -p ~/.n8n/custom
ln -s $(pwd) ~/.n8n/custom/n8n-nodes-lithic

# Restart n8n

Credentials Setup

Lithic API Credentials

| Field | Description | Required | |-------|-------------|----------| | Environment | Production, Sandbox, or Custom | Yes | | API Key | Your Lithic API key | Yes | | Webhook Secret | Secret for webhook verification | No | | Account Token | Account token for scoped access | No | | Custom Endpoint | Custom API endpoint URL | If custom |

Lithic Webhook Credentials

| Field | Description | Required | |-------|-------------|----------| | Webhook Secret | Secret for verifying webhook signatures | Yes |

Resources & Operations

Card Resource

• Create Card (virtual/physical)
• Get Card
• Update Card
• List Cards
• Provision Digital Wallet
• Get Provision Status
• Reissue Card
• Renew Card
• Get Card Embed URL
• Get Card PAN/CVV/PIN
• Set Card PIN
• Get/Update Spend Limits
• Search Cards

Card Program Resource

• Get Card Program
• List Card Programs
• Get/Update Program Spend Limits
• Get Program Stats

Account Resource

• Create Account
• Get Account
• Update Account
• List Accounts
• Get Account Balance
• Get/Update Credit Configuration
• Get Account Limits/Statements/Spend

Account Holder Resource

• Create Individual/Business Account Holder
• Get/Update Account Holder
• List Account Holders
• Upload/Get Documents
• Submit for KYC
• Get KYC Status
• Resubmit KYC

Transaction Resource

• Get Transaction
• List Transactions
• Get by Card/Account
• Search Transactions
• Get Enhanced Commercial Data
• Simulate Authorization/Clearing/Return/Void

Authorization Resource

• Get Authorization
• List Authorizations
• Get Pending
• Approve/Decline Authorization
• Simulate Authorization

Payment Resource

• Create Payment
• Get/List Payments
• Retry Payment
• Simulate Release/Return

Transfer Resource

• Create/Get/List Transfers

Balance Resource

• Get/List Balances
• Get by Financial Account
• Get Settlement Details

Financial Account Resource

• Create/Get/List/Update Financial Account
• Get Balance/Statements

External Bank Account Resource

• Create/Get/List/Update/Delete
• Verify Account
• Retry/Get Micro Deposit Status

Book Transfer Resource

• Create/Get/List Book Transfers
• Reverse Book Transfer

Statement Resource

• Get/List Statements
• Get Line Items
• Get by Account

Dispute Resource

• Create/Get/List/Update Dispute
• Upload/Delete/List/Get Evidence
• Initialize Evidence Upload

Auth Rule Resource

• Create/Get/Update/Delete Auth Rule
• List Auth Rules
• Apply/Remove Auth Rule
• Get Report
• Migrate V1 to V2

Velocity Limit Resource

• Create/Get/Update/Delete Velocity Limit
• List Velocity Limits

Token Resource

• Get/List Tokens
• Activate/Deactivate/Pause/Unpause
• Update Digital Wallet State
• Simulate Token

Digital Wallet Resource

• Provision Apple Pay/Google Pay/Samsung Pay
• Get Tokenization Status
• Get Token by DPAN
• List Digital Wallet Tokens

Three DS Resource

• Authenticate 3DS
• Get 3DS Authentication
• Simulate 3DS Challenge
• Challenge Response

Event Resource

• Get/List Events
• Get Event by Token
• Resend Event
• List Event Subscriptions

Webhook Resource

• Create/Get/Update/Delete Webhook
• List Webhooks
• Rotate Secret
• Send Simulated Event
• Get Webhook Events
• Recover/Replay Missing Events

Report Resource

• Get/List Settlement Reports
• Get Report Details
• Download Report

Tokenization Decisioning Resource

• Get/Rotate Tokenization Decisioning Secret

Responder Endpoint Resource

• Create/Get/Update/Delete Responder Endpoint
• Check Health

Utility Resource

• Get API Status
• Validate Card Number
• Get Supported Countries
• Get MCC Codes
• Get Rate Limits
• Test Connection

Trigger Node

The Lithic Trigger node supports real-time webhook events:

Event Categories

• Card Events - Card created, shipped, converted
• Account Events - Account holder created, updated, verification
• Transaction Events - Authorization, clearing, return, void
• Payment Events - Payment created, updated
• Transfer Events - Transfer created, updated
• Digital Wallet Events - Tokenization results
• 3DS Events - Authentication events
• Dispute Events - Dispute updates
• Settlement Events - Report updates

Configuration

• Automatic webhook registration (optional)
• Webhook signature verification
• Event type filtering

Usage Examples

Create a Virtual Card

// Configure Lithic node
Resource: Card
Operation: Create Card
Card Type: VIRTUAL
Account Token: your-account-token

// Optional fields
Memo: Employee expense card
Spend Limit: 5000 (in dollars)
Spend Limit Duration: MONTHLY
State: OPEN

Process a KYC Submission

// Create Account Holder
Resource: Account Holder
Operation: Create Individual

// Required KYC fields
First Name: John
Last Name: Doe
Email: [email protected]
Phone Number: +15551234567
Date of Birth: 1990-01-15
Address: 123 Main St, City, State 12345
Government ID: SSN or ID number

Set Up Authorization Rules

// Create Auth Rule
Resource: Auth Rule
Operation: Create Auth Rule

// Rule configuration
Name: Block international transactions
Type: CONDITIONAL_BLOCK
Parameters: {
  "conditions": [
    {
      "attribute": "COUNTRY",
      "operation": "NOT_IN",
      "value": ["USA"]
    }
  ]
}

Simulate a Transaction (Sandbox)

// Simulate Authorization
Resource: Transaction
Operation: Simulate Authorization

Card Token: card-token-here
Amount: 50.00
Merchant: AMAZON
MCC: 5411

Lithic Concepts

Card Types

• VIRTUAL - Digital-only cards for online transactions
• PHYSICAL - Printed plastic cards for in-person use
• SINGLE_USE - One-time use virtual cards
• MERCHANT_LOCKED - Cards locked to specific merchants

Card States

• OPEN - Active and ready for use
• PAUSED - Temporarily suspended
• CLOSED - Permanently deactivated

Account Types

• ISSUING - Standard card issuing account
• OPERATING - Operational funding account
• RESERVE - Reserve/collateral account

Digital Wallets

• Apple Pay - Provision for Apple devices
• Google Pay - Provision for Android devices
• Samsung Pay - Provision for Samsung devices

3D Secure

EMV 3DS authentication for enhanced transaction security in e-commerce.

Error Handling

The node includes comprehensive error handling:

// Enable "Continue On Fail" in node settings
// Access error details in output
{
  "error": "Error message",
  "statusCode": 400,
  "details": { ... }
}

Security Best Practices

1. API Keys - Store in n8n credentials, never in workflows
2. Webhook Secrets - Always enable signature verification
3. PCI Compliance - Use Lithic's secure card display for PAN/CVV
4. Sandbox Testing - Test workflows in sandbox before production
5. Rate Limiting - Implement appropriate delays between operations
6. Error Handling - Use try/catch patterns for critical operations

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint code
npm run lint

# Fix lint issues
npm run lint:fix

# Type check
npm run typecheck

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
3. Make your changes
4. Run tests: npm test
5. Run linter: npm run lint
6. Submit a pull request

Support

• Issues: GitHub Issues
• Documentation: Lithic API Docs
• Licensing: [email protected]

Acknowledgments

• Lithic for their comprehensive card issuing platform
• n8n for the workflow automation platform
• The n8n community for their contributions and feedback