razorruby 3.0.1

data/lib/extensions/httparty/hash_conversions.rb

@@ -0,0 +1,44 @@
+require 'httparty'
+
+# :nocov:
+module HTTParty
+  # Extension of HTTParty:HashConversions. Changes made to add index to arrays
+  # https://github.com/jnunemaker/httparty/blob/master/lib/httparty/hash_conversions.rb#L42,L55
+  module HashConversions
+    def self.normalize_keys(key, value)
+      stack = []
+      normalized_keys = []
+
+      if value.respond_to?(:to_ary)
+        if value.empty?
+          normalized_keys << ["#{key}[]", '']
+        else
+          normalized_keys = value.to_ary.flat_map.with_index do
+            |element, index| normalize_keys("#{key}[#{index}]", element)
+          end
+        end
+      elsif value.respond_to?(:to_hash)
+        stack << [key, value.to_hash]
+      else
+        normalized_keys << [key.to_s, value]
+      end
+
+      stack.each do |parent, hash|
+        hash.each do |child_key, child_value|
+          if child_value.respond_to?(:to_hash)
+            stack << ["#{parent}[#{child_key}]", child_value.to_hash]
+          elsif child_value.respond_to?(:to_ary)
+            child_value.to_ary.each_with_index do |v, index|
+              normalized_keys << normalize_keys("#{parent}[#{child_key}][#{index}]", v).flatten
+            end
+          else
+            normalized_keys << normalize_keys("#{parent}[#{child_key}]", child_value).flatten
+          end
+        end
+      end
+
+      normalized_keys
+    end
+  end
+end
+# :nocov:

data/lib/razorpay/addon.rb

@@ -0,0 +1,32 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Addon API allows you to fetch and delete
+  # subscription-addons with Razorpay
+  class Addon < Entity
+    def self.request
+      Razorpay::Request.new('addons')
+    end
+
+    def self.fetch(id)
+      request.fetch id
+    end
+
+    def self.all(options = {})
+       request.all options
+    end
+
+    def self.create(subscription_id, options)
+      r = request
+      # POST /addons is not supported
+      # Addon creation endpoint is:
+      # POST subscriptions/{sub_id}/addons
+      r.request :post, "/subscriptions/#{subscription_id}/addons", options
+    end
+
+    def self.delete(id)
+      request.delete id
+    end
+  end
+end

data/lib/razorpay/card.rb

@@ -0,0 +1,17 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Card API allows you to fetch cards
+  # saved with Razorpay
+  # Docs: https://docs.razorpay.com/v1/page/cards
+  class Card < Entity
+    def self.request
+      Razorpay::Request.new('cards')
+    end
+
+    def self.fetch(id)
+      request.fetch id
+    end
+  end
+end

data/lib/razorpay/collection.rb

@@ -0,0 +1,6 @@
+module Razorpay
+  # Collection class handles groups of similar
+  # entities
+  class Collection < Entity
+  end
+end

data/lib/razorpay/constants.rb

@@ -0,0 +1,6 @@
+# Version and other constants are defined here
+module Razorpay
+  BASE_URI = 'https://api.razorpay.com/v1/'.freeze
+  TEST_URL = 'https://api.razorpay.com/'.freeze
+  VERSION = '3.0.1'.freeze
+end

data/lib/razorpay/customer.rb

@@ -0,0 +1,42 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Customer API allows you to create and fetch customers on Razorpay
+  class Customer < Entity
+    def self.request
+      Razorpay::Request.new('customers')
+    end
+
+    def self.create(options)
+      request.create options
+    end
+
+    def self.fetch(id)
+      request.fetch id
+    end
+
+    def self.edit(id, options = {})
+      request.put id, options
+    end
+
+    def self.all(options = {})
+      request.all options
+    end
+    
+    # Fetch token by customerId
+    # https://razorpay.com/docs/api/recurring-payments/upi/tokens/#22-fetch-tokens-by-customer-id 
+    def fetchTokens
+      self.class.request.get "#{id}/tokens" 
+    end
+ 
+   # Fetch specific token 
+    def fetchToken(tokenId)
+      self.class.request.get "#{id}/tokens/#{tokenId}" 
+    end
+
+    def deleteToken(tokenId)
+      self.class.request.delete "#{id}/tokens/#{tokenId}" 
+    end
+  end
+end

