Add mercanet processor

Author: eileenmcnaughton

CRM/Core/Payment/OmnipayMultiProcessor.php

@@ -468,8 +468,7 @@ public function doTransferCheckout(&$params, $component = 'contribute') {
    * @throws CiviCRM_API3_Exception
    */
   public function getPaymentFormFields() {
-    if ($this->_paymentProcessor['billing_mode'] == 4) {
-      $this->isTransparentRedirect();
+    if ($this->_paymentProcessor['billing_mode'] == 4 || $this->isTransparentRedirect()) {
       return array();
     }
     return $this->_paymentProcessor['payment_type'] == 1 ? $this->getCreditCardFormFields() : $this->getDirectDebitFormFields();

composer.json

@@ -23,6 +23,10 @@
         {
             "type": "git",
             "url":  "https://github.com/eileenmcnaughton/omnipay-authorizenet.git"
+        },
+        {
+            "type": "git",
+            "url":  "https://github.com/eileenmcnaughton/omnipay-mercanet.git"
         }
     ],
     "require":
@@ -37,7 +41,8 @@
         "pointybeard/omnipay-nabtransact": "dev-transact",
         "fzaninotto/faker": "^1.6@dev",
         "omnipay/paymentexpress": "dev-master",
-        "omnipay/authorizenet": "dev-master"
+        "omnipay/authorizenet": "dev-master",
+        "fuzion/omnipay-mercanet": "dev-master"
     },
     "require-dev":
     {

omnipay_Mercanet_Offsite.mgd.php

@@ -0,0 +1,69 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * User: eileen
+ * Date: 17/06/2014
+ * Time: 10:14 PM
+ *
+ * To add a new processor you need to add an item to this array. It is sequentially numerically indexed and the important aspects are
+ *
+ * - name - omnipay_{Processor_Name}, Omnipay calls the gateway method create with the processor name as the parameter.
+ * To get the processor name take a look at the Readme for the gateway you are adding - you will generally see
+ * The following gateways are provided by this package: Mollie so the name should be ominpay_Mollie (note matching capitalisation)
+ *
+ * A more complex example is omnipay_SecurePay_DirectPayment.
+ * This breaks down as
+ *  - omnipay_ - our label within CiviCRM to denote Omnipay
+ *  - SecurePay - the namespace as declared within the composer.json within the securepay gateway
+ *  - DirectPost - the prefix on the Gateway file. It is called DirectPostGateway.php - this portion is excluded when the file is simply
+ *     named 'Gateway.php'
+ *
+ * - user_name_label, password_label, signature_label, subject_label - these are generally about telling the plugin what to call these when they pass them to
+ * Omnipay. They are also shown to users so some reformatting is done to turn it into lower-first-letter camel case. Take a look at the gateway file for your gateway. This is directly under src.
+ * Some provide more than one and the 'getName' function distinguishes them. The getDefaultParameters will tell you what to pass. eg if you see
+ * 'apiKey' you should enter 'user_name' => 'Api Key' (you might ? be able to get away with 'API Key' - need to check). You can provide as many or as
+ * few as you want of these and it's irrelevant which field you put them in but note that the signature field is the longest and that
+ * in future versions of CiviCRM hashing may be done on password and signature on the screen.
+ *
+ * - 'class_name' => 'Payment_OmnipayMultiProcessor', (always)
+ *
+ * - 'url_site_default' - this is ignored. But, by giving one you make it easier for people adding processors
+ *
+ * - 'billing_mode' - 1 = onsite, 4 = redirect offsite (including transparent redirects).
+ *
+ * - payment_mode - 1 = credit card, 2 = debit card, 3 = transparent redirect. In practice 3 means that billing details are gathered on-site so
+ * it may also be used with automatic redirects where address fields need to be mandatory for the signature.
+ *
+ * The record will be automatically inserted, updated, or deleted from the
+ * database as appropriate. For more details, see "hook_civicrm_managed" at:
+ * http://wiki.civicrm.org/confluence/display/CRMDOC/Hook+Reference
+ */
+return array(
+    array(
+      'name' => 'OmniPay - Mercanet',
+      'entity' => 'payment_processor_type',
+      'params' =>
+        array(
+          'version' => 3,
+          'title' => 'OmniPay - Mercanet Offsite',
+          'name' => 'omnipay_Mercanet_Offsite',
+          'description' => 'Omnipay Mercanet Payment Processor',
+          'user_name_label' => 'Merchant ID',
+          'password_label' => 'Secret Key',
+          'signature_label' => '',
+          'site_url' => '',
+          'class_name' => 'Payment_OmnipayMultiProcessor',
+          'billing_mode' => 1,
+          'payment_type' => 3,
+        ),
+        'metadata' => array(
+          'transparent_redirect' => array(
+            'fields' => array(
+              // place holder for more work on adding fields to transparent_redirect payment form.
+              // leave empty for only hidden fields.
+            ),
+            'billing_fields' => array(),
+          ),
+        ),
+    ),
+);