4. sr.php

The file sr.php or send and receive is used to handle setting up the form and handling the post back.

This file includes two php functions and they are:

and

These functions include the name of your gateway then the function name. The first portion comes from the $data['gateway']['name'] variable set in the config file.

So if you named your gateway ?kingarthur? then your functions would be:

and

These method is used by the core files to tell the difference from each gateway.

Now that the function names are out of the way we will move on to the $params array that is passed to the functions.

Create Form

The createform function has these available $params.

$params['oID'] - Order ID
$params['extra'] - The extra info
$params['extra2'] - The second extra info
$params['oProduct'] - The product name ordered
$params['oTotal'] - The total price
$params['userinfo'] ? An array of all the users details.

If you wish to see all of the available params you can add the following php inside the function:
print_r($params); die;
Then a list of variables will be printed when you place a test ad.

Process Transaction

The processTransaction function has these available $params.

$params['gatewayid'] - The id of the gateway
$params['approved'] - Y or N depending on if it is approved.
$params['extra'] ? The extra data defined in administration
$params['extra2'] ? Same as above.

Plus any others from your Payment Gateway. You will need to refer to their documentation on what they are.
Since the check / money order gateway doesn't include the post back information you will probably need, we will use the processTransaction function from the Paymate gateway:

function paymate_processTransaction($params)
{
	global $db,$Orders,$userid;

$orderid = (int)@$params['ref'];
	switch ($params['responseCode'])
	{
		case "PA":
			$Orders->logTransaction($params['gatewayid'], $orderid, 'Payment is approved', $userid, $params['transactionID'], $params['paymentAmount']);
			if($Orders->updateOrder($orderid, 'Y'))
			{
				return TRUE;
			}
			else
			{
				//an error occured
				return "Payment was made but your order has not been approved. Please contact support for help.";
			}
		break;
		case "PD":
			$Orders->logTransaction($params['gatewayid'], $orderid, 'Payment is declined', $userid, $params['transactionID'], $params['paymentAmount']);
			return "Payment is declined";
		break;
		case "PP":
			$Orders->logTransaction($params['gatewayid'], $orderid, 'Payment is processing', $userid, $params['transactionID'], $params['paymentAmount']);
			return "Payment is processing";
		break;
		default:
			$Orders->logTransaction($params['gatewayid'], $orderid, 'An error occured', $userid, $params['transactionID'], $params['paymentAmount']);
			return "We are sorry but an occured.";
		break;	
	}
}

Starting from the top we include global $db, $Orders, $userid. I will not go into details what the global does but you can find out from php.net.

Next we have $orderid = (int)@$params['ref'];
The $params['ref'] comes from Paymate and that is the internal reference for 68 Classifieds so it knows what order to approve.
After that comes a switch statement which is the response code Paymate sent.
Through each case we call the logtransaction function so the administrator knows they tried to complete the payment but something happened.
Finally if the order is approved. Paymate uses the PA which I assume means PAID.

We then update the order with this call:

If it returns true then the order was successfully updated if not it returns an error and something happened inside the Orders class to make the order not be updated.

As you can see creating a custom gateway is not a simple process and as such is not supported by us. A lot of things can go wrong and it will take some trial and error getting it setup properly.

Still have a question? Post it on the Help Forums.

4. sr.php

Related Articles