data/lib/razorpay/entity.rb

@@ -0,0 +1,46 @@
+require 'json'
+
+module Razorpay
+  # Entity class is the base class for all Razorpay objects
+  # This saves data in a hash internally, and makes it available
+  # via direct methods
+  class Entity
+    attr_reader :attributes
+
+    def initialize(attributes)
+      @attributes = attributes
+    end
+
+    # This method fakes attr_reader, but uses
+    # the @attributes hash as the source, instead of
+    # instance variables
+    def method_missing(name)
+      if @attributes.key? name.to_s
+        @attributes[name.to_s]
+      else
+        super
+      end
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      @attributes.key?(method_name.to_s) || super
+    end
+
+    # Public: Convert the Entity object to JSON
+    # Returns the JSON representation of the Entity (as a string)
+    def to_json(*args)
+      @attributes.to_json(*args)
+    end
+
+    # Mutates the entity in accordance with
+    # the block passed to this construct
+    #
+    # Used to implement bang methods, by calling
+    # the non-bang method in the passed block
+    def with_a_bang
+      mutated_entity = yield
+      @attributes = mutated_entity.attributes
+      mutated_entity
+    end
+  end
+end

data/lib/razorpay/errors/bad_request_error.rb

@@ -0,0 +1,14 @@
+require 'razorpay/errors/razorpay_error'
+
+module Razorpay
+  # Bad request to API. Missing a field or an invalid field.
+  # Error in merchant request. Check the description and correct the request accordingly.
+  class BadRequestError < Razorpay::Error
+    attr_reader :field
+
+    def initialize(code, status, field = nil)
+      super(code, status)
+      @field = field
+    end
+  end
+end

data/lib/razorpay/errors/gateway_error.rb

@@ -0,0 +1,7 @@
+require 'razorpay/errors/razorpay_error'
+
+module Razorpay
+  # Error in Gateway Communication.
+  class GatewayError < Razorpay::Error
+  end
+end

data/lib/razorpay/errors/razorpay_error.rb

@@ -0,0 +1,11 @@
+module Razorpay
+  # Default Error class for any unknown errors
+  class Error < StandardError
+    attr_reader :code, :status
+
+    def initialize(code = nil, status = nil)
+      @code = code
+      @status = status
+    end
+  end
+end

data/lib/razorpay/errors/server_error.rb

@@ -0,0 +1,7 @@
+require 'razorpay/errors/razorpay_error'
+
+module Razorpay
+  # There is some problem with the server
+  class ServerError < Razorpay::Error
+  end
+end

data/lib/razorpay/errors.rb

@@ -0,0 +1,4 @@
+require 'razorpay/errors/razorpay_error'
+require 'razorpay/errors/bad_request_error'
+require 'razorpay/errors/gateway_error'
+require 'razorpay/errors/server_error'

data/lib/razorpay/fund_account.rb

@@ -0,0 +1,19 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # FundAccount API allows you to create and fetch a fund account for a customer. 
+  class FundAccount < Entity
+    def self.request
+      Razorpay::Request.new('fund_accounts')
+    end
+
+    def self.create(options)
+      request.create options
+    end
+
+    def self.all(data = {})
+      request.all data
+    end
+  end
+end

data/lib/razorpay/invoice.rb

