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: to get base URL

HTTP Method: GET

 

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"
}}

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":"02357485946496925482100BC\r",
    "network":"mtn",
    "pinDenomination":"100",
    "pinQuantity":1,
    "product_name":"MTN ePIN 100",
    "TransactionDate":"2023-03-20 05:58:AM"
     }
    }

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 ₦230
01 1.5GB (DC) - 30 Days 1500 ₦305
01 2GB (DC) - 30days 527 ₦430
01 3GB (DC) - 30days 58 ₦885
01 4GB (DC) - 30days 83 ₦1180
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

 

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, gotv, startimes
smartNo R Number The Smile number to make the subscription on

 

EXPECTED RESPONSE

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

 

Recharge 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 account number to make the subscription on
vcode R String This is the variation code from account validation.
amount R 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":{"response_description":"TRANSACTION SUCCESSFUL",
"ref":"884666332234","amount":"100",
"transaction_date":"2020-04-17 07:04:19"
}}

Bet9ja Payment API Integration

Bet9ja Payment API Integration

This section contains your RESTful API for Bet9ja 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 Bet9ja ACCOUNT NUMBER

You can validate Bet9ja 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 Bet9ja customer number to make the subscription on

 

EXPECTED RESPONSE

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

 

Recharge Bet9ja Account

This endpoint allows you to recharge Bet9ja account using it’s Customer ID.

Endpoint URL: {{baseurl}}/bet9ja

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
customerId R Number The Bet9ja customer Number to make the payment on
reference R String The reference number generated during bet9ja account validation
amount R Number The amount to credit on bet9ja account
customerName R String Customer Name generated during Bet9ja 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":{"response_description":"TRANSACTION SUCCESSFUL",
"ref":"884666332234","amount":"100",
"transaction_date":"2020-04-17 07:04:19"
}}

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 ₦250
01 500MB (SME) - 30days 500 ₦128
01 2GB (SME) - 30days 2000 ₦500
01 3GB (SME) - 30days 3000 ₦750
01 5GB (SME) - 30days 5000 ₦1250
01 10GB (SME) - 30 days 10000 ₦2500
03 100MB (SME) - 30days 6 ₦40
03 300MB (SME) - 30days 7 ₦63
03 500MB (SME) - 30days 500.01 ₦90
03 1GB (SME) - 30days 1000.01 ₦203
03 1.5GB (SME) - 30days 1500.01 ₦305
03 2GB (SME) - 30days 13 ₦406
03 2.5GB (SME) - 30days 2500.01 ₦508
03 3GB (SME) - 30days 32 ₦609
03 4GB (SME) - 30days 4000.01 ₦812
03 5GB (SME) - 30days 5500.01 ₦1015
03 6GB (SME) - 30days 60 ₦1218
03 7.5GB (SME) - 30days ₦1523
03 10GB (SME) - 30days 110 ₦2030
03 11GB (SME) - 30days 11500.01 ₦2233
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
₦
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 ₦252
01 2GB (CG_LITE) 211 ₦504
01 3GB (CG_LITE) 212 ₦756
01 5GB (CG_LITE) 213 ₦1260
01 10GB (CG_LITE) 214 ₦2520
01 12GB (CG_LITE) 215 ₦3024
01 15GB (CG_LITE) 216 ₦3780
01 20GB (CG_LITE) 217 ₦5040
01 25GB (CG_LITE) 218 ₦6300
01 30GB (CG_LITE) 219 ₦7560
01 40GB (CG_LITE) 220 ₦10080
01 50GB (CG_LITE) 221 ₦12600
01 60GB (CG_LITE) 260 ₦15120
01 70GB (CG_LITE) 270 ₦17640
01 75GB (CG_LITE) 275 ₦18900
01 80GB (CG_LITE) 278 ₦20160
01 90GB (CG_LITE) 290 ₦22680
01 100GB (CG_LITE) 296 ₦25200
₦
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 N700 3GB - 2 days mtn-3gb-700 ₦700
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 ₦43
01 250MB (CG) - 30days ₦75
01 500MB (CG) - 30days 500m ₦118
01 1GB (CG) - 30days 1g ₦235
01 2GB (CG) - 30days 2g ₦470
01 3GB (CG) - 30days 3g ₦705
01 5GB (CG) - 30days 5g ₦1175
01 10GB (CG) - 30days 10g ₦2350
01 12GB (CG) - 30days 12g ₦2820
01 15GB (CG) - 30days 15g ₦3525
01 20GB (CG) - 30days 20g ₦4700
01 25GB (CG) - 30days 25g ₦5875
01 30GB (CG) - 30days 30g ₦7050
01 40GB (CG) - 30days 40g ₦9400
01 50GB (CG) - 30days 50g ₦11750
01 60GB (CG) - 30days 60g ₦14100
01 70GB (CG) - 30days 70g ₦16450
01 75GB (CG) - 30days 75g ₦17625
01 80GB (CG) - 30days 80g ₦18800
01 90GB (CG) - 30days 90g ₦21150
01 100GB (CG) - 30days 100g ₦23500
04 100MB (CG) - 7days 10 ₦75
04 300MB (CG) - 7days 11 ₦110
04 500MB (CG) - 30days 12 ₦158
04 1GB (CG) - 30days 1000 ₦212
04 2GB (CG) - 30days 2000 ₦424
04 5GB (CG) - 30days 5000 ₦1060
04 10GB (CG) - 30days, 10000 ₦2120
04 15GB (CG) - 30days 15000 ₦3180
04 20GB (CG) - 30days 20000 ₦4240
02 200MB (CG) - 14days 200 ₦65
02 500MB (CG) - 30days 500m ₦115
02 1GB (CG) - 30days 1000 ₦218
02 2GB (CG) - 30days 2000 ₦436
02 3GB (CG) - 30days 3000 ₦654
02 5GB (CG) - 30days 5000 ₦1090
02 10GB (CG) - 30days 10000 ₦2180
03 500MB (CG) - 30days ₦80
03 1GB (CG) - 30days ₦155
03 1.5GB (CG) - 30days ₦233
03 2GB (CG) - 30days ₦310
03 2.5GB (CG) - 30days ₦388
03 3GB (CG) - 30days ₦465
03 4GB (CG) - 30days ₦620
03 10GB (CG) - 30days ₦1550
₦
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}}/balance

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":"45000.00",
	}

}

Response Codes

Response Codes

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

 

 

Error Codes

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

Endpoint URL: {{baseurl}}/balance

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":"45000.00",
	}

}