Developers – Songhai Exchange

Developers

Songhai Exchange Documentation

OVERVIEW

SHE Developers’page offers the support, information and expertise that you need to make cost-effective payments into and around Africa. Our comprehensive documentation and guide helps you explore our products and features, which gets you integrated with us as soon as possible.

Get Started

All the information you need to get started with the API

Work Flow

Read our functional guides on how to code for specific tasks

Tech Support

Get in touch for support from our development team

Services

Bank Transfer and
Cash Pick-up

Mobile Airtime
Top-up

Mobile Money

Bill Payment

E-wallet and
Borderless Banking

Merchant
Product Payment

Agency Banking
Management

Payout Network

GET STARTED

STEP 1: Read the documentation

We suggest that you read the API Doc to get familiar with the API components

STEP 2: Sign Up for API

Request access to the API by filling the form button below. This will give you access to log into and create your TEST API key.

Fill the form below to sign up

STEP 3: Use the TEST API

The TEST API is connected to our TEST environment, which calls real data but executes trades in a TEST environment and does not execute LIVE payments.

STEP 4: Start LIVE transactions with SHE

Contact us to discuss opening a LIVE account. We recommend you talk to us at the start of your project so that we can advise you on the best direction to take to be fully integrated with SHE from a technical and compliance point of view. We will also take you through the on-boarding process and run any testing that is required to get you up and running. This includes getting your API key for access to the LIVE environment.

STEP 5: Commence Payments

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

1. 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.

2. 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.

3. Get a list of biller items linked to a biller

Endpoint

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

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

The API Endpoints

1. Validate PCN and lock for Pay-out

Endpoint

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

For Example

https://she.themoneytransferapplication.com:9090/cashpickup/validateCashPickupPcnAndLockForPayout

2. Mark Cash Pickup

Endpoint

https://she.themoneytransferapplication.com:9090/swagger-ui.html#/cash-pick-up-service/markCashPickupAsPaidOutUsingPOST

For Example

https://she.themoneytransferapplication.com:9090/cashpickup/markCashPickupAsPaidOut

3. Unlock Cash Pickup

Endpoint

https://she.themoneytransferapplication.com:9090/swagger-ui.html#/cash-pick-up-service/unlockCashPickupUsingPOST/span>

For Example

https://she.themoneytransferapplication.com:9090/cashpickup/unlockCashPickup

TECH SUPPORT

Fill the form below to sign up