You are here

class pay_method_gateway in Pay 6

Same name and namespace in other branches
  1. 7 includes/handlers/pay_method_gateway.inc \pay_method_gateway

@file The base class for credit card payment activities.

Hierarchy

Expanded class hierarchy of pay_method_gateway

1 string reference to 'pay_method_gateway'
hook_pay_method_handler_info in ./pay.api.php
This hook is used to inform Pay of available payment method handlers. Administrators will be able to create new instances of payment methods, based on the capabilities and options for your handler(s).

File

includes/handlers/pay_method_gateway.inc, line 8
The base class for credit card payment activities.

View source
class pay_method_gateway extends pay_method {
  var $payment_types = array();
  var $gateway_testmode = TRUE;

  // Each subclass should define these according to capabilities.
  var $gateway_supports_ach = FALSE;
  var $gateway_supports_cc = TRUE;
  var $gateway_supports_recurring = FALSE;
  var $payment_type;
  var $cc_type;
  var $cc_number;
  var $cc_ccv2;
  var $cc_exp_month;
  var $cc_exp_year;
  var $cc_issue_number;

  /**
   * Effect an 'authorize' gateway transaction.  If successful, the transaction
   * state will be set to 'active' and the authorization history will be stored
   * in our records.
   *
   * @return string the recommended transaction state after this action.
   *  Possible states are listed in $pay_transaction->states().
   */
  function authorize_action() {

    // Call execute, which runs the gateway interactions.
    $result = $this
      ->execute();

    // We can't proceed if there's an error, so return 'canceled'.
    return $result ? 'active' : 'canceled';
  }

  /**
   * Complete a transaction.  For new transactions, this means creating an
   * AUTH_CAPTURE request.  For existing ones, capture a preauthorization.
   *
   * @return string the recommended transaction state after this action.
   *  Possible states are listed in $pay_transaction->states().
   */
  function complete_action() {

    // Look for an 'authorize' action in this activity's history.
    foreach ($this->activity
      ->history() as $previous) {

      // If there was a successful authorization, copy its details.
      if ($previous->action == 'authorize' && $previous->result) {
        $this->activity->identifier = $previous->identifier;
        $this->activity->data = $previous->data;
        $this->activity->total = $previous->total;
        $this->payment_type = $previous->payment_type;
      }
    }

    // TODO this should be deprecated: 'activity' has been renamed to 'action'.
    $this->activity->activity = $this->activity->action;

    // TODO passing in $this->activity should also be deprecated.
    $result = $this
      ->execute($this->activity);

    // If successful, increase the 'captured' balance.
    if ($result) {
      $this->activity
        ->set_transaction_total($this->activity->total);
    }

    // If the transaction's state is 'pending', this is an auth_capture
    // action. We don't have enough to complete it, so return a failed state.
    if ($this->activity
      ->pay_transaction()
      ->state() == 'pending') {
      return $result ? 'complete' : 'canceled';
    }
    elseif ($this->activity
      ->pay_transaction()
      ->state() == 'active') {
      return $result ? 'complete' : 'active';
    }
  }

  /**
   * Refund a transaction.
   */
  function refund_action() {
  }

  /**
   * Cancel a transaction.
   */
  function cancel_action() {

    // TODO - If there's anything to void, void it!
    return parent::cancel_action();
  }

  /**
   * The URL where your provider accepts requests.
   *
   * Returning NULL prevents anything from executing. Subclasses are responsible
   * for returning a responsible url.
   */
  function gateway_url() {
  }

  /**
   * The request data that will be sent to your gatway provider.
   *
   * Returning NULL prevents anything from executing. Subclasses are responsible
   * for returning responsible request data.
   */
  function gateway_request() {
  }

