Wallet

Verify BVN and update user KYC

post

Authorizations

bearerapi-key

Body

application/json

bvnstringRequired

11-digit BVN number

Example: 12345678901

Responses

200

KYC updated successfully

application/json

400

Invalid BVN or verification failed

post

/api/v1/wallet/kyc/bvn

HTTPcURLJavaScriptPython

POST /api/v1/wallet/kyc/bvn HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "bvn": "12345678901"
}

{
  "id": "text",
  "createdAt": "2026-03-10T06:22:24.097Z",
  "updatedAt": "2026-03-10T06:22:24.097Z",
  "deletedDate": "2026-03-10T06:22:24.097Z",
  "verificationStatus": "text",
  "firstName": "text",
  "lastName": "text",
  "gender": "text",
  "dateOfBirth": "text",
  "phoneNo": "text",
  "pixBase64": "text",
  "kycStatus": "text",
  "verifiedAt": "2026-03-10T06:22:24.097Z"
}

Fund wallet with naira

post

Authorizations

bearerapi-key

Body

application/json

amountnumberRequired

Responses

default

application/json

statusCodenumberRequired

messagestringRequired

post

/api/v1/wallet/user/fund-wallet

HTTPcURLJavaScriptPython

POST /api/v1/wallet/user/fund-wallet HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 12

{
  "amount": 1
}

default

{
  "statusCode": 1,
  "message": "text",
  "data": {
    "link": "text"
  }
}

Get wallet data for authenticated user

get

Authorizations

bearerapi-key

Query parameters

chainIdnumberOptional

ChainId of the evm chain portfolio to return

Responses

default

application/json

nairaBalancenumberRequired

evmPortfolioobjectOptional

solPortfolioobjectOptional

get

/api/v1/wallet/me

HTTPcURLJavaScriptPython

GET /api/v1/wallet/me HTTP/1.1
Host: api.monei.cc
Accept: */*

default

{
  "nairaBalance": 1,
  "evmPortfolio": {},
  "solPortfolio": {},
  "subwallets": [
    {
      "id": "text",
      "createdAt": "2026-03-10T06:22:24.097Z",
      "updatedAt": "2026-03-10T06:22:24.097Z",
      "deletedDate": "2026-03-10T06:22:24.097Z",
      "parentWalletId": "text",
      "type": "FIAT",
      "currency": "text",
      "balance": 1,
      "chain": "text",
      "publicAddress": "text",
      "evmPortfolio": {},
      "solPortfolio": {}
    }
  ]
}

Get available banks for withdrawal

get

Authorizations

bearerapi-key

Responses

default

application/json

statusCodenumberRequired

messagestringRequired

get

/api/v1/wallet/get-banks

HTTPcURLJavaScriptPython

GET /api/v1/wallet/get-banks HTTP/1.1
Host: api.monei.cc
Accept: */*

default

{
  "statusCode": 1,
  "message": "text",
  "data": [
    {
      "swiftCode": "ABC123",
      "bic": "BIC456",
      "isMobileVerified": true,
      "isCashPickUp": false,
      "nibssCode": "110072",
      "id": "178",
      "code": "110072",
      "name": "78 Finance Company Limited",
      "branches": [
        []
      ]
    }
  ]
}

Verify bank account

post

Authorizations

bearerapi-key

Body

application/json

accountNumberstringRequired

bankstringRequired

Responses

default

application/json

statusCodenumberRequired

messagestringRequired

post

/api/v1/wallet/verify-bank-account

HTTPcURLJavaScriptPython

POST /api/v1/wallet/verify-bank-account HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "accountNumber": "text",
  "bank": "text"
}

default

{
  "statusCode": 1,
  "message": "text",
  "data": {
    "accountName": "Customer Name",
    "accountNumber": "0736379044",
    "bankCode": "058",
    "bankName": "Guaranty Trust Bank"
  }
}

make a withdrawal to a naira account

post

Authorizations

bearerapi-key

Body

application/json

amountnumberRequired

bankstringRequired

accountNumberstringRequired

transactionPinstringRequired

currencystringOptional

narrationstringOptional

Responses

default

application/json

statusCodenumberRequired

messagestringRequired

dataobjectRequired

post

/api/v1/wallet/withdrawals

HTTPcURLJavaScriptPython

POST /api/v1/wallet/withdrawals HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 110

{
  "amount": 1,
  "bank": "text",
  "accountNumber": "text",
  "transactionPin": "text",
  "currency": "text",
  "narration": "text"
}

default

{
  "statusCode": 1,
  "message": "text",
  "data": {}
}

Transfer funds to another user

post

Authorizations

bearerapi-key

Body

application/json

receiverstringRequired

amountnumberRequired

transactionPinstringRequired

currencystringOptional

Responses

default

application/json

statusCodenumberRequired

messagestringRequired

dataobjectRequired

post

/api/v1/wallet/peer-transfer

HTTPcURLJavaScriptPython

POST /api/v1/wallet/peer-transfer HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 72

{
  "receiver": "text",
  "amount": 1,
  "transactionPin": "text",
  "currency": "text"
}

default

{
  "statusCode": 1,
  "message": "text",
  "data": {}
}