@extends('layouts.public') @section('title', 'Build with FinAegis - Integration Guide') @section('seo') @include('partials.seo', [ 'title' => 'Build with FinAegis - Integration Guide', 'description' => 'Multiple ways to integrate FinAegis core banking infrastructure into your applications. REST API, native SDKs, webhooks, and more.', 'keywords' => 'FinAegis, integration, API, SDK, webhooks, banking infrastructure, fintech, development', ]) @endsection @push('styles') @endpush @section('content')
REST API v5.2 Cross-Chain & DeFi BaaS Partner SDKs RegTech Compliance AI Transaction Query

Build with FinAegis

Multiple ways to integrate our core banking infrastructure into your applications. Choose the approach that fits your needs.

View Integration Options Start with REST API

Integration Approaches

Choose the integration method that best suits your application architecture and development needs

Available Now

REST API

Direct HTTP/JSON integration

Integrate directly with our RESTful API using any programming language. Full OpenAPI 3.0 specification available.

Standard HTTP methods and status codes
Comprehensive API documentation
Sandbox environment for testing
Postman collection available
View API Docs Postman Collection
In Development

Native SDKs

Language-specific libraries

Official SDKs for popular programming languages with idiomatic APIs and comprehensive type safety.

JavaScript/TypeScript
Python
PHP
Go
Ruby
Java

Native SDKs are planned for future development. Currently, use our REST API directly.

AI Agent Integration

Connect to our AI-powered banking agents with simple API calls

AI Agent API

JavaScript Example 
const agent = new FinAegisAI({
  apiKey: 'your-api-key'
});

// Send a message to the AI agent
const response = await agent.chat({
  message: 'What is my account balance?',
  context: { accountId: 'acc_123' }
});

console.log(response.message);
// "Your current balance is $12,456.78"

MCP Tool Integration

Python Example 
from finaegis import MCPClient

# Initialize MCP client
mcp = MCPClient(api_key='your-api-key')

# Use banking tools directly
balance = mcp.tools.get_account_balance(
    account_id='acc_123',
    currency='USD'
)

print(f"Balance: {balance.amount} {balance.currency}")
Try AI Agent Demo View AI API Docs →

Model Context Protocol (MCP)

Standard protocol for AI model integration with banking tools

15+ Banking Tools

Account, transaction, compliance, and analytics tools

Built-in Security

Authentication, authorization, and audit logging

Real-time Processing

Stream responses with WebSocket support

MCP Server Configuration 
{
  "name": "finaegis-mcp-server",
  "version": "1.0.0",
  "tools": [
    "GetAccountBalance",
    "TransferMoney",
    "KycVerification",
    "AmlScreening",
    "SpendingAnalysis"
  ],
  "capabilities": {
    "streaming": true,
    "authentication": "bearer",
    "rateLimit": 1000
  }
}

Native SDKs Are Planned

We're planning to build native SDKs for all major programming languages to make integration even easier.

JavaScript Python PHP Java Go Ruby C#/.NET Rust & more
Available Now via Partner API (v2.9+)

BaaS SDK Generation

Generate type-safe, versioned SDKs for your partner integration in TypeScript, Python, Java, Go, and PHP -- directly through the Partner API.

TypeScript

@finaegis/sdk

Available

Python

finaegis-sdk

Available

Java

com.finaegis:sdk

Available

Go

finaegis-go

Available

PHP

finaegis/sdk

Available

Generate Your SDK via Partner API

When you onboard as a BaaS partner, SDKs are automatically generated for your requested languages. You can also regenerate or request additional language SDKs at any time. 

# Request SDK generation for your partner account
curl -X POST https://api.finaegis.org/api/v1/partner/sdk/generate \
  -H "Authorization: Bearer YOUR_PARTNER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "languages": ["typescript", "python", "java", "go", "php"],
    "api_version": "v5",
    "include_modules": ["accounts", "transfers", "crosschain", "defi", "compliance"],
    "options": {
      "include_types": true,
      "include_examples": true,
      "include_tests": true
    }
  }'

