Skip to content
/ MBBank Public

An unofficial API wrapper for Vietnam Military Commercial Joint Stock Bank (MBBank, MB)

License

Notifications You must be signed in to change notification settings

thedtvn/MBBank

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

123 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MBBank API for Python

An unofficial, lightweight Python API wrapper for the "Military Commercial Joint Stock Bank" (MBBank) personal accounts.

Warning

This library is unofficial and not endorsed by MBBank. Use it at your own risk.

Features

  • Login: Authenticate with your MBBank credentials.
  • Balance: Check account balances.
  • Transaction History: Retrieve transaction history for your accounts.
  • Transfer: Perform money transfers to another account*.
  • Async Support: Includes asynchronous capabilities for better performance.

Note

Transfer feature requires MBBank APP on your phone to scan OTP code and confirm the transfer.

Installation

From PyPI

pip install mbbank-lib

From Source (Development Version)

pip install git+https://github.com/thedtvn/MBBank

Requirements

Quick Start

Here is a simple example of how to log in and fetch your account balance:

import mbbank

def main():
    username = "YOUR_USERNAME"
    password = "YOUR_PASSWORD"

    try:
        mb = mbbank.MBBank(username=username, password=password)
        
        # Get balance information
        balance_info = mb.getBalance()
        
        if balance_info.acct_list:
            print(f"Login successful! Found {len(balance_info.acct_list)} account(s).")
            for acct in balance_info.acct_list:
                print(f"Account: {acct.acctNo} - Balance: {acct.currentBalance} {acct.currency}")
        else:
            print("Login successful, but no accounts found.")

    except Exception as e:
        print(f"An error occurred: {e}")

if __name__ == "__main__":
    main()

For more examples, check the examples directory or docs

Documentation

For detailed documentation and FAQ, visit: http://mbbank.rtfd.io/

Related Projects

Donate

If you find this project helpful, you can support the developer:

  • Momo: 0961291206
  • ZaloPay: 0961291206
  • Banking:
    • Bank: Techcombank
    • Account Name: NGUYEN DUONG TUAN
    • Account Number: 9612912060
    • Nickname: THEDTVN

License

This project is licensed under the MIT License. See the LICENSE file for details.

About

An unofficial API wrapper for Vietnam Military Commercial Joint Stock Bank (MBBank, MB)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 5

Languages