Senegal

Send XOF directly to bank accounts in Senegal. This guide walks you through the steps required to initiate and verify a transfer.

Prerequisites

Complete KYC and ensure your account is approved for transactions.
Whitelist your server IP addresses. See this guide for more information.
Enable Transfers via API. See this guide for more information.
Ensure your balance has sufficient funds. If needed, you can debit an alternate balance. See supported currencies for XOF transfers.

Payout Flow

Follow these steps to send money to a bank account in Senegal.

Collect the beneficiary details
Gather the beneficiary's name, bank, and 24-character IBAN (International Bank Account Number).

See the table below for the required and optional parameters.

Parameter	Description	Format	Example	Isrequired
`account_bank`	The beneficiary's bank code. Use the Get Banks endpoint to retrieve the bank code.	String	"25562426"	Yes
`account_number`	The beneficiary's 24-character IBAN.	String	"SN4213700308306287000024"	Yes
`beneficiary_name`	The beneficiary's full name.	String	"WALY CHO"	Yes
`amount`	The amount to send.	Integer	350	Yes
`currency`	The transfer currency. Must be `XOF`.	String	"XOF"	Yes
`destination_branch_code`	The beneficiary bank's branch code. Use the Get Branches endpoint to retrieve the branch code.	String	"1812062HD2"	No
`debit_currency`	The wallet currency to debit for the transfer.	String	"XAF"	No
`narration`	A description for the transfer.	String	"Payout To Senegal"	No
`reference`	Unique reference to identify the transfer.	String	"Your-Unique-Reference"	No

Initiate the transfer
Send a POST request to the transfer endpoint with the beneficiary and transfer details.

curl --request POST \
  --url https://api.flutterwave.com/v3/transfers \
  --header 'Authorization: Bearer {{YOUR_SECRET_KEY}}' \
  --header 'Content-Type: application/json' \
  --data '{
        "amount": 340,
        "account_bank": "25562426",
        "account_number": "SN4213700308306287000024",
        "destination_branch_code": "1812062HD2",
        "currency": "XOF",
        "beneficiary_name": "Waly Diouf",
        "debit_currency": "XAF",
        "narration": "Waly's withdrawal",
       "reference":"STkKkkgrfMRkFl_kd5lkdHk17dkY3kk8d1esl_PMCKDU_1"
}'

{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 2240896,
        "account_number": "SN4213700308306287000024",
        "bank_code": "25562426",
        "full_name": "Waly Diouf",
        "created_at": "2026-09-15T17:00:28.000Z",
        "currency": "XOF",
        "debit_currency": "XAF",
        "amount": 340,
        "fee": 1500,
        "status": "NEW",
        "reference": "STkKkkgrfMRkFl_kd5lkdHk17dkY3kk8d1esl_PMCKDU_1",
        "meta": null,
        "narration": "Waly's withdrawal",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}

Verify the transfer status
There are two ways to verify the transfer status:

Call the transfer status endpoint using the transfer ID (data.id) returned in the transfer response.

curl --request GET \
  --location 'https://api.flutterwave.com/v3/transfers/2240896' \
  --header 'Authorization: Bearer {{YOUR_SECRET_KEY}}'

{
    "status": "success",
    "message": "Transfer fetched",
    "data": {
        "id": 2240896,
        "account_number": "SN4213700308306287000024",
        "bank_code": "25562426",
        "full_name": "Waly Diouf",
        "created_at": "2026-09-15T17:00:28.000Z",
        "currency": "XOF",
        "debit_currency": "XAF",
        "amount": 340,
        "fee": 1500,
        "status": "SUCCESSFUL",
        "reference": "STkKkkgrfMRkFl_kd5lkdHk17dkY3kk8d1esl_PMCKDU_1",
        "meta": null,
        "narration": "Waly's withdrawal",
        "approver": null,
        "complete_message": "Successful",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}

Listen for webhooks: Configure your webhook URL on the Flutterwave Dashboard to receive real-time transfer updates. See the webhooks guide for more information.

{
  "event": "transfer.completed",
  "event.type": "Transfer",
  "data": {
    "id": 2240896,
    "account_number": "SN4213700308306287000024",
    "bank_name": "FA-BANK",
    "bank_code": "25562426",
    "fullname": "Waly Diouf",
    "created_at": "2026-09-15T17:00:28.000Z",
    "currency": "XOF",
    "debit_currency": "XAF",
    "amount": 340,
    "fee": 1500,
    "status": "SUCCESSFUL",
    "reference": "STkKkkgrfMRkFl_kd5lkdHk17dkY3kk8d1esl_PMCKDU_1",
    "meta": null,
    "narration": "Waly's withdrawal",
    "approver": null,
    "complete_message": "Successful",
    "requires_approval": 0,
    "is_approved": 1
  }
}

Testing Transfers

Check the testing guide for mocking transfers in the test environment.