Get Authorization API

This API is used to generate an authorization token and redirect URL to initiate the NSDL PAN eKYC flow. Upon successful authorization, the user must be redirected to the provided URL to complete the PAN application process.

X-Checksum (Mandatory):

Partners must generate the X-Checksum header using AES-CBC-256 encryption.

Algorithm: AES-CBC-256

Implementation Reference:
https://github.com/mervick/aes-bridge

Requests without a valid X-Checksum will be rejected.

Aadhaar Consent:
“I have no objection in authenticating myself and fully understand that information provided by me shall be used for authenticating my identity through Aadhaar Authentication System for the purpose stated above and no other purpose.”

curl --location 'https://api.formaxpay.com/api/nsdl/get_authorization' \ --header 'Authorization: Basic UVRNRlRKckJjRWt5RnBETGtCSGpkV0dMYnFBclFwbkE6Rm9ybWF4QDEyMw==' \ --header 'X-Checksum: U2FsdGVkX1+uAS4hA93U/mwqjAqW2cV6eLEFF/2F3JtTy4b7jdnAF8RUafwa3LJPijQSLq/10Iqp+dZ213wxKbrgEm6Agau4J6iVfnyCfTkwfzraC7Seqdec0j0bWjwYieX8h/sjHrZYp/mV+BTCmxhwDfUKDFykonj4zDMChaifLEHzsR+l93YIVsqH1NTrYhGCQu7fEsxJtDSX5lfG91xlGmGas+Kl3Tdco2zuBeR/T1a8CvmooBWMryMcpbHwgJxnbPg+aLAUIT6HRRQEo7EfdEYA2LPMLP/LNCCQbGR5pZ5P9L3CeMNsLdfkACOTQ1f+6ug+URvyMF+oteuS6bPGV7CKZZjJyl+4cKj/tomt+AgVNdRajZWTuotnnSaF757EfQaSHm5OEY8OSUjStAy6Ij6d3MhGqNzSfiZFB5uiWAyqBkPS1/CHOsEXgbQvKO2fHCXcZNW8P+mIOL0BOA==' \ --header 'Content-Type: application/json' \ --data-raw '{ "branch_code": "FPAY01", "application_mode": "EKYC", "application_type": "49A", "category": "P", "name": "EZAZUL HAQUE", "gender": "M", "mobile": "9836993732", "email": "ezazul.haque@formaxit.com", "is_physical_pan_required": "Y", "consent": "Y", "redirect_url": "https://www.yourdomain.com/response", "p_order_id": "FJ92187500000000RFKB7" }'

{ "status": "SUCCESS", "message": "Transaction Successful", "data": { "order_id": "NSDL14379882812500EFNFG", "p_order_id": "FJ92187500000000RFKB7", "target_url": "https://protean-redirect.ssoaccess.in/sso_nsdl_ekyc_redirect?type=NEW&authorization=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiMyIsImFwcGxpY2F0aW9uX3R5cGUiOiI0OUEiLCJjYXRlZ29yeSI6IlAiLCJuYW1lIjoiRVpBWlVMIEhBUVVFIiwiZG9iIjoiMDEvMDEvMTk3NSIsImdlbmRlciI6Ik0iLCJtb2JpbGUiOiI5ODM2OTkzNzMyIiwiZW1haWwiOiJlemF6dWwuaGFxdWVAZm9ybWF4aXQuY29tIiwiaXNfcGh5c2ljYWxfcGFuX3JlcXVpcmVkIjoiWSIsInJlZGlyZWN0X3VybCI6Imh0dHBzOi8vd3d3LnlvdXJkb21haW4uY29tL3Jlc3BvbnNlIiwib3JkZXJfaWQiOiJOU0RMMTQzNzk4ODI4MTI1MDBFRk5GRyIsInBfb3JkZXJfaWQiOiJGSjkyMTg3NTAwMDAwMDAwUkZLQjciLCJpYXQiOjE2NDgxMjM3NzksImV4cCI6MTY0ODIxMDE3OX0.RyyroAkvLgbH2BihB6B9mZ6YCHj-EJcuQorxGIK-970", "incomplete_url": "https://protean-redirect.ssoaccess.in/sso_nsdl_ekyc_redirect?is_incomplete=true&authorization=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiMyIsImFwcGxpY2F0aW9uX3R5cGUiOiI0OUEiLCJjYXRlZ29yeSI6IlAiLCJuYW1lIjoiRVpBWlVMIEhBUVVFIiwiZG9iIjoiMDEvMDEvMTk3NSIsImdlbmRlciI6Ik0iLCJtb2JpbGUiOiI5ODM2OTkzNzMyIiwiZW1haWwiOiJlemF6dWwuaGFxdWVAZm9ybWF4aXQuY29tIiwiaXNfcGh5c2ljYWxfcGFuX3JlcXVpcmVkIjoiWSIsInJlZGlyZWN0X3VybCI6Imh0dHBzOi8vd3d3LnlvdXJkb21haW4uY29tL3Jlc3BvbnNlIiwib3JkZXJfaWQiOiJOU0RMMTQzNzk4ODI4MTI1MDBFRk5GRyIsInBfb3JkZXJfaWQiOiJGSjkyMTg3NTAwMDAwMDAwUkZLQjciLCJpYXQiOjE2NDgxMjM3NzksImV4cCI6MTY0ODIxMDE3OX0.RyyroAkvLgbH2BihB6B9mZ6YCHj-EJcuQorxGIK-970", "authorization": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiMyIsImFwcGxpY2F0aW9uX3R5cGUiOiI0OUEiLCJjYXRlZ29yeSI6IlAiLCJuYW1lIjoiRVpBWlVMIEhBUVVFIiwiZG9iIjoiMDEvMDEvMTk3NSIsImdlbmRlciI6Ik0iLCJtb2JpbGUiOiI5ODM2OTkzNzMyIiwiZW1haWwiOiJlemF6dWwuaGFxdWVAZm9ybWF4aXQuY29tIiwiaXNfcGh5c2ljYWxfcGFuX3JlcXVpcmVkIjoiWSIsInJlZGlyZWN0X3VybCI6Imh0dHBzOi8vd3d3LnlvdXJkb21haW4uY29tL3Jlc3BvbnNlIiwib3JkZXJfaWQiOiJOU0RMMTQzNzk4ODI4MTI1MDBFRk5GRyIsInBfb3JkZXJfaWQiOiJGSjkyMTg3NTAwMDAwMDAwUkZLQjciLCJpYXQiOjE2NDgxMjM3NzksImV4cCI6MTY0ODIxMDE3OX0.RyyroAkvLgbH2BihB6B9mZ6YCHj-EJcuQorxGIK-970" } }

Request

Responses