Mojaloop Integration


This page describes the integration of OpenG2P with the Mojaloop switch enabling cash transfer from one bank (treasury bank, for instance) to an individual's bank account. The connection to Mojaloop is achieved via an intermediate interoperability layer implemented by a Payment Hub (PH).

Functional architecture

Below is the reference architecture of disbursements triggered from OpenG2P resulting in cash transfers.

Payment process

The beneficiary list is created on OpenG2P. After creating payment cycles and entitlements, payment batches are created for each cycle. A batch payment is triggered via the Payment Manager. This batch is received by the interoperability layer implemented by a Payment Hub (PH) and payments are orchestrated either in bulk or individually. The Payment Hub connects to the Mojaloop interface of the Digital Financial Service Provider (DSFP). DFSP1 takes the transaction forward with Mojaloop Switch.

Reconciliation at the OpenG2P end is done via status API calls to Payment Hub which is responsible for gathering payment status information of all transactions from DFSPs and Switch.

In the current integration, the account id of the payee is available in the OpenG2P registry and passed on to Payment Hub (hence propagated to Mojaloop). The account id of the payer is configured in the Payment Manager.

If Account Mapper is available as part of Digital Public Infrastructure, then the account id need not be stored in the OpenG2P registry.

Payment Hub

The payment architecture may vary from country to country. An interoperability layer like Payment Hub shields the downstream variations by offering a uniform payments API interface such that systems like OpenG2P do not have to modify the payment code, thus enabling interoperability with any payment system. Of course, customisation needs to be done on the Payment Hub, where a specific Payment Connector needs to be created specifically for the payment systems interface.

Payment Hub connects to Mojaloop via the Mojaloop Connector.

As part of the roadmap, OpenG2P is working towards supporting payment interfaces being defined as part of the G2P Connect initiative.

Payments demo

Source code

The source code for OpenG2P - Payment Hub integration can be found here.

Last updated


Copyright © 2024 OpenG2P. This work is licensed under Creative Commons Attribution International LicenseCC-BY-4.0 unless otherwise noted.