Buy Data

post https://sandbox.paddieswitch.com/api/v1/bills-payment/data

Use this method to purchase Data by following the procedure below:

1. Authentication – make a call to the authentication endpoint.

2. Authorization: - authorize with the token generated from the authentication call above.

3. List Billers by Country Alpha 2 Code: make a call to this endpoint to fetch the list of all billers available for airtime/data per country using the alpha 2 code.

4. Obtain the biller’s name, biller code and identifier from number 3 above.

5. Get Data Bundles: make a call to this endpoint and supply the biller code obtained from step 3 above to get the bundle type and bundle description.

6. Buy Data: make a call to this endpoint to purchase Data.
Supply the parameters obtained from the above steps to complete the payload.

Body Params

amount

int32

Defaults to 100

this is the value of data you wish to purchase

beneficiary currency

string

Defaults to NGN

this is the recipient's currency. The value is set as NGN by default for Nigeria (naira)

biller code

string

Defaults to data

This is the specific biller code of the biller you wish to purchase data from

bundle type

string

Defaults to 9

Input the bundle type from the list of Data Bundles fetched

country

string

Defaults to NG

This is set as Nigeria i.e NG

identifier

string

Defaults to NGA30002

This is the unique biller identifier for Data

narration

string

Defaults to test

This is the reason or purpose of the data purchase

phone number

string

Defaults to 08139926828

This is the recipient's phone number

sender currency

string

Defaults to NGN

this is the sender's currency

sessionId

string

Defaults to 62173202092022

this is the unique transaction reference

Responses

Language

Credentials

OAuth2


xxxxxxxxxx
18
1
curl --request POST \
2
     --url https://sandbox.paddieswitch.com/api/v1/bills-payment/data \
3
     --header 'Content-Type: application/json' \
4
     --header 'accept: application/json' \
5
     --data '
6
{
7
  "amount": 100,
8
  "beneficiary currency": "NGN",
9
  "biller code": "data",
10
  "bundle type": "9",
11
  "country": "NG",
12
  "identifier": "NGA30002",
13
  "narration": "test",
14
  "phone number": "08139926828",
15
  "sender currency": "NGN",
16
  "sessionId": "62173202092022"
17
}
18
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400