> ## Documentation Index
> Fetch the complete documentation index at: https://docs.recital.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Transfers API Overview

> Introduction to the Recital Finance Transfers API. Learn how to initiate, finalize, and track bank transfers across supported providers.

Welcome to the **Transfers API** section of Recital Finance.

This API allows you to seamlessly integrate direct bank transfers into your application or backend workflows. Whether you're disbursing funds to users, vendors, or employees, the Transfers API provides an end-to-end secure and traceable system for managing these transactions.

### 🔄 Transfer Lifecycle

The typical lifecycle of a transfer involves the following steps:

1. **Initiate Transfer** - Start a new transfer by providing recipient details and amount.
2. **Finalize Transfer (if required)** - Confirm the transfer using a PIN/OTP if `shouldFinalize` is `true`.
3. **Get Transfer Status** - Query the current status of a transfer using the `transferReference`.

### 🚀 What You Can Do

* Send money to bank accounts.
* Track and confirm the state of each transfer.
* Secure transfers with OTP confirmation flows.
* Integrate with multiple providers like Flutterwave, Paystack, and more.

### 🧱 Key Concepts

* **Transfer Reference**: A unique identifier for each transfer transaction.
* **Connect ID**: Identifies the merchant or app user initiating the transaction.
* **Provider ID**: Identifies the PSP (payment service provider) powering the transfer.

### 🔐 Security

All endpoints are secured with Bearer token authentication. You must pass a valid API key in the `Authorization` header for every request.