  /**
   * HTTP headers that should be sent to the gateway provider.
   *
   * For example, if your gateway provider requires XML:
   *
   *  function gateway_headers() {
   *     return array('Content-Type' => 'text/xml');
   *  }
   */
  function gateway_headers() {
    return array();
  }
  function gateway_response() {
  }
  function execute($activity) {
    if ($request = $this
      ->gateway_request()) {
      $ret = drupal_http_request($this
        ->gateway_url(), $this
        ->gateway_headers(), 'POST', $request);
      if ($ret->error) {
        watchdog('payment', "Gateway Error: @err Payment NOT processed.", array(
          '@err' => $ret->error,
        ));
        $this->activity->data = (array) $ret;
        $this->activity->result = FALSE;
      }
      else {
        $this->activity->result = $this
          ->gateway_response($ret->data);
      }

      // Return TRUE or FALSE on success/failure.
      return $this->activity->result == 1;
    }
  }
  function cc_expiration() {
    if ($this->cc_exp_month && $this->cc_exp_year) {
      $exp = str_pad((int) $this->cc_exp_month, 2, '0', STR_PAD_LEFT);
      $exp .= str_pad((int) $this->cc_exp_year, 2, '0', STR_PAD_LEFT);
      return $exp;
    }
  }
  function cc_issue_number_required($val = NULL) {
    $issue_number_cc_types = array(
      'switch',
    );

    // For validation of form submission.
    if ($val && in_array($val, $issue_number_cc_types)) {
      return TRUE;
    }

    // For display of form field.
    if (!$val) {
      foreach ($issue_number_cc_types as $cc_type) {
        if ($this->payment_types[$cc_type]) {
          return TRUE;
        }
      }
    }
    return FALSE;
  }
  function set_cc_issue_number($val) {
    $this->cc_issue_number = preg_replace('/[^\\d]/', '', $val);
  }
  function set_cc_number($val) {
    $this->cc_number = preg_replace('/[^\\d]/', '', $val);

    // Set the credit card type rather than relying on user input.
    $orig_cc_type = $this->cc_type;
    $this->cc_type = NULL;
    $prefix1 = substr($this->cc_number, 0, 1);
    $prefix2 = substr($this->cc_number, 0, 2);
    $prefix3 = substr($this->cc_number, 0, 3);
    $prefix4 = substr($this->cc_number, 0, 4);
    $prefix5 = substr($this->cc_number, 0, 5);
    $prefix6 = substr($this->cc_number, 0, 6);

    /**
     * References: http://www.beachnet.com/~hstiles/cardtype.html
     */
    switch ($prefix1) {
      case 1:

        // JCB: prefix 1800, length 15
        if ($prefix4 == 1800) {
          $this->cc_type = 'jcb';
        }
        break;
      case 2:

        // JCB: prefix 2131, length 15
        if ($prefix4 == 2131) {
          $this->cc_type = 'jcb';
        }
        elseif ($prefix4 == 2014) {
          $this->cc_type = 'enroute';
        }
        elseif ($prefix4 == 2149) {
          $this->cc_type = 'enroute';
        }
        break;
      case 3:

        // Diners Club: prefix 300-305, length 14
        if (in_array($prefix3, array(
          300,
          301,
          302,
          303,
          304,
          305,
        ))) {
          $this->cc_type = 'diners';
        }
        elseif (in_array($prefix2, array(
          34,
          37,
        ))) {
          $this->cc_type = 'amex';
        }
        elseif (in_array($prefix2, array(
          36,
          38,
        ))) {
          $this->cc_type = 'diners';
        }
        else {
          $this->cc_type = 'jcb';
        }
        break;
      case 4:

        // Visa: prefix 4, length 13, 16
        $this->cc_type = 'visa';

        // Switch: prefix 4903, 4905, 4911, 4936
        if (in_array($prefix4, array(
          4903,
          4905,
          4911,
          4936,
        ))) {
          $this->cc_type = 'switch';
        }
        break;
      case 5:

        // Mastercard: prefix 51-55, length 16
        if (in_array($prefix2, array(
          51,
          52,
          53,
          54,
          55,
        ))) {
          $this->cc_type = 'mc';
        }

        // Switch: prefix 564182
        if ($prefix6 == 564182) {
          $this->cc_type = 'switch';
        }

        // Maestro: prefix 5018, 5020, 5038
        if (in_array($prefix4, array(
          5018,
          5020,
          5038,
        ))) {
          $this->cc_type = 'maestro';
        }
        break;
      case 6:

        // Discover: prefix 6011, length 16
        if ($prefix4 == 6011) {
          $this->cc_type = 'discover';
        }

        // Laser: prefix 6304 or 6706 or 6709 or 6771, length 19
        if ($prefix4 == 6304 || $prefix4 == 6706 || $prefix4 == 6709 || $prefix4 == 6771) {
          $this->cc_type = 'laser';
        }

        // Switch: prefix 633110, 6333, 6759,
        if ($prefix6 == 633110 || $prefix4 == 6333) {
          $this->cc_type = 'switch';
        }

        // Maestro: prefix 6759, 6761, 6763
        if (in_array($prefix4, array(
          6759,
          6761,
          6763,
        ))) {
          $this->cc_type = 'maestro';
        }

        // Solo: prefix 6334 or 6767
        if ($prefix4 == 6334 || $prefix4 == 6767) {
          $this->cc_type = 'solo';
        }
        break;
    }

    // Only if we still fail to determine card type, reset it to user supplied
    // value.
    if (empty($this->cc_type)) {
      $this->cc_type = $orig_cc_type;
    }
  }
  function set_cc_ccv2($val) {
    $this->cc_ccv2 = preg_replace('/[^\\d]/', '', $val);
  }
  function cc_number_validate() {
    $number = $this->cc_number;
    if (strlen($number) < 13 || strlen($number) > 19) {
      $this->error_message = t('Invalid credit card number.');
      return FALSE;
    }

    // Mod-10 credit card validation.
    for ($i = 0; $i < strlen($number); $i++) {
      $digit = substr($number, $i, 1);
      if ((strlen($number) - $i - 1) % 2) {
        $digit *= 2;
        if ($digit > 9) {
          $digit -= 9;
        }
      }
      $total += $digit;
    }
    if ($total % 10 != 0) {
      $this->error_message = t('Invalid credit card number.');
      return FALSE;
    }
    return TRUE;
  }
  function cc_expiration_validate() {
    if ($this->cc_exp_year == date('y')) {
      if ($this->cc_exp_month < date('m')) {
        $this->error_message = t('The credit card appears to be expired.');
        return FALSE;
      }
    }
    return TRUE;
  }
  function cc_issue_number_validate() {
    if ($this
      ->cc_issue_number_required($this->cc_type) && (strlen($this->cc_issue_number) != 2 || !is_numeric($this->cc_issue_number))) {
      $this->error_message = t('Invalid issue number.');
      return FALSE;
    }
    return TRUE;
  }
  function cc_ccv2_validate() {
    if ($this->cc_ccv2) {
      if ($this->cc_type == 'amex') {
        if (strlen($this->cc_ccv2) != 4) {
          $this->error_message = t('The security code must be 4 numeric digits for American Express cards');
          return FALSE;
        }
      }
      elseif (strlen($this->cc_ccv2) != 3) {
        $this->error_message = t('The security code must be 3 numeric digits.');
        return FALSE;
      }
    }
    return TRUE;
  }
  function payment_types($filter = NULL) {
    $payment_types = array();
    if ($this->gateway_supports_cc) {
      $payment_types = array(
        'visa' => t('Visa'),
        'mc' => t('Mastercard'),
        'amex' => t('American Express'),
        'discover' => t('Discover'),
        'diners' => t("Diner's Club"),
        'laser' => t('Laser'),
        'maestro' => t('Maestro'),
        'switch' => t('Switch'),
        'solo' => t('Solo'),
      );
    }
    if ($this->gateway_supports_ach) {

      // TODO this is a stub. We need to build the echeck form and validation
      // functions for this to be relevant. Thus it's commented out for now.

      //$payment_types['ach'] = t('Online checking transfer.');
    }
    if ($filter) {
      foreach ($payment_types as $key => $label) {
        if (!$filter[$key]) {
          unset($payment_types[$key]);
        }
      }
    }
    return $payment_types;
  }
  function settings_form(&$form, &$form_state) {
    parent::settings_form($form, $form_state);
    $group = $this
      ->handler();
    $form[$group]['gateway'] = array(
      '#type' => 'fieldset',
      '#title' => t('Gateway settings'),
      '#group' => $group,
    );
    $form[$group]['gateway']['payment_types'] = array(
      '#type' => 'checkboxes',
      '#title' => t('Available payment types'),
      '#options' => $this
        ->payment_types(),
      '#default_value' => $this->payment_types,
      '#required' => TRUE,
      '#parents' => array(
        $group,
        'payment_types',
      ),
    );
    $form[$group]['gateway']['gateway_testmode'] = array(
      '#type' => 'checkbox',
      '#title' => t('Test mode'),
      '#default_value' => $this->gateway_testmode,
      '#parents' => array(
        $group,
        'gateway_testmode',
      ),
    );
  }
  function form(&$form, &$form_state) {
    global $user;
    $group = $this->pay_form
      ->handler();
    if (isset($this->gateway_testmode) && $this->gateway_testmode) {
      drupal_set_message(t('The @name payment method is in test mode. This transaction will not be fully processed.', array(
        '@name' => $this
          ->title(),
      )), 'warning');
    }
    if (isset($form[$group]['pay_method'][$this->pmid])) {
      $method_form = $form[$group]['pay_method'][$this->pmid];
    }
    $method_form['#theme'] = 'pay_cc_form';
    $options = array();
    if ($this->gateway_supports_cc) {
      $options['cc'] = t('Credit or debit card');
    }

    // TODO should reflect 'bank account' input here, but it's unsupported.
    $method_form['payment_type'] = array(
      '#type' => 'select',
      '#title' => t('Payment type'),
      '#options' => $options,
      '#required' => TRUE,
      '#default_value' => 'cc',
      '#access' => count($options) > 1,
    );
    $method_form['first_name'] = array(
      '#type' => 'textfield',
      '#title' => t('First name'),
      '#pre_render' => array(
        'pay_element_set_required',
      ),
    );
    $method_form['last_name'] = array(
      '#type' => 'textfield',
      '#title' => t('Last name'),
      '#pre_render' => array(
        'pay_element_set_required',
      ),
    );
    if ($user->uid) {
      $method_form['mail'] = array(
        '#type' => 'value',
        '#value' => $user->mail,
      );
    }
    else {
      $method_form['mail'] = array(
        '#type' => 'textfield',
        '#title' => t('E-mail'),
        '#pre_render' => array(
          'pay_element_set_required',
        ),
      );
    }
    $method_form['billto'] = array(
      '#type' => 'postal',
      '#postal_user' => $user,
      '#title' => t('Billing address'),
      '#pre_render' => array(
        'pay_element_set_required',
      ),
    );
    $method_form['cc_type'] = array(
      '#type' => 'radios',
      '#title' => t('Card type'),
      '#options' => $this
        ->payment_types($this->payment_types),
    );
    $method_form['cc_number'] = array(
      '#type' => 'textfield',
      '#title' => t('Card number'),
      '#size' => 19,
      '#maxlength' => 19,
      '#pre_render' => array(
        'pay_element_set_required',
      ),
      '#attributes' => array(
        'autocomplete' => 'off',
      ),
    );
    $method_form['cc_ccv2'] = array(
      '#type' => 'textfield',
      '#title' => t('Security code'),
      '#size' => 4,
      '#maxlength' => 4,
      '#attributes' => array(
        'autocomplete' => 'off',
      ),
    );
    if ($this
      ->cc_issue_number_required()) {
      $method_form['cc_issue_number'] = array(
        '#type' => 'textfield',
        '#title' => t('Issue number'),
        '#size' => 2,
        '#maxlength' => 2,
        '#attributes' => array(
          'autocomplete' => 'off',
        ),
      );
    }
    $months = array();
    foreach (range(1, 12) as $i) {
      $key = str_pad($i, 2, '0', STR_PAD_LEFT);
      $months[$key] = $key . '- ' . date('F', strtotime('1-' . $i . '-2000'));
    }
    $method_form['cc_exp_month'] = array(
      '#type' => 'select',
      '#options' => $months,
      '#pre_render' => array(
        'pay_element_set_required',
      ),
      '#attributes' => array(
        'title' => t('Expiration month'),
      ),
    );
    $years = array();
    foreach (range(0, 9) as $i) {
      $year = date('Y') + $i;
      $years[substr($year, 2)] = $year;
    }
    $method_form['cc_exp_year'] = array(
      '#type' => 'select',
      '#options' => $years,
      '#pre_render' => array(
        'pay_element_set_required',
      ),
      '#attributes' => array(
        'title' => t('Expiration year'),
      ),
    );

    // Add this method_form to the expected place on the parent form.
    $form[$group]['pay_method'][$this->pmid] = $method_form;
    $form[$group]['pay_method'][$this->pmid]['#prefix'] = '<div class="payment-method-form">';
    $form[$group]['pay_method'][$this->pmid]['#suffix'] = '</div>';
  }

