3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.6 |
5 +--------------------------------------------------------------------+
6 | This file is a part of CiviCRM. |
8 | CiviCRM is free software; you can copy, modify, and distribute it |
9 | under the terms of the GNU Affero General Public License |
10 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
12 | CiviCRM is distributed in the hope that it will be useful, but |
13 | WITHOUT ANY WARRANTY; without even the implied warranty of |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
15 | See the GNU Affero General Public License for more details. |
17 | You should have received a copy of the GNU Affero General Public |
18 | License and the CiviCRM Licensing Exception along |
19 | with this program; if not, contact CiviCRM LLC |
20 | at info[AT]civicrm[DOT]org. If you have questions about the |
21 | GNU Affero General Public License or the licensing of CiviCRM, |
22 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
23 +--------------------------------------------------------------------+
28 * PxPay Functionality Copyright (C) 2008 Lucas Baker, Logistic Information Systems Limited (Logis)
29 * PxAccess Functionality Copyright (C) 2008 Eileen McNaughton
30 * Licensed to CiviCRM under the Academic Free License version 3.0.
32 * Grateful acknowledgements go to Donald Lobo for invaluable assistance
33 * in creating this payment processor module
37 * Class CRM_Core_Payment_PaymentExpress
39 class CRM_Core_Payment_PaymentExpress
extends CRM_Core_Payment
{
40 const CHARSET
= 'iso-8859-1';
42 protected $_mode = NULL;
45 * We only need one instance of this object. So we use the singleton
46 * pattern and cache the instance in this variable
51 static private $_singleton = NULL;
57 * The mode of operation: live or test.
59 * @param $paymentProcessor
61 * @return \CRM_Core_Payment_PaymentExpress
63 public function __construct($mode, &$paymentProcessor) {
66 $this->_paymentProcessor
= $paymentProcessor;
67 $this->_processorName
= ts('DPS Payment Express');
71 * Singleton function used to manage this object
74 * The mode of operation: live or test.
76 * @param object $paymentProcessor
77 * @param null $paymentForm
83 public static function &singleton($mode = 'test', &$paymentProcessor, &$paymentForm = NULL, $force = FALSE) {
84 if (!empty($paymentProcessor['id'])) {
85 $cacheKey = $paymentProcessor['id'];
88 //@todo eliminated instances of this in favour of id-specific instances.
89 $cacheKey = $mode . '_' . $paymentProcessor['name'];
91 if (self
::$_singleton[$cacheKey] === NULL) {
92 self
::$_singleton[$cacheKey] = new CRM_Core_Payment_PaymentExpress($mode, $paymentProcessor);
94 return self
::$_singleton[$cacheKey];
98 * This function checks to see if we have the right config values
100 * @internal param string $mode the mode we are operating in (live or test)
102 * @return string the error message if any
104 public function checkConfig() {
105 $config = CRM_Core_Config
::singleton();
109 if (empty($this->_paymentProcessor
['user_name'])) {
110 $error[] = ts('UserID is not set in the Administer » System Settings » Payment Processors');
113 if (empty($this->_paymentProcessor
['password'])) {
114 $error[] = ts('pxAccess / pxPay Key is not set in the Administer » System Settings » Payment Processors');
117 if (!empty($error)) {
118 return implode('<p>', $error);
126 * @param array $params
130 public function setExpressCheckOut(&$params) {
131 CRM_Core_Error
::fatal(ts('This function is not implemented'));
139 public function getExpressCheckoutDetails($token) {
140 CRM_Core_Error
::fatal(ts('This function is not implemented'));
144 * @param array $params
148 public function doExpressCheckout(&$params) {
149 CRM_Core_Error
::fatal(ts('This function is not implemented'));
153 * This function collects all the information from a web/api form and invokes
154 * the relevant payment processor specific functions to perform the transaction
156 * @param array $params
157 * Assoc array of input parameters for this transaction.
159 * @return array the result in an nice formatted array (or an error object)
162 public function doDirectPayment(&$params) {
163 CRM_Core_Error
::fatal(ts('This function is not implemented'));
167 * Main transaction function
169 * @param array $params
170 * Name value pair of contribution data.
176 public function doTransferCheckout(&$params, $component) {
177 $component = strtolower($component);
178 $config = CRM_Core_Config
::singleton();
179 if ($component != 'contribute' && $component != 'event') {
180 CRM_Core_Error
::fatal(ts('Component is invalid'));
183 $url = $config->userFrameworkResourceURL
. "extern/pxIPN.php";
185 if ($component == 'event') {
186 $cancelURL = CRM_Utils_System
::url('civicrm/event/register',
187 "_qf_Confirm_display=true&qfKey={$params['qfKey']}",
191 elseif ($component == 'contribute') {
192 $cancelURL = CRM_Utils_System
::url('civicrm/contribute/transact',
193 "_qf_Confirm_display=true&qfKey={$params['qfKey']}",
199 * Build the private data string to pass to DPS, which they will give back to us with the
201 * transaction result. We are building this as a comma-separated list so as to avoid long URLs.
203 * Parameters passed: a=contactID, b=contributionID,c=contributionTypeID,d=invoiceID,e=membershipID,f=participantID,g=eventID
206 $privateData = "a={$params['contactID']},b={$params['contributionID']},c={$params['contributionTypeID']},d={$params['invoiceID']}";
208 if ($component == 'event') {
209 $merchantRef = substr($params['contactID'] . "-" . $params['contributionID'] . " " . substr($params['description'], 27, 20), 0, 24);
210 $privateData .= ",f={$params['participantID']},g={$params['eventID']}";
212 elseif ($component == 'contribute') {
213 $membershipID = CRM_Utils_Array
::value('membershipID', $params);
215 $privateData .= ",e=$membershipID";
217 $merchantRef = substr($params['contactID'] . "-" . $params['contributionID'] . " " . substr($params['description'], 20, 20), 0, 24);
222 'AmountInput' => str_replace(",", "", number_format($params['amount'], 2)),
223 'CurrencyInput' => $params['currencyID'],
224 'MerchantReference' => $merchantRef,
225 'TxnData1' => $params['qfKey'],
226 'TxnData2' => $privateData,
227 'TxnData3' => $component . ",".$this->_paymentProcessor
['id'],
228 'TxnType' => 'Purchase',
229 // Leave this empty for now, causes an error with DPS if we populate it
232 'UrlSuccess' => $url,
234 // Allow further manipulation of params via custom hooks
235 CRM_Utils_Hook
::alterPaymentProcessorParams($this, $params, $dpsParams);
238 * determine whether method is pxaccess or pxpay by whether signature (mac key) is defined
241 if (empty($this->_paymentProcessor
['signature'])) {
245 * This contains the XML/Curl functions we'll need to generate the XML request
248 $dpsParams['PxPayUserId'] = $this->_paymentProcessor
['user_name'];
249 $dpsParams['PxPayKey'] = $this->_paymentProcessor
['password'];
250 // Build a valid XML string to pass to DPS
251 $generateRequest = CRM_Core_Payment_PaymentExpressUtils
::_valueXml($dpsParams);
253 $generateRequest = CRM_Core_Payment_PaymentExpressUtils
::_valueXml('GenerateRequest', $generateRequest);
254 // Get the special validated URL back from DPS by sending them the XML we've generated
255 $curl = CRM_Core_Payment_PaymentExpressUtils
::_initCURL($generateRequest, $this->_paymentProcessor
['url_site']);
258 if ($response = curl_exec($curl)) {
260 $valid = CRM_Core_Payment_PaymentExpressUtils
::_xmlAttribute($response, 'valid');
262 // the request was validated, so we'll get the URL and redirect to it
263 $uri = CRM_Core_Payment_PaymentExpressUtils
::_xmlElement($response, 'URI');
264 CRM_Utils_System
::redirect($uri);
267 // redisplay confirmation page
268 CRM_Utils_System
::redirect($cancelURL);
272 // calling DPS failed
273 CRM_Core_Error
::fatal(ts('Unable to establish connection to the payment gateway.'));
277 $processortype = "pxaccess";
278 require_once 'PaymentExpress/pxaccess.inc.php';
280 $PxAccess_Url = $this->_paymentProcessor
['url_site'];
282 $PxAccess_Userid = $this->_paymentProcessor
['user_name'];
283 // Your DES Key from DPS
284 $PxAccess_Key = $this->_paymentProcessor
['password'];
285 // Your MAC key from DPS
286 $Mac_Key = $this->_paymentProcessor
['signature'];
288 $pxaccess = new PxAccess($PxAccess_Url, $PxAccess_Userid, $PxAccess_Key, $Mac_Key);
289 $request = new PxPayRequest();
290 $request->setAmountInput($dpsParams['AmountInput']);
291 $request->setTxnData1($dpsParams['TxnData1']);
292 $request->setTxnData2($dpsParams['TxnData2']);
293 $request->setTxnData3($dpsParams['TxnData3']);
294 $request->setTxnType($dpsParams['TxnType']);
295 $request->setInputCurrency($dpsParams['InputCurrency']);
296 $request->setMerchantReference($dpsParams['MerchantReference']);
297 $request->setUrlFail($dpsParams['UrlFail']);
298 $request->setUrlSuccess($dpsParams['UrlSuccess']);
299 $request_string = $pxaccess->makeRequest($request);
300 CRM_Utils_System
::redirect($request_string);