Data Migration Overview
  • 17 Mar 2022
  • 3 Minutes To Read
  • Dark
    Light
  • PDF

Data Migration Overview

  • Dark
    Light
  • PDF

This section describes how to import and export existing data into and out of Mambu.

Importing data

The main steps for importing data into Mambu are:

  1. Carry out the required preliminary steps described in Prerequisites below.
  2. Plan and schedule your migration. For an API-based migration, contact your onboarding consultant for planning assistance.
  3. Extract the data from your legacy system.
  4. Prepare your data for submission to Mambu.
  5. Submit your data to Mambu using one or both of these methods:
    • Via the Mambu APIs (recommended)
    • Using a provided Excel template
  6. Mambu automatically validates your submission.
  7. Review your submission, and make any necessary corrections.
  8. Confirm your import to complete the migration.

All of these steps are described further below.

We recommend using the Mambu API, or using the API in addition to using the Excel-based import. Migration with our Excel template does not support some common cases, including:

  • Importing Dynamic Loan Schedules or Revolving Credit Loans.
  • Specifying a penalty rate per account at import.
  • Importing deposit accounts with different interest rates - all deposit accounts imported with Excel sheets use the Deposit Product default interest rate.
  • Importing Deposit Transactions, only the current balance.

Despite these limitations, there are cases where it is better or easier to import data via Excel, such as when your old systems export data in a CSV file. Many of the limitations with the Excel method can be addressed using our APIs after the initial import. If, on the other hand, you will be retrieving data from your legacy system using an API, it is usually easier to migrate via API.

Generally speaking, you are responsible for preparing your data for import, but we do provide some assistance. When importing via Excel, we provide a template sheet and detailed instructions for how to enter data.

If you are planning to migrate via API, please contact your onboarding consultant to request support. They can work with you to help determine the best strategy and APIs to use, depending on your needs. For more information on how to contact your onboarding consultant, see Importing your Data via API - What We'll Need from You.

Be sure to plan your migration carefully. Based on the amount of legacy data you have, it can take time. If your organization is already live, we strongly recommend planning to reduce the risk of any performance impact, such as scheduling migration after business hours when possible.

No migration process is risk-free, so be sure that all of your data is appropriately backed up during the process.

Import prerequisites

Please be Aware

The following steps are required before beginning migration.

In order to migrate data into Mambu, the following setup steps must be completed. These steps ensure that the necessary structure is in place for your data to be imported into our systems.

Completing this setup in advance allows us to assign all imported clients and groups to the appropriate branches and credit officers, to fill all necessary custom fields, and to assign all accounts to the appropriate products.

For more instructions on importing data into Mambu, see the remaining pages of this section.

Exporting data

Mambu users may download their entire data set at any time by performing a database dump using either the Mambu UI or Mambu API.

Please be Aware

For large databases, we strongly recommend using the API instead of the Mambu UI. You may experience technical issues exporting data using the Mambu UI for large data sets, such as receiving a 504 Gateway Timeout status code.

Exporting data with the Mambu UI

To export your data using the UI:

  1. Ensure that Data Export is enabled for your tenant by checking the feature list in the Administration menu.
  2. Go to Administration > Data.
  3. Select Export Your Data.
  4. Select Download Database.

To see the process in action, check out our demo video, below.



Please be Aware

The export process will take some time depending on the size of your data set. You will receive a notification when the process is complete so you can safely navigate away from the page and carry on with your work while the backup is generated.

Exporting data with the API

To export your data using the API, follow the instructions in Database Backups.


Was This Article Helpful?