  // This is called from the form_validate function in a pay_form class.
  function pay_method_validate($form, &$form_state, $element) {
    parent::pay_method_validate($form, $form_state, $element);
    if ($this->payment_type == 'cc') {

      // Manually handle #required on fields required by this payment_type.
      $required = array(
        'first_name',
        'last_name',
        'mail',
        'cc_number',
        'cc_exp_month',
        'cc_exp_year',
      );
      foreach ($required as $key) {
        if (!count($this->{$key}) || is_string($this->{$key}) && strlen(trim($this->{$key})) == 0) {
          form_error($element[$key], t('!name field is required.', array(
            '!name' => $element[$key]['#title'],
          )));
        }
      }

      // Validate the card number and set the form value to our clean version.
      if (!$this
        ->cc_number_validate()) {
        form_error($element['cc_number'], $this->error_message);
      }
      form_set_value($element['cc_number'], $this->cc_number, $form_state);

      // Validate the CCV2 code and set the form value to our clean version.
      if (!$this
        ->cc_ccv2_validate()) {
        form_error($element['cc_ccv2'], $this->error_message);
      }
      form_set_value($element['cc_ccv2'], $this->cc_ccv2, $form_state);

      // Validate the expiration date.
      if (!$this
        ->cc_expiration_validate()) {
        form_error($element['cc_exp_month'], $this->error_message);
      }

      // Set the "payment_type" value to the specific card type.
      form_set_value($element['payment_type'], $this->cc_type, $form_state);

      // Validate the issue number field.
      if (!$this
        ->cc_issue_number_validate()) {
        form_set_error('cc_issue_number', $this->error_message);
      }
    }
  }

}

