---
title: "Register a bank account"
method: POST
path: "/bankaccount"
tags: ["Bank Account"]
---

# Register a bank account

`POST /bankaccount`

Register a bank account that can be used for withdrawal for a given currency. Only NGN is supported at the moment.

## Request body

- BankAccount
  - `bankName` string, string
  - `bankCode` string, string
  - `bankAccountNumber` string, string
  - `bankAccountName` string, string
  - `currency` 'NGN', string
  - `walletId` string, string

## Response `200`

Bank account response

- object
  - `status` string, string
  - `data` BankAccount
    - `bankName` string, string
    - `bankCode` string, string
    - `bankAccountNumber` string, string
    - `bankAccountName` string, string
    - `currency` 'NGN', string
    - `walletId` string, string

## Other responses

- `400` — Unexpected error

## Changes

- **2025-01-31** `d0fae6875ede` — 1 breaking, 1 info
  - removed the enum value `KES` of the request property `currency`
  - removed the `KES` enum value from the `data/currency` response property for the response status `200`
- **2024-06-14** `2d988bc5fda5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stealthmoney/apis/mavapay-api/changes/bankaccount/post.md)

---

[API](https://skmtc.dev/stealthmoney/apis/mavapay-api.md) · [All operations](https://skmtc.dev/stealthmoney/apis/mavapay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stealthmoney/mavapay-api/revisions/842376cab855/schema)