📲Airtime & Data Bundles

Note: all requests should have your API Token as a bearer token in authorization header. Content-Type application/json

There are three endpoints involved in Airtime and Data Bundles in the order of Account Number Validation, Vend and Transaction Confirmation

Airtime Validation

POST http://epayment.com.ng/epayment/api/3pvtu_validate

Headers

Name	Type	Description
Bearer Token*	String	your-api-token

Request Body

Name	Type	Description
Body*	String	{"phone":"2348068888888"}

200: OK {"opts":{"hasOpenRange":true,"country":"Nigeria","operator" :"MTN","iso":"ng","canOverride":true,"msisdn":"234806888516 6"},"products":[{"product_id":"MFIN-5- OR","openRange":true,"openRangeMin":1,"openRangeMax":200000 ,"rate":0.98,"topup_currency":"NGN","currency":"NGN"}]}

{
    // Response
}

Vend Airtime

POST http://epayment.com.ng/epayment/api/3pvtu_vend

Headers

Name	Type	Description
Bearer Token*	String	your-api-token

Request Body

Name	Type	Description
Body*	String	{ "product_code":"MFIN-5-OR", "phone":"2348068885166", "amount":"100", "customer_reference":"0P927347", "service":"MTN" }

200: OK {"status":201,"message":"Operation Successful, Recharge created, Reference : f8623900-96f6-11eb-b0e7- adef76ad73c2","reference":"f8623900-96f6-11eb-b0e7- adef76ad73c2","code":"RECHARGE_COMPLETE","paid_amount":98," paid_currency":"NGN","topup_amount":100,"topup_currency":"N GN","target":"2348068885166","product_id":"MFIN-5- OR","time":"2021-04- 06T16:41:45.617Z","country":"Nigeria","operator_name":"MTN" ,"completed_in":745,"customer_reference":"475- 511834","api_transactionid":"2021040617414505802515644","pi n_based":false}

201: Created {"status":201,"message":"Operation Successful, Recharge created, Reference : f8623900-96f6-11eb-b0e7- adef76ad73c2","reference":"f8623900-96f6-11eb-b0e7- adef76ad73c2","code":"RECHARGE_COMPLETE","paid_amount":98," paid_currency":"NGN","topup_amount":100,"topup_currency":"N GN","target":"2348068885166","product_id":"MFIN-5- OR","time":"2021-04- 06T16:41:45.617Z","country":"Nigeria","operator_name":"MTN" ,"completed_in":745,"customer_reference":"475- 511834","api_transactionid":"2021040617414505802515644","pi n_based":false}

{
    // Response
}

Verify Completed Airtime Vending

POST http://epayment.com.ng/epayment/api/3pvtu_verify

Headers

Name	Type	Description
Bearer Token*	String	your-api-token

Request Body

Name	Type	Description
Body*	String	{ "customer_reference":"100123" }

200: OK {"status":201,"message":"Operation Successful, Recharge created, Reference : f8623900-96f6-11eb-b0e7- adef76ad73c2","reference":"f8623900-96f6-11eb-b0e7- adef76ad73c2","code":"RECHARGE_COMPLETE","paid_amount":98," paid_currency":"NGN","topup_amount":100,"topup_currency":"N GN","target":"2348068885166","product_id":"MFIN-5- OR","time":"2021-04- 06T16:41:45.617Z","country":"Nigeria","operator_name":"MTN" ,"completed_in":745,"customer_reference":"475- 511834","api_transactionid":"2021040617414505802515644","pi n_based":false}

{
    // Response
}

201: Created {"status":201,"message":"Operation Successful, Recharge created, Reference : f8623900-96f6-11eb-b0e7- adef76ad73c2","reference":"f8623900-96f6-11eb-b0e7- adef76ad73c2","code":"RECHARGE_COMPLETE","paid_amount":98," paid_currency":"NGN","topup_amount":100,"topup_currency":"N GN","target":"2348068885166","product_id":"MFIN-5- OR","time":"2021-04- 06T16:41:45.617Z","country":"Nigeria","operator_name":"MTN" ,"completed_in":745,"customer_reference":"475- 511834","api_transactionid":"2021040617414505802515644","pi n_based":false}

