From f05d705fe599646790a6ab4c8b9bfdae3d119017 Mon Sep 17 00:00:00 2001
From: PCM <smurray@tronnet.me>
Date: Wed, 31 Jul 2019 23:40:11 -0700
Subject: [PATCH 1/2] adding in hooks and model for Purchases

---
 src/Models/Purchase.php |  23 +++++++++
 src/Ontraport.php       |   8 ++++
 src/Purchases.php       | 102 ++++++++++++++++++++++++++++++++++++++++
 3 files changed, 133 insertions(+)
 create mode 100644 src/Models/Purchase.php
 create mode 100644 src/Purchases.php

diff --git a/src/Models/Purchase.php b/src/Models/Purchase.php
new file mode 100644
index 0000000..b57174a
--- /dev/null
+++ b/src/Models/Purchase.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace OntraportAPI\Models;
+
+use OntraportAPI\Exceptions as Exceptions;
+
+class Transaction
+{
+    /**
+     * Transaction constructor
+     *
+     * @param int $contact_id The id of the contact this transaction is for.
+     * @param int $charge_now Binary integer flag indicating if this transaction should be charged now or logged
+     * @param int $gateway_id The id of the gateway this transaction is going through.
+     *
+     * @throws Exceptions\OntraportAPIException No gateway id provided for charge now
+     *
+     */
+    public function __construct()
+    {
+    }
+
+}
diff --git a/src/Ontraport.php b/src/Ontraport.php
index ac2cdf9..1842fd6 100644
--- a/src/Ontraport.php
+++ b/src/Ontraport.php
@@ -254,6 +254,14 @@ public function product()
     {
         return $this->getApi("Products");
     }
+    
+    /**
+     * @return Products
+     */
+    public function purchase()
+    {
+        return $this->getApi("Purchases");
+    }
 
     /**
      * @return Offers
diff --git a/src/Purchases.php b/src/Purchases.php
new file mode 100644
index 0000000..56a0d0e
--- /dev/null
+++ b/src/Purchases.php
@@ -0,0 +1,102 @@
+<?php
+
+namespace OntraportAPI;
+
+/**
+ * Class Purchases
+ *
+ * @author ONTRAPORT
+ *
+ * @package OntraportAPI
+ */
+class Purchases extends BaseApi
+{
+    /**
+     * $var string endpoint for single purchase
+     */
+    protected $_endpoint = "Purchase";
+
+    /**
+     * $var string endpoint for plural purchases
+     */
+    protected $_endpointPlural = "Purchases";
+
+    /**
+     * @param Ontraport $client
+     */
+    public function __construct(Ontraport $client)
+    {
+        parent::__construct($client);
+    }
+
+    /**
+     * @TODO: This is a placeholder, API needs to be changed to follow one standard for naming endpoints
+     */
+    private $_mainPurchaseEndpoint = "purchase";
+
+    /**
+     * @brief Retrieve a single specified purchase
+     *
+     * @param mixed[] $requestParams The parameters to submit with GET request.
+     *                               Possible array keys: "id" (required)
+     *
+     * @return string JSON formatted HTTP response
+     */
+    public function retrieveSingle($requestParams)
+    {
+        return parent::_retrieveSingle($requestParams);
+    }
+
+    /**
+     * @brief Retrieve multiple purchases according to specific criteria, handle pagination
+     *
+     * @param mixed[] $requestParams Array of parameters to submit with GET request. All parameters are optional but if "ids"
+     *                               are not specified, all will be selected.
+     *                               Possible array keys: "ids","start","range","sort","sortDir","condition","search",
+     *                                                    "searchNotes","group_ids","performAll","externs","listFields"
+     *
+     * @return string JSON formatted array of response data: each page of data will be an element in that array.
+     */
+    public function retrieveMultiplePaginated($requestParams)
+    {
+        return parent::_retrieveMultiplePaginated($requestParams);
+    }
+
+    /**
+     * @brief Retrieve multiple purchases according to specific criteria
+     *
+     * @param mixed[] $requestParams Array of parameters to submit with GET request. All parameters are optional but if "ids"
+     *                               are not specified, all will be selected.
+     *                               Possible array keys: "ids","start","range","sort","sortDir","condition","search",
+     *                                                    "searchNotes","group_ids","performAll","externs","listFields"
+     *
+     * @return string JSON formatted HTTP response
+     */
+    public function retrieveMultiple($requestParams)
+    {
+        return parent::_retrieveMultiple($requestParams);
+    }
+
+    /**
+     * @brief Retrieve information (such as number of purchases) about purchase collection
+     *
+     * @param mixed[] $requestParams Array of parameters to submit with GET request. All parameters are optional.
+     *                               Possible array keys: "condition","search","searchNotes","group_ids","performAll"
+     *
+     * @return string JSON formatted HTTP response
+     */
+    public function retrieveCollectionInfo($requestParams)
+    {
+        return parent::_retrieveCollectionInfo($requestParams);
+    }
+
+    /**
+     * @brief Retrieve meta for a purchase object
+     *
+     * @return string JSON formatted meta for purchase object
+     */
+    public function retrieveMeta()
+    {
+        return parent::_retrieveMeta();
+    }
+}

From b7b49a49f4ecff8d9556335bfcb60eb41385d827 Mon Sep 17 00:00:00 2001
From: PCM <smurray@tronnet.me>
Date: Wed, 31 Jul 2019 23:44:09 -0700
Subject: [PATCH 2/2] renaming from Transaction cloning

---
 src/Models/Purchase.php | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/src/Models/Purchase.php b/src/Models/Purchase.php
index b57174a..1775aea 100644
--- a/src/Models/Purchase.php
+++ b/src/Models/Purchase.php
@@ -4,14 +4,10 @@
 
 use OntraportAPI\Exceptions as Exceptions;
 
-class Transaction
+class Purchase
 {
     /**
-     * Transaction constructor
-     *
-     * @param int $contact_id The id of the contact this transaction is for.
-     * @param int $charge_now Binary integer flag indicating if this transaction should be charged now or logged
-     * @param int $gateway_id The id of the gateway this transaction is going through.
+     * Purchase constructor
      *
      * @throws Exceptions\OntraportAPIException No gateway id provided for charge now
      *