Debit Wallet

Overview

The Debit Wallet endpoint initiates a debit against a customer's wallet balance.

Common uses:

• Client-initiated payments
• Subscription billing
• Service charges
• Commission deductions

Prerequisites

• Active wallet with sufficient balance
• Valid transaction reference (msgId)

---

Endpoint

POST /waas/Transaction/debitWallet

---

Request Parameters

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 Body

Field	Type	Required	Description
debitAccountNo	string	Yes	Wallet to be debited
amount	decimal	Yes	Transaction amount
msgId	string	Yes	Unique transaction reference
narration	string	Yes	Transaction description

---

Request Example

curl -X POST https://api-sandbox.accessbankplc.com/waas/Transaction/debitWallet \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "debitAccountNo": "0702334455",
    "amount": 5000.00,
    "msgId": "TXN-20250211-001",
    "narration": "Subscription payment"
  }'

---

Response

{
  "succeeded": true,
  "code": "200",
  "message": "successful request",
  "data": {
    "transactionRef": "TXN-20250211-001",
    "status": "SUCCESS"
  },
  "pageMeta": {},
  "errors": {}
}

---

Next Steps

Use Transaction Status to verify completion.

---