API Documentation

 

ePINs API Documentation

 

ePINs Nigeria API allows you to easily integrate bill payment services available on the epins.com.ng platform on your mobile or web application.

 

To initiate API Call, you will need to send a GET request to the endpoint below;
Endpoint:
https://api.epins.com.ng/core
or copy and paste in browser to get base URL

HTTP Method: GET

All Requests and Responses are in json format

Airtime VTU API Integration

VTU Airtime API Integration

This section contains your RESTful API for Airtime VTU API integration.

 

Authentication

The ePINs API uses API Key for Authentication.

Please use the following details for authentication

Apikey = kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM

API Key: Your Gateway API Key

Please create your API key here Create API Key

 

Purchase products

Airtime VTU services can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/airtime/

Network: as specified in the parameters below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
network R String Network as specified. These includes, mtn, airtel, glo, etisalat
phone R Number The phone number to receive the airtime
amount R Number The amount you wish to recharge
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

{"code":101,
"description":{"response_description":"TRANSACTION SUCCESSFUL",
"ref":"884666332234","amount":"100",
"transaction_date":"2020-04-17 07:04:19"
}}

Bulk Airtime VTU API Integration

Bulk Airtime VTU API Integration

This section contains your RESTful API for Bulk Airtime VTU API integration.

 

Authentication

The ePINs API uses API Key for Authentication.

Please use the following details for authentication

Apikey = kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM

API Key: Your Gateway API Key

Please create your API key here Create API Key

 

Purchase products

Airtime VTU services can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/bulkairtime/

Network: as specified in the parameters below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
variation R String Airtime variations as specified. Variation should be in the format below, 08034893982=100,08023909941=200,08058938938=500.
Please note: Variations should be comma separated.
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

{"code":101,"description":
{"response_description":"TRANSACTION SUCCESSFUL", 
"ref":"0826967791501483","amount":50,
"amount_paid":47.5,"transaction_date":"2024-09-04 02:37:56pm",
"product_name":"Bulk Airtime"
}}

Recharge Card PINs Generator API Integration

Recharge Card PINs API Integration

This section contains your RESTful API for Recharge card PIN Generator API integration.

 

Authentication

The ePINs API uses API Key for Authentication.

Please use the following details for authentication

Apikey = kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM

API Key: Your Gateway API Key

Please create your API key here Create API Key

 

Purchase products

Recharge card PIN services can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/epin/

Network: as specified in the parameters below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String service name as specified. This should be, epin
network R String Network as specified. These includes, mtn, airtel, glo, etisalat
pinDenomination R Number The denomination of pin to generate. These includes,

Denominations

Service variation

100

1

200

2

400

4

500

5

750

7.5

1000

10

1500

15
pinQuantity R Number The number of pins to generate
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

    {"code":101,
    "description":{
    "status":"TRANSACTION SUCCESSFUL",
    "PIN":"0000009150973272559492072143270930000000100BC\r",
    "network":"mtn",
    "pinDenomination":"100",
    "pinQuantity":1,
    "product_name":"MTN PIN 100(1)",
    "TransactionDate":"2024-09-13 12:33:25am",
    "direct_pin":{
    "serial":"00000091509732725",
    "pin":"5949-2072-1432-7093-0"
    }}}

DATA CARD API Integration

Purchase DATA CARD

DATA CARD services can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/datacard/

Request Method: POST

Network: as specified in the parameters below;

Network

Service variation
MTN
01

Airtel

04

9Mobile

03

Glo

02

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Service id should be datacard.
network R String Network as specified in the service variation above.
pinQuantity R Number The number of DATA CARD PINs to generate
DataPlan R Number The Data plan variation. See plan code column in the table below;
Network Plan plancode Amount
01 1GB (DC) - 30days 105 ₦255
01 1.5GB (DC) - 30 Days 1500 ₦340
01 2GB (DC) - 30days 527 ₦450
01 3GB (DC) - 30days 58 ₦885
01 5GB (DC) - 30days 94 ₦1475
₦
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

 {
    "code": 101,
    "description": {
        "status": "TRANSACTION SUCCESSFUL",
        "PIN": "808346012S\n541093716S\n",
        "network": "MTN",
        "pinDenomination": "1500",
        "pinQuantity": "2",
        "product_name": "MTN DATACARD 1.5 GB ",
        "TransactionDate": "2023-03-19 03:12:PM"
    }
}

MTN Share Airtime API Integration

MTN Share Airtime API Integration

This section contains your RESTful API for MTN Share Airtime API integration.

 

Authentication

The ePINs API uses API Key for Authentication.

Please use the following details for authentication

Apikey = kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM

API Key: Your Gateway API Key

Please create your API key here Create API Key

 

