CRM/Core/Payment/Dummy.php

   1 <?php
   2 /*
   3  * Copyright (C) 2007
   4  * Licensed to CiviCRM under the Academic Free License version 3.0.
   5  *
   6  * Written and contributed by Ideal Solution, LLC (http://www.idealso.com)
   7  *
   8  */
   9
  10 /**
  11  *
  12  * @package CRM
  13  * @author Marshal Newrock <marshal@idealso.com>
  14  * $Id: Dummy.php 45429 2013-02-06 22:11:18Z lobo $
  15  */
  16
  17 /**
  18  * Dummy payment processor
  19  */
  20 class CRM_Core_Payment_Dummy extends CRM_Core_Payment {
  21   const CHARSET = 'iso-8859-1';
  22
  23   protected $_mode = NULL;
  24
  25   protected $_params = array();
  26   protected $_doDirectPaymentResult = array();
  27
  28   /**
  29    * Set result from do Direct Payment for test purposes.
  30    *
  31    * @param array $doDirectPaymentResult
  32    *  Result to be returned from test.
  33    */
  34   public function setDoDirectPaymentResult($doDirectPaymentResult) {
  35     $this->_doDirectPaymentResult = $doDirectPaymentResult;
  36     if (empty($this->_doDirectPaymentResult['trxn_id'])) {
  37       $this->_doDirectPaymentResult['trxn_id'] = array();
  38     }
  39     else {
  40       $this->_doDirectPaymentResult['trxn_id'] = (array) $doDirectPaymentResult['trxn_id'];
  41     }
  42   }
  43
  44   /**
  45    * We only need one instance of this object. So we use the singleton
  46    * pattern and cache the instance in this variable
  47    *
  48    * @var object
  49    */
  50   static private $_singleton = NULL;
  51
  52   /**
  53    * Constructor.
  54    *
  55    * @param string $mode
  56    *   The mode of operation: live or test.
  57    *
  58    * @param $paymentProcessor
  59    *
  60    * @return \CRM_Core_Payment_Dummy
  61    */
  62   public function __construct($mode, &$paymentProcessor) {
  63     $this->_mode = $mode;
  64     $this->_paymentProcessor = $paymentProcessor;
  65     $this->_processorName = ts('Dummy Processor');
  66   }
  67
  68   /**
  69    * Submit a payment using Advanced Integration Method.
  70    *
  71    * @param array $params
  72    *   Assoc array of input parameters for this transaction.
  73    *
  74    * @return array
  75    *   the result in a nice formatted array (or an error object)
  76    */
  77   public function doDirectPayment(&$params) {
  78     // Invoke hook_civicrm_paymentProcessor
  79     // In Dummy's case, there is no translation of parameters into
  80     // the back-end's canonical set of parameters.  But if a processor
  81     // does this, it needs to invoke this hook after it has done translation,
  82     // but before it actually starts talking to its proprietary back-end.
  83     if (!empty($params['is_recur'])) {
  84       $throwAnENoticeIfNotSetAsTheseAreRequired = $params['frequency_interval'] . $params['frequency_unit'];
  85     }
  86     // no translation in Dummy processor
  87     $cookedParams = $params;
  88     CRM_Utils_Hook::alterPaymentProcessorParams($this,
  89       $params,
  90       $cookedParams
  91     );
  92     // This means we can test failing transactions by setting a past year in expiry. A full expiry check would
  93     // be more complete.
  94     if (!empty($params['credit_card_exp_date']['Y']) && date('Y') >
  95       CRM_Core_Payment_Form::getCreditCardExpirationYear($params)) {
  96       $error = new CRM_Core_Error(ts('transaction failed'));
  97       return $error;
  98     }
  99     //end of hook invocation
 100     if (!empty($this->_doDirectPaymentResult)) {
 101       $result = $this->_doDirectPaymentResult;
 102       $result['trxn_id'] = array_shift($this->_doDirectPaymentResult['trxn_id']);
 103       return $result;
 104     }
 105     if ($this->_mode == 'test') {
 106       $query = "SELECT MAX(trxn_id) FROM civicrm_contribution WHERE trxn_id LIKE 'test\\_%'";
 107       $p = array();
 108       $trxn_id = strval(CRM_Core_Dao::singleValueQuery($query, $p));
 109       $trxn_id = str_replace('test_', '', $trxn_id);
 110       $trxn_id = intval($trxn_id) + 1;
 111       $params['trxn_id'] = 'test_' . $trxn_id . '_' . uniqid();
 112     }
 113     else {
 114       $query = "SELECT MAX(trxn_id) FROM civicrm_contribution WHERE trxn_id LIKE 'live_%'";
 115       $p = array();
 116       $trxn_id = strval(CRM_Core_Dao::singleValueQuery($query, $p));
 117       $trxn_id = str_replace('live_', '', $trxn_id);
 118       $trxn_id = intval($trxn_id) + 1;
 119       $params['trxn_id'] = 'live_' . $trxn_id . '_' . uniqid();
 120     }
 121     $params['gross_amount'] = $params['amount'];
 122     // Add a fee_amount so we can make sure fees are handled properly in underlying classes.
 123     $params['fee_amount'] = 1.50;
 124     $params['net_amount'] = $params['gross_amount'] - $params['fee_amount'];
 125
 126     return $params;
 127   }
 128
 129   /**
 130    * Are back office payments supported - e.g paypal standard won't permit you to enter a credit card associated with someone else's login
 131    * @return bool
 132    */
 133   protected function supportsLiveMode() {
 134     return TRUE;
 135   }
 136
 137   /**
 138    * Generate error object.
 139    *
 140    * Throwing exceptions is preferred over this.
 141    *
 142    * @param string $errorCode
 143    * @param string $errorMessage
 144    *
 145    * @return CRM_Core_Error
 146    *   Error object.
 147    */
 148   public function &error($errorCode = NULL, $errorMessage = NULL) {
 149     $e = CRM_Core_Error::singleton();
 150     if ($errorCode) {
 151       $e->push($errorCode, 0, NULL, $errorMessage);
 152     }
 153     else {
 154       $e->push(9001, 0, NULL, 'Unknown System Error.');
 155     }
 156     return $e;
 157   }
 158
 159   /**
 160    * This function checks to see if we have the right config values.
 161    *
 162    * @return string
 163    *   the error message if any
 164    */
 165   public function checkConfig() {
 166     return NULL;
 167   }
 168
 169 }