Column Connector

Prerequisites

Before you begin, you need to have a Column account. Column is a modern banking-as-a-service platform that provides access to banking infrastructure through a simple API. Make sure you have a Column API key with the least amount of permissions required to access the functionality of the Column Connector you plan to use. You can find more information about how to create an API key in the Column API documentation.

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

fctl payments connectors install column column.json

curl

curl -X POST "https://$STACK.formance.cloud/api/payments/connectors/column" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d @column.json

With column.json containing:

{
    "name": "column",
    "pollingPeriod": "30s",
    "endpoint": "https://api.column.com",
    "apiKey": "<your-column-api-key>",
    "pageSize": 1
}

Configuration Parameters

Parameter	Description	Required
name	The name of the connector	Yes
pollingPeriod	The frequency at which the connector polls for updates	Yes
endpoint	The Column API endpoint	Yes
apiKey	Your Column API key	Yes
pageSize	The number of items to fetch per page	No

Features

The Column connector supports the following capabilities:

• Account Management: Fetch accounts and balances, create bank accounts
• External Accounts: Fetch and manage external counterparties
• Payments: Fetch payment history and create various types of transfers
• Internal Transfers: Transfer funds between Column accounts
• External Payouts: Support for ACH, wire, international wire, and real-time transfers
• Reversals: Reverse ACH transfers when needed
• Webhook Integration: Real-time updates about transaction statuses

Supported Payment Types

Internal Transfers

Transfer funds between Column accounts within your organization.

ACH Transfers

Automated Clearing House transfers for domestic payments with support for different entry class codes (PPD, etc.).

Wire Transfers

Domestic wire transfers for same-day settlement.

International Wire Transfers

Cross-border wire transfers with support for SWIFT messaging.

Real-time Transfers

Instant payment transfers for immediate settlement.

Metadata Support

The Column connector uses metadata with the namespace com.column.spec/ to provide additional configuration options for:

• Bank account creation (routing numbers, account types, addresses)
• Payout specifications (transfer types, overdraft settings)
• ACH-specific settings (entry class codes, debit/credit types)
• International wire details (charge bearer, beneficiary references)
• Reversal reasons for transaction corrections