Internal Transfers

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:

Debiting fees and amounts from a Fixed Account when powering transfers or making bills payment.
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"
}
'

Attribute	Required?	Type	Description
amount	Yes	integer	This 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_id	Yes	string	This is the account id of the sender.
to_account_id	Yes	string	This is the account id of the recipient.
narration	No	string	This is a reason for the transfer
reference	No	string	This 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_data	No	object	This 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.