For making Wahid eLoad requests programmatically, please follow these steps.

• Follow the API details here or use our PHP API client api-2.0.2.tar.gz e.g. extract these under /opt directory
• cd /opt
• wget http://github.com/wahid-eload/api/archive/2.0.2.tar.gz
• tar -xzvf 2.0.2.tar.gz
• ln -s api-2.0.2/weconnect weconnect
• NOTE:Make sure that these files are not accessible via your web root directory. As these files contains your API key and other private information, so never make it accessible from your web root directory.
• After extracting you should get /opt/weconnect/api directory which will contain the following files
• WeConnect.php: This file contains the WeConnect class for sending wahid requests.
• settings.php: This contains the API key and other settings. Please see your API Settings here and change the values in this file.
• CA-cert.pem: This is weconnect server certificate.
• check.php: Helper script to test if your system have all the needed extensions/modules
• You can also download and extract api-examples-1.0.5.tar.gz API examples to see how you can use WeConnect class to make wahid eload requests.
• If you have extracted weconnect api in different directory then please replace /opt to the correct path in api-examples-1.0.5/examples/init.php file.
• Available commands, their parameters and return codes/messages detail are available here
• Some examples of using WeConnect class are shown below


• Any commands: Detail of all commands and their required parameters are available here

    $we = WeConnect();
    $xml = $we->request("1", array('company'=>30, 'number'=>3001234567, 'amount'=>30));
    if (isset($xml->error))
    {
      foreach ($xml->error as $e){print "Error:".$e['value']."\n";}
    }
    if (isset($xml->warning))
    {
      foreach ($xml->warning as $e){print "Warning:".$e['value']."\n";}
    }
    if (isset($xml->message))
    {
      foreach ($xml->message as $e){print "".$e['value']."\n";}
    }
    print "Request status:".$xml->status[0]['value']."\n";

• Getting Balance:

    $we = new WeConnect();
    $xml = $we->request("35");
    if ($xml->status[0]['code']=="1")
    {
      if (isset($xml->balance))
      {
        print "Balance: ".$xml->balance[0]['value']."\n";
      }
    }

• Query using request ID:

    $we = new WeConnect();
    $xml = $we->request("0",array('webid' => 12345));
    if (isset($xml->error))
    {
      foreach ($xml->error as $e){print "Error:".$e['value']."\n";}
    }
    if (isset($xml->warning))
    {
      foreach ($xml->warning as $e){print "Warning:".$e['value']."\n";}
    }
    if (isset($xml->message))
    {
      foreach ($xml->message as $e){print "".$e['value']."\n";}
    }

• Query Operator RefID for a Wahid TID:

    $we = new WeConnect();
    $xml = $we->request("refid",array('tid' => 12345));
    if (isset($xml->error))
    {
      foreach ($xml->error as $e){print "Error:".$e['value']."\n";}
    }
    if (isset($xml->warning))
    {
      foreach ($xml->warning as $e){print "Warning:".$e['value']."\n";}
    }
    if (isset($xml->message))
    {
      foreach ($xml->message as $e){print "".$e['value']."\n";}
    }

• All Loads Request:

    $we = new WeConnect();
    $xml=$we->request("2", array('company'=>31, 'mtype'=>4, 'amount'=>335, 'number'=>'3001234567'));
    if (isset($xml->error))
    {
      foreach ($xml->error as $e){print "Error:".$e['value']."\n";}
    }
    if (isset($xml->warning))
    {
      foreach ($xml->warning as $e){print "Warning:".$e['value']."\n";}
    }
    if (isset($xml->message))
    {
      foreach ($xml->message as $e){print "".$e['value']."\n";}
    }
    $id=0;
    if ($xml->status[0]['code']=="1")
    {
      if (isset($xml->webid) && ($xml->webid[0]['value']>1))
      {$id=$xml->webid[0]['value'];}
    }
    if ($id>0){print "Request successfully registered: $id\n";}
    else{print "Error: Unable to register the request, please fix the error and try again.\n";}

• EasyLoad Request: Deprecating soon, use All Loads (2) command instead

    $we = new WeConnect();
    $xml=$we->request("1", array('number'=>'3001234567', 'company'=>30, 'amount'=>200));
    if (isset($xml->error))
    {
      foreach ($xml->error as $e){print "Error:".$e['value']."\n";}
    }
    if (isset($xml->warning))
    {
      foreach ($xml->warning as $e){print "Warning:".$e['value']."\n";}
    }
    if (isset($xml->message))
    {
      foreach ($xml->message as $e){print "".$e['value']."\n";}
    }
    $id=0;
    if ($xml->status[0]['code']=="1")
    {
      if (isset($xml->webid) && ($xml->webid[0]['value']>1))
      {
        $id=$xml->webid[0]['value'];
      }
    }
    if ($id>0){print "Request successfully registered: $id\n";}
    else{print "Error: Unable to register the request, please fix the error and try again.\n";}

• Postpay Request: Deprecating soon, use All Loads (2) command instead

    $we = new WeConnect();
    $xml=$we->request("9", array('number'=>'3001234567', 'company'=>30, 'amount'=>200));
    if (isset($xml->error))
    {
      foreach ($xml->error as $e){print "Error:".$e['value']."\n";}
    }
    if (isset($xml->warning))
    {
      foreach ($xml->warning as $e){print "Warning:".$e['value']."\n";}
    }
    if (isset($xml->message))
    {
      foreach ($xml->message as $e){print "".$e['value']."\n";}
    }
    $id=0;
    if ($xml->status[0]['code']=="1")
    {
      if (isset($xml->webid) && ($xml->webid[0]['value']>1))
      {
        $id=$xml->webid[0]['value'];
      }
    }
    if ($id>0){print "Request successfully registered: $id\n";}
    else{print "Error: Unable to register the request, please fix the error and try again.\n";}

In order to make API calls without our API clients, you need to implement something like the following

• Send a POST request to https://www.weconnet.com.pk/api/v2 with following parameters in POST request
• user=register-number is your registration number (without starting 0 e.g. 3001234567)
• request=request-number is any valid Wahid Request number defined here. For example 1 for pre-paid easyload, 2 for balance check, 3 for self load etc.
• pin=wahid-pin is 4 to 6 digit wahid eload pin.
• parameter=value are parameters needed for the request e.g. number=3121234567&amount=30&company=31 for sending 30 RS load to Zong number 3121234567
• Set the following Headers in your HTTPS request
• Authorization: signature
• WahidToken: unique-token
Where
  unique-token is md5 hash of any unqiue string. Each request should have a different unique-token.
  signature is md5 hash of string apikey=your-api-key;token=uniq-token-md5-hash
• An example of calling api using curl is
  curl --cacert path/of/weconnect/CA-cert.pem -H 'Authorization: 12345678901234567890123456789ab' -H 'WahidToken: 987654321098765432109876543210ab' --data 'user=3001234567&pin=012345&request=1&number=3121234567&amount=30&company=31' 'https://www.weconnect.com.pk/api/v2'