To make a new bank transfer you will need to pass the amount, bank_code, bank, account_number,account_name, narration, reference and currency in the request body as shown below

Example

var axios = require('axios');
var qs = require('qs');
var data = qs.stringify({
  'amount': '1000',
  'bank_code': '044',
  'bank': 'Access bank',
  'account_number': '0690000031',
  'account_name': 'Pastor Bright',
  'narration': 'Transfer',
  'reference': '9967998',
  'currency': 'NGN' 
});
var config = {
  method: 'post',
  url: 'https://integrations.getravenbank.com/v1/transfers/create',
  headers: { },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

{
  "status": "success",
  "message": "transfer queued successfully",
  "data": {
    "email": "johndoe@gmail.com",
    "trx_ref": "202207111524IIGEEHC",
    "merchant_ref": "9967998",
    "amount": 1000,
    "bank": "Access bank",
    "bank_code": "044",
    "account_number": "0690000031",
    "account_name": "Pastor Bright",
    "narration": "Transfer",
    "fee": 10,
    "status": "pending",
    "created_at": "2022-07-11T13:24:03.402Z",
    "id": 2
  }
}

Because Transfer is an asynchronous transaction the transaction status will be pending, but once the transaction status changes, we will notify you via webhook .

Also, the reference field in the request body refers to the customer's own reference which is optional, while the trx_ref in the response body is auto-generated.

👍
Try it in the console
Click here to try it