{
    // Response
}

Data Bundle Validation

POST http://epayment.com.ng/epayment/api/3pbundle_validate

Headers

Name	Type	Description
Bearer Token*	String	your-api-token

Request Body

Name	Type	Description
Body*	String	{"phone":"2348068885166"}

200: OK {"opts":{"hasOpenRange":true,"country":"Nigeria","operator" :"MTN","iso":"ng","canOverride":true,"msisdn":"234806888516 6"},"products":[{"product_id":"MFIN-5- OR","openRange":true,"openRangeMin":1,"openRangeMax":200000 ,"rate":0.98,"topup_currency":"NGN","currency":"NGN"}]}

{
    // Response
}

Vend Data Bundle

POST http://epayment.com.ng/epayment/api/3pbundle_vend

Headers

Name	Type	Description
Bearer Token*	String	your-api-token

Request Body

Name	Type	Description
Body*	String	{ "product_code":"MFIN-5-OR", "phone":"2348068885166", "amount":"100", "customer_reference":"0P927347", "service":"MTN" }

200: OK {"status":201,"message":"Operation Successful, Recharge created, Reference : f8623900-96f6-11eb-b0e7- adef76ad73c2","reference":"f8623900-96f6-11eb-b0e7- adef76ad73c2","code":"RECHARGE_COMPLETE","paid_amount":98," paid_currency":"NGN","topup_amount":100,"topup_currency":"N GN","target":"2348068885166","product_id":"MFIN-5- OR","time":"2021-04- 06T16:41:45.617Z","country":"Nigeria","operator_name":"MTN" ,"completed_in":745,"customer_reference":"475- 511834","api_transactionid":"2021040617414505802515644","pi n_based":false}

201: Created {"status":201,"message":"Operation Successful, Recharge created, Reference : f8623900-96f6-11eb-b0e7- adef76ad73c2","reference":"f8623900-96f6-11eb-b0e7- adef76ad73c2","code":"RECHARGE_COMPLETE","paid_amount":98," paid_currency":"NGN","topup_amount":100,"topup_currency":"N GN","target":"2348068885166","product_id":"MFIN-5- OR","time":"2021-04- 06T16:41:45.617Z","country":"Nigeria","operator_name":"MTN" ,"completed_in":745,"customer_reference":"475- 511834","api_transactionid":"2021040617414505802515644","pi n_based":false}

{
    // Response
}

Verify Completed Data Bundle Vending

POST http://epayment.com.ng/epayment/api/3pbundle_verify

Headers

Name	Type	Description
Bearer Token*	String	your-api-token

Request Body

Name	Type	Description
Body*	String	{ "customer_reference":"100123" }

200: OK {"status":201,"message":"Operation Successful, Recharge created, Reference : f8623900-96f6-11eb-b0e7- adef76ad73c2","reference":"f8623900-96f6-11eb-b0e7- adef76ad73c2","code":"RECHARGE_COMPLETE","paid_amount":98," paid_currency":"NGN","topup_amount":100,"topup_currency":"N GN","target":"2348068885166","product_id":"MFIN-5- OR","time":"2021-04- 06T16:41:45.617Z","country":"Nigeria","operator_name":"MTN" ,"completed_in":745,"customer_reference":"475- 511834","api_transactionid":"2021040617414505802515644","pi n_based":false}

{
    // Response
}

201: Created {"status":201,"message":"Operation Successful, Recharge created, Reference : f8623900-96f6-11eb-b0e7- adef76ad73c2","reference":"f8623900-96f6-11eb-b0e7- adef76ad73c2","code":"RECHARGE_COMPLETE","paid_amount":98," paid_currency":"NGN","topup_amount":100,"topup_currency":"N GN","target":"2348068885166","product_id":"MFIN-5- OR","time":"2021-04- 06T16:41:45.617Z","country":"Nigeria","operator_name":"MTN" ,"completed_in":745,"customer_reference":"475- 511834","api_transactionid":"2021040617414505802515644","pi n_based":false}

{
    // Response
}