Recharge Dstv

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

Use this method to make Cable Tv recharge for Dstv 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 Dstv per country using the alpha 2 code.

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

5. Get Dstv Bouquet: make a call to this endpoint to fetch all the available Dstv Bouquet Types.
Supply the biller code in this request - DSTV1

6. Recharge Dstv: make a call to this endpoint to Recharge Dstv.
Supply the parameters obtained from the above steps to complete the payload

Body Params

amount

int32

Defaults to 2950

this is the value of the dstv bouquet 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 DSTV1

This is the specific biller code for Dstv

bundle type

string

Defaults to NNJ1E36

Input the bundle type from the list of Get Dstv Bouquet fetched

country

string

Defaults to NG

This is set as Nigeria i.e NG

identifier

string

Defaults to NGA30010

This is the unique biller identifier for Dstv

narration

string

Defaults to testing

This is the reason, purpose or short description of the transaction

numberOfMonths

int32

Defaults to 1

This is the duration (in months) of the Dstv Subscription

phone number

string

Defaults to NGA30010

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

smartCardNumber

string

Defaults to smartCardNumber

This is the registered Dstv Smart Card Number

Responses

Language

Credentials

OAuth2


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

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

application/json

200200

400400