2. Sign in and tap the API button shown on the home screen as shown in the image to the left.

3. The enable API screen will load up and offer you a green button to enable API. Tap this button and we proceed to creating and enabling API services for your account.

Step 1 – Fill in your Information

• Name – This can be your brand or company name.
• Description – Please describe why you need the API and what you will be using it for.
• website – The URL to your website
• IPN URL – Whenever a transaction is confirmed, this is the url that will be posted to with transaction details. IPN – stands for Instant Payment Notification. You will have to provide us a callback (ipn) url to notify your system when payments are made.
• PIN – Please enter your easypay PIN to confirm enabling your API.

Using instant payment notification model, all your transactions should be marked as pending and only be marked as confirmed from this notification. It is also known as the callback url.

After you click save, your API will be enabled and live. You will be given a client Key and client Password that you will need for authenticating the API functions below.

This is the API clientId that you are given within app after you enable API. see above

password

action

provider

paybillbundles

This method returns a list of supported areas supported by NWSC. You are supposed to display these to the user giving him a choice to choose his location.

POST URL: https://www.easypay.co.ug/api/

• action – This leave as ‘paybillbundles’
• provider – This this the provider you are quering. In this case, leave as nwsc.

Success Result

{
"data": [
"Kampala",
"Entebbe",
"Iganga",
"Jinja",
"Kajjansi",
"Kawuku",
"Mukono",
"Others"
],
"success": 1
}

Failure Result

{
"success": 0,
"errormsg": "This method is not supported by this provider"
}

paybilladvice

This method is called when a user wants to check and validate the users provided account number.

POST URL: https://www.easypay.co.ug/api/

• action – This leave as ‘paybilladvice’
• provider – This this the provider you are quering. In this case, leave as nwsc.
• account – NWSC account number
• location – Supported location picked from paybillbundles above.

Success Result

{
"success": 1,
"data": {
"outstanding": "2972",
"type": null,
"CustomerId": "21.....",
"CustomerName": "REHE... NGO"
},
"charge": 330
}}

Failure Result

{
"success": 0,
"errormsg": "INVALID CUSTOMER REFERENCE"
}

paybill

This method is called when a user wants to pay the actual bill in this case nwsc.

POST URL: https://www.easypay.co.ug/api/

• action – This leave as ‘paybill’
• provider – This this the provider you are quering. In this case, leave as nwsc.
• account – nwsc account number
• amount – The amount you wish to pay
• phone – This is the phone number where your receipt will be sent.
• location – This is the location the user picked in step 1
• reference – Your order reference. it will be returned in successful results and can be used for reconciliation later on. This value must be unique.

Success Result

{
"success": 1,
"details": {
"phone": "0787.....",
"account": "2114...",
"amount": "1000",
"easypayId": "5345351",
"transferCode": "0424xxx-NWSC834561",
"type": "",
"reference":"Your order ref",
"date": "2018-10-27 13:10:28"
},
"data": "Your payment of NSWC has been accepted. Customer Ian K.... Account: 2114... Tel: 0787... Amount: UGX 1,000 Charge: UGX 95 etc"
}

Failure Result

{
"success": 0,
"errormsg": "Insufficient balance"
}

paybillstatus

This method is called when a user wants to pay find out the current status of bill against the reference they provided above. It can be used for auto-reconciliation. In response take note of the status property. It tells you the status of order. Incase of ‘Success’ it also return order receipts.

POST URL: https://www.easypay.co.ug/api/

• action – This leave as ‘paybillstatus’
• provider – This this the provider you are quering. In this case, leave as nwsc.
• reference – Your order reference.

Success Result

{
"success": 1,
"data": {
"status": "Success",
"data": {
"data": "837761XX",
"transferCode": "0424XXX-NWSC8463157",
"charge": 330,
"success": 1,
}
}
}

Failure Result

{
"success": 0,
"errormsg": "Cannot find reference provided"
}

checkbalance

This method is called you want to know your current balance at easypay. You can use this method to notify you that your balance is running low. That way you can ensure you do not run out of float.

POST URL: https://www.easypay.co.ug/api/

Success Result

{
"success": 1,
"data": "14129.9",
"currencyCode": "UGX"
}

Failure Result

{
"success": 0,
"errormsg": "something went wrong"
}