1. Home
  2. Wallet Service
  3. Transaction API
  4. Transfer – Wallet to Account

Transfer – Wallet to Account

This is the endpoint for transfer to bank account.

Request Message Description

Field#Field nameData typeRequired Max Length Description Options 
1walletIdTypeMapyes
 wallet identifier type
2channel Stringyes 30 channel sending request “WEB” or “USSD” or “SERVICE” or “MOBILE”
3walletId String yes
wallet identifier
4amountStringyes
amount
5encryptedPinStringyes
encrypted Pin
6txnRefStringyes
transaction reference
7domainStringno
wallet domain
8beneficiaryAccountNumberStringyes
beneficiary Account number
9beneficiaryAccountNameStringyes
beneficiary Account name
10beneficiaryBankCbnCodeStringyes
beneficiary bank code

Endpoint

Base URL : https://api-gateway.interswitchng.com

Request: POST  /generic-wallet/api/v1/transaction/transfer/account

Header

Content-Type: application/json
Authorization: {passport generated bearer token}

Sample Request

{
"txnRef":"70039202",
"domain":"ISW",
"walletIdType":"NIN",
"walletId":"9999",
"beneficiaryAccountNumber":"738892022",
"beneficiaryAccountName":"Tester Tester",
"beneficiaryBankCbnCode":"058",
"channel":"SERVICE",
"amount":"200",
"encryptedPin": "31d7e6e95aa309fc21127391833733eb"
}

Sample Response (success)

{
"statusCode": "200",
"responseCode": "00",
"responseMessage": "Successful",
"errors": null,
"modelList": null,
"count": 0
}

Was this article helpful to you? Yes 2 No

How can we help?