razorpay 3.2.1 → 3.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5cd01ee8ed4e390a472e9054a4383fde2482eea27f29992bf7d7fc39f33b24c9
-  data.tar.gz: b099a18ac979054c0862c1bdfbb643cb997d42cd5b8bb73c034811109793537e
+  metadata.gz: 378791c954dc8fd9cd1b32fac1f61e4955bb8cf0e0df081f6be872ca22d26da8
+  data.tar.gz: dced052941fccf512cbbffaa2ca4e36949c96f12456908bea790e7511f4062ab
 SHA512:
-  metadata.gz: 726a001671bd021fb23623a05bcda7a952ee618b4b327d45643dddbe3feae613069aa0abb83fb695b798b759638ba5073cfa50711162dc2077c14e462221fd9b
-  data.tar.gz: 1fe13db4f2ace27314ccc8601e7679289ad1f3fb02ee150fced0c1c192e8727e01c1922c883bf66d627c10997a635de0b81b1ab51f0f859d650391a3fe01dbe9
+  metadata.gz: e0c9d0ceec3e76d8e996ea56e3032f615891278c37c511b3f6e777508e6525b9eaddecb11fd02ecf09cd7845562680d085f13a14f6591cfe88b692e496d52a01
+  data.tar.gz: 1513933a083dbb5df97ad56e5cb898c3538ca51186a9118818c4bc6c05838f29bf6e3af1c0dc836b65d260152ba6ad85dfde26b9877ef0830868f2f8b1521c04

data/CHANGELOG.md

@@ -4,6 +4,23 @@ Changelog for Razorpay-Ruby SDK.
 
 ## Unreleased
 
+## [3.2.3] - 2024-05-27
+
+feat: Added new API endpoints
+* Added support for `add_bank_account`, `delete_bank_account`, `request_eligibility_check` & `fetch_eligibility` on customer
+* Added support for `expand_details` on payment
+* Added support for fetch Reversals for a Transfer
+* Added support for Dispute
+* Added support for Document
+* Added support for `view_rto` & `edit_fulfillment` on order
+
+## [3.2.2] - 2024-04-16
+
+feat: Added oauth APIs and support for access token based authentication mechanism
+* Added oauth APIs (getAuthURL, getAccessToken, refreshToken, revokeToken)
+* Added support for access token based authentication mechanism
+* Added support for onboarding signature generation
+
 ## [3.2.1] - 2023-12-19
 
 Rollback: Generic access point due to some performance concern

data/README.md

@@ -27,7 +27,11 @@ Ruby 2.6.8 or later
 
 Remember to `require 'razorpay'` before anything else.
 
-Next, you need to setup your key and secret using the following:
+Next, you need to setup your auth details. This setup can be done via two ways:
+
+### Using Private Auth
+
+you need to setup your key and secret using the following:
 
 ```rb
 Razorpay.setup('key_id', 'key_secret')
@@ -38,6 +42,16 @@ You can set customer headers for your requests using the following:
 Razorpay.headers = {"CUSTOM_APP_HEADER" => "CUSTOM_VALUE"}
 ```
 
+### Using Access Token
+you need to setup your access token using the following
+```rb
+Razorpay.setup_with_oauth('access_token')
+```
+You can set customer headers for your requests using the following:
+```rb
+Razorpay.headers = {"CUSTOM_APP_HEADER" => "CUSTOM_VALUE"}
+```
+
 You can find your API keys at <https://dashboard.razorpay.com/#/app/keys>.
 
 If you are using rails, the right place to do this might be `config/initializers/razorpay.rb`.
