Add search by order id request

This way we can search BT transactions for a specific order

composer.json

@@ -1,5 +1,5 @@
 {
-    "name": "omnipay/braintree",
+    "name": "theiconic/omnipay-braintree",
     "type": "library",
     "description": "Braintree gateway for Omnipay payment processing library",
     "keywords": [
@@ -11,22 +11,8 @@
         "braintree",
         "purchase"
     ],
-    "homepage": "https://github.com/thephpleague/omnipay-braintree",
+    "homepage": "https://github.com/theiconic/omnipay-braintree",
     "license": "MIT",
-    "authors": [
-        {
-            "name": "Kayla Daniels",
-            "email": "[email protected]"
-        },
-        {
-            "name": "Barry vd. Heuvel",
-            "email": "[email protected]"
-        },
-        {
-            "name": "Omnipay Contributors",
-            "homepage": "https://github.com/thephpleague/omnipay-braintree/contributors"
-        }
-    ],
     "autoload": {
         "psr-4": { "Omnipay\\Braintree\\" : "src/" }
     },

src/Gateway.php

@@ -290,4 +290,13 @@ public function fetchTransaction(array $parameters = array())
     {
         return $this->createRequest('\Omnipay\Braintree\Message\FindRequest', $parameters);
     }
+
+    /**
+     * @param array $parameters
+     * @return Message\SearchRequest
+     */
+    public function searchTransaction(array $parameters = array())
+    {
+        return $this->createRequest('\Omnipay\Braintree\Message\SearchRequest', $parameters);
+    }
 }

src/Message/SearchRequest.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace Omnipay\Braintree\Message;
+
+use Braintree\TransactionSearch;
+use Omnipay\Common\Message\ResponseInterface;
+
+class SearchRequest extends AbstractRequest
+{
+    /**
+     * Authorize Request
+     *
+     * @method Response send()
+     */
+    public function getData()
+    {
+        $this->validate('purchaseOrderNumber');
+
+        return array(
+            'purchaseOrderNumber' => $this->getPurchaseOrderNumber(),
+        );
+    }
+
+    /**
+     * Send the request with specified data
+     *
+     * @param  mixed $data The data to send
+     * @return ResponseInterface
+     */
+    public function sendData($data)
+    {
+        $response = $this->braintree->transaction()->search([
+            TransactionSearch::orderId()->is($data['purchaseOrderNumber']),
+        ]);
+
+        $transactions = [];
+        foreach($response as $transaction) {
+            $transactions[] = $transaction;
+        }
+
+        return $this->createResponse($transactions);
+    }
+}

tests/GatewayTest.php

@@ -172,6 +172,12 @@ public function testParseNotification()
         }
     }
 
+    public function testSearchTransaction()
+    {
+        $request = $this->gateway->searchTransaction(['purchaseOrderNumber' => '2187588535']);
+        $this->assertInstanceOf('Omnipay\Braintree\Message\SearchRequest', $request);
+    }
+
     /**
      * @param $payload
      *

tests/Message/SearchRequestTest.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace Omnipay\Braintree\Message;
+
+use Omnipay\Tests\TestCase;
+
+class SearchRequestTest extends TestCase
+{
+    /**
+     * @var SearchRequest
+     */
+    private $request;
+
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->request = new SearchRequest($this->getHttpClient(), $this->getHttpRequest(), \Braintree_Configuration::gateway());
+        $this->request->initialize(
+            array(
+                'purchaseOrderNumber' => '2187588535',
+            )
+        );
+    }
+
+    public function testGetData()
+    {
+        $data = $this->request->getData();
+
+        $this->assertSame('2187588535', $data['purchaseOrderNumber']);
+    }
+}