Add functionality for sending requests from XML

Author: djvaldez

lib/CybsSoapClient.php

@@ -9,6 +9,8 @@
  */
 class CybsSoapClient extends SoapClient
 {
+    const CLIENT_LIBRARY_VERSION = "CyberSource PHP 1.0.0";
+
     private $merchantId;
     private $transactionKey;
 
@@ -104,6 +106,40 @@ public function getTransactionKey()
         return $this->transactionKey;
     }
 
+    public function simpleXmlToCybsRequest($simpleXml) {
+
+        $vars = get_object_vars($simpleXml);
+        $request = new stdClass();
+        foreach(array_keys($vars) as $key) {
+            $element = $vars[$key];
+            if ($key == 'comment') {
+                continue;
+            }
+            if (is_string($element)) {
+                $request->$key = $element;
+            } else if (is_array($element)) {
+                $array = $element;
+                if ($key == "@attributes") {
+                    // Each attribute in the '@attributes' array should
+                    // instead be a property of the parent element.
+                    // copyAttributes($simpleXml, $array);
+                    foreach($array as $k => $value) {
+                        $request->$k = $value;
+                    }
+                } else {
+                    $newArray = array();
+                    foreach($array as $k => $value) {
+                        $newArray[$k] = $this->simpleXmlToCybsRequest($value);
+                    }
+                    $request->$key = $newArray; 
+                }
+            } else if ($element instanceof SimpleXMLElement) {
+                $request->$key = $this->simpleXmlToCybsRequest($element);
+            }
+        }
+        return $request;
+    }
+
     /**
      * Returns an object initialized with basic client information.
      *
@@ -115,9 +151,25 @@ public function createRequest($merchantReferenceCode)
         $request = new stdClass();
         $request->merchantID = $this->merchantId;
         $request->merchantReferenceCode = $merchantReferenceCode;
-        $request->clientLibrary = "CyberSource PHP 1.0.0";
+        $request->clientLibrary = self::CLIENT_LIBRARY_VERSION;
         $request->clientLibraryVersion = phpversion();
         $request->clientEnvironment = php_uname();
         return $request;
     }
+
+    /**
+     * Runs a transaction from an XML file
+     *
+     * @param string $filePath The path to the XML file
+     * @param string $merchantReferenceCode Desired reference code for the request
+     * @return stdClass An object representation of the transaction response.     
+     */
+    public function runTransactionFromXml($filePath, $merchantReferenceCode)
+    {
+        $request = $this->createRequest($merchantReferenceCode);
+        $xml = simplexml_load_string(file_get_contents($filePath));
+        $xmlRequest = $this->simpleXmlToCybsRequest($xml);
+        $mergedRequest = (object) array_merge((array) $request, (array) $xmlRequest);
+        return $this->runTransaction($mergedRequest);
+    }
 }

samples/AuthFromXml.php

@@ -0,0 +1,18 @@
+<?php
+// This sample demonstrates how to run a sale request, which combines an
+// authorization with a capture in one request.
+
+// Using Composer-generated autoload file.
+require __DIR__ . '/../vendor/autoload.php';
+// Or, uncomment the line below if you're not using Composer autoloader.
+// require_once(__DIR__ . '/../lib/CybsSoapClient.php');
+
+
+// Before using this example, you can use your own reference code for the transaction.
+$referenceCode = 'your_merchant_reference_code';
+
+$client = new CybsSoapClient();
+$reply = $client->runTransactionFromXml(__DIR__ . '/xml/auth.xml', $referenceCode);
+
+// This section will show all the reply fields.
+print("\nRESPONSE: " . print_r($reply, true));

samples/xml/auth.xml

@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="utf-8"?>
+<requestMessage
+	xmlns="urn:schemas-cybersource-com:transaction-data-_1.109_">                       -->
+	<merchantReferenceCode>your_merchant_reference_code</merchantReferenceCode>
+	<billTo>
+		<firstName>John</firstName>
+		<lastName>Doe</lastName>
+		<street1>1295 Charleston Road</street1>
+		<city>Mountain View</city>
+		<state>CA</state>
+		<postalCode>94043</postalCode>
+		<country>US</country>
+		<phoneNumber>650-965-6000</phoneNumber>
+		<email>nobody@cybersource.com</email>
+		<ipAddress>10.7.7.7</ipAddress>
+	</billTo>
+	<shipTo>
+		<firstName>Jane</firstName>
+		<lastName>Doe</lastName>
+		<street1>100 Elm Street</street1>
+		<city>San Mateo</city>
+		<state>CA</state>
+		<postalCode>94401</postalCode>
+		<country>US</country>
+	</shipTo>
+	<item id="0">
+		<unitPrice>12.34</unitPrice>
+	</item>
+	<item id="1">
+		<unitPrice>56.78</unitPrice>
+	</item>
+	<purchaseTotals>
+		<currency>USD</currency>
+	</purchaseTotals>
+	<card>
+		<accountNumber>4111111111111111</accountNumber>
+		<expirationMonth>12</expirationMonth>
+		<expirationYear>2020</expirationYear>
+	</card>
+	<ccAuthService run="true">
+	</ccAuthService>
+</requestMessage>