Outward Transfer

This endpoint allows users to initiate outward transfers to external accounts or institutions. It facilitates the transfer of funds from the customer's account to external accounts or institutions. POST /api/transfer/v1/outwardtransfer You need to provide the necessary parameters, such as beneficiaryAccountName, originatorAccountName, amount, and other required information to successfully initiate an outward transfer.

Headers

Name	Value
Content-Type*	application/json
Authorization*	Bearer <token>
Request-Reference	{unique-reference}

Body

Name	Data Type (length)	Required	Description
nameEnquiryRef	string		The reference code from a name enquiry
amount	integer		The amount to be transferred in kobo The amount must be provided in the base currency, e.g. NGN 5000.50 should be provided as 500050 kobo
fee	integer (nullible)		The fee associated with the transfer. Any passed fee will override the existing configured fee by the institution within the CBA Pass the fee as 0 if you do not want to charge a fee. The fee is also charged in Kobo
beneficiaryAccountName	string		The account name of the transfer's beneficiary
beneficiaryAccountNumber	string		The account number of the transfer's beneficiary on Udara360 to credit
beneficiaryBankName	string		The bank name of the transfer's beneficiary
beneficiaryBankVerificationNumber	string		The BVN of the transfer's beneficiary
beneficiaryKycLevel	integer		The KYC level of the transfer's beneficiary
originatorAccountName	string		The name of the account initiating the transfer
originatorAccountNumber	string		The account number initiating the transfer
originatorBankVerificationNumber	string		The BVN of the account initiating the transfer
originatorKycLevel	integer		The KYC level of the originator
destinationInstitutionCode	string		The bank code of the destination institution
originatorNarration	string		The narration from the originator for the transfer
paymentReference	string		The name enquiry reference for the transfer
transactionLocation	string		The location of the transaction
beneficiaryNarration	string		The narration for the beneficiary

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

Sample Request

curl --location -g '{{baseurl}}/api/transfer/v1/outwardtransfer' \
--header 'Authorization: bearer {token}' \
--header 'request-reference: {unique_reference}' \
--header 'Content-Type: application/json' \
--data '{
  "amount": 0,
  "fee": 0,
  "beneficiaryAccountName": "string",
  "beneficiaryAccountNumber": "string",
  "beneficiaryBankName": "string",
  "beneficiaryBankVerificationNumber": "string",
  "beneficiaryKycLevel": 0,
  "originatorAccountName": "string",
  "originatorAccountNumber": "string",
  "originatorBankVerificationNumber": "string",
  "originatorKycLevel": 0,
  "destinationInstitutionCode": "string",
  "nameEnquiryRef": "string",
  "originatorNarration": "string",
  "paymentReference": "string",
  "transactionLocation": "string",
  "beneficiaryNarration": "string"
}'

Respose: 200

{
  "status": true,
  "message": "string",
  "data": {
    "statusCode": "string",
    "referenceNumber": "string",
    "instrumentNumber": "string",
    "sessionID": "string"
  }
}