Buy Airtime

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

Use this method to purchase Airtime 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. Buy Airtime: make a call to this endpoint to purchase airtime.
Supply the parameters obtained from the above steps to complete the payload.

Responses

Language

Credentials

OAuth2


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

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

application/json

200200

400400