Skip to main content

​
Prerequisites

Before you begin, you need to have a Tink account. Make sure you have a Tink API key and secret, with the least amount of permissions required to access the functionality of the Tink 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
  • Tink console access with permissions to modify application settings
We recommend starting with a fresh Tink application. If using an existing application, ensure you can modify the redirect URL and delete any existing webhooks, as these are configured programmatically during connector installation.

​
Installation

fctl payments connectors install tink config.json
With config.json containing: 
{
  "clientID": "string",
  "clientSecret": "string",
  "endpoint": "string",
  "name": "string",
  "pollingPeriod": "30m"
}

​
Setup Process

​
Step 1: Configure Tink application

  1. Log in to your Tink console
  2. Navigate to App Settings
  3. Create a new client secret and copy it for use in the connector configuration
If using an existing Tink application, delete all existing webhooks before proceeding. The connector will configure webhooks programmatically during installation.

​
Configuration parameters

ParameterDescriptionExample Value
clientIDApplication client identifier from Tink consoleYour Tink app client ID
clientSecretApplication client secret from Tink consoleGenerated client secret
endpointTink API base URLhttps://api.tink.com
The current Tink API endpoint is https://api.tink.com. Refer to the Tink API documentation for the most up-to-date endpoint information.

​
Step 2: Retrieve the connector ID

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

​
Step 3: Configure Tink redirect URL

  1. In the Tink console, navigate to App Settings
  2. Scroll to the bottom and add the following redirect callback URL:
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.

​
Setup Checklist

  • Verify Connectivity module version ≥ 3.1.0
  • Create or prepare Tink application with appropriate permissions
  • Generate new client secret in Tink console
  • Remove existing webhooks (if using existing application)
  • Install Tink connector with proper configuration
  • Retrieve and record connector ID
  • Configure redirect callback URL in Tink console
  • Select banking institutions to activate or deactivate

​
Troubleshooting

​
Redirect URL configuration error

Problem: Error occurs when accessing the create-link endpoint, typically showing a redirect URL mismatch. Solution: Verify that the redirect URL in your Tink console App 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.

​
Webhook conflicts

Problem: Installation fails due to existing webhook configurations. Solution: Delete all existing webhooks in your Tink application before installing the connector. The connector will automatically configure the required webhooks during installation.