Bank API Documentation - os-salahuddin/php8-cluster GitHub Wiki

Official Docs

Pdf Link

https://drive.google.com/drive/folders/1RF6QQhmV3IKU14vG2brTw5aK2Q-z8kbj

MTB

Add money initiate request [Link Account Request]

URL

[POST] http://127.0.0.1:8001/api/v1/mtb/lb-execute/LinkAccountBankURL

Request Headers

The following headers must be included in the request for authentication:

Header	Type	Description	Required
`Content-Type`	String	`application/json`	Yes
`userName`	String	The API username	Yes
`password`	String	The API password	Yes
`ChannelId`	String	A unique identifier for the requesting channel	Yes

Sample request

{
  "version": null,
  "timestamp": "20250311120353",
  "redirectURL": null,
  "originatorConversationId": "100xxxxxxxxxxxxxx023c1",
  "linkSessionId": "LSTP1xxxxxxxxxxxxxcfd6bd023c1",
  "kycInfo": {
    "dob": "23/10/1990",
    "nid": "19xxxxxxxxxx0",
    "nid2": "9xxxxxxxx2"
  },
  "userMSISDN": "01xxxxxxxx2",
  "accountNumber": "13xxxxxxxx3",
  "signature": "96700f67xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxfaba6"
}

Sample Request Format

Parameter	Type	Description	Always Present
`version`	String	API version	No
`timestamp`	String	Request timestamp (YYYYMMDDHHMMSS)	Yes
`redirectURL`	String	Redirect URL	No
`originatorConversationId`	String	Alphanumeric unique identifier	Yes
`linkSessionId`	String	L+3 character for wallet identifier+ YYYYMMDD HHMMSSMsMsMsRRR RR	Yes
`kycInfo.dob`	String	Date of birth (DD/MM/YYYY)	Yes
`kycInfo.nid`	String	National ID number	Yes
`kycInfo.nid2`	String	Additional NID	No
`userMSISDN`	String	User's mobile number	Yes
`accountNumber`	String	accountNumber+userMSISDN	Yes
`signature`	String	Security signature	Yes

Sample Response

{
  "version": "V1.0",
  "timestamp": "20220310153032",
  "errorCode": "0000",
  "errorDesc": "Link Account Bank Request Successful",
  "authURL": "",
  "originatorConversationId": "",
  "linkSessionId": "",
  "linkToken": "",
  "userMSISDN": "",
  "accountNumber": ""
}

{
  "code": 422,
  "messages": [
    "Sorry! Could not initiate transaction : "
  ],
  "data": []
}

Sample Response Format

Parameter	Type	Description	Always Present
`version`	String	API version	Yes
`timestamp`	String	Timestamp of the response in `yyyyMMddHHmmss` format	Yes
`errorCode`	String	Error code of the response	Yes
`errorDesc`	String	Description of the error or success message	Yes
`authURL`	String	Authentication URL (if applicable)	No
`originatorConversationId`	String	Unique identifier for the transaction originator	No
`linkSessionId`	String	Session ID for linked account request	No
`linkToken`	String	Token for linking the account	No
`userMSISDN`	String	User's mobile number	No
`accountNumber`	String	Linked account number	No

Add money initiate request [If Already Linked Account]

URL

[POST] http://127.0.0.1:8001/api/v1/mtb/lb-execute/AddMoney

Sample request

{
  "version": null,
  "timestamp": "20250311120353",
  "redirectURL": null,
  "originatorConversationId": "100xxxxxxxxxxxxxx023c1",
  "addMoneySessionId": "LWAL20220310153032Rtgs3",
  "linkToken": "abc123xyz",
  "transactionAmount": "1000",
  "signature": "96700f67xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxfaba6"
}

Sample Request Format

Parameter	Type	Description	Always Present
`version`	String	API version	No
`timestamp`	String	Request timestamp (YYYYMMDDHHMMSS)	Yes
`redirectURL`	String	Redirect URL	No
`originatorConversationId`	String	Alphanumeric unique identifier	Yes
`addMoneySessionId`	String	Unique session ID for the transaction	Yes
`linkToken`	String	Represents account link information	Yes
`transactionAmount`	String	User transaction amount	Yes
`signature`	String	Security signature for verification	Yes

Sample Response

{
  "version": "V1.0",
  "timestamp": "20220310153032",
  "errorCode": "0000",
  "errorDesc": "Add Money Bank Request Successful",
  "authURL": "",
  "originatorConversationId": "",
  "addMoneySessionId": "",
  "linkToken": "",
  "accountNumber": "",
  "Params": ""
}

{
  "code": 422,
  "messages": [
    "Sorry! Could not initiate transaction : "
  ],
  "data": []
}

Sample Response Format

Parameter	Type	Description	Always Present
`version`	String	API version	Yes
`timestamp`	String	Timestamp of the response in `yyyyMMddHHmmss` format	Yes
`errorCode`	String	Error code of the response	Yes
`errorDesc`	String	Description of the error or success message	Yes
`authURL`	String	Authentication URL (if applicable)	No
`originatorConversationId`	String	Unique identifier for the transaction originator	No
`addMoneySessionId`	String	Session ID for the transaction request	No
`linkToken`	String	Token for linking the account	No
`accountNumber`	String	Linked account number	No
`Params`	String	Dynamic parameters as defined by the bank (if any)	No