paygate/payhost-helper

Merchant integration helper in PHP

PayHost

This library is merely a Merchant integration helper in PHP, _(*1)

Requirements: PHP 5.3 because of namespaces., _(*2)

Setup

Add a composer.json file to your project:, _(*3)

{
  "require": {
      "paygate/payhost-helper": "1.0.2"
  }
}

Then provided you have composer installed, you can run the following command:, _(*4)

$ composer.phar install

That will fetch the library and its dependencies inside your vendor folder. Then you can add the following to your .php files in order to use the library, _(*5)

require_once __DIR__.'/vendor/autoload.php';

Then you need to use the relevant classes, for example:, _(*6)

use PayGate\PayHost\Helper;

Usage

We start by mapping all our front end html inputs to their respective sections in the PayHost wsdl:, _(*7)

$inputMap = array();

The values in the array should be the html input names on the form, while the keys remain untouched as these are what the Helper class looks for., _(*8)

For an example of the array contents, look at the public $inputMap property in Helper.php., _(*9)

Initiate the Helper class, passing in the input map array:, _(*10)

$Helper = new Helper($inputMap);

At the moment, all the sanitizing of the inputs received from the form is not being done by the helper. One could use PHP's filter_var_array to create a new array containing the sanitized values., _(*11)

We'll call this new array $filteredPost for now., _(*12)

Then call setWebPaymentRequestMessage or setCardPaymentRequestMessage depending on your needs, and pass in the array created before:, _(*13)

$SinglePaymentRequest = $Helper->setWebPaymentRequestMessage($filteredPost);

Once the request object has been built, create valid XML from it by calling:, _(*14)

$xml = Helper::generateValidXmlFromObj($SinglePaymentRequest, 'SinglePaymentRequest');

We now have a valid XML to pass to PHP's SoapClient., _(*15)

eg., _(*16)

$SoapClient = new SoapClient("https://www.secure.paygate.co.za/payhost/process.trans?wsdl", array('trace' => 1)); //point to WSDL and set trace value to debug

try {
    /*
     * Send SOAP request
     */
    $result = $SoapClient->__soapCall('SinglePayment', array(
        new SoapVar($xml, XSD_ANYXML)
    ));
} catch (SoapFault $sf){
    /*
     * handle errors
     */
    $err = $sf->getMessage();
}