simplify 1.0.0

data/lib/simplify/invoice.rb

@@ -0,0 +1,105 @@
+#
+# Copyright (c) 2013, MasterCard International Incorporated
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without modification, are 
+# permitted provided that the following conditions are met:
+# 
+# Redistributions of source code must retain the above copyright notice, this list of 
+# conditions and the following disclaimer.
+# Redistributions in binary form must reproduce the above copyright notice, this list of 
+# conditions and the following disclaimer in the documentation and/or other materials 
+# provided with the distribution.
+# Neither the name of the MasterCard International Incorporated nor the names of its 
+# contributors may be used to endorse or promote products derived from this software 
+# without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY 
+# EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 
+# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT 
+# SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 
+# IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 
+# IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 
+# SUCH DAMAGE.
+#
+
+require 'simplify/paymentsapi'
+
+module Simplify
+
+# A Invoice object.
+#
+class Invoice < Hash
+
+    # Public key used to access the API.
+    attr_accessor :public_key
+
+    # Private key used to access the API.
+    attr_accessor :private_key
+
+
+
+    # Retrieve Invoice objects.
+    # criteria:: a hash of parameters; valid keys are: 
+    # * <code>filter</code>    Filters to apply to the list.  
+    # * <code>max</code>    Allows up to a max of 50 list items to return.  <b>default:20</b>
+    # * <code>offset</code>    Used in paging of the list.  This is the start offset of the page.  <b>default:0</b>
+    # * <code>sorting</code>    Allows for ascending or descending sorting of the list. The value maps properties to the sort direction (either <code>asc</code> for ascending or <code>desc</code> for descending).  Sortable properties are: <code> id</code><code> invoiceDate</code><code> customer</code><code> amount</code><code> processedDate</code>. 
+    # public_key:: Public to use for the API call. If nil, the value of Simplify::public_key will be used.
+    # private_key:: Private key to use for the API call. If nil, the value of Simplify::private_key will be used.
+    # Returns an object where the <code>list</code> property contains the list of Invoice objects and the <code>total</code>
+    # property contains the total number of Invoice objects available for the given criteria.
+    def self.list(criteria = nil, public_key = nil, private_key = nil)
+
+        if public_key == nil then
+            public_key = Simplify::public_key
+        end
+        if private_key == nil then
+           private_key = Simplify::private_key
+        end
+
+        h = Simplify::PaymentsApi.execute("invoice", 'list', criteria, public_key, private_key)
+        obj = Invoice.new()
+        obj.public_key = public_key
+        obj.private_key = private_key
+        obj = obj.merge(h)
+        obj
+
+    end
+
+    # Retrieve a Invoice object from the API
+    #
+    # id:: ID of object to retrieve
+    # public_key:: Public to use for the API call. If nil, the value of Simplify::public_key will be used.
+    # private_key:: Private key to use for the API call. If nil, the value of Simplify::private_key will be used.
+    # Returns a Invoice object.
+    def self.find(id, public_key = nil, private_key = nil)
+        if public_key == nil then
+             public_key = Simplify::public_key
+        end
+        if private_key == nil then
+            private_key = Simplify::private_key
+        end
+
+        h = Simplify::PaymentsApi.execute("invoice", 'show', {"id" => id}, public_key, private_key)
+        obj = Invoice.new()
+        obj.public_key = public_key
+        obj.private_key = private_key
+        obj = obj.merge(h)
+        obj
+    end
+
+    # Updates this object
+    #
+    # The properties that can be updated:
+    # * <code>status</code> Status of the invoice. Examples: OPEN = Invoice has not been processed and can have invoice items added to it. PAID = Invoice has been paid. UNPAID = Invoice was not paid when the card was processed. System will try up to 5 times to process the card. <b>(required)</b>
+    def update()
+          h = Simplify::PaymentsApi.execute("invoice", 'update', self, self.public_key, self.private_key)
+          self.merge!(h)
+          self
+    end
+
+end
+end

data/lib/simplify/invoiceitem.rb