Purchase products

MTN Share Airtime services can be purchased with the endpoint below:

Endpoint URL:{{baseurl}}/mshare/

Network: as specified in the parameters below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
phone R Number The phone number to receive the airtime
amount R Number The amount you wish to recharge
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

{"code":101,
"description":{"response_description":"TRANSACTION SUCCESSFUL",
"ref":"884666332234","amount":"100",
"transaction_date":"2020-04-17 07:04:19"
}}

Universal Airtime API Integration

Universal Airtime API Integration

This section contains your RESTful API for universal airtime API integration.

 

Authentication

The ePINs API uses API Key for Authentication.

Please use the following details for authentication

Apikey = kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM

API Key: Your Gateway API Key

Please create your API key here Create API Key

 

Purchase Airtime

Airtime VTU services can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/onecard/

Network: as specified in the parameters below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
phone R Number The phone number to receive the airtime
amount R Number The amount you wish to recharge
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

{"code":101,
"description":{"response_description":"TRANSACTION SUCCESSFUL",
"ref":"884666332234","amount":"100",
"transaction_date":"2020-04-17 07:04:19"
}}

Electricity Payment API Integration

Electricity Payment API Integration

This section contains your RESTful API for Electricity Payment API integration.

 

Authentication

The ePINs API uses API Key for Authentication.

Please see the following sample API key for authentication

Apikey = kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM

API Key: Your Gateway API Key

Please create your API key here Create API Key

 

VALIDATE METER NUMBER

You can validate meter number with the following endpoint:

Endpoint URL: {{baseurl}}/merchant-verify/

Endpoint URL: {{baseurl}}/electric-verify/

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Service as specified. These includes, ikeja-electric, eko-electric, portharcourt-electric, jos-electric, kano-electric, ibadan-electric, enugu-electric, abuja-electric,benin-electric

smartNo R Number The meter number to load the electricity token
type R String This is the meter type. Example: prepaid or postpaid

 

EXPECTED RESPONSE

{
    "code": 119,
    "description": {
        "Customer": "PAUL BECKY",
        "Address": "ELEME - PORTHARCOURT",
        "MeterNumber": "1022101199113"
    }
}

 

Generate Token

This endpoint allows you to generate electricity token using meter number.

Endpoint URL: {{baseurl}}/biller/

Service: as specified in the fields below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Service as specified. These includes, ikeja-electric, eko-electric, portharcourt-electric, jos-electric, kano-electric, ibadan-electric,benin-electric
accountno R Number The meter number to load the electricity token
vcode R String This is the meter type. Example: prepaid or postpaid
amount R Number The amount of electricity token you want to buy
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

{"code":101,
"description":{"Status":"TRANSACTION SUCCESSFUL",
"Token":"40364652026905256691",
"Units":"500 kWh",
"meterNumber":"100221233",
"product_name":"Ikeja Electric Payment - PHCN"
	
    }
}

TV Payment API Integration

TV Payment API Integration

This section contains your RESTful API for TV Payment API integration.

 

Authentication

The ePINs API uses API Key for Authentication.

Please see the following sample API key for authentication

Apikey = kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM

API Key: Your Gateway API Key

Please create your API key here Create API Key

 

GET VARIATION CODES

Using a GET method, the ePINs variation codes for GOTV,DSTV, Startimes bouquets can be accessed with the endpoint below:

GOTV Variations: {{baseurl}}/variations/?service=gotv
DSTV Variations: {{baseurl}}/variations/?service=dstv
Startime Variations: {{baseurl}}/variations/?service=startimes

View Gotv variation code View Dstv variation code View Startimes variation code

 

VALIDATE SMARTCARD/IUC NUMBER

You can validate smartcard/IUC number with the following endpoint:

Endpoint URL: {{baseurl}}/merchant-verify/

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Service as specified. These includes, dstv, gotv, startimes
smartNo R Number The smartcard or IUC number to make the subscription on
type R String same as service parameter.

 

EXPECTED RESPONSE

{"code":119,
"description":{"Customer":"PAUL BECKY",
"Due_Date":"2019-07-23T00:00:00",
"Status":"Open"
	}
}

 

Recharge Decoder

This endpoint allows you to recharge GOTV/DSTV/Startimes decoder using it’s smartcard/IUC number.

Endpoint URL: {{baseurl}}/biller/

Service: as specified in the fields below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Service as specified. These includes, dstv, gotv, startimes
accountno R Number The smartcard or IUC number to make the subscription on
vcode R String This is the meter type. Example: prepaid or postpaid
amount R Number The amount of electricity token you want to buy
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

{"code":101,
"description":{"response_description":"TRANSACTION SUCCESSFUL",
"ref":"884666332234","amount":"100",
"transaction_date":"2020-04-17 07:04:19"
}}

