# 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/

{% hint style="info" %}
***The ADVISED-IP for both test and production will be provided at the point of integration and deployment respectively***
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://testdocs.nibss-plc.com.ng/simswap/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.