@@ -0,0 +1,68 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Invoice API allows you to create and
+  # manage invoices with Razorpay
+  class Invoice < Entity
+    def self.request
+      Razorpay::Request.new('invoices')
+    end
+
+    def self.create(options)
+      request.create options
+    end
+
+    def self.fetch(id)
+      request.fetch id
+    end
+
+    def self.all(options = {})
+      request.all options
+    end
+
+    def self.edit(id, options = {})
+      request.patch id, options
+    end
+
+    def self.issue(id)
+      request.post "#{id}/issue"
+    end
+
+    def self.cancel(id)
+      request.post "#{id}/cancel"
+    end
+
+    def edit(options = {})
+      self.class.edit id, options
+    end
+
+    def edit!(options = {})
+      with_a_bang { edit options }
+    end
+
+    def issue
+      self.class.issue id
+    end
+
+    def issue!
+      with_a_bang { issue }
+    end
+
+    def cancel
+      self.class.cancel id
+    end
+
+    def cancel!
+      with_a_bang { cancel }
+    end
+
+    def self.notify_by(id, medium)
+      request.post "#{id}/notify_by/#{medium}"
+    end
+    
+    def self.delete(id)
+      request.delete "#{id}" 
+    end
+  end
+end

data/lib/razorpay/item.rb

@@ -0,0 +1,34 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Item API allows you to create and fetch customers on Razorpay
+  class Item < Entity
+    def self.request
+      Razorpay::Request.new('items')
+    end
+
+    def self.create(options)
+      request.create options
+    end
+
+    def self.fetch(id)
+      request.fetch id
+    end
+
+    def self.edit(id, options = {})
+      if(!options.is_a?(String) && options.key?(:active))
+        options[:active] = (options[:active] ? 1 : 0)
+      end 
+      request.patch id, options
+    end
+
+    def self.all(options = {})
+      request.all options
+    end
+
+    def self.delete(id)
+        request.delete id
+    end    
+  end
+end

data/lib/razorpay/order.rb

@@ -0,0 +1,39 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Order API allows you to associate
+  # Payments with an order entity
+  class Order < Entity
+    def self.request
+      Razorpay::Request.new('orders')
+    end
+
+    def self.create(options)
+      request.create options
+    end
+
+    def self.fetch(id)
+      request.fetch id
+    end
+
+    def self.all(options = {})
+      request.all options
+    end
+
+    def payments(options = {})
+      r = self.class.request
+      r.request :get, "/orders/#{id}/payments", options
+    end
+    
+    def self.edit(id, options = {})
+      request.patch id, options
+    end
+    
+    def self.fetch_transfer_order(id)
+      # Fetch Transfer for an Order
+      # Docs: https://razorpay.com/docs/api/payments/route/#fetch-transfer-for-an-order
+      request.get "#{id}/?expand[]=transfers&status"
+    end
+  end
+end

data/lib/razorpay/payment.rb

@@ -0,0 +1,116 @@
+require 'razorpay/request'
+require 'razorpay/refund'
+require 'razorpay/entity'
+
+module Razorpay
+  # Payment class is the most commonly used class
+  # and is used to interact with Payments, the most
+  # common type of transactions
+  class Payment < Entity
+    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
+    end
+
+    def self.all(options = {})
+      request.all options
+    end
+
+    def self.capture(id, options)
+      request.post "#{id}/capture", options
+    end
+
+    def refund(options = {})
+      self.class.request.post "#{id}/refund", options
+    end
+
+    def refund!(options = {})
+      refund = refund options
+      with_a_bang { self.class.request.fetch id }
+      refund
+    end
+
+    def capture(options)
+      self.class.request.post "#{id}/capture", options
+    end
+
+    def capture!(options)
+      with_a_bang { capture options }
+    end
+
+    def refunds
+      self.class.request.get "#{id}/refunds"
+    end
+
+    def method
+      method_missing(:method)
+    end
+
+    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
+  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/plan.rb

@@ -0,0 +1,24 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Plan API allows you to create and
+  # manage subscription-plans with Razorpay
+  class Plan < Entity
+    def self.request
+      Razorpay::Request.new('plans')
+    end
+
+    def self.create(options)
+      request.create options
+    end
+
+    def self.fetch(id)
+      request.fetch id
+    end
+
+    def self.all(options = {})
+      request.all options
+    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

@@ -0,0 +1,27 @@
+require 'razorpay/request'
+require 'razorpay/entity'
+
+module Razorpay
+  # Refund class handles all refund objects
+  class Refund < Entity
+    def self.request
+      Razorpay::Request.new('refunds')
+    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
+  end
+end