Airtime VTU, Share & Sell
Data Gifting, SME, Transfer, Corporate
Data PIN
Transaction
Webhooks
Change Subscription
post
/cable
Purchase Renewal / Free Entry / BoxOffice
Body
{
"request_ref": "Request Ref",
"iuc_number": "IUC Number",
"product_id": "Product ID/CODE",
"variation_code": "Variation",
"type": "change",
"is_box_office": "Boolean",
"month": "month",
"pin": "Your pin"
}Parameters
| request_ref | Your unique Request Ref (Optional) |
| iuc_number | This is the iuc number on which subscription will be recharged. |
| product_id | This can be any of the "ID/CODE" from the "Cable Tv Providers" here |
| variation_code | This is the identification code of the selected bouquet from "product variation" request page. here |
| type | type of subscription |
| is_box_office | This is an optional property that should only be added only if the account is a box office account only. |
| month | This is the number of months selected for the bouquets subscription from the "options" property retrieved from "Retrieve provider bouquets variations" request page. |
| pin | Your transaction pin |
Sample Response
{
"status": "ok",
"message": "Request successfully",
"data": {
"transaction": {
"id": 95,
"user_id": 1,
"user_product_id": 6,
"user_variation_id": 443,
"reference": "9bdbe400-76da-4d12-bccc-90d040704dc8",
"request_ref": "pZxmX4qjpOLRCx8d6jRc",
"type": "MTN Gifting",
"details": "MTN Gifting 15GB Weekly Digital Bundle sent to 07047341144",
"amount": "2000.00",
"status": "successful",
"request_data": {
"phone": "07047341144",
"product_id": 2,
"variation_code": "NACT_NG_Data_2003",
"request_ref": "pZxmX4qjpOLRCx8d6jRc"
},
"created_at": "2024-04-21T08:14:13.000000Z",
"updated_at": "2024-04-21T08:14:29.000000Z",
"gateway": {
"id": 7,
"name": "MTN Gateway",
"status": "connected",
"phone": "08134679853",
"is_site": false,
"created_at": "2024-04-12T06:35:38.000000Z"
},
"logs": [
{
"id": 604,
"user_id": 1,
"ip_address": "69.57.163.195",
"logger_type": "App\\Models\\Transaction",
"logger_id": 95,
"message": "",
"data": {
"name": "Unknown",
"subscriptionId": "NACT_NG_Data_2003",
"productId": "416",
"productName": "15GB Weekly Digital Bundle",
"rechargeType": "Normal",
"phoneNumber": "2347047341144",
"traceId": "UgeFwW6dVvcEq3JH7HL79pQZ5N7mQR",
"currency": "NGN",
"feeBearer": "M",
"amount": 2000,
"autoRenew": false
},
"is_admin_only": false,
"created_at": "2024-04-21T08:14:20.000000Z",
"updated_at": "2024-04-21T08:14:20.000000Z"
},
{
"id": 605,
"user_id": 1,
"ip_address": "69.57.163.195",
"logger_type": "App\\Models\\Transaction",
"logger_id": 95,
"message": "",
"data": {
"Pin": "1234",
"TranId": "54020240421091419869719",
"PhoneNumber": "8134679853"
},
"is_admin_only": false,
"created_at": "2024-04-21T08:14:28.000000Z",
"updated_at": "2024-04-21T08:14:28.000000Z"
}
]
}
}
}