Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.formance.com/llms.txt

Use this file to discover all available pages before exploring further.

The Generic Connector is specifically designed to connect your Formance Stack with Financial Service Providers that are not natively supported by Formance. This guide explains how to use it to enable reconciliation with unsupported PSPs.

​
How it works

The Generic Connector acts as a bridge between Formance Connectivity and your custom PSP integration:

​
Implementation steps

​
1. Create your integration service

You need to build a service that:
  • Connects to your PSP using their specific API/protocol
  • Exposes data in the format expected by the Generic Connector API specifications
  • Handles authentication and data transformation

​
2. Install the Generic Connector

Install the generic connector with your integration service configuration: 
fctl payments connectors install generic config.json
With config.json containing: 
{
  "name": "my-custom-psp",
  "pollingPeriod": "2m",
  "apiKey": "your-api-key-for-authentication",
  "endpoint": "https://your-integration-service.com/api"
}

​
3. Authentication setup

The Generic Connector will authenticate requests to your service using: 
Authorization: Bearer <API_KEY>
Your integration service should validate this API key for security.

​
4. Data polling

The Generic Connector will poll your integration service for:
  • Account lists and their balances
  • Transaction history for each account
  • Beneficiary lists for payouts

​
5. Enable reconciliation

Once the Generic Connector is feeding data into Formance Connectivity, you can use Formance Reconciliation to:
  • Perform account-based reconciliation between your PSP accounts and Formance Ledger accounts
  • Generate reconciliation reports showing any discrepancies
  • Monitor balance consistency across systems

​
Reconciliation process

The reconciliation module will:
  1. Compare balances between your PSP (via Generic Connector) and Formance Ledger
  2. Ensure the sum of reconciled account balances match
  3. Generate reports highlighting any discrepancies
  4. Provide audit trails for finance teams

​
Benefits

This approach allows you to:
  • Integrate any PSP regardless of native Formance support
  • Maintain data consistency across multiple payment providers
  • Automate reconciliation processes
  • Scale to multiple PSPs using the same pattern
The Generic Connector lets you reconcile with any PSP — you implement the standardized API interface once, and Formance handles the rest.