Skip to content

Add DFSP Onboarding Playbook toolkit and templates #542

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open

Add DFSP Onboarding Playbook toolkit and templates #542

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b13510a
Add DFSP Onboarding Playbook toolkit and templates
PaulMakinMojaloop Nov 6, 2025
28f7d8b
Update package-lock.json
PaulMakinMojaloop Nov 6, 2025
0e69cae
Rename DFSP Onboarding Playbook directory for consistency
PaulMakinMojaloop Nov 6, 2025
70eb8bc
Update DFSP onboarding docs and remove playbook files
PaulMakinMojaloop Nov 6, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/.vuepress/config.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1152,7 +1152,7 @@ module.exports = {
['features/use-cases', 'Use Cases'],
['features/transaction', 'Transactions'],
['features/risk', 'Risk Management'],
['features/connectivity', 'Connectivity Support'],
['features/connectivity', 'DFSP Onboarding'],
['features/product', 'Portals and Operational Features'],
['features/tariffs', 'Fees and Tariffs'],
['features/performance', 'Performance'],
Expand Down
20 changes: 17 additions & 3 deletions docs/product/features/connectivity.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,20 @@
# Connectivity
# DFSP Onboarding

In principle, having developed and documented the [Mojaloop APIs](./transaction.md#Mojaloop APIs), this should be sufficient to enable DFSPs to connect to a Mojaloop Hub. However, as part of the Mojaloop Community's mission to address financial inclusion, it has long been felt that the key to minimising the cost and complexity of connecting a DFSP's back office to a Mojaloop Hub is through the provision of a portfolio of connectivity solutions, allowing a DFSP to select the approach that best meets their needs.
In principle, having developed and documented the [Mojaloop APIs](./transaction.md#Mojaloop APIs), this should be sufficient to enable DFSPs to connect to a Mojaloop Hub. However, as part of the Mojaloop Community's mission to address financial inclusion, it has long been felt that the key to minimising the cost and complexity of connecting a DFSP's back office to a Mojaloop Hub is through the provision of a portfolio of connectivity solutions, allowing a DFSP to select the approach that best meets their needs. These are supplemented by a DFSP Onboarding Playbook, encapsulating the business processes that are needed to onboard a DFSP.
## Business Onboarding
There are many steps needed in the onboarding of a DFSP to a Mojaloop Hub that are nothing to do with technology, and these are addressed in the DFSP Onboarding Playbook.

This playbook, which has been donated by Thitsaworks, comprises a set of tools and templates to assist with the planning and execution of a Mojaloop deployment, specifically focusing on DFSP onboarding. The tools are:
- A workplan template, including samples used in past deployments;
- An example end to end test case, in this case for payee-side DFSP integration;
- A Technical assessment form, used to define the technical assistance required by candidate DFSPs;
- A technical onboarding checklist;
- An API mapping template, used to map between Mojaloop Hub API elements and the corresponding actions required by the DFSP's back office;
- A plan for the setup of the security of the DFSP's connection to the Mojaloop Hub.

You can [download the Thitsaworks DFSP Onboarding Playbook by clicking on this link](https://drive.google.com/drive/folders/198J65_WtneNV3CsF-M82g7zJqnxfmO9p?usp=sharing).

## Technical Onboarding
The current connectivity portfolio includes a toolkit that would allow a Systems Integrator (SI) to create a connection by combining the various elements of a toolkit in a way that best meets the DFSP's needs. These elements include:
- Mojaloop Connection Manager (MCM);
- Mojaloop Connector (for integrating with the Mojaloop Hub);
Expand All @@ -25,11 +38,12 @@ Note that the adoption of an exemplar installation affects the type of service a

## Applicability

This version of this document relates to Mojaloop Version [17.0.0](https://github.com/mojaloop/helm/releases/tag/v17.0.0)
This version of this document relates to Mojaloop Version [17.1.0](https://github.com/mojaloop/helm/releases/tag/v17.1.0)

## Document History
|Version|Date|Author|Detail|
|:--------------:|:--------------:|:--------------:|:--------------:|
|1.3|6th November 2025| Paul Makin|Linked to Thitsaworks' DFSP Onboarding Playbook|
|1.2|9th June 2025| Tony Williams|Added reference to participant feature matrix|
|1.1|14th April 2025| Paul Makin|Updates related to the release of V17|
|1.0|5th February 2025| Paul Makin|Initial version|
62 changes: 33 additions & 29 deletions package-lock.json
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 2 additions & 2 deletions package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,10 +24,10 @@
"devDependencies": {
"@vuepress/plugin-back-to-top": "^1.9.10",
"@vuepress/plugin-medium-zoom": "^1.9.10",
"got": "^14.5.0",
"got": "^14.6.2",
"husky": "^9.1.7",
"markdownlint-cli": "^0.45.0",
"npm-check-updates": "^19.0.0",
"npm-check-updates": "^19.1.2",
"plantuml-encoder": "^1.4.0",
"svgo": "^4.0.0",
"vuepress": "^1.9.10",
Expand Down