Members

Namesort descending Modifiers Type Description Overrides
pay::$permissions property
pay::access function
pay::disable function
pay::drupal_invoke function Execute an named Drupal hook function, passing $this as the first parameter.
pay::enable function
pay::form_setup function
pay::form_submit function 2
pay::form_validate function 1
pay::form_values function
pay::handler function
pay::handler_title function
pay::menu_path function 1
pay::notes function
pay::pay_activity function
pay::pay_form function
pay::pay_transaction function 1
pay::permissions_settings function
pay::save function
pay::settings_form_submit function
pay::settings_form_validate function
pay::set_completed function
pay::set_created function
pay::set_handler function
pay::set_hostname function
pay::set_identifer function
pay::set_key function Do not allow this value to be automatically set.
pay::set_mail function
pay::set_notes function
pay::set_status function
pay::set_table function Do not allow this value to be automatically set.
pay::set_timestamp function
pay::set_total function
pay::set_total_paid function
pay::set_uid function
pay::timestamp_value function
pay::title function 2
pay::total function 1
pay::uid function
pay::user function
pay::__construct function
pay_method::$billto property
pay_method::$description property
pay_method::$first_name property
pay_method::$key property Overrides pay::$key
pay_method::$last_name property
pay_method::$mail property
pay_method::$max_amount property
pay_method::$min_amount property
pay_method::$pay_form_action property
pay_method::$pmid property
pay_method::$status property
pay_method::$table property Overrides pay::$table
pay_method::$title property
pay_method::$total property
pay_method::available_currencies function Your payment method should return an array of valid currencies, using 3-digit currency codes. Example:
pay_method::set_description function Set a default description if none is specified.
pay_method::set_max_amount function Set a default max_amount if none is specified.
pay_method::set_min_amount function Set a default min_amount if none is specified.
pay_method::set_title function Set a default title if none is specified.
pay_method::set_valid_actions function Modify the list of payment actions that are valid for a given pay_form. 1
pay_method::valid_action function Determine whether an action is valid and appropraite for a transaction.
pay_method_gateway::$cc_ccv2 property
pay_method_gateway::$cc_exp_month property
pay_method_gateway::$cc_exp_year property
pay_method_gateway::$cc_issue_number property
pay_method_gateway::$cc_number property
pay_method_gateway::$cc_type property
pay_method_gateway::$gateway_supports_ach property
pay_method_gateway::$gateway_supports_cc property
pay_method_gateway::$gateway_supports_recurring property
pay_method_gateway::$gateway_testmode property
pay_method_gateway::$payment_type property
pay_method_gateway::$payment_types property
pay_method_gateway::authorize_action function Effect an 'authorize' gateway transaction. If successful, the transaction state will be set to 'active' and the authorization history will be stored in our records.
pay_method_gateway::cancel_action function Cancel a transaction. Overrides pay_method::cancel_action
pay_method_gateway::cc_ccv2_validate function
pay_method_gateway::cc_expiration function
pay_method_gateway::cc_expiration_validate function
pay_method_gateway::cc_issue_number_required function
pay_method_gateway::cc_issue_number_validate function
pay_method_gateway::cc_number_validate function
pay_method_gateway::complete_action function Complete a transaction. For new transactions, this means creating an AUTH_CAPTURE request. For existing ones, capture a preauthorization.
pay_method_gateway::execute function
pay_method_gateway::form function Overrides pay::form
pay_method_gateway::gateway_headers function HTTP headers that should be sent to the gateway provider.
pay_method_gateway::gateway_request function The request data that will be sent to your gatway provider.
pay_method_gateway::gateway_response function
pay_method_gateway::gateway_url function The URL where your provider accepts requests.
pay_method_gateway::payment_types function
pay_method_gateway::pay_method_validate function Overrides pay_method::pay_method_validate
pay_method_gateway::refund_action function Refund a transaction.
pay_method_gateway::settings_form function Overrides pay_method::settings_form
pay_method_gateway::set_cc_ccv2 function
pay_method_gateway::set_cc_issue_number function
pay_method_gateway::set_cc_number function