Create NGN Wallet

Create a custom NGN wallet for a merchant enabled for multiple NGN wallets.

Endpoint

POST /api/s2s/v1/wallet/create-ngn

Headers

Authorization: Bearer sk_live_xxxxx
Content-Type: application/json

Request Body

{
  "title": "Operations Wallet"
}

Sample Response

{
  "success": true,
  "message": "Wallet created successfully",
  "data": {
    "wallet": {
      "id": 123,
      "title": "Operations Wallet",
      "wallet_code": "NGN169XXXX",
      "currency": "NGN",
      "is_default": 0,
      "is_custom": 1,
      "domain": "live",
      "status": 1
    },
    "virtual_account": {
      "account_number": "1234567890",
      "bank_name": "Wema Bank"
    }
  }
}

Notes

Custom NGN wallet creation is only available to merchants enabled for multiple NGN wallets.
Custom wallet creation should be used in live mode.
Store the returned wallet_code for wallet-specific payments, payouts, and wallet transfers.

Multiple NGN Wallets Get Wallet Balance