Skip to main content

​
Prerequisites

Before you begin, you need to have a Powens account. Make sure you have a Powens API key and secret, with the least amount of permissions required to access the functionality of the Powens Connector you plan to use.
Make sure to create an API key dedicated to Formance. Doing so will improve your auditability and security and will allow you to revoke access to Formance at any time if needed.
  • Connectivity module version 3.1.0 or higher
  • A Powens domain with administrative access to modify:
    • Webhook configurations
    • Redirect URIs
  • Powens console access with permissions to create applications
Some configuration is needed on the Powens console to make it compatible with our connector. You will need either a fresh Powens domain or a domain where you can modify webhooks and redirection URIs.

​
Installation

fctl payments connectors install powens config.json
With config.json containing: 
{
  "clientID": "string",
  "clientSecret": "string",
  "configurationToken": "string",
  "domain": "string",
  "endpoint": "string",
  "maxConnectionsPerLink": 0,
  "name": "string",
  "pollingPeriod": "30m"
}

​
Setup Process

​
Step 1: Create a Powens application

  1. Log in to your Powens console
  2. Navigate to Applications and create a new application
  3. Choose a descriptive name for your application
  4. Set a temporary redirect URL (you’ll update this in Step 3)

​
Configuration parameters

ParameterDescriptionLocation in Powens Console
clientIDApplication client identifierApplications > [Your App] > Client ID
clientSecretApplication client secretApplications > [Your App] > Client Secret
configurationTokenServer configuration tokenSettings > Server keys > Config
domainYour Powens domain nameDomain settings
endpointAPI base URL (without /2.0 suffix)Settings > Important information > API URL
maxConnectionsPerLinkMaximum bank connections per authentication sessionCustom value (recommended: 5)

​
Step 2: Retrieve the connector ID

After installation, you’ll need the connector ID for webhook configuration. You can find it using either method: Option 1: Formance Console
  1. Navigate to Connectivity > Connectors
  2. Locate your Powens connector
  3. Copy the connector ID
Option 2: Command line 
fctl payments connectors list
Locate the Powens connector entry and copy its ID. You may need to specify your organization and stack ID if using multiple environments.

​
Step 3: Configure Powens Console

​
Select banking institutions

Review and configure which banking institutions are available to your users. By default, Powens activates major French banking institutions. You can customize this selection based on your target market.

​
Update redirect URI

  1. Navigate to Applications > [Your App] > Settings
  2. Update the redirect URI to:
https://<stack-url>/api/payments/v3/connectors/open-banking/<connectorID>/redirect
Replace <stack-url> with your Formance stack URL and <connectorID> with the ID from Step 2.

​
Configure webhooks

Before creating webhooks, ensure you have configured an alert email address in the Powens console. Webhook creation will fail without this setting.
Create the following webhooks with the authentication credentials automatically generated during connector installation:
WebhookCallbackURL
CONNECTION_DELETEDhttps://<stack-url>/api/payments/v3/connectors/webhooks/<connectorID>/connection-deleted
CONNECTION_SYNCEDhttps://<stack-url>/api/payments/v3/connectors/webhooks/<connectorID>/connection-synced
USER_DELETEDhttps://<stack-url>/api/payments/v3/connectors/webhooks/<connectorID>/user-deleted

​
Setup Checklist

  • Verify Connectivity module version ≥ 3.0.0
  • Ensure Powens domain access with administrative permissions
  • Create new application in Powens console
  • Install Powens connector with proper configuration
  • Retrieve and record connector ID
  • Configure banking institution selection
  • Update redirect URI in Powens application settings
  • Configure required webhooks:
    • CONNECTION_DELETED
    • CONNECTION_SYNCED
    • USER_DELETED

​
Troubleshooting

​
Missing webhook authenticator

Problem: No authenticator appears with the connector name when configuring webhooks. Solution: This indicates an installation issue. Verify that all configuration parameters are correct and reinstall the connector if necessary.

​
No account data after connection

Problem: Accounts or transactions don’t appear after a user successfully connects their bank. Solution:
  1. Verify webhook URLs are correctly configured
  2. Ensure the proper authentication method is selected for each webhook
  3. Check that webhook endpoints are accessible from Powens servers

​
Invalid redirect URL error

Problem: Users see an “invalid redirect_url” error during the authentication flow. Solution: Verify the redirect URI in your Powens application settings matches exactly: 
https://<stack-url>/api/payments/v3/connectors/open-banking/<connectorID>/redirect
Ensure there are no trailing slashes or additional parameters in the configured URL.