# Response includes download URLs for each SDK
{
  "data": {
    "generation_id": "sdkgen_abc123",
    "status": "completed",
    "packages": [
      {
        "language": "typescript",
        "version": "5.0.0",
        "package_name": "@finaegis/sdk",
        "download_url": "https://sdk.finaegis.org/packages/typescript/finaegis-sdk-5.0.0.tgz",
        "install_command": "npm install @finaegis/sdk@5.0.0"
      },
      {
        "language": "python",
        "version": "5.0.0",
        "package_name": "finaegis-sdk",
        "download_url": "https://sdk.finaegis.org/packages/python/finaegis-sdk-5.0.0.tar.gz",
        "install_command": "pip install finaegis-sdk==5.0.0"
      },
      {
        "language": "java",
        "version": "5.0.0",
        "package_name": "com.finaegis:sdk",
        "download_url": "https://sdk.finaegis.org/packages/java/finaegis-sdk-5.0.0.jar",
        "install_command": "mvn install com.finaegis:sdk:5.0.0"
      },
      {
        "language": "go",
        "version": "5.0.0",
        "package_name": "github.com/finaegis/sdk-go",
        "download_url": "https://sdk.finaegis.org/packages/go/finaegis-sdk-go-5.2.0.tar.gz",
        "install_command": "go get github.com/finaegis/sdk-go@v5.2.0"
      },
      {
        "language": "php",
        "version": "5.0.0",
        "package_name": "finaegis/sdk",
        "download_url": "https://sdk.finaegis.org/packages/php/finaegis-sdk-5.0.0.zip",
        "install_command": "composer require finaegis/sdk:^5.0"
      }
    ]
  }
}

Quick Install

TypeScript / JavaScript

npm install @finaegis/sdk@5.0.0

Python

pip install finaegis-sdk==5.0.0

Java (Maven)

mvn install com.finaegis:sdk:5.0.0

Go

go get github.com/finaegis/sdk-go@v5.2.0

PHP (Composer)

composer require finaegis/sdk:^5.0

Partner SDK Integration Guide

Step-by-step guide to integrating the FinAegis BaaS SDK into your partner application, covering authentication, module access, and advanced features like Cross-Chain and DeFi.

1

Initialize the SDK with Your Partner Credentials

Use the API key and partner ID from your onboarding response. The SDK auto-configures based on your enabled modules.

TypeScript

import { FinAegis } from '@finaegis/sdk';

const client = new FinAegis({
  apiKey: process.env.FINAEGIS_PARTNER_KEY,
  partnerId: 'partner_acme_abc123',
  environment: 'production', // or 'sandbox'
  modules: ['accounts', 'transfers',
    'crosschain', 'defi', 'compliance']
});

Python

from finaegis import FinAegis

client = FinAegis(
    api_key=os.environ['FINAEGIS_PARTNER_KEY'],
    partner_id='partner_acme_abc123',
    environment='production',
    modules=['accounts', 'transfers',
        'crosschain', 'defi', 'compliance']
)
2

Access Cross-Chain and DeFi Modules (v5.2)

The SDK provides typed interfaces for bridge operations (Wormhole, LayerZero, Axelar), DEX aggregation (Uniswap, Aave, Curve, Lido), cross-chain swaps, and multi-chain portfolio management. 

// TypeScript -- Cross-Chain Bridge + DeFi Swap in one workflow
async function crossChainSwapWorkflow() {
  // Bridge USDC from Ethereum to Polygon
  const bridgeQuote = await client.crosschain.bridge.quote({
    source_chain: 'ethereum',
    destination_chain: 'polygon',
    token: 'USDC',
    amount: '5000.00'
  });

  const bridgeTx = await client.crosschain.bridge.initiate({
    quote_id: bridgeQuote.data.quote_id,
    sender_address: '0x1234...abcd',
    recipient_address: '0x1234...abcd'
  });

  // Wait for bridge completion, then swap on Polygon
  await client.crosschain.bridge.waitForCompletion(bridgeTx.data.bridge_tx_id);

  const swapQuote = await client.defi.swap.quote({
    chain: 'polygon',
    token_in: 'USDC',
    token_out: 'WMATIC',
    amount_in: '5000.00'
  });

  const swap = await client.defi.swap.execute({
    quote_id: swapQuote.data.quote_id,
    wallet_address: '0x1234...abcd'
  });

  // Get multi-chain portfolio overview
  const portfolio = await client.crosschain.portfolio.get({
    wallet_address: '0x1234...abcd',
    chains: ['ethereum', 'polygon', 'arbitrum']
  });

  console.log('Portfolio total value:', portfolio.data.total_value_usd);
}
3