@@ -0,0 +1,140 @@
+#
+# Copyright (c) 2013, MasterCard International Incorporated
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without modification, are 
+# permitted provided that the following conditions are met:
+# 
+# Redistributions of source code must retain the above copyright notice, this list of 
+# conditions and the following disclaimer.
+# Redistributions in binary form must reproduce the above copyright notice, this list of 
+# conditions and the following disclaimer in the documentation and/or other materials 
+# provided with the distribution.
+# Neither the name of the MasterCard International Incorporated nor the names of its 
+# contributors may be used to endorse or promote products derived from this software 
+# without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY 
+# EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 
+# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT 
+# SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 
+# IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 
+# IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 
+# SUCH DAMAGE.
+#
+
+require 'simplify/paymentsapi'
+
+module Simplify
+
+# A InvoiceItem object.
+#
+class InvoiceItem < Hash
+
+    # Public key used to access the API.
+    attr_accessor :public_key
+
+    # Private key used to access the API.
+    attr_accessor :private_key
+
+
+
+    # Creates an InvoiceItem object
+    #
+    # parms:: a hash of parameters; valid keys are:
+    # * <code>amount</code>    Amount of the invoice item (minor units). Example: 1000 = 10.00 <b>required </b>
+    # * <code>currency</code>    Currency code (ISO-4217) for the invoice item. Must match the currency associated with your account. <b>required </b><b>default:USD</b>
+    # * <code>description</code>    Individual items of an invoice 
+    # * <code>invoice</code>    Description of the invoice item <b>required </b>
+    # public_key:: Public to use for the API call. If nil, the value of Simplify::public_key will be used.
+    # private_key:: Private key to use for the API call. If nil, the value of Simplify::private_key will be used.
+    # Returns a InvoiceItem object.
+    def self.create(parms, public_key = nil, private_key = nil)
+        if public_key == nil then
+            public_key = Simplify::public_key
+        end
+        if private_key == nil then
+            private_key = Simplify::private_key
+        end
+
+        h = Simplify::PaymentsApi.execute("invoiceItem", 'create', parms, public_key, private_key)
+        obj = InvoiceItem.new()
+        obj.public_key = public_key
+        obj.private_key = private_key
+        obj = obj.merge(h)
+        obj
+    end
+
+    # Delete this object
+    def delete()
+        h = Simplify::PaymentsApi.execute("invoiceItem", 'delete', self, self.public_key, self.private_key)
+        self.merge!(h)
+        self
+    end
+
+    # Retrieve InvoiceItem objects.
+    # criteria:: a hash of parameters; valid keys are: 
+    # * <code>filter</code>    Filters to apply to the list.  
+    # * <code>max</code>    Allows up to a max of 50 list items to return.  <b>default:20</b>
+    # * <code>offset</code>    Used in paging of the list.  This is the start offset of the page.  <b>default:0</b>
+    # * <code>sorting</code>    Allows for ascending or descending sorting of the list. The value maps properties to the sort direction (either <code>asc</code> for ascending or <code>desc</code> for descending).  Sortable properties are: <code> id</code><code> amount</code><code> description</code><code> invoice</code>. 
+    # public_key:: Public to use for the API call. If nil, the value of Simplify::public_key will be used.
+    # private_key:: Private key to use for the API call. If nil, the value of Simplify::private_key will be used.
+    # Returns an object where the <code>list</code> property contains the list of InvoiceItem objects and the <code>total</code>
+    # property contains the total number of InvoiceItem objects available for the given criteria.
+    def self.list(criteria = nil, public_key = nil, private_key = nil)
+
+        if public_key == nil then
+            public_key = Simplify::public_key
+        end
+        if private_key == nil then
+           private_key = Simplify::private_key
+        end
+
+        h = Simplify::PaymentsApi.execute("invoiceItem", 'list', criteria, public_key, private_key)
+        obj = InvoiceItem.new()
+        obj.public_key = public_key
+        obj.private_key = private_key
+        obj = obj.merge(h)
+        obj
+
+    end
+
+    # Retrieve a InvoiceItem object from the API
+    #
+    # id:: ID of object to retrieve
+    # public_key:: Public to use for the API call. If nil, the value of Simplify::public_key will be used.
+    # private_key:: Private key to use for the API call. If nil, the value of Simplify::private_key will be used.
+    # Returns a InvoiceItem object.
+    def self.find(id, public_key = nil, private_key = nil)
+        if public_key == nil then
+             public_key = Simplify::public_key
+        end
+        if private_key == nil then
+            private_key = Simplify::private_key
+        end
+
+        h = Simplify::PaymentsApi.execute("invoiceItem", 'show', {"id" => id}, public_key, private_key)
+        obj = InvoiceItem.new()
+        obj.public_key = public_key
+        obj.private_key = private_key
+        obj = obj.merge(h)
+        obj
+    end
+
+    # Updates this object
+    #
+    # The properties that can be updated:
+    # * <code>amount</code> Amount of the invoice item (minor units). Example: 1000 = 10.00 
+# * <code>currency</code> Currency code (ISO-4217) for the invoice item. Must match the currency associated with your account. 
+# * <code>description</code> Individual items of an invoice 
+    def update()
+          h = Simplify::PaymentsApi.execute("invoiceItem", 'update', self, self.public_key, self.private_key)
+          self.merge!(h)
+          self
+    end
+
+end
+end

