API Overview

MFS Africa has two main sets of APIs:

  • The Hub APIs
  • The Enterprise APIs

Each set of APIs provides different ways to access MFS Africa's services.


Enterprise or Hub. What's the difference?

  • Enterprise has a web-based portal that enables connection to the MFS Africa Hub without the need to do a technical integration.

  • On the other hand, in order to connect directly to the MFS Africa Hub, you need a software engineer to do the integration.

Both Enterprise and the MFS Africa Hub provide APIs. Whether you use the Enterpirse APIs or the MFS Africa Hub APIs, your payments will go through the MFS Africa Hub.

For some use-cases, you can use either set of APIs, while other use-cases can only be achieved using one API set. Specifically, if you want to send bulk payments to subscribers, you could use either the Hub APIs or the Enterprise APIs.

Read on to learn about each set of APIs and choose the one best suited for your use-cases.

The Hub APIs

MFS Africa operates a Payments Hub that is connected to banks, mobile network operators, and agent networks across Africa - our Partners.

In order to access these partners, you connect to the Payments Hub via the Hub APIs.

The Hub APIs enable you to connect directly to the Payments Hub.

The Hub APIs include:

  1. Asynchronous Payments API
    For Money Transfer Organizations (MTOs) and other general types of disbursement partners.

  2. Asynchronous Webhooks API
    Works with the Asynchronous Payments API to deliver Instant Payment Notifications (IPNs)

  3. Synchronous Payments API
    Tailor-made for Mobile Network Operators (MNOs)

  4. Synchronous Bank Transfer API
    For transferring funds to banks.

  5. Get Rates API
    For programmatic access to MFS Africa's daily forex exchange rates

The Enterprise APIs

The Enterprise Platform is an MFS Africa product that provides a web-based portal that customers can use to send and receive payments via the MFS Africa Hub.

The Enterprise portal allows customers to access MFS Africa's services without the need for writing any custom software. The portal also provides various self-serve tools for managing the payment process and accessing payment analytics and reports. Learn more.

As shown above, the Enterprise Platform also provides APIs that can be used to access MFS Africa's services.

These include:

  1. Bulk Payments API
    For issuing funds disbursement instructions and accessing previously issued disbursement instructions.

  2. Collection Requests API
    For requesting funds from subscribers and accessing previously issued requests.

  3. Collections API
    For retrieving information on funds previously collected from subscribers (whether via the collection request API or via other means)

  4. Contacts API
    For adding or accessing subscriber data

  5. Other data access APIs
    For accessing other data within your Enterprise account including Transactions, Currencies, Networks, Banks, Events, and more.

What’s Next

Click on for help choosing between these APIs