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 750MB (DC) - 7DAYS 720 ₦200
01 1GB (DC) - 30 Days 707 ₦340
01 1.5 GB (DC) - 30DAYS 15 ₦380
01 2 GB (DC) - 30DAYS 212 ₦680
₦
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) - 7days 1000 ₦786
01 500MB (SME) - 7days 500 ₦495
01 2GB (SME) - 30days 2000 ₦1486
01 3.5GB (SME) - 30days 3000 ₦2470
01 7GB (SME) - 30days 5000 ₦3450
01 10GB (SME) - 30 days 10000 ₦4435
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
04 600MB (SME) - 2 Days 4391 ₦280
04 300MB (SME) - 2 Days 4242 ₦130
04 7GB (SME) - 7 DAYS VALIDITY 4263 ₦2350
04 10GB (SME) - 30DAYS VALIDITY 4284 ₦3550
02 1GB (SME) - 30 Days 320 ₦445
02 2 GB (SME) - 30 Days 640 ₦900
02 3GB(SME) - 30 Days 960 ₦1335
02 500MB (SME) - 14 days 161 ₦225
02 5 GB (SME) - 30 Days 1600 ₦2250
02 10 GB(SME) - 30 Days 3100 ₦4500
₦
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 1.5GB (CG_LITE) - 7 Days 210 ₦985
01 2.7GB (CG_LITE) - 30 Days 211 ₦1985
01 3.5GB (CG_LITE) - 7 Days 212 ₦1485
01 5GB (CG_LITE) 213 ₦1400
01 12.5GB (CG_LITE) - 30 Days 214 ₦5450
01 50GB (CG_LITE) 221 ₦14000
01 4 GB (CGLITE) 230 ₦1100
01 500 MB (CG_LITE) 205 ₦140
01 2GB (CGLITE) - 2 Days 750 ₦746
01 16.5GB (CGLITE) - 30 Days 165 ₦6450
01 20GB (CGLITE) - 30 Days 2750 ₦7450
01 65GB (CG_LITE) - 30 Days 656 ₦15900
01 36GB (CG_LITE) - 30 Days 1132 ₦10850
01 75GB (CG_LITE) - 30 Days 752 ₦17800
01 25GB (CGLITE) - 30 Days 2590 ₦8880
₦
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
03 9mobile 100MB - 100 Naira - 1 day eti-100 ₦100
03 9mobile 250MB - 200 Naira - 1 day eti-200 ₦200
03 9mobile 650MB - 500 Naira - 1 day eti-500 ₦500
03 9mobile 5.10GB - 4,000 Naira - 30 days eti-4000 ₦4000
03 9mobile 2.44GB - 2000 Naira - 30 Days eti-2000 ₦2000
03 9mobile 6.5GB - 5,000 Naira - 30 Days eti-5000 ₦5000
03 9mobile 16GB - 12,000 Naira - 30 days eti-12000 ₦12000
03 9mobile 24.3GB - 18,500 Naira - 30 Days eti-18500 ₦18500
03 9mobile 3.91GB - 3,000 Naira - 30 days eti-3000 ₦3000
03 9mobile 1400MB - 1,200 Naira - 30 Days eti-1200 ₦1200
03 9mobile 40MB - 50 Naira - 1 day eti-50 ₦50
03 9mobile 450MB (1 day) - 350 Naira eti-350 ₦350
03 9mobile 3.17GB - 2,500 Naira - 30 days eti-2500 ₦2500
03 9mobile 26.5GB - 20,000 Naira - 30 days eti-20000 ₦20000
03 9mobile 1100MB - 1000 Naira eti-1000 ₦1000
03 9mobile 1750MB - 7 days eti-1500-7 ₦1500
03 9mobile 180MB - 1 day eti-150-1 ₦150
03 9mobile 650MB - 600 Naira - 14 days eti-650-14 ₦600
03 9mobile 39GB - 30,000 Naira - 2 Months eti-39-60 ₦30000
03 9mobile 78GB - 60,000 Naira - 3 Months eti-78-90 ₦60000
03 9mobile 190GB - 150,000 Naira - 6 Months eti-190-180 ₦150000
02 Glo Data (SME) N90 - 200MB - 14 days glo-dg-70 ₦90
02 Glo Data (SME) N450 - 1GB 30 days glo-dg-320 ₦450
02 Glo Data (SME) N1,350 - 3GB 30 days glo-dg-960 ₦1350
02 Glo Data (SME) N4500 - 10GB - 30 Days glo-dg-3100 ₦4500
02 Glo Data (SME) N900 - 2GB 30 days glo-dg-640 ₦900
02 Glo Data (SME) N225 - 500MB 14 days glo-dg-160-14 ₦225
02 Glo Data (SME) N2250 - 5GB 30 days glo-dg-1600 ₦2250
02 Glo 45MB - N50 Oneoff glo-daily-50 ₦50
02 Glo 125MB - N100 Oneoff glo-daily-100 ₦100
02 Glo 260MB - N200 Oneoff glo-2days-200 ₦200
02 Glo 1.5GB - N500 Oneoff glo-2weeks-500 ₦500
02 Glo 2.6GB - N1000 Oneoff glo-monthly-1000 ₦1000
02 Glo 5GB - N1500 Oneoff glo-monthly-1500 ₦1500
02 Glo 6.25GB - N2000 Oneoff glo-monthly-2000 ₦2000
02 Glo 7.5GB - N2500 Oneoff glo-monthly-2500 ₦2500
02 Glo 11GB - N3000 Oneoff glo-monthly-3000 ₦3000
02 Glo 14GB - N4000 Oneoff glo-monthly-4000 ₦4000
02 Glo 18GB - N5000 Oneoff glo-monthly-5000 ₦5000
02 Glo 29GB - N8000 Oneoff glo-monthly-8000 ₦8000
02 Glo 40GB - N10000 Oneoff glo-monthly-10000 ₦10000
02 Glo 69GB - N15000 Oneoff glo-monthly-15000 ₦15000
02 Glo 110GB - N20000 Oneoff glo-monthly-20000 ₦20000
02 Glo 1.75GB - Sunday N200 glo-sunday-200 ₦200
02 Glo 2GB - Special N500 glo-special-500 ₦500
02 Glo 6GB - Special N1500 glo-special-1500 ₦1500
02 Glo 2.2GB - Weekend N500 glo-weekend-500 ₦500
02 Glo 165GB - Mega N30000 Oneoff glo-mega-30000 ₦30000
02 Glo 220GB - Mega N36000 Oneoff glo-mega-36000 ₦36000
02 Glo 320GB - Mega N50000 Oneoff glo-mega-50000 ₦50000
02 Glo 380GB - Mega N60000 Oneoff glo-mega-60000 ₦60000
02 Glo 475GB - Mega N75000 Oneoff glo-mega-75000 ₦75000
02 Glo TV VOD 500 MB 3days Oneoff glo-tv-150 ₦150
02 Glo TV VOD 2GB 7days Oneoff glo-tv-450 ₦450
02 Glo TV VOD 6GB 30days Oneoff glo-tv-1400 ₦1400
02 Glo TV Lite 2GB Oneoff glo-tv-900 ₦900
02 Glo TV Max 6 GB Oneoff glo-tv-3200 ₦3200
02 300MB - GloMyG N100 OneOff glo-social-oneoff-100 ₦100
02 Glo MyG N300 1 GB OneOff (Whatsapp, Instagram, Sna glo-social-oneoff-300 ₦300
02 Glo MyG N500 1.5 GB OneOff (Whatsapp, Instagram, S glo-social-oneoff-500 ₦500
02 Glo MyG N1000 3.5 GB OneOff (Whatsapp, Instagram, glo-social-oneoff-1000 ₦1000
02 Glo 235MB - Camp-Boost N100 Oneoff glo-campus-booster-100 ₦100
02 Glo 480MB - Camp-Boost N200 Oneoff glo-campus-booster-200 ₦200
02 Glo 2GB - Camp-Boost N500 Oneoff glo-campus-booster-500 ₦500
02 Glo 4.2GB - Camp-Boost N1000 Oneoff glo-campus-booster-1000 ₦1000
02 Glo 10.6GB - Camp-Boost 2000 Oneoff glo-campus-booster-2000 ₦2000
02 Glo 32GB - Camp-Boost N5000 Oneoff glo-campus-booster-5000 ₦5000
04 Airtel 250MB Night Plan (12 - 5 AM) - 50 Naira - airt-50 ₦50
04 Airtel 200MB Social Plan (2 Days) - 100 Naira - 1D airt-100 ₦100
04 Airtel 200MB Daily Plan (2 Days) - 200 Naira - 200 airt-200 ₦200
04 Airtel Data - 100 Naira - 100MB - 1 Day airt-daily-100 ₦100
04 Airtel 500MB Weekly Plan (7 Days) - 500 Naira airt-500 ₦500
04 Airtel 1.5GB Weekly Plan + Youtube & Social Plans airt-1000-7 ₦1000
04 Airtel 3GB Weekly Plan + Youtube & Social Platform airt-1500-7 ₦1500
04 Airtel 3GB Monthly Plan + Youtube & Social Plan (3 airt-2000 ₦2000
04 Airtel 6GB Monthly Plan + Youtube & Social Plan (3 airt-3000 ₦3000
04 Airtel 10GB Monthly Plan + Youtube & Social Plan ( airt-4000 ₦4000
04 Airtel 13GB Monthly Plan + Youtube & Social Plan ( airt-5000 ₦5000
04 Airtel 5GB Binge Plan + Youtube & Social Platforms airt-1500-2 ₦1500
04 Airtel 35GB Monthly Plan + Youtube & Social Plan ( airt-10000 ₦10000
04 Airtel 60GB Monthly Plan + Youtube & Social Plan ( airt-15000 ₦15000
04 Airtel 200GB Data (30 Days) - 40,000 Naira airt-40000 ₦40000
04 Airtel 350GB Monthly Plan + Youtube & Social Plan airt-60000 ₦60000
04 Airtel 400GB Data (365 Days) - 100,000 Naira airt-100000 ₦100000
04 Airtel 100GB Monthly Plan + Youtube & Social Plan airt-20000 ₦20000
04 Airtel 4GB Monthly Plan + Youtube & Social Plan (3 airt-2500 ₦2500
04 Airtel 25GB Monthly Plan + Youtube & Social Plan ( airt-8000 ₦8000
04 Airtel 150GB Monthly Plan (30 Days) - 30,000 Naira airt-30000 ₦30000
04 Airtel 200GB Monthly Plan (90 Days) - 50,000 Naira airt-50000 ₦50000
04 Airtel 1.5GB Binge Plan + Youtube & Social Plan Da airt-600 ₦600
04 Airtel 3GB Binge Plan + Youtube & Social Plans Dat airt-1000-2 ₦1000
04 Airtel 8.5GB Weekly Plan + Youtube & Social Platfo airt-3000-7 ₦3000
04 Airtel 18GB Weekly Plan + Youtube & Social Platfor airt-5000-7 ₦5000
04 Airtel 500 Naira Binge Plan - airt-binge-500-1 ₦500
04 Airtel 1GB Weekly Plan (7 Days) - 800 Naira airt-800-7 ₦800
04 Airtel 18GB Monthly Plan + Youtube & Social Plan ( airt-6000-30 ₦6000
04 Airtel 75MB Daily Plan (1 Day) - 75 Naira airt-75-1 ₦75
04 Airtel 300MB Daily Plan (1 Day) - 300 Naira airt-300-1 ₦300
04 Airtel 1GB Social Plan Plan (3 Days) - 300 Naira airt-social-300-3 ₦300
04 Airtel 2GB Binge Plan + Youtube & Social Plan Data airt-750-2 ₦750
04 Airtel 2GB Monthly Plan + Youtube & Social Plan (3 airt-1500-30 ₦1500
04 Airtel 6GB Weekly Plan + Youtube & Social Platform airt-2500-7 ₦2500
04 Airtel 13GB MIFI 5 Data - MiFi Only (30 Days) - 5, airt-mifi-5000-30 ₦5000
04 Airtel 35GB MIFI 10 Data - MiFi Only (30 Days) - 1 airt-mifi-10000-30 ₦10000
04 Airtel 60GB MIFI 15 Data - MiFi Only (30 Days) - 1 airt-mifi-15000-30 ₦15000
04 Airtel 100GB Unlimited Uiltra 20 - Router Only (30 airt-mifi-20000-30 ₦20000
04 Airtel Unlimited 20MBPS Data - Router Only (30 Day airt-mifi-30000-30 ₦30000
04 Airtel Unlimited 60MBPS Data - Router Only (30 Day airt-mifi-50000-30 ₦50000
04 Airtel Unlimited 60MBPS Data - Router Only (90 Day airt-mifi-80000-90 ₦80000
04 Airtel Unlimited 60MBPS Data - Router Only (90 Day airt-mifi-135000-90 ₦135000
04 Airtel Unlimited 20MBPS Data - Router Only (120 Da airt-mifi-150000-120 ₦150000
04 Airtel 1.5GB Social Plan - 500 Naira airt-social-500-7 ₦500
01 MTN 110MB Daily Plan (1 Day) - N100 mtn-10mb-100 ₦100
01 MTN 1.5GB Weekly Plan (7 Days) - N1,000 mtn-1500mb-1000 ₦1000
01 MTN 7GB Monthly Plan - N3,500 mtn-5.5gb-3500 ₦3500
01 MTN 16.5GB Monthly Plan mtn-data-6500 ₦6500
01 MTN 20GB Monthly Plan mtn-20gb-7500 ₦7500
01 MTN 36GB Monthly Plan mtn-32gb-11000 ₦11000
01 MTN 75GB Monthly Plan mtn-75gb-20000 ₦18000
01 MTN N24,000 120GB - 30days mtn-120gb-24000 ₦24000
01 MTN 480GB 3-Month Plan - N90,000 mtn-480gb-90000 ₦90000
01 MTN N500 1GB + 1.5mins - 1 day mtn-1gb-350 ₦500
01 MTN 1GB+5mins Weekly Plan mtn-1gb-600 ₦800
01 MTN 2GB + 2 Mins Monthly Plan - N1,500 mtn-xtra-1000 ₦1500
01 MTN N11,000 Xtradata mtn-xtra-10000 ₦11000
01 MTN 12.5GB Monthly Plan - N5,500 mtn-11gb-5000 ₦5500
01 MTN N900 2.5GB - 2 days mtn-2-5gb-900 ₦900
01 MTN 165GB Monthly Plan mtn-120gb-22000 ₦35000
01 MTN 150GB 2-Month Plan mtn-150gb-40000 ₦40000
01 MTN 200GB 2-Month Plan mtn-200gb-50000 ₦50000
01 MTN N3,500 11GB - 7 days mtn-11gb-3500 ₦3500
01 MTN 1.5GB Daily Plan (2 Days) - N600 mtn-2-5gb-ex-600 ₦600
01 MTN 2.7GB+5mins Monthly Plan mtn-1500mb-ex-1200 ₦2000
01 MTN N4,500 10GB + 10mins - 30 days mtn-8gb-ex-3000 ₦4500
01 MTN 500MB + 1GB YouTube (7 Days) - N500 mtn-500mb-500 ₦500
01 MTN N1000 3.2GB - 2 days mtn-3.2gb-1000 ₦1000
01 MTN N2500 3.5GB +5mins Monthly Plan mtn-3.5gb-2500 ₦2500
01 MTN 60GB Monthly HyNetFlex Plan - N14,500 mtn-hynetflex-14500-30 ₦14500
01 MTN 450GB 3-Month Broadband Plan - N75,000 mtn-hynetflex-75000-90 ₦75000
01 MTN 30GB Monthly Broadband Plan - N9,000 mtn-hynetflex-9000-30 ₦9000
01 2GB Daily Plan (2 Days) - N750 mtn-2gb-ex-750 ₦750
01 3.5GB Weekly Plan (7 Days) - N1,500 mtn-3.5gb-1500 ₦1500
01 65GB Monthly Plan (30 Days) - N16,000 mtn-65gb-ex-16000 ₦16000
01 25GB Monthly Plan mtn-25gb-9000 ₦9000
₦
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 63 ₦30
01 250MB (CG) - 30days 64 ₦213
01 500MB (CG) - 30days 65 ₦425
01 1GB (CG) - 30days 66 ₦850
01 2GB (CG) - 30days 67 ₦1700
01 3GB (CG) - 30days 68 ₦2550
01 5GB (CG) - 30days 69 ₦4250
02 200MB (CG) - 14days 93 ₦95
02 500MB (CG) - 30days 94 ₦225
02 1GB (CG) - 30days 95 ₦450
02 2GB (CG) - 30days 96 ₦900
02 3GB (CG) - 30days 97 ₦1350
02 5GB (CG) - 30days 98 ₦2250
02 10GB (CG) - 30days 99 ₦4500
03 25MB (CG) - 30days 121 ₦37
03 1GB (CG) - 30days 122 ₦285
03 1.5GB (CG) - 30days 123 ₦427.5
03 2GB (CG) - 30days 124 ₦570
03 5GB (CG) - 30days 125 ₦1425
03 3GB (CG) - 30days 126 ₦855
03 4GB (CG) - 30days 127 ₦1140
03 10GB (CG) - 30days 128 ₦2850
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.