data/lib/simplify/payment.rb

@@ -0,0 +1,133 @@
+#
+# Copyright (c) 2013, MasterCard International Incorporated
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without modification, are 
+# permitted provided that the following conditions are met:
+# 
+# Redistributions of source code must retain the above copyright notice, this list of 
+# conditions and the following disclaimer.
+# Redistributions in binary form must reproduce the above copyright notice, this list of 
+# conditions and the following disclaimer in the documentation and/or other materials 
+# provided with the distribution.
+# Neither the name of the MasterCard International Incorporated nor the names of its 
+# contributors may be used to endorse or promote products derived from this software 
+# without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY 
+# EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 
+# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT 
+# SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 
+# IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 
+# IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 
+# SUCH DAMAGE.
+#
+
+require 'simplify/paymentsapi'
+
+module Simplify
+
+# A Payment object.
+#
+class Payment < Hash
+
+    # Public key used to access the API.
+    attr_accessor :public_key
+
+    # Private key used to access the API.
+    attr_accessor :private_key
+
+
+
+    # Creates an Payment object
+    #
+    # parms:: a hash of parameters; valid keys are:
+    # * <code>amount</code>    Amount of the payment (minor units). Example: 1000 = 10.00 <b>required </b>
+    # * <code>card => addressCity</code>    City of the cardholder. 
+    # * <code>card => addressCountry</code>    Country code (ISO-3166-1-alpha-2 code) of residence of the cardholder. 
+    # * <code>card => addressLine1</code>    Address of the cardholder. 
+    # * <code>card => addressLine2</code>    Address of the cardholder if needed. 
+    # * <code>card => addressState</code>    State code (USPS code) of residence of the cardholder. 
+    # * <code>card => addressZip</code>    Postal code of the cardholder. 
+    # * <code>card => cvc</code>    CVC security code of the card. This is the code on the back of the card. Example: 123 
+    # * <code>card => expMonth</code>    Expiration month of the card. Format is MM. Example: January = 01 <b>required </b>
+    # * <code>card => expYear</code>    Expiration year of the card. Format is YY. Example: 2013 = 13 <b>required </b>
+    # * <code>card => name</code>    Name as it appears on the card. 
+    # * <code>card => number</code>    Card number as it appears on the card. <b>required </b>
+    # * <code>currency</code>    Currency code (ISO-4217) for the transaction. Must match the currency associated with your account. <b>required </b><b>default:USD</b>
+    # * <code>customer</code>    ID of customer. If specified, card on file of customer will be used. 
+    # * <code>description</code>    Custom naming of payment for external systems to use. 
+    # * <code>token</code>    If specified, card associated with card token will be used. 
+    # public_key:: Public to use for the API call. If nil, the value of Simplify::public_key will be used.
+    # private_key:: Private key to use for the API call. If nil, the value of Simplify::private_key will be used.
+    # Returns a Payment object.
+    def self.create(parms, public_key = nil, private_key = nil)
+        if public_key == nil then
+            public_key = Simplify::public_key
+        end
+        if private_key == nil then
+            private_key = Simplify::private_key
+        end
+
+        h = Simplify::PaymentsApi.execute("payment", 'create', parms, public_key, private_key)
+        obj = Payment.new()
+        obj.public_key = public_key
+        obj.private_key = private_key
+        obj = obj.merge(h)
+        obj
+    end
+
+    # Retrieve Payment objects.
+    # criteria:: a hash of parameters; valid keys are: 
+    # * <code>filter</code>    Filters to apply to the list.  
+    # * <code>max</code>    Allows up to a max of 50 list items to return.  <b>default:20</b>
+    # * <code>offset</code>    Used in paging of the list.  This is the start offset of the page.  <b>default:0</b>
+    # * <code>sorting</code>    Allows for ascending or descending sorting of the list. The value maps properties to the sort direction (either <code>asc</code> for ascending or <code>desc</code> for descending).  Sortable properties are: <code> dateCreated</code><code> amount</code><code> id</code><code> description</code><code> paymentDate</code>. 
+    # public_key:: Public to use for the API call. If nil, the value of Simplify::public_key will be used.
+    # private_key:: Private key to use for the API call. If nil, the value of Simplify::private_key will be used.
+    # Returns an object where the <code>list</code> property contains the list of Payment objects and the <code>total</code>
+    # property contains the total number of Payment objects available for the given criteria.
+    def self.list(criteria = nil, public_key = nil, private_key = nil)
+
+        if public_key == nil then
+            public_key = Simplify::public_key
+        end
+        if private_key == nil then
+           private_key = Simplify::private_key
+        end
+
+        h = Simplify::PaymentsApi.execute("payment", 'list', criteria, public_key, private_key)
+        obj = Payment.new()
+        obj.public_key = public_key
+        obj.private_key = private_key
+        obj = obj.merge(h)
+        obj
+
+    end
+
+    # Retrieve a Payment object from the API
+    #
+    # id:: ID of object to retrieve
+    # public_key:: Public to use for the API call. If nil, the value of Simplify::public_key will be used.
+    # private_key:: Private key to use for the API call. If nil, the value of Simplify::private_key will be used.
+    # Returns a Payment object.
+    def self.find(id, public_key = nil, private_key = nil)
+        if public_key == nil then
+             public_key = Simplify::public_key
+        end
+        if private_key == nil then
+            private_key = Simplify::private_key
+        end
+
+        h = Simplify::PaymentsApi.execute("payment", 'show', {"id" => id}, public_key, private_key)
+        obj = Payment.new()
+        obj.public_key = public_key
+        obj.private_key = private_key
+        obj = obj.merge(h)
+        obj
+    end
+
+end
+end