Smile Payment API Integration

Smile Payment API Integration

This section contains your RESTful API for TV Payment API integration.

 

Authentication

The ePINs API uses API Key for Authentication.

Please see the following sample API key for authentication

Apikey = kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM

API Key: Your Gateway API Key

Please create your API key here Create API Key

 

VALIDATE SMILE ACCOUNT NUMBER

You can validate Smile number with the following endpoint:

Endpoint URL: {{baseurl}}/merchant-verify/smile/

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Service as specified. These includes, smile-direct
email R String The Smile account email to make the subscription on

 

EXPECTED RESPONSE

{"code":119,
"description":{"Customer":"PAUL BECKY",
"Due_Date":"2019-07-23T00:00:00",
"Status":"Open"
	}
}

 

Topup Smile Account

This endpoint allows you to recharge Smile account using smile number.

Endpoint URL: {{baseurl}}/smile/

Service: as specified in the fields below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Service as specified. Example, smile-direct
accountno R Number The Smile accountId from smile validation response to make the subscription on
vcode R String This is the variation code for smile plans.
View variations code
amount O Number The amount to recharge
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

    {"code":101,"description":{"Status":"successful",
    "ProductName":"SMILE 1GB FlexiDaily for 1days - 330 Naira",
    "Network":"smile",
    "TransactionRef":"SmD2024014410002",
    "Date":"2024-01-12 11:27:24am"}}

Betting Payment API Integration

Betting Payment API Integration

This section contains your RESTful API for Betting Payment API integration.

 

Authentication

The ePINs API uses API Key for Authentication.

Please see the following sample API key for authentication

Apikey = kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM

API Key: Your Gateway API Key

Please create your API key here Create API Key

 

VALIDATE Betting ACCOUNT NUMBER

You can validate Betting Account number with the following endpoint:

Endpoint URL: {{baseurl}}/bet-verify/

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
customerId R Number The Betting customer number to make the payment to
service R String Betting Service network as specified.
View Network variations

 

EXPECTED RESPONSE

{"code":200,
"description":{"Customer":"PETER OKOJE","ServiceName":"Bet9ja",
"reference":"hc7c9fd5064e13bsaed6fb1764cf",
"accountNumber":null,"discount":0.1 }}

 

Topup Betting Account

This endpoint allows you to topup Betting account using Customer ID.

Endpoint URL: {{baseurl}}/betting/

Service: as specified in the fields below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Betting Service network as specified.
View Network variations
customerId R Number The Betting customer Number to make the payment on
reference R String The reference number generated during betting account validation
amount R Number The amount to credit on betting account
customerName R String Customer Name generated during Betting account validation
request_id R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

    
   {"code":101,
   "description":{"Status":"successful","CustomerId":"0000111",
   "Reference":"b3933x4455cca61efe7be23",
   "CustomerName":"PETER OKOJE",
   "product_name":"Bet9ja",
   "amount":"50000",
   "TransactionRef":"20039920240144d449",
   "Date":"2024-01-02 04:41:42pm"}}

SME Data Topup API Integration

Purchase SME Data

SME Data services can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/data/

Request Method: POST

Network: as specified in the parameters below;

Network

Service variation
MTN
01

Airtel

04

9Mobile

03

Glo

02

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Network as specified in the service variation above.
MobileNumber R Number The phone number to receive the SME Data
DataPlan R Number The SME Data plan Variation code.
View variation code
Network Plan plancode Amount
01 1GB (SME) - 30days 1000 ₦259
01 500MB (SME) - 30days 500 ₦128
01 2GB (SME) - 30days 2000 ₦518
01 3GB (SME) - 30days 3000 ₦777
01 5GB (SME) - 30days 5000 ₦1295
01 10GB (SME) - 30 days 10000 ₦2590
03 1GB (SME) - 30days 1000.01 ₦305
03 2GB (SME) - 30days 13 ₦610
03 2.5GB (SME) - 30days 2500.01 ₦508
03 3GB (SME) - 30days 244 ₦915
03 4GB (SME) - 30days 4000.01 ₦1220
03 5GB (SME) - 30days 5500.01 ₦1525
03 6GB (SME) - 30days 60 ₦1218
03 10GB (SME) - 30days 110 ₦3050
03 15GB (SME) - 30days 15000.01 ₦3045
03 20GB (SME) - 30days 38 ₦4060
03 25GB (SME) - 30days ₦5075
03 30GB (SME) - 30days ₦6090
03 40GB (SME) - 30days ₦8120
03 50GB (SME) - 30days ₦10150
03 100GB (SME) - 30days ₦20300
03 1.5GB 151 ₦450
₦
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

