Wallet to Other Bank Transfer

Overview

Initiate interbank transfers to accounts in other Nigerian banks via NIP (NIBSS Instant Payment).

---

Endpoint

POST /waas/Transaction/wallet2OtherBank

---

Request Headers

Key	Value	Required
Authorization	Your client-specific secret key	Yes
Ocp-Apim-Subscription-Key	Your access subscription key	Yes
Content-Type	application/json	Yes

Request Parameters

Field	Type	Required	Description
debitAccountNo	string	Yes	Wallet to debit
debitAccountName	string	Yes	Wallet account name
creditBankCode	string	Yes	Destination bank code
creditAccountNo	string	Yes	Destination account number
amount	decimal	Yes	Transfer amount
msgId	string	Yes	Unique reference
narration	string	Yes	Description

---

Bank Codes

Bank	Code
GTBank	058
Zenith Bank	057
First Bank	011
UBA	033

---

Request Example

curl -X POST "https://api-sandbox.accessbankplc.com/waas/Transaction/wallet2OtherBank" \
  -H "Authorization: Bearer <access_token>" \
  -H "Ocp-Apim-Subscription-Key: <subscription_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "debitAccountNo": "0702334455",
    "debitAccountName": "John Doe",
    "creditBankCode": "058",
    "creditAccountNo": "0123456789",
    "amount": 5000,
    "msgId": "W2OB-20250211-001",
    "narration": "Interbank wallet transfer"
  }'

---

Response

{
  "succeeded": true,
  "code": "200",
  "message": "successful request",
  "data": {
    "transactionRef": "W2OB-1707654321",
    "status": "SUCCESS"
  },
  "pageMeta": {}
}

---

Best Practice

Always perform Name Enquiry before interbank transfers.