Developers

Songhai Exchange Documentation

Developers > Workflow

Workflow

Songhai Exchange is a platform that connects organisations directly with trusted African banking and pay-out partners. It provides a simple access point for all of your payments, with complete transparency on pricing. It provides various services and there are different Api endpoints for the services provided.

Find below some of the services, with their description, Api endpoints and the flow:

Bill Payment Workflow

The Bill payment service can be used for bill payment transactions; it can be used to view billers, products and to select a product to be paid for. Below is a sequence diagram for the bill payment process;

The API Endpoints

Get a list of bill payment categories in a country

Endpoint

https://she.themoneytransferapplication.com:9090/swagger-ui.html#/gate-way service/executeBillPaymentCategoryUsingPOST

For Example

https://she.themoneytransferapplication.com:9090/gateway/billPaymentCategory

This above endpoint returns the list of categories specific to a country and transaction type.

Get the list of billers linked to a category

Endpoint

https://she.themoneytransferapplication.com:9090/swagger-ui.html#/gate-way service/executeBillPaymentBillersUsingPOST

For Example

https://she.themoneytransferapplication.com:9090/gateway/billPaymentBillers

This above endpoint returns the list of billers under a specific category in a country. The service_id is obtained from the request in step 1.

Get a list of biller items linked to a biller

Endpoint

https://she.themoneytransferapplication.com:9090/swagger-ui.html#/gate-way-service/executeBillPaymentBillerItemsUsingPOST

For Example

https://she.themoneytransferapplication.com:9090/gateway/billPaymentBillerItems

This above endpoint returns the list of products under a category and biller in a specific country. The service_id and operator_id are gotten from the requests in step 1 and 2.

Transaction Service

The transaction management service is a gateway service used to manage transactions such as bank transfer and mobile money transactions. Below is a sequence diagram for the transaction process
Songhai Exchange