Added new samples and modified CybsSoapClient::createRequest() to accept the merchant reference code

Author: djvaldez

.gitignore

@@ -5,3 +5,5 @@
 /composer.phar
 /composer.lock
 
+# CyberSource config parameters
+/lib/conf/cybs.ini

lib/CybsSoapClient.php

@@ -105,13 +105,18 @@ public function getTransactionKey()
     }
 
     /**
+     * @param string The desired reference code for this request.
      *
      * @return stdClass An object initialized with the client's merchant ID.
      */
-    public function createRequest()
+    public function createRequest($merchantReferenceCode)
     {
         $request = new stdClass();
         $request->merchantID = $this->merchantId;
+        $request->merchantReferenceCode = $merchantReferenceCode;
+        $request->clientLibrary = "PHP";
+        $request->clientLibraryVersion = phpversion();
+        $request->clientEnvironment = php_uname();
         return $request;
     }
 }

samples/AuthCapture.php

@@ -0,0 +1,79 @@
+<?php
+// This sample demonstrates how to run an authorization request followed by a
+// capture request.
+
+// Using Composer-generated autoload file.
+require 'vendor/autoload.php';
+// Or, uncomment the line below if you're not using Composer autoloader.
+// require_once('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();
+$request = $client->createRequest($referenceCode);
+
+// This section contains a sample transaction request for the authorization 
+// service with complete billing, payment card, and purchase (two items) information.   
+$ccAuthService = new stdClass();
+$ccAuthService->run = 'true';
+$request->ccAuthService = $ccAuthService;
+
+$billTo = new stdClass();
+$billTo->firstName = 'John';
+$billTo->lastName = 'Doe';
+$billTo->street1 = '1295 Charleston Road';
+$billTo->city = 'Mountain View';
+$billTo->state = 'CA';
+$billTo->postalCode = '94043';
+$billTo->country = 'US';
+$billTo->email = 'null@cybersource.com';
+$billTo->ipAddress = '10.7.111.111';
+$request->billTo = $billTo;
+
+$card = new stdClass();
+$card->accountNumber = '4111111111111111';
+$card->expirationMonth = '12';
+$card->expirationYear = '2020';
+$request->card = $card;
+
+$purchaseTotals = new stdClass();
+$purchaseTotals->currency = 'USD';
+$request->purchaseTotals = $purchaseTotals;
+
+$item0 = new stdClass();
+$item0->unitPrice = '12.34';
+$item0->quantity = '2';
+$item0->id = '0';
+
+$item1 = new stdClass();
+$item1->unitPrice = '56.78';
+$item1->id = '1';
+
+$request->item = array($item0, $item1);
+
+$reply = $client->runTransaction($request);
+
+// This section will show all the reply fields.
+print("\nAUTH RESPONSE: " . print_r($reply, true));
+
+if ($reply->decision != 'ACCEPT') {
+    print("\nFailed auth request.\n");
+    return;
+}
+
+// Build a capture using the request ID in the response as the auth request ID
+$ccCaptureService = new stdClass();
+$ccCaptureService->run = 'true';
+$ccCaptureService->authRequestID = $reply->requestID;
+
+$captureRequest = $client->createRequest($referenceCode);
+$captureRequest->ccCaptureService = $ccCaptureService;
+$captureRequest->item = array($item0, $item1);
+$captureRequest->purchaseTotals = $purchaseTotals;
+
+$captureReply = $client->runTransaction($captureRequest);
+
+// This section will show all the reply fields.
+print("\nCAPTRUE RESPONSE: " . print_r($captureReply, true));

samples/Sale.php

@@ -0,0 +1,54 @@
+<?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 'vendor/autoload.php';
+
+// Or, uncomment the line below if you're not using Composer autoloader.
+// require_once('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();
+$request = $client->createRequest($referenceCode);
+
+// Build a sale request (combining an auth and capture). In this example only
+// the amount is provided for the purchase total.
+$ccAuthService = new stdClass();
+$ccAuthService->run = 'true';
+$request->ccAuthService = $ccAuthService;
+
+$ccCaptureService = new stdClass();
+$ccCaptureService->run = 'true';
+$request->ccCaptureService = $ccCaptureService;
+
+$billTo = new stdClass();
+$billTo->firstName = 'John';
+$billTo->lastName = 'Doe';
+$billTo->street1 = '1295 Charleston Road';
+$billTo->city = 'Mountain View';
+$billTo->state = 'CA';
+$billTo->postalCode = '94043';
+$billTo->country = 'US';
+$billTo->email = 'null@cybersource.com';
+$billTo->ipAddress = '10.7.111.111';
+$request->billTo = $billTo;
+
+$card = new stdClass();
+$card->accountNumber = '4111111111111111';
+$card->expirationMonth = '12';
+$card->expirationYear = '2020';
+$request->card = $card;
+
+$purchaseTotals = new stdClass();
+$purchaseTotals->currency = 'USD';
+$purchaseTotals->grandTotalAmount = '90.01';
+$request->purchaseTotals = $purchaseTotals;
+
+$reply = $client->runTransaction($request);
+
+// This section will show all the reply fields.
+print("\nRESPONSE: " . print_r($reply, true));