Skip to main content

EDIS (Approval) Page Redirect

This API is used to redirect users to the EDIS approval page where they authorize transactions with their Depository (CDSL or NSDL). After approval, the Depository redirects back to your application and sends a response for further processing.

🌐 Request URL Format

https://demo.synapsewave.com/edis/newnetnet/EDISGatewayRequest.aspx?enct=<Base64_Encoded_Request>

📜Step-by-Step Process

  1. Prepare all EDIS parameters (user details, scrips, etc.)
  2. Combine them into a single URL query string.
  3. Base64-encode the full query string.
  4. Pass the encoded string as the enct parameter.
  5. Open the URL in a browser pop-up for user approval.
  6. After approval, Depository redirects via POST to your webhook.

Example URL (CDSL)

https://demo.synapsewave.com/edis/newnetnet/EDISGatewayRequest.aspx?userCode=AAABV &managerIP=10.0.0.15 &sessionID=0x0134AECDAD9C67DACF053D396440F7 &channel=MOB &isin=INE205A01025 &isinName=VEDANTA LIMITED &exchangeCd=NSE &product=1 &instrument=Equity &quantity=8970 &dpId=092200 &clientId=1209220000000217 &depository=CDSL &productcode=WAVE &MarketSegId=1 &ScripDetails=[{ISIN:'INE205A01025',Quantity:8,ISINName:'VEDANTA LIMITED',SettlmtCycle:'T1'}, {ISIN:'INE467B01029',Quantity:5,ISINName:'TATA CONSULTANCY SERV LT',SettlmtCycle:'T1'}, {ISIN:'INE118H01025',Quantity:7,ISINName:'BSE LIMITED',SettlmtCycle:'T1'}, {ISIN:'INE012A01025',Quantity:5,ISINName:'ACC LIMITED',SettlmtCycle:'T1'}] &ReqId=GER123 &userId=AD001 &groupId=HO &ProductType=D &AMO=N &SettlmtCycle=T2

🛣️Parameters Description

ParameterTypeExampleDescription
userCodestringAAABVUnique user code assigned by broker
managerIPstring10.0.0.15IP address of the request origin
sessionIDstring0x0134AECDAD9...Unique session identifier
channelstringMOB / WEBRequest channel
isinstringINE205A01025Primary ISIN for approval
isinNamestringVEDANTA LIMITEDName of the scrip
exchangeCdstringNSE / BSEExchange Code
productnumber1Product type (1 = Cash)
instrumentstringEquityInstrument name
quantitynumber8970Quantity of shares
dpIdstring092200Depository Participant ID
clientIdstring1209220000000217Client ID
depositorystringCDSL / NSDLDepository name
productcodestringWAVEProduct code (MOBILEAPI / WEBAPI / WAVE)
MarketSegIdnumber1Market Segment ID
ScripDetailsarrayJSON ArrayList of ISINs, quantities, settlement cycle
ReqIdstringGER123Unique Request ID
userIdstringAD001User identifier
groupIdstringHOGroup identifier
ProductTypestringD / MFD = Delivery, MF = MTF
AMOstringNAfter Market Order flag
SettlmtCyclestringT1 / T2Settlement cycle

🔒 Encoding

All parameters must be Base64 encoded and passed as:

Example: https://demo.synapsewave.com/edis/newnetnet/EDISGatewayRequest.aspx?enct=<Base64_Encoded_String>

Response From Depository

Depository sends a POST request to your configured webhook URL.

Response Format

POST → http://DOMAIN_NAME/PAGE_URL

Example JSON Body

{
"Depository": "CDSL",
"dpId": "092200",
"clientId": "1209220000000217",
"isin": "INE205A01025",
"OriginalQty": "8970",
"BlkQty": "25",
"Channel": "MOB",
"Status": "Success",
"Remark": "",
"RefNum": "0",
"TransRefNum": "1310202062531710",
"StatusCode": "",
"ScripDetails": "[{\"ISIN\":\"INE898S01029\",\"Qty\":8,\"Status\":\"Failure\",\"StatusCode\":\"ERR035\",\"RefNo\":\"00092200DA236\",\"ISINName\":\"MAJESCO LIMITED\",\"ErrorDesc\":\"Invalid ISIN\"},{\"ISIN\":\"INE325A01013\",\"Qty\":8,\"Status\":\"Success\",\"StatusCode\":\"\",\"RefNo\":\"00092200DA246\",\"ISINName\":\"TIMKEN INDIA LTD.\",\"ErrorDesc\":null}]",
"BrokerOrdrNo": "AAABV1602622349",
"ReqId": "GER123",
"UserId": "AD001",
"GroupId": "HO"
}

🔗Webhook Configuration

You must configure the webhook URL in your application’s web.config file under key:

EDIS_POST_RESPONSE_URL

This is where the Depository will post the approval response.

💡 Notes

  • Always Base64 encode the full query before sending.
  • Use a browser pop-up to open the approval link.
  • After user approval, the Depository will auto-redirect with the response.
  • ScripDetails must be a valid JSON array of ISINs.
get/EDISGatewayRequest.aspx