razorpay 2.4.0 → 3.2.4

data/lib/razorpay/payload_validator.rb

@@ -0,0 +1,93 @@
+module Razorpay
+
+  ValidationType = {
+    non_null: :non_null,
+    non_empty_string: :non_empty_string,
+    url: :url,
+    id: :id,
+    mode: :mode,
+    token_grant: :token_grant
+  }
+
+  # PayloadValidator allows to perform basic validations
+  class PayloadValidator
+    def self.validate(request, validation_configs)
+      validation_configs.each do |config|
+        field_name = config.field_name
+        config.validations.each do |validation_type|
+          apply_validation(request, field_name, validation_type)
+        end
+      end
+    end
+
+    class << self
+
+      private
+
+      def apply_validation(payload, field, validation_type)
+        case validation_type
+        when ValidationType[:non_null]
+          validate_non_null(payload, field)
+        when ValidationType[:non_empty_string]
+          validate_non_empty_string(payload, field)
+        when ValidationType[:url]
+          validate_url(payload, field)
+        when ValidationType[:id]
+          validate_id(payload, field)
+        when ValidationType[:mode]
+          validate_mode(payload, field)
+        when ValidationType[:token_grant]
+          validate_grant_type(payload, field)
+        end
+      end
+
+      def validate_non_null(payload, field)
+        raise Razorpay::Error.new, "Field #{field} cannot be null" unless payload.key?(field) && !payload[field].nil?
+      end
+
+      def validate_non_empty_string(payload, field)
+        raise Razorpay::Error.new, "Field #{field} cannot be empty" if payload[field].to_s.strip.empty?
+      end
+
+      def validate_url(payload, field)
+        url = payload[field]
+        url_regex = /^(http[s]?):\/\/[^\s\/$.?#].[^\s]*$/
+        
+        unless url_regex.match?(url)
+          error_message = "Field #{field} is not a valid URL"
+          raise Razorpay::Error.new, error_message
+        end
+      end
+
+      def validate_id(payload, field)
+        validate_non_null(payload, field)
+        validate_non_empty_string(payload, field)
+        value = payload[field]
+        id_regex = /^[A-Za-z0-9]{1,14}$/
+
+        unless value.match?(id_regex)
+          error_message = "Field #{field} is not a valid ID"
+          raise Razorpay::Error.new, error_message
+        end
+      end
+
+      def validate_mode(payload, field)
+        validate_non_null(payload, field)
+        unless ["test", "live"].include?(payload[field])
+          error_message = "Invalid value provided for field #{field}"
+          raise Razorpay::Error.new, error_message
+        end
+      end
+
+      def validate_grant_type(payload, field)
+        validate_non_null(payload, field)
+        case payload[field]
+        when 'authorization_code'
+          validate_non_null(payload, 'code');
+        when 'refresh_token'
+          validate_non_null(payload, 'refresh_token');
+        end
+      end
+    end
+  end
+end

data/lib/razorpay/payment.rb

@@ -10,6 +10,46 @@ module Razorpay
     def self.request
       Razorpay::Request.new('payments')
     end
+    
+    def self.create_recurring_payment(data={})
+      request.post "create/recurring" , data
+    end
+
+    def self.create_json_payment(data={})
+      request.post "create/json" , data
+    end
+
+    def self.fetch_payment_downtime
+      request.get "downtimes"
+    end
+
+    def self.fetch_payment_downtime_by_id(id)
+      request.get "downtimes/#{id}"
+    end
+
+    def self.fetch_card_details(id)
+      request.get "#{id}/card"  
+    end
+    
+    def fetch_transfer
+      self.class.request.get "#{id}/transfers"  
+    end
+
+    def fetch_refund(refundId)
+      self.class.request.get "#{id}/refunds/#{refundId}"  
+    end
+    
+    def self.fetch_multiple_refund(id, options = {})
+      request.get "#{id}/refunds",options
+    end
+
+    def transfer(options = {})
+      self.class.request.post "#{id}/transfers", options
+    end
+
+    def edit(options = {})
+      self.class.request.patch id, options
+    end
 
     def self.fetch(id)
       request.fetch id
@@ -52,5 +92,29 @@ module Razorpay
     def bank_transfer
       self.class.request.get "#{id}/bank_transfer"
     end
+
+    def self.otp_generate(id)
+      request.post "#{id}/otp_generate"
+    end
+
+    def otp_submit(options)
+      self.class.request.post "#{id}/otp/submit", options
+    end
+
+    def otp_resend
+      self.class.request.post "#{id}/otp/resend"
+    end
+
+    def self.create_upi(data={})
+      request.post "create/upi" , data
+    end
+    
+    def self.validate_vpa(data={})
+      request.post "validate/vpa" , data
+    end
+
+    def self.expand_details(id, options={})
+      request.get "#{id}", options
+    end
   end
 end

data/lib/razorpay/payment_link.rb

@@ -0,0 +1,36 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Payment Links are URLs that you can send to your customers 
+  # through SMS and email to collect payments from them.
+  class PaymentLink < Entity
+    def self.request
+      Razorpay::Request.new('payment_links')
+    end
+
+    def self.create(options)
+      request.create options
+    end
+
+    def self.fetch(id)
+      request.fetch id
+    end
+
+    def self.edit(id, options = {})
+      request.patch id, options
+    end
+
+    def self.all(options = {})
+      request.all options
+    end
+
+    def self.cancel(id)
+      request.post "#{id}/cancel"
+    end
+    
+    def self.notify_by(id,medium)
+      request.post "#{id}/notify_by/#{medium}"
+    end
+  end
+end

data/lib/razorpay/payment_method.rb

@@ -0,0 +1,17 @@
+require 'razorpay/request'
+require 'razorpay/refund'
+require 'razorpay/entity'
+
+module Razorpay
+  # Payment Methods class is allows you to create
+  # to fetch all payment methods
+  class PaymentMethods < Entity
+    def self.request
+      Razorpay::Request.new('methods')
+    end
+    
+    def self.all(options = {})
+      request.all options
+    end
+  end
+end

data/lib/razorpay/product.rb

@@ -0,0 +1,37 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Product API allows you to enable sub-merchants request for a product.
+  class Product < Entity
+
+    @@versions = "v2"
+
+    def self.request
+      Razorpay::Request.new('accounts')
+    end
+
+    def self.request_product_configuration(account_id, options)
+      if(!options.is_a?(String) && options.key?(:tnc_accepted))
+        options[:tnc_accepted] = (options[:tnc_accepted] ? 1 : 0)
+      end
+      request.post "#{account_id}/products", options, @@versions
+    end
+
+    def self.fetch(account_id, id)
+      request.fetch "#{account_id}/products/#{id}", @@versions
+    end 
+
+    def self.edit(account_id, id, options = {})
+      if(!options.is_a?(String) && options.key?(:tnc_accepted))
+        options[:tnc_accepted] = (options[:tnc_accepted] ? 1 : 0)
+      end
+      request.patch "#{account_id}/products/#{id}", options, @@versions
+    end
+
+    def self.fetch_tnc(productName)
+      r = request
+      r.request :get, "/#{@@versions}/products/#{productName}/tnc", {}
+    end
+  end
+end

data/lib/razorpay/qr_code.rb

@@ -0,0 +1,34 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # QrCode API allows you to create, close and fetch QR codes
+  class QrCode < Entity
+    def self.request
+      Razorpay::Request.new('payments/qr_codes')
+    end
+
+    def self.create(options)
+        if(!options.is_a?(String) && options.key?(:fixed_amount))
+           options[:fixed_amount] = (options[:fixed_amount] ? 1 : 0)
+        end  
+      request.create options
+    end
+
+    def self.fetch(id)
+      request.fetch id
+    end
+
+    def self.all(options = {})
+      request.all options
+    end
+
+    def fetch_payments(options = {})
+      self.class.request.get "#{id}/payments", options
+    end
+
+    def close
+      self.class.request.post "#{id}/close"
+    end
+  end
+end

data/lib/razorpay/refund.rb

@@ -19,5 +19,9 @@ module Razorpay
     def self.fetch(id)
       request.fetch id
     end
+
+    def edit(options = {})
+      self.class.request.patch id, options
+    end
   end
 end

data/lib/razorpay/request.rb

@@ -11,65 +11,86 @@ module Razorpay
 
     ssl_ca_file File.dirname(__FILE__) + '/../ca-bundle.crt'
 
-    def initialize(entity_name = nil)
-      self.class.base_uri(Razorpay::BASE_URI)
+    def initialize(entity_name = nil, host = Razorpay::API_HOST)
+      self.class.base_uri(get_base_url(host))
       @entity_name = entity_name
       custom_headers = Razorpay.custom_headers || {}
       predefined_headers = {
-        'User-Agent' => "Razorpay-Ruby/#{Razorpay::VERSION}"
+        'User-Agent' => "Razorpay-Ruby/#{Razorpay::VERSION}; Ruby/#{RUBY_VERSION}"
       }
+
       # Order is important to give precedence to predefined headers
       headers = custom_headers.merge(predefined_headers)
-      @options = {
-        basic_auth: Razorpay.auth,
-        timeout: 30,
-        headers: headers
-      }
+
+      if Razorpay.auth_type == Razorpay::OAUTH
+        @options = {
+          timeout: 30,
+          headers: headers
+        }
+        headers['Authorization'] = 'Bearer ' + Razorpay.access_token 
+      else 
+        @options = {
+          basic_auth: Razorpay.auth,
+          timeout: 30,
+          headers: headers
+        }
+      end
     end
 
-    def fetch(id)
-      request :get, "/#{@entity_name}/#{id}"
+    def fetch(id, version="v1")
+      request :get, "/#{version}/#{@entity_name}/#{id}"
     end
 
-    def all(options)
-      request :get, "/#{@entity_name}", options
+    def all(options, version="v1")
+      request :get, "/#{version}/#{@entity_name}", options
     end
 
-    def post(url, data = {})
-      request :post, "/#{@entity_name}/#{url}", data
+    def post(url, data = {}, version="v1")
+      request :post, "/#{version}/#{@entity_name}/#{url}", data
     end
 
-    def get(url)
-      request :get, "/#{@entity_name}/#{url}"
+    def get(url, data = {}, version="v1")
+      request :get, "/#{version}/#{@entity_name}/#{url}", data
+    end
+    
+    def delete(url, version="v1")
+      request :delete, "/#{version}/#{@entity_name}/#{url}"
     end
 
-    def put(id, data = {})
-      request :put, "/#{@entity_name}/#{id}", data
+    def put(id, data = {}, version="v1")
+      request :put, "/#{version}/#{@entity_name}/#{id}", data
     end
 
-    def patch(id, data = {})
-      request :patch, "/#{@entity_name}/#{id}", data
+    def patch(id, data = {}, version="v1")
+      request :patch, "/#{version}/#{@entity_name}/#{id}", data
     end
 
-    def create(data)
-      request :post, "/#{@entity_name}", data
+    def create(data, version="v1")
+      request :post, "/#{version}/#{@entity_name}", data
     end
 
     def request(method, url, data = {})
       create_instance raw_request(method, url, data)
     end
 
-    def raw_request(method, url, data = {})
+    def raw_request(method, url, data = {}) 
       case method
       when :get
         @options[:query] = data
       when :post, :put, :patch
         @options[:body] = data
       end
-
+      
       self.class.send(method, url, @options)
     end
 
+    def get_base_url(host)
+      if host == Razorpay::AUTH_HOST
+        return Razorpay::AUTH_URL
+      end 
+      Razorpay::BASE_URI
+    end
+
     # Since we need to change the base route
     def make_test_request
       self.class.get Razorpay::TEST_URL, @options
@@ -80,9 +101,12 @@ module Razorpay
     def create_instance(res)
       response = res.parsed_response
 
+      if response.is_a?(Array)==true || response.to_s.length == 0
+        return response
+      end 
+      
       # if there was an error, throw it
-      raise_error(response['error'], res.code) if response.nil? || response.key?('error')
-
+      raise_error(response['error'], res.code) if response.nil? || response.key?('error') && res.code !=200
       # There must be a top level entity
       # This is either one of payment, refund, or collection at present
       begin

data/lib/razorpay/settlement.rb

@@ -0,0 +1,39 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Settlement API allows you to fetch and delete
+  # Docs: https://razorpay.com/docs/api/settlements/
+  class Settlement < Entity
+    def self.request
+      Razorpay::Request.new('settlements')
+    end
+
+    def self.fetch(id)
+      request.fetch id
+    end
+
+    def self.reports(options={})
+      request.get "recon/combined", options
+    end
+
+    def self.all(options = {})
+      request.all options
+    end
+
+    def self.create(options={})
+      if(!options.is_a?(String) && options.key?(:settle_full_balance))
+        options[:settle_full_balance] = (options[:settle_full_balance] ? 1 : 0)
+      end 
+      request.post "ondemand", options
+    end
+
+    def self.fetch_all_ondemand_settlement(options={})
+      request.get "ondemand", options
+    end
+
+    def self.fetch_ondemand_settlement_by_id(id, options={})
+      request.get "ondemand/#{id}", options
+    end
+  end
+end

data/lib/razorpay/stakeholder.rb

@@ -0,0 +1,39 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Stakeholder API allows you to add stakeholders for an account. 
+  class Stakeholder < Entity
+
+    @@versions = "v2"
+
+    def self.request
+      Razorpay::Request.new('accounts')
+    end
+
+    def self.create(account_id, options)
+      request.post "#{account_id}/stakeholders", options, @@versions
+    end
+
+    def self.fetch(account_id, id)
+      request.fetch "#{account_id}/stakeholders/#{id}", @@versions
+    end
+
+    def self.all(account_id)
+      request.get "#{account_id}/stakeholders",{}, @@versions
+    end   
+
+    def self.edit(account_id, id, options = {})
+      request.patch "#{account_id}/stakeholders/#{id}", options, @@versions
+    end
+
+    def self.upload_stakeholder_doc(account_id, id,options)
+      r = request
+      r.request :post, "/#{@@versions}/accounts/#{account_id}/stakeholders/#{id}/documents", options
+    end
+
+    def self.fetch_stakeholder_doc(account_id, id)
+      request.fetch "#{account_id}/stakeholders/#{id}/documents", @@versions
+    end
+  end
+end

data/lib/razorpay/subscription.rb

@@ -32,5 +32,29 @@ module Razorpay
     def cancel!(options = {})
       with_a_bang { cancel options }
     end
+
+    def edit(options = {})
+      self.class.request.patch id, options
+    end
+
+    def pending_update
+      self.class.request.get "#{id}/retrieve_scheduled_changes"
+    end
+
+    def self.cancel_scheduled_changes(id)
+      request.post "#{id}/cancel_scheduled_changes"
+    end
+
+    def self.pause(id, options = {})
+      request.post "#{id}/pause", options
+    end
+
+    def self.resume(id, options = {})
+      request.post "#{id}/resume", options
+    end
+
+    def self.delete_offer(id, offerId)
+      request.delete "#{id}/#{offerId}"
+    end
   end
 end

data/lib/razorpay/subscription_registration.rb

@@ -0,0 +1,16 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # SubscriptionRegistration are an alternate way of 
+  # creating an authorization transaction
+  class SubscriptionRegistration < Entity
+    def self.request
+      Razorpay::Request.new('subscription_registration/auth_links')
+    end
+
+    def self.create(options)
+        request.create options
+    end
+  end
+end

data/lib/razorpay/token.rb

@@ -0,0 +1,28 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  
+  class Token < Entity
+
+    def self.request
+      Razorpay::Request.new('tokens')
+    end
+
+    def self.create(options)
+      request.create options
+    end
+
+    def self.fetch(options)
+      request.post "fetch", options
+    end 
+
+    def self.delete(options)
+      request.post "delete", options
+    end
+
+    def self.process_payment_on_alternate_pa_or_pg(options)
+      request.post "service_provider_tokens/token_transactional_data", options
+    end
+  end
+end

data/lib/razorpay/transfer.rb

@@ -0,0 +1,39 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Transfer class handles all refund objects
+  class Transfer < Entity
+    def self.request
+      Razorpay::Request.new('transfers')
+    end
+    
+    def self.create(options)
+      request.create options
+    end
+
+    def self.all(options = {})
+     request.all options
+    end
+
+    def self.fetch(id)
+      request.fetch id
+    end
+
+    def edit(options = {})
+      self.class.request.patch id, options
+    end
+
+    def reverse(options = {})
+      self.class.request.post "#{id}/reversals", options
+    end
+
+    def self.fetch_settlements
+      request.get "?expand[]=recipient_settlement"
+    end
+
+    def self.reversals(id)
+      request.get "#{id}/reversals"
+    end  
+  end
+end