Class default

constructor

• new default(data): default

• Creates a new MB client instance.

  Parameters

  • data: {
        username: string;
        password: string;
        preferredOCRMethod?: "default" | "tesseract" | "custom";
        customOCRFunction?: ((image) => Promise<string>);
        saveWasm?: boolean;
    }

    Configuration options

    • username: string

      MB Bank login username (usually your registered phone number)

    • password: string

      MB Bank login password

    • Optional preferredOCRMethod?: "default" | "tesseract" | "custom"

      OCR method for captcha recognition

    • Optional customOCRFunction?: ((image) => Promise<string>)

      • • (image): Promise<string>

        • Custom OCR function (required if preferredOCRMethod is "custom")

          Parameters

          • image: Buffer

          Returns Promise<string>

    • Optional saveWasm?: boolean

      Whether to save the WASM file to disk

  Returns default

  Throws

  If username or password is not provided

  Example

  // Basic usage with default OCR
  const mbClient = new MB({
    username: '0123456789',
    password: 'your_password'
  });
  
  // Using Tesseract OCR
  const mbWithTesseract = new MB({
    username: '0123456789',
    password: 'your_password',
    preferredOCRMethod: 'tesseract'
  });
  
  // Using custom OCR function
  const mbWithCustomOCR = new MB({
    username: '0123456789',
    password: 'your_password',
    preferredOCRMethod: 'custom',
    customOCRFunction: async (image) => {
      // Your custom captcha recognition logic
      return recognizedText;
    }
  });
  Copy

Readonly username

Readonly password

sessionId

deviceId

client

login

• login(): Promise<LoginResponseData>

• Authenticates with MB Bank API by solving captcha and sending login credentials. Sets the session ID upon successful login.

  Returns Promise<LoginResponseData>

  Login response from the API

  Throws

  If login fails with specific error code and message

  Example

  const mb = new MB({
    username: '0123456789',
    password: 'your_password'
  });
  
  try {
    const loginResponse = await mb.login();
    console.log('Login successful!');
    console.log('Session ID:', mb.sessionId);
  } catch (error) {
    console.error('Login failed:', error.message);
  }
  Copy

getBalance

• getBalance(): Promise<undefined | BalanceList>

• Retrieves account balance information for all accounts.

  Returns Promise<undefined | BalanceList>

  Account balance data or undefined if request fails

  Example

  const mb = new MB({
    username: '0123456789',
    password: 'your_password'
  });
  
  async function getAccountInfo() {
    await mb.login();
    const balanceInfo = await mb.getBalance();
  
    if (balanceInfo) {
      console.log(`Total balance: ${balanceInfo.totalBalance} ${balanceInfo.currencyEquivalent}`);
  
      // Display each account's details
      balanceInfo.balances.forEach(account => {
        console.log(`Account: ${account.name} (${account.number})`);
        console.log(`Balance: ${account.balance} ${account.currency}`);
        console.log('---');
      });
    }
  }
  
  getAccountInfo().catch(console.error);
  Copy

getTransactionsHistory

• getTransactionsHistory(data): Promise<undefined | TransactionInfo[]>

• Retrieves transaction history for a specific account within a date range.

  Parameters

  • data: {
        accountNumber: string;
        fromDate: string;
        toDate: string;
    }

    Request parameters

    • accountNumber: string

      MB Bank account number to query

    • fromDate: string

      Start date in format "DD/MM/YYYY" or "D/M/YYYY"

    • toDate: string

      End date in format "DD/MM/YYYY" or "D/M/YYYY"

  Returns Promise<undefined | TransactionInfo[]>

  Array of transaction details or undefined if request fails

  Throws

  If date range exceeds 90 days or date format is invalid

  Example

  const mb = new MB({
    username: '0123456789',
    password: 'your_password'
  });
  
  async function getLastMonthTransactions() {
    await mb.login();
  
    // Get account first
    const balanceInfo = await mb.getBalance();
    if (!balanceInfo?.balances?.length) {
      console.log('No accounts found');
      return;
    }
  
    const accountNumber = balanceInfo.balances[0].number;
  
    // Get transactions for the last 30 days
    const today = new Date();
    const lastMonth = new Date();
    lastMonth.setDate(today.getDate() - 30);
  
    const fromDate = `${lastMonth.getDate()}/${lastMonth.getMonth() + 1}/${lastMonth.getFullYear()}`;
    const toDate = `${today.getDate()}/${today.getMonth() + 1}/${today.getFullYear()}`;
  
    const transactions = await mb.getTransactionsHistory({
      accountNumber,
      fromDate,
      toDate
    });
  
    if (transactions) {
      console.log(`Found ${transactions.length} transactions`);
  
      transactions.forEach(tx => {
        const amount = tx.creditAmount || tx.debitAmount;
        const type = tx.creditAmount ? 'CREDIT' : 'DEBIT';
  
        console.log(`${tx.transactionDate} | ${type} | ${amount} ${tx.transactionCurrency}`);
        console.log(`Description: ${tx.transactionDesc}`);
        if (tx.toAccountName) {
          console.log(`To: ${tx.toAccountName} (${tx.toAccountNumber}) at ${tx.toBank}`);
        }
        console.log('---');
      });
    }
  }
  
  getLastMonthTransactions().catch(console.error);
  Copy