Internal Transfers

Learn how to process internal transfers between virtual accounts in Bloc

Our Internal Transfers API allows you to send funds between two Bloc virtual accounts. Internal Transfers are free and are not subject to any of our transfer fees regardless of how much the amount is.

There are a few use cases for internal transfers:

  1. Debiting fees and amounts from a Fixed Account when powering transfers or making bills payment.
  2. Sending money from one virtual account to another.

How it works

To power internal transfers, all that is required from you is to provide the amount and pass the sender's account id and the recipient's account id.

curl --request POST \
     --url https://api.blochq.io/v1/transfers/internal \
     --header 'accept: application/json' \
     --header 'authorization: Bearer sk_live_64520e0201478f5cd412865f64520e0201478f5cd4128660' \
     --header 'content-type: application/json' \
     --data '
{
  "amount": 10000,
  "from_account_id": "6410616d7f1b4b36103f872b",
  "to_account_id": "64105fdd7f1b4b36103f870f",
  "narration": "test transaction",
  "reference": "617849033kd44223dvs232cd13"
}
'
AttributeRequired?TypeDescription
amountYesintegerThis is the amount being sent. When passing your amount, make sure to pass in kobo. To convert Naira to kobo, simply multiply the Naira amount by 100, e.g. NGN100 will be passed as "amount": 10000,.
from_account_idYesstringThis is the account id of the sender.
to_account_idYesstringThis is the account id of the recipient.
narrationNostringThis is a reason for the transfer
referenceNostringThis is a unique identifier for the transaction. If you pass a reference number, we'll use it in our system. If no reference number is passed, we automatically generate one for the transfer.
meta_dataNoobjectThis is additional data passed by you with the request. We always return this meta_data when returning a response.

๐Ÿ“˜

Important to Note:

To get the account id for your Main Balance, call the Get Ogranisation accounts endpoint URL.