EDIS (Approval) Page Redirect – NSDL
This API facilitates the creation of a browser pop-up URL to request EDIS approval for securities delivery via NSDL. Upon user approval in the pop-up, the response is sent back to the parent application window for further processing.
📝Request Body Schema
| Field | Type | Description | Example |
|---|---|---|---|
| depository | string | Target Depository | "NSDL" |
| usercode | string | User code obtained from login response | "AABB12" |
userId | string | Unique Client Code (UCC) | "UCC12345" |
| groupId | string | Group Identifier | "HO" |
| managerIP | string | Manager system IP address | 10.0.01.15 |
| sessionID | string | Unique session Identifier | 0x0987YU7658990 |
| channel | string | Requested channel | MOB ,WEB |
| isin | string | ISIN of the main security | INE78765800 |
| isinName | string | Name of the main security | BHARAT ELECTRONICS LTD |
| exchangeCD | string | Exchange Code | NSE,BSE |
| product | integer | Product code (Cash segment = 1) | 1 |
| instrument | string | Type of Instrument | Equity |
| Quantity | integer | Quantity of the main security | 2 |
| dpID | string | Depository Participant ID | 1209020 |
| clientID | integer | ClientID | 120589663000 |
| productcode | string | Product Source/Application | ODINAERO , WAVE |
| ScripDetails | string | JSON string containing security details | {"ISIN":"INE263A01024","Quantity":2,"ISINName":"BHARAT ELECTRONICS LTD"} |
| ProductType | string | Product Type | D (Delivery), MF (MTF) |
| ReqId | string | Unique Request Identifier | GER123 |
| amo | string | After Market order flag | Y,N |
| SettlmtCycle | string | Settlement Cycle | T1,T2 |
Note: The entire parameter string should be Base64 encoded and sent via the enct query parameter.
🔄User Flow Summary
- Prepare all required parameters as per the schema above.
- Build a query string combining these parameters.
- Base64 encode the query string.
- Open a browser pop-up with the URL including the encoded string.
- User approves or rejects the EDIS delivery request on the NSDL page.
- The browser sends the response back to the parent window.
- The final response is then posted to your webhook URL for further processing.
🟢Success Response - 200 Ok
| Field | Type | Description | Example/ENUM |
|---|---|---|---|
| Despository | string | Name of depository | CDSL |
| dpId | string | Depository Participant ID | "092200" |
| clientID | string | Client ID | "52886666000" |
| isin | string | ISIN of the main security | "IEN87976500" |
| OriginalQty | string | Quantity requested | 10 |
| BlkQty | string | Quantity blocked | 10 |
| Channel | string | Channel used | MOB |
| Status | string | Approval status | "success" |
| Remark | string | Any additional message or reason | "Approved" |
RefNum | string | Reference number from depository | 0 |
| TransRefNum | string | Transaction reference number | 131025258077 |
| StatusCode | string | Status code for error handling | ERR035, "" |
| ScripDetails | string | JSON list of status for each ISIN | "[{\"ISIN\":\"INE263A01024\",\"Qty\":2,\"Status\":\"Success\",\"StatusCode\":\"\",\"RefNo\":\"NS301604L66\",\"ISINName\":\"BHARAT+ELECTRONICS+LTD\",\"ErrorDesc\":null}]", |
| BrokerOrdrNo | string | Internal broker order number | "AABBVVN123545OP" |
| ReqID | string | Request ID | GER123 |
| UserId | string | Unique Client code (UCC) | "UCC12345" |
| GroupId | string | Group ID | HO |
The final JSON response is posted to your webhook URL, which should be configured in web.config