data/lib/simplify/paymentsapi.rb

@@ -0,0 +1,411 @@
+#
+# Copyright (c) 2013, MasterCard International Incorporated
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without modification, are 
+# permitted provided that the following conditions are met:
+# 
+# Redistributions of source code must retain the above copyright notice, this list of 
+# conditions and the following disclaimer.
+# Redistributions in binary form must reproduce the above copyright notice, this list of 
+# conditions and the following disclaimer in the documentation and/or other materials 
+# provided with the distribution.
+# Neither the name of the MasterCard International Incorporated nor the names of its 
+# contributors may be used to endorse or promote products derived from this software 
+# without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY 
+# EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 
+# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT 
+# SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 
+# IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 
+# IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 
+# SUCH DAMAGE.
+#
+
+require 'rest_client'
+require 'base64'
+require 'open-uri'
+require 'json'
+require 'hmac-sha2'
+require 'securerandom'
+require 'simplify/apiexception'
+require 'simplify/constants'
+require 'simplify/event'
+
+module Simplify
+
+  @@public_key = nil
+  @@private_key = nil
+  @@api_base_live_url = Constants::api_base_live_url
+  @@api_base_sandbox_url = Constants::api_base_sandbox_url
+  @@user_agent = nil
+
+
+  # Returns the value of the public API key.
+  def self.public_key
+    @@public_key
+  end
+
+  # Sets the value of the public API key.
+  def self.public_key=(key)
+    @@public_key = key
+  end
+
+  # Returns the value of the private API key.
+  def self.private_key
+    @@private_key
+  end
+
+  # Sets the value of the private API key.
+  def self.private_key=(key)
+    @@private_key = key
+  end
+
+  # Returns the base URL for the live API.
+  def self.api_base_live_url
+    @@api_base_live_url
+  end
+
+  # Sets the base URL for the live API.
+  def self.api_base_live_url=(url)
+    @@api_base_live_url = url
+  end
+
+  # Returns the base URL for the sandbox API.
+  def self.api_base_sandbox_url
+    @@api_base_sandbox_url
+  end
+
+  # Sets the base URL for the sandbox API.
+  def self.api_base_sandbox_url=(url)
+    @@api_base_sandbox_url = url
+  end
+
+  # Returns the user agent value sent in requests to the API.
+  def self.user_agent
+    @@user_agent
+  end
+
+  # Sets the value of the user agent sent in requests to the API.
+  def self.user_agent=(ua)
+    @@user_agent = ua
+  end
+
+
+  class PaymentsApi
+
+    @@JWS_NUM_HEADERS = 7
+    @@JWS_ALGORITHM   = 'HS256'
+    @@JWS_TYPE        = 'JWS'
+    @@JWS_HDR_UNAME   = 'uname'
+    @@JWS_HDR_URI            = 'api.simplifycommerce.com/uri'
+    @@JWS_HDR_TIMESTAMP      = 'api.simplifycommerce.com/timestamp'
+    @@JWS_HDR_NONCE          = 'api.simplifycommerce.com/nonce'
+    @@JWS_TIMESTAMP_MAX_DIFF = 1000 * 60 * 5   # 5 minutes
+
+    @@HTTP_SUCCESS  = 200
+    @@HTTP_REDIRECTED = 302
+    @@HTTP_UNAUTHORIZED = 401
+    @@HTTP_NOT_FOUND = 404
+    @@HTTP_NOT_ALLOWED = 405
+    @@HTTP_BAD_REQUEST = 400
+
+    def self.execute(type, action, objectMap, public_key = nil, private_key = nil)
+
+      if public_key == nil
+          public_key = Simplify::public_key
+      end
+
+      if public_key == nil
+           raise ArgumentError.new("Must have a valid public key to connect to the API")
+      end
+
+      if private_key == nil
+          private_key = Simplify::private_key
+      end
+
+      if private_key == nil
+           raise ArgumentError.new("Must have a valid API key to connect to the API", nil, nil)
+      end
+
+      content_type = 'application/json'
+      url = build_url(get_base_url(public_key), type, action, objectMap)
+
+      signature = jws_encode(public_key,  private_key, url, objectMap, action == 'update' || action == 'create')
+
+      opts = case action
+      when 'show', 'projections' then
+      {
+        :method => 'GET',
+        :headers => { :authorization => "JWS #{signature}" }
+      }
+      when 'list' then
+      {
+        :method => 'GET',
+        :headers => { :authorization => "JWS #{signature}" }
+      }
+      when 'update' then
+      {
+        :method => 'PUT',
+        :payload => signature
+      }
+      when 'create' then
+      {
+        :method => 'POST',
+        :payload => signature
+      }
+      when 'delete' then
+      {
+        :method => 'DELETE',
+        :headers => { :authorization => "JWS #{signature}" }
+      }
+      end
+
+      user_agent = "Ruby-SDK/#{Constants::version}"
+      if Simplify::user_agent != nil
+          user_agent = "#{user_agent} #{Simplify::user_agent}"
+      end
+
+      opts = opts.merge({
+        :url => url,
+        :headers => {
+          'Content-Type' => content_type,
+          'Accept' => 'application/json',
+          'User-Agent' => user_agent
+        }.merge(opts[:headers] || {})
+      })
+
+      begin
+        response = RestClient::Request.execute(opts)
+        JSON.parse(response.body)
+      rescue RestClient::Exception => e
+
+        begin
+           errorData = JSON.parse(e.response.body)
+        rescue JSON::ParserError => e2
+           raise ApiException.new("Unknown error", nil, nil)
+        end
+
+        if e.response.code == @@HTTP_REDIRECTED
+            raise BadRequestException.new("Unexpected response code returned from the API, have you got the correct URL?", responseCode, e.response.code, errorData)
+        elsif e.response.code == @@HTTP_BAD_REQUEST
+            raise BadRequestException.new("Bad request", e.response.code, errorData)
+        elsif e.response.code == @@HTTP_UNAUTHORIZED
+            raise AuthenticationException.new("You are not authorized to make this request.  Are you using the correct API keys?", e.response.code, errorData)
+        elsif e.response.code == @@HTTP_NOT_FOUND
+            raise ObjectNotFoundException.new("Object not found", e.response.code, errorData)
+        elsif e.response.code == @@HTTP_NOT_ALLOWED
+            raise NotAllowedException.new("Operation not allowed", e.response.code, errorData)
+        elsif e.response.code < 500
+            raise BadRequestException.new("Bad request", e.response.code, errorData)
+        else
+            raise SystemException.new("An unexpected error has been raised.  Looks like there's something wrong at our end.", e.response.code, errorData)
+        end
+      end
+    end
+
+    def self.build_url(base_url, type, action, objectMap)
+      parts = []
+      parts << base_url
+      parts << type
+      parts << case action
+      when 'show', 'update', 'delete' then
+        [URI::encode(objectMap["id"].to_s)]
+
+      end
+      url = parts.flatten().join('/')
+
+      query = Array.new
+
+      if action == "list" and objectMap != nil then
+
+         if (objectMap['max'])
+            query << "max=#{objectMap['max']}"
+         end
+         if (objectMap['offset'])
+            query << "offset=#{objectMap['offset']}"
+         end
+         if (objectMap['sorting']) then
+            objectMap['sorting'].each { |k, v|
+               query << "sorting[#{URI::encode(k.to_s)}]=#{URI::encode(v.to_s)}"
+            }
+         end
+         if (objectMap['filter']) then
+            objectMap['filter'].each { |k, v|
+               query << "filter[#{URI::encode(k.to_s)}]=#{URI::encode(v.to_s)}"
+            }
+         end
+      end
+
+      if query.size > 0 then
+          url = url + "?" + query.join('&')
+      end
+
+      return url
+    end
+
+    def self.get_base_url(public_key)
+
+        if live_key?(public_key)
+            return Simplify::api_base_live_url
+        end
+        return Simplify::api_base_sandbox_url
+
+    end
+
+    def self.jws_encode(public_key, private_key, url, objectMap, hasPayload)
+
+        jws_hdr = {'typ' => @@JWS_TYPE,
+                   'alg' => @@JWS_ALGORITHM,
+                   'kid' => public_key,
+		            @@JWS_HDR_URI => url,
+		            @@JWS_HDR_TIMESTAMP => Time.now.to_i * 1000,
+       		        @@JWS_HDR_NONCE => SecureRandom.hex }
+
+        hdr = urlsafe_encode64(jws_hdr.to_json)
+
+        payload = ''
+        if (hasPayload) then
+            payload = urlsafe_encode64(objectMap.to_json)
+        end
+
+        msg = hdr + '.' + payload
+        return msg + '.' + jws_sign(private_key, msg)
+
+    end
+
+    def self.jws_decode(params, public_key, private_key)
+
+      if public_key == nil
+           raise ArgumentError.new("Must have a valid public key to connect to the API")
+      end
+
+      if private_key == nil
+           raise ArgumentError.new("Must have a valid API key to connect to the API")
+      end
+
+      payload = params['payload']
+      if payload == nil 
+           raise ArgumentError.new("Event data is missing payload")
+      end 
+
+	  begin
+      
+        payload.strip!     
+	    data = payload.split('.')
+        if data.size != 3
+            jws_auth_error("Incorrectly formatted JWS message");
+        end
+
+	    msg = "#{data[0]}.#{data[1]}"
+	    header = urlsafe_decode64(data[0])
+	    payload = urlsafe_decode64(data[1])
+
+	    jws_verify_header(header, params['url'], public_key)
+	    if !jws_verify_signature(private_key, msg, data[2])
+	       jws_auth_error("JWS signature does not match")
+	    end
+	    
+	    return JSON.parse(payload)
+
+	  resue Exception => e
+	      jws_auth_error("Exception during JWS decoding: #{e}")
+	  end
+
+	  jws_auth_error("JWS decode failed")
+    end
+
+    def self.jws_sign(private_key, msg)
+        urlsafe_encode64(HMAC::SHA256.digest(Base64.decode64(private_key), msg))
+    end
+
+
+    def self.jws_verify_header(header, url, public_key)
+
+	    hdr = JSON.parse(header)
+
+	    if hdr.size != @@JWS_NUM_HEADERS
+		    jws_auth_error("Incorrect number of JWS header parameters - found #{hdr.size} required #{@@JWS_NUM_HEADERS}")
+	    end
+
+	    if hdr['alg'] != @@JWS_ALGORITHM
+		    jws_auth_error("Incorrect algorithm - found #{hdr['alg']} required #{@@JWS_ALGORITHM}")
+	    end
+
+	    if hdr['typ'] != @@JWS_TYPE
+		    jws_auth_error("Incorrect type - found #{hdr['typ']} required #{@@JWS_TYPE}")
+	    end
+
+	    if hdr['kid'] == nil
+		    jws_auth_error("Missing Key ID")
+	    end
+
+	    if hdr['kid'] != public_key
+	        if live_key?(public_key)
+	            jws_auth_error("Invalid Key ID")
+ 		    end
+	    end
+
+	    if hdr[@@JWS_HDR_URI] == nil
+		    jws_auth_error("Missing URI")
+	    end
+
+	    if url != nil && hdr[@@JWS_HDR_URI] != url
+	        jws_auth_error("Incorrect URL - found #{hdr[@@JWS_HDR_URI]} required #{url}")
+	    end
+
+	    if hdr[@@JWS_HDR_TIMESTAMP] == nil
+		    jws_auth_error("Missing timestamp")
+	    end
+
+	    if !jws_verify_timestamp(hdr[@@JWS_HDR_TIMESTAMP])
+		    jws_auth_error("Invalid timestamp")
+	    end
+
+	    if hdr[@@JWS_HDR_NONCE] == nil
+		    jws_auth_error("Missing nonce")
+	    end
+
+	    if hdr[@@JWS_HDR_UNAME] == nil
+		    jws_auth_error("Missing username header")
+	    end
+    end
+
+    def self.jws_verify_signature(private_key, msg, crypto)
+        return crypto == jws_sign(private_key, msg)
+    end
+
+
+    def self.jws_verify_timestamp(ts)
+    	return (Time.now.to_i * 1000 - ts.to_i).abs < @@JWS_TIMESTAMP_MAX_DIFF
+    end
+
+    def self.jws_auth_error(reason)
+	    raise AuthenticationException.new("JWS authentication failure: #{reason}", nil, nil)
+    end
+
+    def self.live_key?(public_key)
+    	return public_key.start_with?("lvpb")
+    end
+
+    # Base64.urlsafe_encode64()/urlsafe_decode64() is not available in ruby 1.8
+    def self.urlsafe_encode64(s)
+        return Base64::encode64(s).gsub(/\n/, '').gsub('+', '-').gsub('/', '_').gsub('=', '')
+    end
+
+    def self.urlsafe_decode64(s)
+    	# Put back padding
+    	case (s.size % 4)
+	       when 0:
+	       when 2: s = s + "=="
+	       when 3: s = s + "="
+	       else raise ArgumentError.new("Webhook event data incorrectly formatted", nil, nil)
+	    end
+        return Base64::decode64(s.gsub('-','+').gsub('_','/'))
+    end
+
+  end
+end