Validate Top-Up Status

Get the status of airtime or data top-up

POST {{BASE_URL}}/v1/corporate/topup-status

Body Parameters

Property	Data Type	Description	Example	Required
reference	string	The transaction reference returned from performing a bill payment transaction	"VPX6ca6cefa-34c74eb4"	Yes

Node.js

import Axios from 'axios';

// set the api url
const API_URL = `${BASE_URL}/v1/corporate/topup-status`;

// define request body
const data = {
    reference: "VPX6ca6cefa-34c74eb4"
}

// make request using axios
Axios({
    method: "GET",
    url: `${API_URL}`,
    headers: {
        lg: 'en',
        ch: 'web'
        Authorization: `Bearer ${API_KEY}`,
        'Content-Type': 'application/json',
    },
    data: data
}).then((resp) => {
    console.log(resp)
}).catch((err) => {
    console.log(err)
})

Response

{
    "error": false,
    "errors": [],
    "data": {
        "reference": "VPX6ca6cefa-34c74eb4",
        "status": "completed",
        "billerCode": "",
        "billerName": "",
        "hasToken": false,
        "token": "",
        "network": "mtn",
        "phoneNumber": "[phone]",
        "type": "airtime"
    },
    "message": "500 mtn airtime purchased via Softklin Services wallet",
    "status": 200
}