{"code":101,
"description":{"response_description":"TRANSACTION SUCCESSFUL",
"ref":"884666332234","amount":"100",
"transaction_date":"2020-04-17 07:04:19"
}}

CG LITE Data Topup API Integration

Purchase CGLITE Data

CG LITE Data services can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/data/

Request Method: POST

Network: as specified in the parameters below;

Network

Service variation
MTN
01

Airtel

04

9Mobile

03

Glo

02

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Network as specified in the service variation above.
MobileNumber R Number The phone number to receive the Data
DataPlan R Number The CG LITE Data plan Variation code.
View variation code
Network Plan plancode Amount
01 1GB (CG_LITE) 210 ₦256
01 2GB (CG_LITE) 211 ₦512
01 3GB (CG_LITE) 212 ₦768
01 5GB (CG_LITE) 213 ₦1280
01 10GB (CG_LITE) 214 ₦2560
01 50GB (CG_LITE) 221 ₦12800
₦
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE


    {"code":101,
    "description": {"Status":"successful",
    "ProductName":"MTN 1GB (CG_LITE)","Network":null,
    "TransactionRef":"3807689167291450",
    "Date":"2023-06-28 12:32:PM"}}

Direct Data Topup API Integration

Purchase Direct Data

Direct Data services can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/data/

Request Method: POST

Network: as specified in the parameters below;

Network

Service variation
MTN
01

Airtel

04

9Mobile

03

Glo

