Skip to main content
Version: v2.0

BankingCircle Connector

Prerequisites

Before you begin, you need to have a BankingCircle account. If you don't have one, you can sign up for a BankingCircle account here. Make sure you have prepared your BankingCircle API credentials, with the least amount of permissions required to access the functionality of the BankingCircle Connector you plan to use. You can find more information about how to create an API key here.

Client Certificate

You will also need a client certificate, along with the unecrypted key that you can extract from the pfx file you have assigned to your BankingCircle account. You can use the following commands to extract the certificate and the key from the pfx file:

openssl pkcs12 -in <filename.pfx> -clcerts -nokeys | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > client.cer
openssl pkcs12 -in <filename.pfx> -nocerts -nodes | sed -ne '/-BEGIN PRIVATE KEY-/,/-END PRIVATE KEY-/p' > client.key

IP Whitelisting

In addition to the steps above, you will alsoneed to whitelist the IP addresses of the Formance Platform in your BankingCircle account. The IP address you will need to whitelist is relative to the region your Formance Platform is hosted. The IP addresses of a Formance Cloud deployment are:

RegionIP Address
sandbox18.202.172.221
eu-west-152.49.33.19
us-west-254.70.241.235
af-south-113.244.136.76
sa-east-154.232.156.67
info

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.

Setup

fctl payments connectors install bankingcircle bankingcircle.json

with bankingcircle.json containing:

{
"name": "bankingcircle",
"username": "<username>",
"password": "<password>",
"endpoint": "<endpoint>",
"authorizationEndpoint": "<authorization endpoint>",
"userCertificate": "<certificate>",
"userCertificateKey": "<certificate key>",
"pollingPeriod": "2m"
}