razorpay 3.0.0 → 3.0.1

data/documents/upi.md

@@ -10,6 +10,7 @@ Razorpay.setup('key_id', 'key_secret')
 para_attr = {
   "name": "Razorpay User",
   "email": "customer@razorpay.com",
+  "fail_existing": 0,
   "contact": 9123456780,
   "notes": {
     "notes_key_1": "Tea, Earl Grey, Hot",
@@ -52,23 +53,19 @@ Razorpay::Customer.create(para_attr)
 
 ```rb
 para_attr = {
-  "amount": 0,
+  "amount": 100,
   "currency": "INR",
+  "customer_id": "cust_4xbQrmEoA5WJ01",
   "method": "upi",
-  "customer_id": "cust_1Aa00000000001",
+  "token": {
+    "max_amount": 200000,
+    "expire_at": 2709971120,
+    "frequency": "monthly"
+  },
   "receipt": "Receipt No. 1",
   "notes": {
-    "notes_key_1": "Beam me up Scotty",
-    "notes_key_2": "Engage"
-  },
-  "token": {
-    "auth_type": "netbanking",
-    "max_amount": 9999900,
-    "expire_at": 4102444799,
-    "notes": {
-      "notes_key_1": "Tea, Earl Grey, Hot",
-      "notes_key_2": "Tea, Earl Grey… decaf."
-    }
+    "notes_key_1": "Tea, Earl Grey, Hot",
+    "notes_key_2": "Tea, Earl Grey… decaf."
   }
 }
 Razorpay.Order.create(para_attr)
@@ -83,7 +80,7 @@ Razorpay.Order.create(para_attr)
 | method*        | string  | The authorization method. In this case the value will be `emandate`                      |
 | receipt         | string  | Your system order reference id.                                              |
 | notes           | object  | A key-value pair                                                             |
-| token           | object  | A key-value pair                                                             |
+| token           | object  | All parameters listed [here](https://razorpay.com/docs/api/payments/recurring-payments/upi/create-authorization-transaction#112-create-an-order) are supported |
 
 **Response:**
 ```json
@@ -147,17 +144,16 @@ Razorpay::SubscriptionRegistration.create(para_attr)
 
 | Name            | Type    | Description                                                                  |
 |-----------------|---------|------------------------------------------------------------------------------|
-| customer          | object | Details of the customer to whom the registration link will be sent.           |
+| customer   | object      | All parameters listed [here](https://razorpay.com/docs/api/payments/recurring-payments/upi/create-authorization-transaction/#121-create-a-registration-link) are supported |
 | type*        | string  | In this case, the value is `link`.                      |
 | currency*        | string  | The 3-letter ISO currency code for the payment. Currently, only `INR` is supported. |
 | amount*         | integer  | The payment amount in the smallest currency sub-unit.                 |
 | description*    | string  | A description that appears on the hosted page. For example, `12:30 p.m. Thali meals (Gaurav Kumar`).                                                             |
-| subscription_registration           | object  | Details of the authorization payment.                      |
-|sms_notify           | array  | Details of the line item that is billed in the invoice.  |
-|email_notify           | array  | Details of the line item that is billed in the invoice.  |
-|expire_by           | array  | Details of the line item that is billed in the invoice.  |
-|receipt         | string  | Your system order reference id.  |
-|notes           | object  | A key-value pair                                                             |
+| subscription_registration      | object  | All parameters listed [here](https://razorpay.com/docs/api/payments/recurring-payments/upi/create-authorization-transaction/#121-create-a-registration-link) are supported |
+| sms_notify  | boolean  | SMS notifications are to be sent by Razorpay (default : 1)  |
+| email_notify | boolean  | Email notifications are to be sent by Razorpay (default : 1)  |
+| expire_by    | integer | The timestamp, in Unix format, till when the customer can make the authorization payment. |
+| notes | object  | A key-value pair  |
 
 
 **Response:**
@@ -227,7 +223,7 @@ invoiceId = "inv_JDdNb4xdf4gxQ7"
 
 medium = "email" 
 
-Razorpay::Invoice.notifyBy(invoiceId, medium)
+Razorpay::Invoice.notify_by(invoiceId, medium)
 ```
 
 **Parameters:**
@@ -322,9 +318,9 @@ Razorpay::Invoice.cancel(invoiceId)
 ### Fetch token by payment ID
 
 ```rb
-customerId = "cust_1Aa00000000004"
+paymentId = "pay_FHfAzEJ51k8NLj"
 
-Razorpay::Customer.fetchTokens(customerId)
+Razorpay::Payment.fetch(paymentId)
 ```
 
 **Parameters:**
@@ -382,7 +378,7 @@ Razorpay::Customer.fetchTokens(customerId)
 ```rb
 customerId = "cust_1Aa00000000004"
 
-Razorpay::Customer.fetchTokens(customerId)
+Razorpay::Customer.fetch(customerId).fetchTokens
 ```
 
 **Parameters:**
@@ -433,7 +429,7 @@ customerId = "cust_1Aa00000000004"
 
 tokenId = "token_Hxe0skTXLeg9pF"
 
-Razorpay::fetch(customerId).deleteToken(tokenId)
+Razorpay::Customer.fetch(customerId).deleteToken(tokenId)
 ```
 
 **Parameters:**
@@ -458,6 +454,7 @@ para_attr{
   "amount": 1000,
   "currency": "INR",
   "receipt": "Receipt No. 1",
+  "payment_capture": true,
   "notes": {
     "notes_key_1": "Tea, Earl Grey, Hot",
     "notes_key_2": "Tea, Earl Grey… decaf."
@@ -473,8 +470,8 @@ Razorpay::Order.create(para_attr)
 | amount*          | integer | Amount of the order to be paid                                               |
 | currency*        | string  | Currency of the order. Currently only `INR` is supported.                      |
 | receipt         | string  | Your system order reference id.                                              |
+| payment_capture*  | boolean  | Indicates whether payment status should be changed to captured automatically or not. Possible values: true - Payments are captured automatically. false - Payments are not captured automatically. |
 | notes           | object  | A key-value pair                                                             |
-
 **Response:**
 ```json
 {
@@ -512,7 +509,7 @@ para_attr = {
   "description": "Creating recurring payment for Gaurav Kumar"
 }
 
-Razorpay::Payment.createRecurringPayment(para_attr)
+Razorpay::Payment.create_recurring_payment(para_attr)
 ```
 
 **Parameters:**

data/documents/virtualAccount.md

@@ -342,7 +342,7 @@ Razorpay::VirtualAccount.fetch(virtualId).payments(options)
 ```rb
 paymend_id = "pay_Di5iqCqA1WEHq6"
 
-Razorpay::Razorpay::Payment.fetch(paymend_id).bank_transfer
+Razorpay::Payment.fetch(paymend_id).bank_transfer
 ```
 
 **Parameters:**
@@ -403,6 +403,8 @@ Razorpay::Razorpay::Payment.fetch(paymend_id).bank_transfer
 
 ### Refund payments made to a virtual account
 ```rb
+paymend_id = "pay_Di5iqCqA1WEHq6"
+
 options = {
   "amount": "100",
   "speed": "normal",
@@ -413,7 +415,7 @@ options = {
   "receipt": "Receipt No. 31"
 }
 
-Razorpay::Payment.fetch(@payment_id).refund(options)
+Razorpay::Payment.fetch(payment_id).refund(options)
 ```
 
 **Parameters:**
@@ -429,20 +431,22 @@ Razorpay::Payment.fetch(@payment_id).refund(options)
 **Response:**
 ```json
 {
-  "id": "rfnd_E6j36ZEKvsWsEn",
+  "id": "rfnd_FP8QHiV938haTz",
   "entity": "refund",
-  "amount": 100,
+  "amount": 500100,
+  "receipt": "Receipt No. 31",
   "currency": "INR",
-  "payment_id": "pay_E54n391WnEAV9H",
-  "notes": {
-    "key_1": "value1",
-    "key_2": "value2"
-  },
+  "payment_id": "pay_FCXKPFtYfPXJPy",
+  "notes": [],
   "receipt": null,
   "acquirer_data": {
-    "rrn": null
+    "arn": null
   },
-  "created_at": 1579522301
+  "created_at": 1597078866,
+  "batch_id": null,
+  "status": "processed",
+  "speed_processed": "normal",
+  "speed_requested": "normal"
 }
 ```
 -------------------------------------------------------------------------------------------------------
@@ -469,7 +473,7 @@ Razorpay::VirtualAccount.add_receiver(virtualId, para_attr)
 |-------|-----------|--------------------------------------------------|
 | virtualId*  | string    | The id of the virtual to be updated  |
 | types*  | object | The receiver type to be added to the virtual account. Possible values are `vpa` or `bank_account`  |
-| vpa    | object | This is to be passed only when `vpa` is passed as the receiver types. |
+| vpa.descriptor    | string | Descriptor should be 10 characters only. |
 
 **Response:**
 For add receiver to an existing virtual account response please click [here](https://razorpay.com/docs/api/smart-collect/#add-receiver-to-an-existing-virtual-account)
@@ -560,7 +564,7 @@ Razorpay::VirtualAccount.delete_allowed_payer(virtualId,allowedPayersId)
 
 **Response:**
 ```json
-{}
+null
 ```
 -------------------------------------------------------------------------------------------------------
 ### Close virtual account
@@ -578,6 +582,7 @@ Razorpay::VirtualAccount.close(virtualId)
 
 **Response:**
 For close virtual account response please click [here](https://razorpay.com/docs/api/smart-collect/#close-a-virtual-account)
+
 -------------------------------------------------------------------------------------------------------
 
 **PN: * indicates mandatory fields**

data/lib/razorpay/addon.rb

@@ -24,5 +24,9 @@ module Razorpay
       # 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/constants.rb

@@ -2,5 +2,5 @@
 module Razorpay
   BASE_URI = 'https://api.razorpay.com/v1/'.freeze
   TEST_URL = 'https://api.razorpay.com/'.freeze
-  VERSION = '3.0.0'.freeze
+  VERSION = '3.0.1'.freeze
 end

data/lib/razorpay/payment.rb

@@ -104,5 +104,13 @@ module Razorpay
     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_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.rb

@@ -19,6 +19,7 @@ require 'razorpay/payment_link'
 require 'razorpay/fund_account'
 require 'razorpay/item'
 require 'razorpay/qr_code'
+require 'razorpay/payment_method'
 
 # Base Razorpay module
 module Razorpay

data/razorpay-ruby.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency 'httparty', '~> 0.14'
 
-  spec.add_development_dependency 'coveralls', '~> 0.8'
+  spec.add_development_dependency 'coveralls_reborn', '~> 0.8'
   spec.add_development_dependency 'minitest', '~> 5.11'
   spec.add_development_dependency 'rake', '~> 12.0'
 
@@ -27,6 +27,7 @@ Gem::Specification.new do |spec|
     # rubocop is only run in the latest ruby build
     # so we use the latest version and don't switch to a
     # older version for 1.9.3
+    spec.add_development_dependency 'simplecov-cobertura'
     spec.add_development_dependency 'rubocop', '~> 0.49'
     spec.add_development_dependency 'webmock', '~> 3.0'
   else

data/test/fixtures/fake_create_upi_payment.json

@@ -0,0 +1,3 @@
+{
+    "razorpay_payment_id": "pay_FVmAstJWfsD3SO"
+}

data/test/fixtures/fake_validate_vpa.json

@@ -0,0 +1,5 @@
+{
+    "vpa": "gauravkumar@exampleupi",
+    "success": true,
+    "customer_name": "Gaurav Kumar"
+  }

data/test/fixtures/payment_methods_collection.json

@@ -0,0 +1,149 @@
+{
+    "entity": "methods",
+    "card": true,
+    "debit_card": true,
+    "credit_card": true,
+    "prepaid_card": true,
+    "card_networks": {
+      "AMEX": 0,
+      "DICL": 0,
+      "MC": 1,
+      "MAES": 1,
+      "VISA": 1,
+      "JCB": 0,
+      "RUPAY": 1,
+      "BAJAJ": 0
+    },
+    "card_subtype": {
+      "consumer": 1,
+      "business": 1,
+      "premium": 0
+    },
+    "amex": false,
+    "netbanking": {
+      "AUBL": "AU Small Finance Bank",
+      "AIRP": "Airtel Payments Bank",
+      "ANDB": "Andhra Bank",
+      "UTIB": "Axis Bank",
+      "BARB_R": "Bank of Baroda - Retail Banking",
+      "VIJB": "Bank of Baroda - Retail Banking (Erstwhile Vijaya Bank)",
+      "MAHB": "Bank of Maharashtra",
+      "CNRB": "Canara Bank",
+      "CSBK": "Catholic Syrian Bank",
+      "CBIN": "Central Bank of India",
+      "DCBL": "DCB Bank",
+      "DEUT": "Deutsche Bank",
+      "DLXB": "Dhanlaxmi Bank",
+      "ESFB": "Equitas Small Finance Bank",
+      "FSFB": "Fincare Small Finance Bank",
+      "ICIC": "ICICI Bank",
+      "IBKL": "IDBI",
+      "IDFB": "IDFC FIRST Bank",
+      "IDIB": "Indian Bank",
+      "ALLA": "Indian Bank (Erstwhile Allahabad Bank)",
+      "IOBA": "Indian Overseas Bank",
+      "INDB": "Indusind Bank",
+      "JAKA": "Jammu and Kashmir Bank",
+      "JSFB": "Jana Small Finance Bank",
+      "KARB": "Karnataka Bank",
+      "KVBL": "Karur Vysya Bank",
+      "KKBK": "Kotak Mahindra Bank",
+      "LAVB_R": "Lakshmi Vilas Bank - Retail Banking",
+      "NSPB": "NSDL Payments Bank",
+      "ORBC": "PNB (Erstwhile-Oriental Bank of Commerce)",
+      "UTBI": "PNB (Erstwhile-United Bank of India)",
+      "PSIB": "Punjab & Sind Bank",
+      "PUNB_R": "Punjab National Bank - Retail Banking",
+      "RATN": "RBL Bank",
+      "SVCB": "SVC Co-Operative Bank Ltd.",
+      "SRCB": "Saraswat Co-operative Bank",
+      "SIBL": "South Indian Bank",
+      "SCBL": "Standard Chartered Bank",
+      "SBBJ": "State Bank of Bikaner and Jaipur",
+      "SBHY": "State Bank of Hyderabad",
+      "SBIN": "State Bank of India",
+      "SBMY": "State Bank of Mysore",
+      "STBP": "State Bank of Patiala",
+      "SBTR": "State Bank of Travancore",
+      "TMBL": "Tamilnad Mercantile Bank",
+      "UCBA": "UCO Bank",
+      "UBIN": "Union Bank of India",
+      "CORP": "Union Bank of India (Erstwhile Corporation Bank)",
+      "YESB": "Yes Bank"
+    },
+    "wallet": {
+      "mobikwik": true,
+      "payzapp": true,
+      "olamoney": true,
+      "airtelmoney": true,
+      "freecharge": true,
+      "jiomoney": true
+    },
+    "emi": false,
+    "upi": true,
+    "cardless_emi": [],
+    "paylater": {
+      "epaylater": true,
+      "getsimpl": true,
+      "icic": true,
+      "hdfc": true,
+      "kkbk": true,
+      "lazypay": true
+    },
+    "google_pay_cards": false,
+    "app": {
+      "cred": 0,
+      "twid": 0,
+      "trustly": 0,
+      "poli": 0,
+      "sofort": 0,
+      "giropay": 0
+    },
+    "gpay": false,
+    "emi_types": {
+      "credit": false,
+      "debit": false
+    },
+    "debit_emi_providers": {
+      "HDFC": 0
+    },
+    "nach": false,
+    "cod": false,
+    "offline": false,
+    "recurring": {
+      "card": {
+        "credit": [
+          "MasterCard",
+          "Visa"
+        ],
+        "prepaid": [
+          "MasterCard",
+          "Visa"
+        ],
+        "debit": {
+          "UTIB": "Axis Bank",
+          "BARB": "Bank of Baroda",
+          "MAHB": "Bank of Maharashtra",
+          "CITI": "CITI Bank",
+          "CNRB": "Canara Bank",
+          "CIUB": "City Union Bank",
+          "ESFB": "Equitas Small Finance Bank",
+          "FDRL": "Federal Bank",
+          "HDFC": "HDFC Bank",
+          "HSBC": "HSBC",
+          "ICIC": "ICICI Bank",
+          "IDIB": "Indian Bank",
+          "ALLA": "Indian Bank (Erstwhile Allahabad Bank)",
+          "IOBA": "Indian Overseas Bank",
+          "INDB": "Indusind Bank",
+          "KVBL": "Karur Vysya Bank",
+          "KKBK": "Kotak Mahindra Bank",
+          "RATN": "RBL Bank",
+          "SBIN": "State Bank of India"
+        }
+      },
+      "upi": true,
+      "nach": false
+    },
+    "upi_intent": true
+  }

data/test/razorpay/test_addon.rb

@@ -57,8 +57,6 @@ module Razorpay
       assert_addon_item_details(addon)
     end
 
-    private
-
     def assert_addon_item_details(addon)
       addon_item = Item.new(addon.item)
 
@@ -68,5 +66,11 @@ module Razorpay
       assert_equal 'INR', addon_item.currency, 'Addon Item currency is accessible'
       assert_equal 500, addon_item.amount, 'Addon Item amount is accessible'
     end
+
+    def test_delete_addon
+      stub_delete(%r{addons/#{@addon_id}$}, 'empty')
+      addon = Razorpay::Addon.delete(@addon_id)
+      assert_instance_of Razorpay::Entity, addon
+    end
   end
 end

data/test/razorpay/test_payment.rb

@@ -217,6 +217,7 @@ module Razorpay
       stub_post(%r{payments/#{@payment_id}/otp/resend$}, 'fake_otp_resend', {})
       payment = Razorpay::Payment.fetch(@payment_id).otp_resend
       assert_equal @payment_id, payment.razorpay_payment_id
+    end 
 
     def test_payment_edit
 
@@ -253,7 +254,50 @@ module Razorpay
       stub_post(%r{payments/create/json$}, 'create_json_payment',payment_attr.to_json) 
       payment = Razorpay::Payment.create_json_payment payment_attr.to_json 
       assert_equal 'pay_FVmAstJWfsD3SO', payment.razorpay_payment_id
+     end
+     def test_create_upi
+
+      param_attr = {
+        "amount": 200,
+        "currency": "INR",
+        "order_id": "order_GAWRjlWkVcRh0V",
+        "email": "gaurav.kumar@example.com",
+        "contact": "9123456789",
+        "method": "upi",
+        "customer_id": "cust_EIW4T2etiweBmG",
+        "save": 1,
+        "ip": "192.168.0.103",
+        "referer": "http",
+        "user_agent": "Mozilla/5.0",
+        "description": "Test flow",
+        "notes": {
+          "note_key": "value1"
+        },
+        "upi": {
+          "flow": "collect",
+          "vpa": "gauravkumar@exampleupi",
+          "expiry_time": 5
+        }
+      }
+
+      stub_post(%r{payments/create/upi$}, 'fake_create_upi_payment',param_attr.to_json) 
+      payment = Razorpay::Payment.create_upi param_attr.to_json 
+      assert_equal 'pay_FVmAstJWfsD3SO', payment.razorpay_payment_id
+    end
+
+    def test_payment_methods
+      stub_get(/methods$/, 'payment_methods_collection') 
+      methods = Razorpay::PaymentMethods.all
+      assert_equal 'methods', methods.entity
     end
-   end 
-  end
+    
+    def test_validate_vpa
+      param_attr = {
+        "vpa": "gauravkumar@exampleupi"
+      }
+      stub_post(%r{payments/validate/vpa$}, 'fake_validate_vpa',param_attr.to_json) 
+      payment = Razorpay::Payment.validate_vpa param_attr.to_json 
+      assert_equal param_attr[:vpa], payment.vpa
+    end  
+  end 
 end

data/test/test_helper.rb

@@ -3,8 +3,10 @@ require 'simplecov'
 require 'minitest/autorun'
 require 'webmock/minitest'
 require 'razorpay'
+require 'simplecov-cobertura'
 
 Coveralls.wear! if ENV['CI']
+SimpleCov.formatter = SimpleCov::Formatter::CoberturaFormatter
 
 def fixture_file(filename)
   return '' if filename == ''