This document needs to be completed by BSG & IT/Vendor for each Application /API. Introduction Project – RBL API Banking List of API Sr. No Name Description 1 Lien API This API is used for Adding/Modifying/Inquiry Lien on RBL account API Name Lien API Description This API is used for Adding Lien on RBL account also used for Modifying Lien and to do Inquiry of Lien. Transport protocol (SOAP / REST) REST API Request URLs https://apideveloper.rblbank.com/test/sb/v1/rbl/api/lien-api/marklien Access Requirement NA Request Parameters for Adding Lien Business Parameter Name Description Parameter Name Tags Mandatory Parameter Type Parameter Constraints Comments TranID Transaction Id TranID Y String Alphanumeric MaxLength=16 Transaction ID generated by consumer which is unique Corp_ID Corporate Id Corp_ID Y String Alphanumeric & MaxLength=16 Unique ID assigned to each enrolled Corporate Maker_ID Maker Id Maker_ID Y String Alphanumeric & MaxLength=20 Unique ID for request creator Checker_ID Checker Id Checker_ID Y String Alphanumeric & MaxLength=20 Unique ID for request checker Approver_ID Approver Id Approver_ID Y String Alphanumeric & MaxLength=20 Unique ID for request approver LienMode Lien Mode LienMode Y Char Alphanumeric & MaxLength=1 Unique Lien Mode As ‘A’ for Addition
Lien Modify LienId Lien Id LienId Y String Alphanumeric Lien Id for Modifying Lien Startdate Start Date Startdate Y Date Numeric Start Date For Lien Modify EndDate End Date EndDate Y Date Numeric End date For Lien Modify ReasonCode Reason Code ReasonCode Y String Alphanumeric & MaxLength=5 Reason Code for Lien Modify Request Sample for Modifying Lien { "LienRequest": { "Header": { "TranID": "1478506493428", "Corp_ID": "MC003", "Maker_ID": "M001", "Checker_ID": "C001", "Approver_ID": "A001" }, "Body": { "LienMode": "M", "AccountNo": "401234512345", "LienAmount": "1", "LienId": [ "RB121482373" ], "Startdate": "2016-11-29", "EndDate": "2017-11-04", "ReasonCode": "9" } } } Response Parameters for Modifying lien Business Parameter Name Description Parameter Name Parameter Type Parameter Constraints Comments TranID Transaction Id TranID String Alphanumeric MaxLength=16 Transaction ID generated by consumer which is unique Corp_ID Corporate Id Corp_ID String Alphanumeric & MaxLength=16 Unique ID assigned to each enrolled Corporate Maker_ID Maker Id Maker_ID String Alphanumeric & MaxLength=20 Unique ID for request creator Checker_ID Checker Id Checker_ID String Alphanumeric & MaxLength=20 Unique ID for request checker Approver_ID Approver Id Approver_ID String Alphanumeric & MaxLength=20 Unique ID for request approver Status Status Status String NA SUCCESS/FAILURE AccountNo Account Numbre AccountNo Numeric Numeric & MaxLength=16 Customer Account Number
LienAmount Lien Amount LienAmount Float Numeric Lien Amount LienID Lien Id LienID String Alphanumeric Modified Lien ID Message Message Message String NA Message for SUCCESS response Response Sample for Modifying Lien { "LienResponse": { "Header": { "TranID": "1478506493428", "Corp_ID": "MC003", "Maker_ID": "M001", "Checker_ID": "C001", "Approver_ID": "A001" }, "Body": { "Status": "SUCCESS", "AccountNo": "401234512345", "LienAmount": "1", "LienID": "RB121482373", "Message": "Lien Successfully Modified" } } } Request Parameters for Inquiry Lien Business Parameter Name Description Parameter Name Tags Mandatory Parameter Type Parameter Constraints Comments TranID Transaction Id TranID Y String Alphanumeric MaxLength=16 Transaction ID generated by consumer which is unique Corp_ID Corporate Id Corp_ID Y String Alphanumeric & MaxLength=16 Unique ID assigned to each enrolled Corporate Maker_ID Maker Id Maker_ID Y String Alphanumeric & MaxLength=20 Unique ID for request creator Checker_ID Checker Id Checker_ID Y String Alphanumeric & MaxLength=20 Unique ID for request checker Approver_ID Approver Id Approver_ID Y String Alphanumeric & MaxLength=20 Unique ID for request approver LienMode Lien Mode LienMode Y Char Alphanumeric & MaxLength=1 Unique Lien Mode As ‘I’ for Addition AccountNo Account Number AccountNo Y Numeric Numeric & MaxLength=16 Customer Account Number LienId Lien Id LienId Y String Alphanumeric Lien Id for Inquiry Lien
Request Sample for Inquiry Lien { "LienRequest": { "Header": { "TranID": "", "Corp_ID": "MC005", "Maker_ID": "M001", "Checker_ID": "C001", "Approver_ID": "A001" }, "Body": { "LienMode": "I", "AccountNo": "401234512345", "LienId": ["RB121482373"] } } } Response Parameters for Inquiry Lien Business Parameter Name Description Parameter Name Parameter Type Parameter Constraints Comments TranID Transaction Id TranID String Alphanumeric MaxLength=16 Transaction ID generated by consumer which is unique Corp_ID Corporate Id Corp_ID String Alphanumeric & MaxLength=16 Unique ID assigned to each enrolled Corporate Maker_ID Maker Id Maker_ID String Alphanumeric & MaxLength=20 Unique ID for request creator Checker_ID Checker Id Checker_ID String Alphanumeric & MaxLength=20 Unique ID for request checker Approver_ID Approver Id Approver_ID String Alphanumeric & MaxLength=20 Unique ID for request approver Status Status Status String NA SUCCESS/FAILURE AccountNo Account Numbre AccountNo Numeric Numeric & MaxLength=16 Customer Account Number LienAmount Lien Amount LienAmount Float Numeric Lien Amount LienID Lien Id LienID String Alphanumeric Lien ID Startdate Start Date Startdate Date Numeric Start Date Of Lien EndDate End Date EndDate Date Numeric End date of lien ReasonCode Reason Code ReasonCode String Alphanumeric & MaxLength=5 Reason Code Of Lien Response Sample for Inquiry Lien {