Airtime VTU, Share & Sell
Data Gifting, SME, Transfer, Corporate
Data PIN
Transaction
Webhooks
Purchase Share & Sell
post
/airtime/share
Purchase Airtime
Body
{
"request_ref": "Request Ref",
"phone": "Phone Number",
"product_id": "Product ID/CODE",
"amount": "Amount",
"webhook_url": "Webhook URL",
"ported_no": "Boolean",
"pin": "Your pin"
}Parameters
| request_ref | Your unique Request Ref (Optional) |
| phone | Receiver Phone Number |
| product_id | Product id/code gotten from Category List here |
| amount | Airtime Amount |
| webhook_url | Optional. If not explicitly provided, the system will automatically utilize the webhook URL specified in your developer keys. |
| ported_no | Boolean (optional). If true, the system will ignore phone number validation errors and attempt to send airtime to the ported number. |
| 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": null,
"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"
}
]
}
}
}