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
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>
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:
- Compare balances between your PSP (via Generic Connector) and Formance Ledger
- Ensure the sum of reconciled account balances match
- Generate reports highlighting any discrepancies
- 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 essentially democratizes PSP integration, allowing you to build reconciliation capabilities for any financial service provider by implementing the standardized API interface.