@@ -70,6 +84,9 @@ If you are using rails, the right place to do this might be `config/initializers
 - [Register NACH and Charge First Payment Together](documents/registerNach.md)
 - [Payment Verification](documents/paymentVerification.md)
 - [Webhook](documents/webhook.md)
+- [OAuthToken](documents/oauth_token.md)
+- [Dispute](documents/dispute.md)
+- [Document](documents/documents.md)
 
 ## Development
 

data/documents/customer.md

@@ -157,6 +157,248 @@ Razorpay::Customer.fetch(customerId)
 
 -------------------------------------------------------------------------------------------------------
 
+### Add Bank Account of Customer
+
+```rb
+customerId = "cust_N5mywh91sXB69O"
+
+Razorpay::Customer.add_bank_account(customerId,{
+    "ifsc_code": "UTIB0000194",
+    "account_number": "916010082985661",
+    "beneficiary_name": "Pratheek",
+    "beneficiary_address1": "address 1",
+    "beneficiary_address2": "address 2",
+    "beneficiary_address3": "address 3",
+    "beneficiary_address4": "address 4",
+    "beneficiary_email": "random@email.com",
+    "beneficiary_mobile": "8762489310",
+    "beneficiary_city": "Bangalore",
+    "beneficiary_state": "KA",
+    "beneficiary_country": "IN"
+})
+```
+
+**Parameters:**
+
+| Name                 | Type     | Description                                                                |
+|----------------------|----------|----------------------------------------------------------------------------|
+| customerId*          | string   | Unique identifier of the customer.                                         |
+| account_number       | string   | Customer's bank account number. For example, `0002020000304030434`.        |
+| beneficiary_name     | string   | The name of the beneficiary associated with the bank account.              |
+| beneficiary_address1 | string   | The virtual payment address.                                               |
+| beneficiary_email    | string   | Email address of the beneficiary. For example, `gaurav.kumar@example.com`. |
+| beneficiary_mobile   | integer  | Mobile number of the beneficiary.                                          |
+| beneficiary_city     | string   | The name of the city of the beneficiary.                                   |
+| beneficiary_state    | string   | The state of the beneficiary.                                              |
+| beneficiary_country  | string   | The country of the beneficiary.                                            |
+| beneficiary_pin      | interger | The pin code of the beneficiary's address.                                 |
+| ifsc_code            | string   | The IFSC code of the bank branch associated with the account.              |
+
+**Response:**
+```json
+{
+    "id": "ba_LSZht1Cm7xFTwF",
+    "entity": "bank_account",
+    "ifsc": "ICIC0001207",
+    "bank_name": "ICICI Bank",
+    "name": "Gaurav Kumar",
+    "notes": [],
+    "account_number": "XXXXXXXXXXXXXXX0434"
+}
+```
+
+-------------------------------------------------------------------------------------------------------
+
+### Delete Bank Account of Customer
+
+```rb
+customerId = "cust_N5mywh91sXB69O"
+
+bankAccountId = "ba_N6aM8uo64IzxHu"
+
+Razorpay::Customer.delete_bank_account(customerId, bankAccountId)
+```
+
+**Parameters:**
+
+| Name          | Type      | Description                                                       |
+|---------------|-----------|-------------------------------------------------------------------|
+| customerId*   | string    |  Customer id of the customer whose bank account is to be deleted. |
+| bankAccountId | string    | The bank_id that needs to be deleted.                             |
+
+**Response:**
+```json
+{
+    "id": "ba_Evg09Ll05SIPSD",
+    "ifsc": "ICIC0001207",
+    "bank_name": "ICICI Bank",
+    "name": "Test R4zorpay",
+    "account_number": "XXXXXXXXXXXXXXX0434",
+    "status": "deleted"
+}
+```
+
+-------------------------------------------------------------------------------------------------------
+
+### Eligibility Check API
+
+```rb
+Razorpay::Customer.request_eligibility_check({
+    "inquiry": "affordability",
+    "amount": 500,
+    "currency": "INR",
+    "customer": {
+        "id": "elig_xxxxxxxxxxxxx",
+        "contact": "+919999999999",
+        "ip": "105.106.107.108",
+        "referrer": "https://merchansite.com/example/paybill",
+        "user_agent": "Mozilla/5.0"
+    }
+})
+```
+
+**Parameters:**
+
+| Name        | Type    | Description                                                                                                                                                                                                                    |
+|-------------|---------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| inquiry     | string  | List of methods or instruments on which eligibility check is required. Possible value is `affordability`.                                                                                                                      |
+| amount*     | integer | The amount for which the order was created, in currency subunits. For example, for an amount of ₹295, enter `29500`. The user makes a payment for this amount against the order; hence, eligibility is checked for the amount. |
+| currency*   | string  | A three-letter ISO code for the currency in which you want to accept the payment. Possible value is `INR`.                                                                                                                     |
+| customer*   | object  | Customer details. [here](https://razorpay.com/docs/payments/payment-gateway/affordability/eligibility-check/#eligibility-check-api)                                                                                            |
+| instruments | object  | Payment instruments on which an eligibility check is required. [here](https://razorpay.com/docs/payments/payment-gateway/affordability/eligibility-check/#eligibility-check-api)                                               |
+
+
+**Response:**
+```json
+{
+  "amount": "500000",
+  "customer": {
+    "id": "KkBhM9EC1Y0HTm",
+    "contact": "+919999999999"
+  },
+  "instruments": [
+    {
+      "method": "emi",
+      "issuer": "HDFC",
+      "type": "debit",
+      "eligibility_req_id": "elig_xxxxxxxxxxxxx",
+      "eligibility": {
+        "status": "eligible"
+      }
+    },
+    {
+      "method": "paylater",
+      "provider": "getsimpl",
+      "eligibility_req_id": "elig_xxxxxxxxxxxxx",
+      "eligibility": {
+        "status": "eligible"
+      }
+    },
+    {
+      "method": "paylater",
+      "provider": "icic",
+      "eligibility_req_id": "elig_xxxxxxxxxxxxx",
+      "eligibility": {
+        "status": "eligible"
+      }
+    },
+    {
+      "method": "cardless_emi",
+      "provider": "walnut369",
+      "eligibility_req_id": "elig_xxxxxxxxxxxxx",
+      "eligibility": {
+        "status": "ineligible",
+        "error": {
+          "code": "GATEWAY_ERROR",
+          "description": "The customer has not been approved by the partner.",
+          "source": "business",
+          "step": "inquiry",
+          "reason": "user_not_approved"
+        }
+      }
+    },
+    {
+      "method": "cardless_emi",
+      "provider": "zestmoney",
+      "eligibility_req_id": "elig_xxxxxxxxxxxxx",
+      "eligibility": {
+        "status": "ineligible",
+        "error": {
+          "code": "GATEWAY_ERROR",
+          "description": "The customer has exhausted their credit limit.",
+          "source": "business",
+          "step": "inquiry",
+          "reason": "credit_limit_exhausted"
+        }
+      }
+    },
+    {
+      "method": "paylater",
+      "provider": "lazypay",
+      "eligibility_req_id": "elig_xxxxxxxxxxxxx",
+      "eligibility": {
+        "status": "ineligible",
+        "error": {
+          "code": "GATEWAY_ERROR",
+          "description": "The order amount is less than the minimum transaction amount.",
+          "source": "business",
+          "step": "inquiry",
+          "reason": "min_amt_required"
+        }
+      }
+    }
+  ]
+}
+```
+
+-------------------------------------------------------------------------------------------------------
+
+### Fetch Eligibility by id
+
+```rb
+eligibilityId = "elig_F1cxDoHWD4fkQt"
+Razorpay::Customer.fetch_eligibility(eligibilityId)
+```
+
+**Parameters:**
+
+| Name          | Type        | Description                                                        |
+|---------------|-------------|--------------------------------------------------------------------|
+| eligibilityId | string      | The unique identifier of the eligibility request to be retrieved.  |
+
+**Response:**
+```json
+{
+  "instruments": [
+    {
+      "method": "paylater",
+      "provider": "lazypay",
+      "eligibility_req_id": "elig_xxxxxxxxxxxxx",
+      "eligibility": {
+        "status": "eligible"
+      }
+    },
+    {
+      "method": "paylater",
+      "provider": "getsimpl",
+      "eligibility_req_id": "elig_xxxxxxxxxxxxx",
+      "eligibility": {
+        "status": "ineligible",
+        "error": {
+          "code": "GATEWAY_ERROR",
+          "description": "The customer has exhausted their credit limit",
+          "source": "gateway",
+          "step": "inquiry",
+          "reason": "credit_limit_exhausted"
+        }
+      }
+    }
+  ]
+}
+```
+
+-------------------------------------------------------------------------------------------------------
+
 **PN: * indicates mandatory fields**
 <br>
 <br>

data/documents/dispute.md

@@ -0,0 +1,301 @@
+## Document
+
+### Fetch All Disputes
+
+```rb
+Razorpay::Dispute.all()
+```
+
+**Response:**
+```json
+{
+  "entity": "collection",
+  "count": 1,
+  "items": [
+    {
+      "id": "disp_Esz7KAitoYM7PJ",
+      "entity": "dispute",
+      "payment_id": "pay_EsyWjHrfzb59eR",
+      "amount": 10000,
+      "currency": "INR",
+      "amount_deducted": 0,
+      "reason_code": "pre_arbitration",
+      "respond_by": 1590604200,
+      "status": "open",
+      "phase": "pre_arbitration",
+      "created_at": 1590059211,
+      "evidence": {
+        "amount": 10000,
+        "summary": null,
+        "shipping_proof": null,
+        "billing_proof": null,
+        "cancellation_proof": null,
+        "customer_communication": null,
+        "proof_of_service": null,
+        "explanation_letter": null,
+        "refund_confirmation": null,
+        "access_activity_log": null,
+        "refund_cancellation_policy": null,
+        "term_and_conditions": null,
+        "others": null,
+        "submitted_at": null
+      }
+    }
+  ]
+}
+```
+-------------------------------------------------------------------------------------------------------
+
+### Fetch a Dispute
+
+```rb
+disputeId = "disp_0000000000000"
+
+Razorpay::Dispute.fetch(disputeId)
+```
+
+**Parameters:**
+
+| Name        | Type   | Description                                      |
+|-------------|--------|--------------------------------------------------|
+| disputeId*  | string | The unique identifier of the dispute.            |
+
+**Response:**
+```json
+{
+  "id": "disp_AHfqOvkldwsbqt",
+  "entity": "dispute",
+  "payment_id": "pay_EsyWjHrfzb59eR",
+  "amount": 10000,
+  "currency": "INR",
+  "amount_deducted": 0,
+  "reason_code": "pre_arbitration",
+  "respond_by": 1590604200,
+  "status": "open",
+  "phase": "pre_arbitration",
+  "created_at": 1590059211,
+  "evidence": {
+    "amount": 10000,
+    "summary": "goods delivered",
+    "shipping_proof": null,
+    "billing_proof": null,
+    "cancellation_proof": null,
+    "customer_communication": null,
+    "proof_of_service": null,
+    "explanation_letter": null,
+    "refund_confirmation": null,
+    "access_activity_log": null,
+    "refund_cancellation_policy": null,
+    "term_and_conditions": null,
+    "others": null,
+    "submitted_at": null
+  }
+}
+```
+-------------------------------------------------------------------------------------------------------
+
+### Accept a Dispute
+
+```rb
+disputeId = "disp_0000000000000"
+
+Razorpay::Dispute.accept(disputeId)
+```
+
+**Parameters:**
+
+| Name        | Type   | Description                                      |
+|-------------|--------|--------------------------------------------------|
+| disputeId*  | string | The unique identifier of the dispute.            |
+
+**Response:**
+```json
+{
+  "id": "disp_AHfqOvkldwsbqt",
+  "entity": "dispute",
+  "payment_id": "pay_EsyWjHrfzb59eR",
+  "amount": 10000,
+  "currency": "INR",
+  "amount_deducted": 10000,
+  "reason_code": "pre_arbitration",
+  "respond_by": 1590604200,
+  "status": "lost",
+  "phase": "pre_arbitration",
+  "created_at": 1590059211,
+  "evidence": {
+    "amount": 10000,
+    "summary": null,
+    "shipping_proof": null,
+    "billing_proof": null,
+    "cancellation_proof": null,
+    "customer_communication": null,
+    "proof_of_service": null,
+    "explanation_letter": null,
+    "refund_confirmation": null,
+    "access_activity_log": null,
+    "refund_cancellation_policy": null,
+    "term_and_conditions": null,
+    "others": null,
+    "submitted_at": null
+  }
+}
+```
+-------------------------------------------------------------------------------------------------------
+### Contest a Dispute (Draft)
+
+```rb
+# Use this API sample code for draft
+
+disputeId = "disp_0000000000000"
+
+Razorpay::Dispute.contest(disputeId,{
+  "amount": 5000,
+  "summary": "goods delivered",
+  "shipping_proof": [
+    "doc_EFtmUsbwpXwBH9",
+    "doc_EFtmUsbwpXwBH8"
+  ],
+  "others": [
+    {
+      "type": "receipt_signed_by_customer",
+      "document_ids": [
+        "doc_EFtmUsbwpXwBH1",
+        "doc_EFtmUsbwpXwBH7"
+      ]
+    }
+  ],
+  "action": "draft"
+})
+```
+
+**Parameters:**
+
+| Name            | Type    | Description                                                                                                                                                                     |
+|-----------------|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| disputeId*      | string  | The unique identifier of the dispute.                                                                                                                                           |
+| amount          | integer | The amount being contested. If the contest amount is not mentioned, we will assume it to be a full dispute contest.                                                             |
+| summary         | string  | The explanation provided by you for contesting the dispute. It can have a maximum length of 1000 characters.                                                                    |
+| shipping_proof  | array   | List of document ids which serves as proof that the product was shipped to the customer at their provided address. It should show their complete shipping address, if possible. |
+| others          | array   | All keys listed [here](https://razorpay.com/docs/api/disputes/contest) are supported                                                                                            |
+| action          | string  | Possible value is `draft` or `submit`                                                                                                                                           |
+
+**Response:**
+```json
+{
+  "id": "disp_AHfqOvkldwsbqt",
+  "entity": "dispute",
+  "payment_id": "pay_EsyWjHrfzb59eR",
+  "amount": 10000,
+  "currency": "INR",
+  "amount_deducted": 0,
+  "reason_code": "chargeback",
+  "respond_by": 1590604200,
+  "status": "open",
+  "phase": "chargeback",
+  "created_at": 1590059211,
+  "evidence": {
+    "amount": 5000,
+    "summary": "goods delivered",
+    "shipping_proof": [
+      "doc_EFtmUsbwpXwBH9",
+      "doc_EFtmUsbwpXwBH8"
+    ],
+    "billing_proof": null,
+    "cancellation_proof": null,
+    "customer_communication": null,
+    "proof_of_service": null,
+    "explanation_letter": null,
+    "refund_confirmation": null,
+    "access_activity_log": null,
+    "refund_cancellation_policy": null,
+    "term_and_conditions": null,
+    "others": [
+      {
+        "type": "receipt_signed_by_customer",
+        "document_ids": [
+          "doc_EFtmUsbwpXwBH1",
+          "doc_EFtmUsbwpXwBH7"
+        ]
+      }
+    ],
+    "submitted_at": null
+  }
+}
+```
+
+-------------------------------------------------------------------------------------------------------
+### Contest a Dispute (Submit)
+
+```rb
+# Use this API sample code for submit
+
+disputeId = "disp_0000000000000"
+
+Razorpay::Dispute.contest(disputeId, {
+  "billing_proof": [
+    "doc_EFtmUsbwpXwBG9",
+    "doc_EFtmUsbwpXwBG8"
+  ],
+  "action": "submit"
+})
+```
+
+**Parameters:**
+
+| Name            | Type    | Description                                                                          |
+|-----------------|---------|--------------------------------------------------------------------------------------|
+| disputeId*      | string  | The unique identifier of the dispute.                                                |
+| billing_proof   | integer | List of document ids which serves as proof of order confirmation, such as a receipt. |
+| action          | string  | Possible value is `draft` or `submit`                                                |
+
+**Response:**
+```json 
+{
+  "id": "disp_AHfqOvkldwsbqt",
+  "entity": "dispute",
+  "payment_id": "pay_EsyWjHrfzb59eR",
+  "amount": 10000,
+  "currency": "INR",
+  "amount_deducted": 0,
+  "reason_code": "chargeback",
+  "respond_by": 1590604200,
+  "status": "under_review",
+  "phase": "chargeback",
+  "created_at": 1590059211,
+  "evidence": {
+    "amount": 5000,
+    "summary": "goods delivered",
+    "shipping_proof": [
+      "doc_EFtmUsbwpXwBH9",
+      "doc_EFtmUsbwpXwBH8"
+    ],
+    "billing_proof": [
+      "doc_EFtmUsbwpXwBG9",
+      "doc_EFtmUsbwpXwBG8"
+    ],
+    "cancellation_proof": null,
+    "customer_communication": null,
+    "proof_of_service": null,
+    "explanation_letter": null,
+    "refund_confirmation": null,
+    "access_activity_log": null,
+    "refund_cancellation_policy": null,
+    "term_and_conditions": null,
+    "others": [
+      {
+        "type": "receipt_signed_by_customer",
+        "document_ids": [
+          "doc_EFtmUsbwpXwBH1",
+          "doc_EFtmUsbwpXwBH7"
+        ]
+      }
+    ],
+    "submitted_at": 1590603200
+  }
+}
+```
+-------------------------------------------------------------------------------------------------------
+**PN: * indicates mandatory fields**
+<br>
+<br>
+**For reference click [here](https://razorpay.com/docs/api/documents)**

data/documents/documents.md

@@ -0,0 +1,65 @@
+## Document
+
+### Create a Document
+
+```rb
+Razorpay::Document.create({
+  "file": File.new("/Users/your_name/Downloads/sample_uploaded.jpeg"),
+  "purpose": "dispute_evidence"
+});
+```
+
+**Parameters:**
+
+| Name    | Type      | Description                                                     |
+|---------|-----------|-----------------------------------------------------------------|
+| file*   | string    | The URL generated once the business proof document is uploaded. |
+| purpose | string    | Possible value is `dispute_evidence`                            |
+
+**Response:**
+```json
+{
+  "id": "doc_EsyWjHrfzb59Re",
+  "entity": "document",
+  "purpose": "dispute_evidence",
+  "name": "doc_19_12_2020.jpg",
+  "mime_type": "image/png",
+  "size": 2863,
+  "created_at": 1590604200
+}
+```
+-------------------------------------------------------------------------------------------------------
+
+### Fetch Document Information
+
+```rb
+documentId = "doc_NiyXWXXXXXXXXX"
+
+Razorpay::Document.fetch(documentId)
+```
+
+**Parameters:**
+
+| Name        | Type      | Description                                      |
+|-------------|-----------|--------------------------------------------------|
+| documentId  | string    | The unique identifier of the document.           |
+
+**Response:**
+```json
+{
+  "entity": "document",
+  "id": "doc_00000000000000",
+  "purpose": "dispute_evidence",
+  "created_at": 1701701378,
+  "mime_type": "application/pdf",
+  "display_name": "ppm_00000000000000",
+  "size": 404678,
+  "url": ""
+}
+```
+-------------------------------------------------------------------------------------------------------
+
+**PN: * indicates mandatory fields**
+<br>
+<br>
+**For reference click [here](https://razorpay.com/docs/api/documents)**