Skip to main content
POST
/
purchaseData
Purchase Data
curl --request POST \
  --url https://api.bleeprs.com/api/purchaseData \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "phoneNumber": "08107176819",
    "productCode": "LV_MTN_1000_34",
    "voucherCode": "LV_MTN",
    "network": "LV_MTN"
  }
]
'
{
  "gatewayStatus": "00",
  "gatewayMessage": "Sucessfully Processed",
  "requestReference": "KpEAFZutv3SvQ4aMjrv7",
  "data": "Data purchased processing"
}

Overview

Purchase a data bundle for any Nigerian phone number using a specific product code. The data will be credited instantly to the recipient’s phone.

How to Use

  1. Get Available Plans: First, call the List Data Plans endpoint to see available data plans for a specific network
  2. Select Product Code: Choose the desired data plan and note its ProductCode
  3. Purchase Data: Use the ProductCode in this endpoint to purchase the data bundle

Example Product Codes

  • LV_MTN_XTRADATA_3DAYS_200_200 - MTN 200MB for 3 days
  • LV_GLOBACOM_DATA_14DAYS_1800MB_500 - Glo 1.8GB for 14 days
  • LV_AIRTEL_DATA_1DAY_1GB_300 - Airtel 1GB for 1 day

Notes

  • Data is credited instantly to the recipient’s phone
  • Phone numbers should be in Nigerian format (e.g., 08107176819)
  • Product codes are case-sensitive
  • Transaction processing may take a few seconds
  • Ensure the phone number is on the correct network for the data plan

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
Minimum array length: 1
phoneNumber
string
required

Recipient's phone number (Nigerian format)

Example:

"08107176819"

productCode
string
required

Product code for the data plan

Example:

"LV_MTN_XTRADATA_3DAYS_200_200"

network
string
required

Target network operator

Example:

"MTN"

voucherCode
string
required

Catalog-provided voucher code identifier

Example:

"LV_MTN_1.5GB"

amount
number

Cost of the data bundle as mapped in the system

Example:

1000

Response

202 - application/json

Data purchase accepted for processing

gatewayStatus
string
Example:

"00"

gatewayMessage
string
Example:

"Sucessfully Processed"

requestReference
string
Example:

"KpEAFZutv3SvQ4aMjrv7"

data
string
Example:

"Data purchased processing"