Skip to main content

Fintiq API Documentation

Welcome to Fintiq - the financial infrastructure platform that enables seamless fund distribution for marketplaces, platforms, and service-based businesses.

Fintiq acts as a payment intermediary, automatically splitting transaction proceeds among multiple recipients while maintaining full compliance and audit trails.

What is Fintiq Platform?​

Fintiq is a disbursement engine that sits between your payment processing and fund distribution needs. Rather than replacing your existing payment processor, Fintiq works downstream to intelligently allocate transaction proceeds to the correct recipients based on your business rules.

Perfect for:

  • Service marketplaces - Salons, spas, fitness studios, food delivery
  • Multi-vendor platforms - Online marketplaces with multiple sellers
  • Tip distribution - Restaurants, hospitality, service industries
  • Commission splits - Real estate, sales organizations, affiliate programs
  • Revenue sharing - Content platforms, creator economies

How Does It Work?​

Fintiq operates on a simple 3-step process that separates your platform management from recipient self-service:

1. Create Merchants and Recipients via API​

Your platform does:

  • Call Fintiq API to create merchant and recipient records
  • Specify basic information (name, email, external IDs)
  • System creates unique wallets and account numbers instantly
  • For merchants: Each location gets its own separate wallet and account number
  • For recipients: Each individual gets their own wallet and account number
  • Fund allocations can begin immediately to any wallet

Merchants and recipients then self-complete:

  • Receive email invitation with secure onboarding link
  • Access simple dashboard portal to complete their profile
  • Complete KYC/AML verification if required (handled automatically)
  • Link bank accounts instantly OR manually with routing/account numbers
  • Verify microdeposits if using manual bank account linking
  • Merchants: Can connect different bank accounts to different locations as needed
  • Recipients: Connect their personal bank account for receiving payments
Important

Merchants and recipients don't receive actual payouts until they complete their profile and link a verified bank account through their dashboard portal.

2. Allocate Funds via API​

Your platform manages all transactions:

  • Log each business transaction via API with total amount
  • Specify who gets what portion using recipient wallet IDs or account numbers
  • System automatically calculates remaining amounts for location wallets
  • All allocations are recorded instantly in merchant and recipient balances

Merchants and recipients track their earnings:

  • View real-time balance updates in their dashboard
  • See upcoming payout schedules and history
  • Manage multiple bank accounts and payout preferences

3. Automated Payouts​

Fintiq handles everything:

  • Funds accumulate in merchant and recipient wallets based on your transaction allocations
  • Automated systems process daily/monthly payouts per individual preferences
  • Only verified merchants and recipients with linked bank accounts receive payouts
  • ACH transfers sent directly to their bank accounts
  • Real-time notifications sent to both you and all recipients

How Money Actually Flows​

Think of Fintiq as a smart accounting system that automatically divides money from your business transactions. Here's the simple flow:

Step 1: Customer Makes Payment​

  • Customer pays your platform using your existing payment processor
  • Money goes to your merchant account as usual
  • Your platform records the transaction details with Fintiq via API

Step 2: Fintiq Splits the Money (Virtually)​

  • Your API call tells Fintiq: "This $100 transaction should give $15 to Sarah, $10 to Mike"
  • Fintiq instantly credits Sarah's wallet with $15, Mike's wallet with $10
  • The remaining $75 goes to your location's wallet
  • No actual money moves yet - these are just accounting entries

Step 3: Money Accumulates in Digital Wallets​

  • Each recipient has their own "digital wallet" that tracks what they've earned
  • Sarah might earn $15 today, $25 tomorrow, building up to $40 total
  • Mike might accumulate $50 over the week
  • Your location wallet tracks the remainder from all transactions

Step 4: Automatic Payouts Happen​

  • Daily payout recipients: Get paid every business day
  • Monthly payout recipients: Get paid once per month
  • Fintiq automatically sends ACH bank transfers to verified recipients
  • You receive a separate payout for your location's accumulated amount

Real Example:​

🛍️ Customer pays $100 for salon services at "Downtown Location"

📱 Your app tells Fintiq: 
   - "Give $20 tip to stylist Sarah (account FTQ-12345)"
   - "Give $15 commission to salon owner Mike (account FTQ-67890)"
   - "Transaction happened at Downtown Location (account FTQ-11111)"

💰 Fintiq instantly records:
   - Sarah's wallet: +$20 (individual recipient)
   - Mike's wallet: +$15 (individual recipient)
   - Downtown Location wallet: +$65 (merchant location gets the remainder)

🏦 Next payout day:
   - Sarah: $20 → her personal bank account
   - Mike: $15 → his personal bank account  
   - Downtown Location: $65 → whatever bank account merchant linked to this location

Location Flexibility for Merchants:​

  • Multi-location business? Each location has its own wallet and can use different bank accounts
  • Single location? Still works the same way - one location wallet, one bank account
  • Franchise model? Each franchise location can have its own separate banking setup

The Beauty of This System:​

  • You focus on your business - just send transaction data via API
  • Recipients self-manage - they handle their own banking setup through their portal
  • Automatic compliance - KYC/AML verification handled seamlessly
  • Complete transparency - everyone sees their earnings and payout history
  • Flexible timing - each person chooses daily or monthly payouts

Key Features​

💰 Intelligent Fund Allocation​

  • API-driven allocation rules per transaction
  • Automatic remaining amount calculation
  • Support for fixed amounts and percentages
  • Multi-level commission structures

🏦 Integrated Banking​

  • ACH processing
  • Automatic bank account verification
  • Configurable payout schedules (daily/monthly)
  • Real-time balance tracking

📊 Complete Audit Trail​

  • Immutable transaction ledgers
  • Full settlement reporting
  • Compliance-ready documentation
  • Historical balance reconstruction

🔄 Real-time Monitoring​

  • Webhook events for all state changes
  • Transaction status tracking
  • Payout confirmation notifications
  • Error alerting and retry logic

🛡️ Enterprise Security​

  • KYC/AML compliance
  • SOC 2 compliant infrastructure
  • Encrypted data at rest and in transit
  • Partner-based API authentication

⚡ Developer Experience​

  • RESTful API design
  • Comprehensive error handling
  • Sandbox environment for testing
  • Detailed documentation with code examples

Need Help?​

Next Steps​

Ready to integrate? Start with:

  1. Authentication Setup - Configure your API credentials
  2. Quick Start Guide - Make your first API call
  3. API Overview - Understand the platform architecture