This library is merely a Merchant integration helper in PHP
Requirements: PHP 5.3 because of namespaces.
Add a composer.json
file to your project:
{
"require": {
"paygate/payhost-helper": "1.0.2"
}
}
Then provided you have composer installed, you can run the following command:
$ 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
require_once __DIR__.'/vendor/autoload.php';
Then you need to use
the relevant classes, for example:
use PayGate\PayHost\Helper;
We start by mapping all our front end html inputs to their respective sections in the PayHost wsdl:
$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.
For an example of the array contents, look at the public $inputMap
property in Helper.php
.
Initiate the Helper
class, passing in the input map array:
$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.
We'll call this new array $filteredPost
for now.
Then call setWebPaymentRequestMessage
or setCardPaymentRequestMessage
depending on your needs, and pass in the array created before:
$SinglePaymentRequest = $Helper->setWebPaymentRequestMessage($filteredPost);
Once the request object has been built, create valid XML from it by calling:
$xml = Helper::generateValidXmlFromObj($SinglePaymentRequest, 'SinglePaymentRequest');
We now have a valid XML to pass to PHP's SoapClient.
eg.
$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();
}