Skip to main content
POST
/
banking
/
v1
/
ng
/
bank_accounts
/
{id}
/
transfer
/
initiate_transfer
Initiate Transaction
curl --request POST \
  --url https://api.example.com/banking/v1/ng/bank_accounts/{id}/transfer/initiate_transfer/ \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "beneficiary_account_number": "<string>",
  "beneficiary_bank_code": "<string>",
  "beneficiary_name": "<string>",
  "amount": 123,
  "pin": "<string>",
  "name_enquiry_session_id": "",
  "narration": "default narration text"
}
'
{
  "beneficiary_account_number": "<string>",
  "beneficiary_bank_code": "<string>",
  "beneficiary_name": "<string>",
  "amount": 123,
  "pin": "<string>",
  "name_enquiry_session_id": "",
  "narration": "default narration text"
}

Authorizations

api-key
string
header
required

Path Parameters

id
string
required

Body

beneficiary_account_number
string
required
Minimum string length: 1
beneficiary_bank_code
string
required
Minimum string length: 1
beneficiary_name
string
required
Minimum string length: 1
amount
number<double>
required
pin
string
required
Required string length: 1 - 4
name_enquiry_session_id
string
default:""
Minimum string length: 1
narration
string
default:default narration text
Minimum string length: 1

Response

200 - application/json
beneficiary_account_number
string
required
beneficiary_bank_code
string
required
beneficiary_name
string
required
amount
number<double>
required
pin
string
required
Maximum string length: 4
name_enquiry_session_id
string
default:""
narration
string
default:default narration text