Integrate RegTech Compliance (v2.8)

Built-in compliance modules for MiFID II reporting, MiCA compliance, and FATF Travel Rule -- automatically enforced based on your jurisdiction configuration. 

// TypeScript -- Compliance-aware transfer
async function compliantTransfer(transferParams) {
  // Travel Rule check is automatic for transfers above threshold
  const complianceResult = await client.regtech.travelRule.check({
    transfer_id: transferParams.id,
    originator: transferParams.originator,
    beneficiary: transferParams.beneficiary,
    transfer_details: {
      amount: transferParams.amount,
      currency: transferParams.currency
    }
  });

  if (!complianceResult.data.is_compliant) {
    throw new Error(
      `Compliance failed: ${complianceResult.data.compliance_issues
        .map(i => i.description).join(', ')}`
    );
  }

  // MiCA compliance for crypto assets
  const micaCheck = await client.regtech.mica.validate({
    asset_type: 'crypto',
    transaction_type: 'transfer',
    amount: transferParams.amount,
    jurisdiction: 'EU'
  });

  // Proceed with transfer only if all checks pass
  return await client.transfers.create(transferParams);
}
4

Use AI Transaction Queries (v2.8)

The SDK includes AI-powered transaction search that accepts natural language queries and returns structured, filterable results with risk scoring. 

// TypeScript -- AI-powered transaction intelligence
const insights = await client.ai.transactions({
  query: 'Large DeFi swaps on Ethereum this month with high slippage',
  account_id: 'acct_primary',
  options: {
    include_analytics: true,
    include_risk_scores: true
  }
});

console.log('Interpreted as:', insights.data.interpreted_query);
console.log('Found:', insights.data.total_results, 'transactions');
console.log('Total volume:', insights.data.analytics.total_volume);

SDK Module Reference

Each BaaS partner SDK includes the following modules, based on the modules enabled during onboarding.

client.accounts

Account creation, balances, transactions

v1.0+

client.transfers

Payments, P2P transfers, bulk operations

v1.0+

client.wallets

Blockchain wallets, hardware wallet support

v2.1+

client.compliance

KYC/AML, sanctions screening

v1.0+

client.regtech

MiFID II, MiCA, Travel Rule compliance

v2.8+

client.crosschain

Bridge protocols, multi-chain portfolio

v5.2+

client.defi

DEX aggregation, lending, staking, yield

v5.2+

client.ai

Transaction queries, spending insights

v2.8+

client.partner

SDK generation, tenant management, config

v2.9+

Built for Your Use Case

Whether you're building a fintech app, marketplace, or enterprise platform, FinAegis provides the banking infrastructure you need

Digital Wallets

Create secure digital wallets with multi-currency support, instant transfers, and comprehensive transaction history.

  • Multi-currency accounts
  • Instant peer-to-peer transfers
  • QR code payments

Marketplace Banking

Enable split payments, escrow services, and automated payouts for your marketplace platform.

  • Automated split payments
  • Escrow services
  • Seller payouts

Neobanking

Launch a complete digital banking solution with accounts, cards, and lending capabilities.

  • Digital account opening
  • Virtual card issuance
  • Personal finance tools

Corporate Banking

Streamline business banking with bulk payments, expense management, and team permissions.

  • Bulk payment processing
  • Multi-user permissions
  • Expense management

Lending Platform

Build lending products with automated underwriting, loan management, and repayment processing.

  • Credit scoring integration
  • Automated disbursements
  • Repayment tracking

Investment Platform

Enable investment accounts, portfolio management, and automated investing features.

  • Fractional investing
  • Portfolio tracking
  • Automated rebalancing

Get Started in Minutes

Three simple steps to integrate FinAegis into your application

1

Sign Up & Get API Keys

Create your free account and generate API keys from your dashboard. You'll get instant access to our sandbox environment.

2

Create Your First Account

Use our API to create customer accounts. Each account can hold multiple currencies and support various transaction types.

3

Process Transactions

Start processing payments, transfers, and other transactions. Monitor everything in real-time through webhooks or API polling.

View Code Examples

See full code examples with syntax highlighting for all operations

Ready to integrate?

Choose your preferred language and start building with FinAegis today

Get API Keys View Examples
@include('partials.footer') @endsection