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.