Purchase Subscription

post
Purchase a cable tv subscription

https://test.platform.baxi.com.ng/services/multichoice/request
Request
Response
Request
Headers
Baxi-date
required
string
Current date in RFC format
Authorization
required
string
See the authentication page
Body Parameters
total_amount
required
string
This is the summation of the total amount for for the bouquet and addons selected. i.e Total_Amount = Selected Bouquet (price * month) + Optional Selected Addon (price * month).
addon_monthsPaidFor
optional
string
This is the number of months selected for the addons subscription from the "availablePricingOption" property retrieved from the "Retrieve Bouquet Addons" page.
addon_code
optional
string
(Optional) This is the identification code of the selected addon from "Retrieve Bouquet Addons" page
product_monthsPaidFor
required
string
This is the number of months selected for the bouquets subscription from the "availablePricingOption" property retrieved from "Retrieve provider bouquets" request page.
product_code
required
string
This is the identification code of the selected bouquet from "Retrieve provider Bouquets" request page.
smartcard_number
required
string
This is the smart card number on which subscription will be recharged.
agentReference
required
string
This is a unique identification number generated by the integrator to identify this transaction.
agentId
required
number
This is the unique identification number given to the integrator.
service_type
required
string
This can be any of the "service_type" from the "Cable Tv Providers". This can be (dstv, gotv)
Response
200: OK
status: The success status means the transaction is successful message: just a description of the transaction status data: has an object property. - statusCode: "0" means the transaction is successful - transactionStatus: Response from the airtime provider - transactionReference: This is the transaction reference generated by our B2B platform. This is the transaction reference you need to be able to do a re-query of the said transaction. - transactionMessage: successful message response.
{
"status": "success",
"message": "Successful",
"code": 200,
"data": {
"statusCode": "0",
"transactionStatus": "success",
"transactionReference": 3,
"transactionMessage": "Cable TV Subcription successful"
}
}