Barter transfers

You can transfer money directly from your available balance to a Barter account.

Hey👋. We recommend checking out Transfers: Overview to understand the basics of transfers first. This guide assumes you've read that.

Making a Barter transfer

To do this, you'll need the mobile number registered on the Barter account. Once you've got that, the process is similar to regular bank account transfers. They make use of the create transfer endpoint, with a few differences:

  • account_bank is always "barter"
  • account_number is the Barter account mobile number.
  • You have to supply a beneficiary_name that can be used to identify this account in your list of beneficiaries
const details = {
    account_bank: "barter",
    account_number: "2348xxxxxxxx8",
    amount: 500,
    currency: "NGN",
    beneficiary_name: "Peter Pan",
};
await flw.Transfer.initiate(details)
$details = [
    "account_bank" => "barter",
    "account_number" => "2348xxxxxxxx8",
    "amount" => 500,
    "currency" => "NGN",
    "beneficiary_name" => "Peter Pan",
];
$response = $transferService->singleTransfer($details);
details = {
    account_bank: "barter",
    account_number: "2348xxxxxxxx8",
    amount: 500,
    currency: "NGN",
    beneficiary_name: "Peter Pan",
}
response = transfer.initiate_transfer details
details = {
    "account_bank": "barter",
    "account_number": "2348xxxxxxxx8",
    "amount": 500,
    "currency": "NGN",
    "beneficiary_name": "Peter Pan",
}
res = rave.Transfer.initate(details)
details := rave.SinglePaymentData {
    AccountBank:     "barter",
    AccountNumber:   "2348xxxxxxxx8",
    Amount:          500,
    Currency:        "NGN",
    BeneficiaryName: "Peter Pan",
}
err, response := transfer.InitiateSingleTransfer(details)
curl --request POST 'https://api.flutterwave.com/v3/transfers' \
  --header 'Authorization: Bearer YOUR_SECRET_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "account_bank": "barter",
    "account_number": "2348xxxxxxxx8",
    "amount": 500,
    "currency": "NGN",
    "beneficiary_name": "Peter Pan"
}'

Here's an example response:

{
  "status": "success",
  "message": "Transfer Queued Successfully",
  "data": {
    "id": 6968703,
    "account_number": "+2348xxxxxxxx8",
    "bank_code": "barter",
    "full_name": "PETER PAN",
    "created_at": "2021-02-10T11:32:59.000Z",
    "currency": "NGN",
    "amount": 500,
    "fee": 0,
    "status": "NEW",
    "reference": "barter-transfer-2",
    "meta": null,
    "narration": "Test",
    "complete_message": "",
    "requires_approval": 0,
    "is_approved": 1,
    "bank_name": "FA-BANK"
  }
}

As always, you'll notice that the status of the returned transfer (data.status) is "NEW". To find out when the transfer is completed, you can set up a webhook or call the get transfer endpoint with the transfer ID. See Transfers: Overview for details.

Bulk transfers

You can also transfer to multiple Barter accounts at once. See the bulk transfers guide for details.

Loading...