Documentation

Features

Differences

This shows you the differences between the selected revision and the current version of the page.

development:gateways 2008/08/24 09:58 development:gateways 2008/10/24 10:06 current
Line 1: Line 1:
====== Payment Gateways ====== ====== Payment Gateways ======
 +Instructions for adding a new payment gateway. All payment gateway code is located in includes/paymentapi/ folder.  Inside this folder you will need to create a new folder to house your custom code created below.
===== Config.php ===== ===== Config.php =====
Line 106: Line 107:
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. 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']; 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. 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. 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. 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. Finally if the order is approved. Paymate uses the PA which I assume means PAID.
Line 115: Line 120:
<code php> <code php>
if($Orders->updateOrder($orderid, 'Y')) if($Orders->updateOrder($orderid, 'Y'))
- +
- return TRUE; + return TRUE; 
- +
- else +else 
- +
- //an error occured + //an error occured 
- return "Payment was made but your order has not been approved. Please contact support for help."; + return "Payment was made but your order has not been approved. Please contact support for help."; 
- }+}
</code> </code>
Line 128: Line 133:
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. 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.
 +
 +===== External Resources  =====
 +  * [[http://php.net|PHP Website]]
 +  * [[http://www.68classifieds.com/forums|68 Classifieds Forums]]
 +
 +

Have more questions? Visit our community forums.