Debit Wallet

Description: Debits funds from a wallet. Special authentication required.

Sample Request

Request Parameters

Important, Always verify wallet name and check available balance before debiting.

POST {baseUrl}/v1/wallets/debit-wallet

curl -X POST `{baseUrl}/v1/wallets/debit-wallet`
  -H "x-Client-Id: your_client_id"
  -H "x-hash-key: sha256(CustomerMAC + clientSecret + payload)"
  -H "Content-Type: application/json"
  -d '{
      "walletNumber": "9025920886",
      "walletName": "JOHN DOE ADEBAYO",
      "transactionReference": "TXN_20240115_001",
      "amount": "50.00",
      "fee": 0,
      "stampDutyFee": 50,
      "narration": "Payment for Service"

  }
'

Parameter	Type	Required	Description	Format
walletNumber	string	Yes	Wallet number	10 digits
walletName	string	Yes	Account name	From name enquiry
transactionReference	string	Yes	Unique reference	Alphanumeric, max 50 chars
amount	string	Yes	Debit amount	Decimal, e.g., "50.00"
fee	number	Yes	Transaction fee	Can be 0
stampDutyFee	number	No	StampDutyFee	This is set for funds transfer debit that exceeds 10,000 naira
narration	string	Yes	Description	Max 100 characters

Sample Response

Sample Success Response

POST {baseUrl}/v1/wallets/debit-wallet

{
  "responseCode": "00",
  "success": true,
  "responseDescription": "Approved or completed successfully"
}