Industry Sim Swap Service

Introduction

This service was developed for the entire financial industry of Nigeria to be able to verify the SIM swap status of mobile subscribers to determine SIMs that have been swapped, recycled etc. This was developed in response to the alarming fraud rate occurring making transactions from a customer’s mobile device, in addition to the CBN’s guidelines on mobile payments most especially via the USSD channel.

This specification document details a service interface that will always be available for the client’s use at any time, where client can be the Deposit Money Banks (DMBs), Other Financial Institutions (OFIs), mCash, Other Third Parties etc.

The exchanged messages are all encrypted with AES encryption algorithm using an api key that will be generated for each bank and can be reset by each bank subsequently.

General Flow

This interface is implemented as a Restful service which exposes four methods: Ping, Reset, Login and GetSIMSwapStatus. The data exchanged during these service calls is json format. The image below depicts the communication between the Client, the SIM Swap Service and the Telco.

Endpoint URL

http://ADVISED-IP/simswap-central/api/

The ADVISED-IP for both test and production will be provided at the point of integration and deployment respectively