handle v1 and v2 api version

documents/card.md

@@ -602,6 +602,51 @@ Razorpay::Card.fetch(cardId)
     "token_iin": null
 }
 ```
+-------------------------------------------------------------------------------------------------------
+## Using Card Number/ Tokenised Card Number
+
+```rb
+Razorpay::Card.request_card_reference({"number":"4111111111111111"});
+```
+**Parameters:**
+
+| Name        | Type    | Description                                                                  |
+|-------------|---------|------------------------------------------------------------------------------|
+| number* | string | The card number whose PAR or network reference id should be retrieved. |
+| tokenised  | string | Determines if the card is saved as a token. Possible value is `true` or `false` |
+
+**Response:**
+```json
+{
+  "network": "Visa",
+  "payment_account_reference": "V0010013819231376539033235990",
+  "network_reference_id": null
+}
+```
+-------------------------------------------------------------------------------------------------------
+
+## Using Razporpay token
+
+```rb
+Razorpay::Card.requestCardReference({"token":"token_4lsdksD31GaZ09"});
+```
+**Parameters:**
+
+| Name        | Type    | Description                                                                  |
+|-------------|---------|------------------------------------------------------------------------------|
+| token* | string | The token whose PAR or network reference id should be retrieved.|
+
+
+
+**Response:**
+```json
+{
+  "network": "Visa",
+  "payment_account_reference": "V0010013819231376539033235990",
+  "network_reference_id": null
+}
+```
+
 -------------------------------------------------------------------------------------------------------
 
 **PN: * indicates mandatory fields**

documents/payment.md

@@ -816,10 +816,53 @@ Razorpay::PaymentMethods.all()
 **Response:** <br>
  please refer this [doc](https://razorpay.com/docs/payments/third-party-validation/s2s-integration/methods-api/#fetch-payment-methods) for response
 
-```
+
 -------------------------------------------------------------------------------------------------------
 
+### Token IIN API
+
+```rb
+tokenIin = "412345";
+
+Razorpay::Iin.fetch(tokenIin);
+```
+
+**Parameters:**
+
+| Name       | Type   | Description                       |
+|------------|--------|-----------------------------------|
+| tokenIin* | string | The token IIN. |
 
+**Response:**
+```json
+{
+  "iin": "412345",
+  "entity": "iin",
+  "network": "Visa",
+  "type": "credit",
+  "sub_type": "business",
+  "issuer_code": "HDFC",
+  "issuer_name": "HDFC Bank Ltd",
+  "international": false,
+  "is_tokenized": true,
+  "card_iin": "411111",
+  "emi":{
+     "available": true
+     },
+  "recurring": {
+     "available": true
+     },
+  "authentication_types": [
+   {
+       "type":"3ds"
+   },
+   {
+       "type":"otp"
+   }
+  ]
+}
+```
+-------------------------------------------------------------------------------------------------------
 **PN: * indicates mandatory fields**
 <br>
 <br>