02

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Network as specified in the service variation above.
MobileNumber R Number The phone number to receive the Data
DataPlan R Number The Direct Data plan Variation codes.
View variation codes
Network Plan plancode Amount
01 MTN N100 100MB - (24 Hours) mtn-10mb-100 ₦100
01 MTN N200 200MB - 3 days mtn-50mb-200 ₦200
01 MTN N50 50MB 2Go - (7 Days) mtn-50mb-50 ₦50
01 MTN N150 160MB - 30 days mtn-160mb-150 ₦150
01 MTN N1,000 1.5GB - 30 days mtn-100mb-1000 ₦1000
01 MTN N2,000 4.5GB - 30 days mtn-500mb-2000 ₦2000
01 MTN N1,500 6GB - 7 days mtn-20hrs-1500 ₦1500
01 MTN N2,500 6GB - 30 days mtn-3gb-2500 ₦2500
01 MTN N3,000 10GB - 30 days mtn-data-3000 ₦3000
01 MTN N3,500 12GB - 30 days mtn-1gb-3500 ₦3500
01 MTN N5,000 20GB - 30 days mtn-100hr-5000 ₦5000
01 MTN N6,000 25GB - 30 days mtn-3gb-6000 ₦6000
01 MTN N10,000 40GB - 30 days mtn-40gb-10000 ₦10000
01 MTN N15,000 75GB - 30 days mtn-75gb-15000 ₦15000
01 MTN N20,000 75GB - 60 days mtn-75gb-20000 ₦20000
01 MTN N1500 3GB - 30 days mtn-3gb-1500 ₦1500
01 MTN N1,200 2GB - 30 days mtn-2gb-1200 ₦1200
01 MTN N8,000 30GB Monthly HyNetFlex Plan (4G Router) mtn-30gb-8000 ₦8000
01 MTN N30,000 120GB - 60days mtn-120gb-30000 ₦30000
01 MTN N50,000 150GB - 90days mtn-150gb-50000 ₦50000
01 MTN N75,000 250GB - 90days mtn-250gb-75000 ₦75000
01 MTN N60,000 550GB Monthly HyNetFlex Plan mtn-550gb-60000 ₦60000
01 MTN N120,000 400GB - 365 days mtn-400gb-120000 ₦120000
01 MTN N250,000 1000GB - 365 days mtn-1000gb-250000 ₦250000
01 MTN N450,000 2000GB - 365 days mtn-2000gb-450000 ₦450000
01 MTN N300 1GB - 1 day mtn-1gb-300 ₦300
01 MTN N300 Xtradata mtn-xtra-300 ₦300
01 MTN N500 1GB - 7 days mtn-1gb-500 ₦500
01 MTN N500 Xtradata mtn-xtra-500 ₦500
01 MTN N500 750MB 50% Deal Zone Offer (500MB+250MB) ( mtn-dealzone-500 ₦500
01 MTN N1,000 Xtradata mtn-xtra-1000 ₦1000
01 MTN N2,000 Xtradata mtn-xtra-2000 ₦2000
01 MTN N5,000 Xtradata mtn-xtra-5000 ₦5000
01 MTN N20,000 110GB - 30 days mtn-110gb-20000 ₦20000
01 MTN N10,000 Xtradata mtn-xtra-10000 ₦10000
01 SME Data Share N13,500 - 35GB mtn-sme30gb-13500 ₦13500
01 MTN N15,000 Xtradata mtn-xtra-15000 ₦15000
01 MTN N20,000 Xtradata mtn-xtra-20000 ₦20000
01 SME Data Share N40,000 - 90GB mtn-90gb-40000 ₦40000
01 SME Data Share N50,000 150GB 12-Months Plan mtn-150gb-sme-50000 ₦50000
01 MTN N3,000 11GB Monthly Plan mtn-11gb-3000 ₦3000
01 MTN N20,000 150GB Bronze HyNetFlex Unlimited Plan mtn-130gb-20000 ₦20000
01 MTN N3,500 13GB Monthly Plan mtn-13gb-3500 ₦3500
01 MTN N5,000 30GB Bronze HyNetFlex Unlimited Weekly mtn-20gb-5000 ₦5000
01 MTN N5,000 22GB Monthly Plan mtn-22gb-5000 ₦5000
01 MTN N6,000 27GB Monthly Plan mtn-27gb-6000 ₦6000
01 MTN N10,000 25GB SME Mobile Data ( 1 Month) mtn-25gb-sme-10000 ₦10000
01 MTN N25,000 200GB Monthly HyNetFlex Plan mtn-200gb-25000 ₦25000
01 MTN N36,000 300GB 2-Monthly HyNetFlex Plan (4G Ro mtn-300gb-36000 ₦36000
01 MTN N45,000 400GB 3-Monthly HyNetFlex Plan mtn-400gb-45000 ₦45000
01 MTN N45,000 400GB Gold Monthly HyNetFlex Unlimited mtn-400gb-46000 ₦45000
01 MTN N50,000 165GB SME Mobile Data (2-Months) mtn-165gb-sme-50000 ₦50000
01 MTN N100,000 1TB 6-Months HyNetFlex Plan (4G Route mtn-1tb-100000 ₦100000
01 MTN N100,000 360GB SME Mobile Data (3 Months) mtn-360gb-sme-100000 ₦100000
01 MTN N150,000 1.5TB Yearly HyNetFlex Plan (4G Route mtn-1-5tb-150000 ₦150000
01 MTN N165,000 1.5TB 6-Months HyNetFlex Unlimited Pl mtn-1-5tb-165000 ₦165000
01 MTN N250,000 1TB SME Mobile Data (3-Months) mtn-1tb-sme-250000 ₦250000
01 MTN N100,000 325GB SME Mobile Data (6 Months) mtn-325gb-sme-100000 ₦100000
01 MTN N450,000 1500GB Mobile Data (1 Year) mtn-1-5tb-450000 ₦450000
01 MTN N100,000 1TB Mobile Data (1 Year) mtn-1tb-110000 ₦100000
01 MTN N250,000 2.5TB Yearly Plan mtn-2-5tb-275000 ₦250000
01 MTN N11,000 - 45GB Monthly HyNetFlex Plan (4G Rout mtn-45gb-11000 ₦11000
01 MTN N18,000 - 100GB Monthly HyNetFlex Plan (4G Rou mtn-100gb-18000 ₦18000
01 MTN N20000 120GB Monthly Plan mtn-120gb-20000 ₦20000
01 MTN 100GB 2-Month Plan mtn-100gb-20000 ₦20000
01 MTN N25,000 200GB Monthly Broadband Plan mtn-200gb-broadband-25000 ₦25000
01 MTN N30,000 160GB 2-Month Plan mtn-160gb-30000 ₦30000
01 MTN N30,000 300GB Monthly Plan (4G router) mtn-300gb-30000 ₦30000
01 MTN N50,000 400GB 3-Month Plan mtn-400gb-50000 ₦50000
01 MTN N75,000 600GB 3-Months Plan mtn-600gb-75000 ₦75000
01 MTN N200 Xtradata mtn-xtra-200 ₦200
01 MTN N1,800 7GB - 7 days mtn-7gb-1800 ₦1800
04 Airtel Data - 50 Naira - 40MB - 1Day airt-50 ₦50
04 Airtel Data - 100 Naira - 100MB - 1Day airt-100 ₦100
04 Airtel Data - 200 Naira - 200MB - 3Days airt-200 ₦200
04 Airtel Data - 300 Naira - 350MB - 7 Days airt-300 ₦300
04 Airtel Data - 500 Naira - 750MB - 14 Days airt-500 ₦500
04 Airtel Data - 1,000 Naira - 1.5GB - 30 Days airt-1000 ₦1000
04 Airtel Data - 1,500 Naira - 3GB - 30 Days airt-1500 ₦1500
04 Airtel Data - 2,000 Naira - 4.5GB - 30 Days airt-2000 ₦2000
04 Airtel Data - 3,000 Naira - 10GB - 30 Days airt-3000 ₦3000
04 Airtel Data - 4,000 Naira - 11GB - 30 Days airt-4000 ₦4000
04 Airtel Data - 5,000 Naira - 20GB - 30 Days airt-5000 ₦5000
04 Airtel Binge - 1,500 Naira (7 Days) - 6GB airt-1500-2 ₦1500
04 Airtel Data - 10,000 Naira - 40GB - 30 Days airt-10000 ₦10000
04 Airtel Data - 15,000 Naira - 75GB - 30 Days airt-15000 ₦15000
04 Airtel Data - 36,000 Naira - 280GB - 30 Days airt-36000 ₦36000
04 Airtel Data - 60,000 Naira - 500GB - 120 Days airt-60000 ₦60000
04 Airtel Data - 100,000 Naira - 1TB - 365 Days airt-100000 ₦100000
04 Airtel Data - 20,000 Naira - 120GB - 30 Days airt-20000 ₦20000
04 Airtel Data - 300 Naira - 1GB - 1 day airt-300x ₦300
04 Airtel Data - 500 Naira - 2GB - 1 days airt-500x ₦500
04 Airtel Data - 1,200 Naira - 2GB - 30 Days airt-1200 ₦1200
04 Airtel Data - 2,500 Naira - 6GB - 30 Days airt-2500 ₦2500
04 Airtel Data - 8,000 Naira - 25GB - 30 Days airt-8000 ₦8000
04 Airtel Data - 30,000 Naira - 200GB - 30 Days airt-30000 ₦30000
04 Airtel Data - 50,000 Naira - 400GB - 90 Days airt-50000 ₦50000
02 Glo Data N100 - 150MB - 1 day glo100 ₦100
02 Glo Data N200 - 350MB - 2 days glo200 ₦200
02 Glo Data N500 - 1.35GB - 14 days glo500 ₦500
02 Glo Data N1000 - 2.9GB - 30 days glo1000 ₦1000
02 Glo Data N2000 - 5.8GB - 30 days glo2000 ₦2000
02 Glo Data N2500 - 7.7GB - 30 days glo2500 ₦2500
02 Glo Data N3000 - 10GB - 30 days glo3000 ₦3000
02 Glo Data N4000 - 13.25GB - 30 days glo4000 ₦4000
02 Glo Data N5000 - 18.25GB - 30 days glo5000 ₦5000
02 Glo Data N8000 - 29.5GB - 30 days glo8000 ₦8000
02 Glo Data N10000 - 50GB - 30 days glo10000 ₦10000
02 Glo Data N15000 - 93GB - 30 days glo15000 ₦15000
02 Glo Data N18000 - 119GB - 30 days glo18000 ₦18000
02 Glo Data N1500 - 4.1GB - 30 days glo1500 ₦1500
02 Glo Data N20000 - 138GB - 30 days glo20000 ₦20000
02 Glo Data N25 - 250MB - 1 Night glo25 ₦25
02 Glo Data N50 - 500MB - (1 Night) glo50 ₦50
02 Glo Data N50 - 50MB - 1 day glo50x ₦50
02 Glo Data N100 - 1GB - (5 Nights) glo100x ₦100
02 Glo Data N200 - 1.25GB - (on Sunday) glo200x ₦200
02 Glo Data N1500 - 7GB - 7 day glo1500x ₦1500
02 Glo Data N30,000 - 225GB - 30 days glo30000 ₦30000
02 Glo Data N36,000 - 300GB - 30 days glo36000 ₦36000
02 Glo Data N50,000 - 425GB - 90 days glo50000 ₦50000
02 Glo Data N60,000 - 525GB - 120 days glo60000 ₦60000
02 Glo Data N75,000 - 675GB - 120 days glo75000 ₦75000
02 Glo Data N100,000 - 1TB - 365 days glo100000 ₦100000
02 Glo Data (SME) N50 - 200MB - 14 days glo-dg-50 ₦50
02 Glo Data (SME) N250 - 1GB 30 days glo-dg-250 ₦250
02 Glo Data (SME) N750 - 3GB 30 days glo-dg-750 ₦750
02 Glo Data (SME) N2500 - 10GB - 30 Days glo-dg-2500 ₦2500
02 Glo Data (SME) N500 - 2GB 30 days glo-dg-500 ₦500
02 Glo Data (SME) N125 - 500MB 14 days glo-dg-125-14 ₦125
02 Glo Data (SME) N125 - 500MB 30 days glo-dg-125-30 ₦125
02 Glo Data (SME) N1250 - 5GB 30 days glo-dg-1250 ₦1250
03 9mobile 100MB - 100 Naira - 1 day eti-100 ₦100
03 9mobile 650MB - 200 Naira - 1 day eti-200 ₦200
03 9mobile 500MB - 500 Naira - 30 Days eti-500 ₦500
03 9mobile 1.5GB - 1,000 Naira - 30 days eti-1000 ₦1000
03 9mobile 11GB - 4,000 Naira - 30 days eti-4000 ₦4000
03 9mobile 4.5GB - 2000 Naira - 30 Days eti-2000 ₦2000
03 9mobile 15GB - 5,000 Naira - 30 Days eti-5000 ₦5000
03 9mobile 40GB - 10,000 Naira - 30 days eti-10000 ₦10000
03 9mobile 75GB - 15,000 Naira - 30 Days eti-15000 ₦15000
03 9mobile 2GB - 1,200 Naira - 30 Days eti-1200 ₦1200
03 9mobile 25MB - 50 Naira - 1 day eti-50 ₦50
03 9mobile 100GB - 84,992 Naira - 100 days eti-84992 ₦84992
03 9mobile 7GB - 1,500 Naira - 7 days eti-1500 ₦1500
03 9mobile 75GB - 25,000 Naira - 90 days eti-25000 ₦25000
03 9mobile 165GB - 50,000 Naira - 180 days eti-50000 ₦50000
03 9mobile 365GB - 100,000 Naira - 365 days eti-100000 ₦100000
₦
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE


{"code":101,
"description":{"Status":"successful",
"ProductName":"AIRTEL Airtel Data - 50 Naira - 40MB  - 1Day",
"Network":null,"TransactionRef":"7138645629790810",
"Date":"2023-07-24 11:56:PM"}}

GIFTING Data API Integration

Purchase GIFTING Data

GIFTING Data services can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/data/

Request Method: POST

Network: as specified in the parameters below;

Network

Service variation
MTN
01

Airtel

04

9Mobile

03

Glo

02

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Network as specified in the service variation above.
MobileNumber R Number The phone number to receive the GIFTING Data
DataPlan R Number The Gifting Data Variation code. These includes;
View variation code
Network Plan plancode Amount
01 50MB (CG) - 30days 50 ₦30
01 250MB (CG) - 30days 25 ₦65
01 500MB (CG) - 30days 500m ₦118
01 1GB (CG) - 30days 1g ₦255
01 2GB (CG) - 30days 2g ₦530
01 3GB (CG) - 30days 3g ₦795
01 5GB (CG) - 30days 5g ₦1325
01 10GB (CG) - 30days 10g ₦2650
01 15GB (CG) - 30days 15g ₦3975
01 20GB (CG) - 30days 20g ₦5300
01 40GB (CG) - 30days 40g ₦10600
01 75GB (CG) - 30days 75g ₦19875
01 100GB (CG) - 30days 100g ₦26500
04 100MB (CG) - 7days 10 ₦55
04 300MB (CG) - 7days 11 ₦105
04 500MB (CG) - 30days 12 ₦140
04 1GB (CG) - 30days 1000 ₦276
04 2GB (CG) - 30days 2000 ₦552
04 5GB (CG) - 30days 5000 ₦1380
04 10GB (CG) - 30days, 10000 ₦2760
04 15GB (CG) - 30days 15000 ₦4140
04 20GB (CG) - 30days 20000 ₦5520
02 200MB (CG) - 14days 200 ₦65
02 500MB (CG) - 30days 500m ₦115
02 1GB (CG) - 30days 1000 ₦270
02 2GB (CG) - 30days 2000 ₦540
02 3GB (CG) - 30days 3000 ₦810
02 5GB (CG) - 30days 5000 ₦1350
02 10GB (CG) - 30days 10000 ₦2700
03 500MB (CG) - 30days 21 ₦80
03 1GB (CG) - 30days 22 ₦245
03 1.5GB (CG) - 30days 23 ₦367.5
03 2GB (CG) - 30days 24 ₦490
03 2.5GB (CG) - 30days 25 ₦612.5
03 3GB (CG) - 30days 26 ₦735
03 4GB (CG) - 30days 27 ₦980
03 10GB (CG) - 30days 28 ₦2450
₦
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

{"code":101,
"description":{"response_description":"TRANSACTION SUCCESSFUL",
"ref":"884666332234","amount":"100",
"transaction_date":"2020-04-17 07:04:19"
}}

WAEC Result Checker API Integration

Purchase WAEC RESULT CHECKER PIN

WAEC Result checker PIN can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/waec/

Network: as specified in the parameters below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Network as specified. These includes, waec
vcode R String The code of the variation. That is waecdirect
amount R Number The amount of the variation (as specified in the VARIATIONS endpoint )
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

{"code":101,"description":{"Content":"Serial No:WRN800312772, pin: 249714527294",
"product_name":"WAEC Result Checker PIN","TransactionDate":"2021-11-01 02:51:PM"}}

NECO Result Checker API Integration

Purchase NECO RESULT CHECKER PIN

NECO result Checker PIN can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/neco/

Network: as specified in the parameters below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Network as specified. These includes, neco
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

 

EXPECTED RESPONSE

{"code":101,"description":{"Status":"TRANSACTION SUCCESSFUL","PIN":"35609198364227070191",
"TransactionRef":"45060440786","product_name":"NECO Result Checker",
"Date":"2021-11-01 02:51:PM"}}

Spectranet PIN Purchase API Integration

Purchase Spectranet PIN

Spectranet PIN services can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/spectranet/

Network: as specified in the parameters below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Network as specified. These includes, spectranet
pinNo R Number The number of Spectranet PINs to purchase
amount R Number The amount of the variation (as specified in the VARIATIONS endpoint )
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

EXPECTED RESPONSE

{"code":101,
"description":{"response_description":"TRANSACTION SUCCESSFUL",
"ref":"884666332234","amount":"100",
"transaction_date":"2020-04-17 07:04:19"
}}

Universal Motor Insurance API Integration

Purchase Universal Motor Insurance

Universal Motor Insurance can be purchased with the endpoint below:

Endpoint URL: {{baseurl}}/ui-insurance/

Network: as specified in the parameters below;

 

PARAMETERS Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at app.epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM
service R String Network as specified. These includes, ui-insure
accountno R String The plate Number of the vehicle you wish to make the insurance payment on. Example: KUJ480BH
vcode R String The code of the variation. That includes Commercial, Private, Tricycles
amount R Number The amount of the variation (as specified in the VARIATIONS endpoint )
Phone R Number The phone number of the customer or recipient of this service
insuredName R String Name of the owner of the insured vehicle
engineNo R String Engine Number of the insured vehicle
chasisNo R String Chasis Number of the insured vehicle
plateNo R String Same as the accountno above
plateNo R String Same as the accountno above
vehicleMake R String Make of the insured vehicle
vehicleColor R String Color of the insured vehicle
vehicleModel R String Model of the insured vehicle
yearofMake R String The year the insured vehicle was made.
contactAddress R String Contact Address of the vehicle owner
ref R String This is a unique reference with which you can use to execute and query the transaction.

 

EXPECTED RESPONSE

{"code":101,
"description":{"response_description":"TRANSACTION SUCCESSFUL",
"ref":"884666332234","Download Certificate":"https://3rdparty.universalinsuranceonline.com/PrintCertificate.aspx?Data=UPMSB001190319136038",
"transaction_date":"2020-04-17 07:04:19"
}}

Wallet Balance API

Wallet Balance API

This section contains your RESTful API to get wallet balance.

 

Authentication

The ePINs API uses API Key for Authentication.

Please see the following sample API key for authentication

Apikey = kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM

API Key: Your Gateway API Key

Please create your API key here Create API Key

 

 

GET WALLET BALANCE

This endpoint allows you to get epins.com.ng wallet balance .

Endpoint URL: {{baseurl}}/account/

Service: as specified in the fields below;

 

PARAMETER Required/Optional TYPE DESCRIPTION
apikey R String The reseller gateway API key created at epins.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM

 

 

EXPECTED RESPONSE


{"code":101,

"description":{"Balance":"100000",
	}

}

Response Codes

Response Codes

This section contains the response codes you will likely get from the ePINs API.

The "code" parameter contains the following response.

 

Response Code Meaning Description
101 Transaction successful Transaction is processed successfully
400 INVALID REQUEST MEHOD Request method used is rejected. Request method includes GET, POST
103 INVALID ACCOUNT Wrong API key or credentials entered
107 INVALID AMOUNT Amount must be an integer
102 LOW BALANCE Your Wallet balance is below the product/service amount
1007 TRANSACTION BLOCKED Transaction rejected
1009 ACCOUNT BLOCKED Your account is locked
104 TRANSACTION ID ALREADY EXIST You have used the RequestID for a previous transaction.
105 TRANSACTION FAILED TRANSACTION FAILED
108 BELOW MINIMUM AMOUNT ALLOWED You are attempting to pay an amount lower than the minimum allowed for that product/service.
118 MISSING SERVICE ID You didn't enter service Id for the requested product/service
207 PIN UNAVAILABLE PIN denomination currently unavailable
303 INVALID SERVICE ID Service ID used is incorrect
304 UNAUTHORIZED ACCESS Your account does not have API access enabled for the product/service.