API Overview

MFS Africa has two main sets of APIs:

  • The Hub APIs
  • The Beyonic APIs

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

📘

Beyonic or Hub. What's the difference?

  • Beyonic 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 Beyonic and the MFS Africa Hub provide APIs. Whether you use Beyonic's 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 Beyonic 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 Beyonic APIs

The Beyonic 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 Beyonic 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 Beyonic 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 Beyonic account including Transactions, Currencies, Networks, Banks, Events, and more.


What’s Next

Click on for help choosing between these APIs