Transaction API | API Developer Portal

Beneficiary Verification API

Description: This API enables the verification of the details of a particular Beneficiary.

Base URL: https://apidev.iserveu.online/{EndPoint}

Endpoint: /common/dmt-lite/unified/transaction/verify-bene

Headers

Content-Type: application/JSON

client_id: To be shared during integration

client_secret: To be shared during integration

Request Body Parameters

Parameters	Description	Data Type	Validation with Sample	Mandatory/ Optional
externalRefNumber	External Reference Number	String	min-6 & max-22 char/digit E.g-DLC00000000032	Mandatory
accountNumber	Bene Account Number	String	min-8 & max-20 digit E.g-11100000000001	Mandatory
beneBankName	Bene Bank Name	String	STATE BANK OF INDIA	Mandatory
beneMobileNumber	Bene Mobile Number	String	10 digit mobile number E.g-8637277058	Mandatory
beneName	Beneficiary Name	String	rajkumar	Mandatory
bankCode	Beneficiary Bank Code	String	min-4 & max-4 char E.g-SBIN	Mandatory
beneIfscCode	Beneficiary IFSC Code	String	Exactly 11 Alphanumeric (the first four representing the bank code, the fifth is always 0, and the last six represent the branch code) E.g-SBIN0225500	Mandatory
transactionMode	Transaction Mode	String	IMPS	Mandatory
customerName	Customer Name	String	max-30 char E.g-Naresh	Mandatory
customerMobileNumber	Customer Mobile Number	String	10 digit mobile number E.g-8337946326	Mandatory
pincode	Pincode	String	6 digit pin code E.g-751080	Optional
address	Customer Address	String	Bhubaneswar	Optional
isHoldTransaction	Hold Transaction Details	Boolean	false	Mandatory
username	Username	String	isutestapi1	Mandatory
latLong	Latitude Longitude	String	123.23,21.345	Mandatory
customerIP	Customer IP	String	12.32.78.90	Mandatory
otp	OTP (One Time Password)	String	E.g. - 873877	Mandatory

NOTE -

The external reference ID, mobile number, and user name should remain the same for Beneficiary Verification, Money Transfer, and in Send OTP APIs.

Sample Request Body

{ "externalRefNumber":"DLC00000000032", "accountNumber":"11100000000001", "beneBankName":"STATE BANK OF INDIA", "beneMobileNumber":"8637277058", "beneName":"rajkumar", "bankCode":"SBIN", "beneIfscCode":"SBIN0225500", "transactionMode":"IMPS", "customerName":"Naresh", "customerMobileNumber":"8337946326", "pincode":"751080", "address":"Bhubaneswar", "isHoldTransaction":false, "username":"isutestapi1", "latLong”:”123.23,21.345", "customerIP”:”12.32.78.90", "otp":"873877" }

{ "externalRefNumber": “DLC00000000022”, "accountNumber": "142956275110", "beneBankName": "State Bank Of India", "beneMobileNumber": "8658733463", "beneName": "Dr. Sangram", "bankCode": "SBIN", "beneIfscCode": "SBIN0000234", "customerName": "iserveu", "customerMobileNumber": "8658733489", "pincode": "759125", "address": "BBSR", "username": "isutestapi1", "latLong":"5125", "customerIP":"626,37", "otp":"873877" }

Response Body Parameters

Parameters	Description	Data Type
status	Status of transaction	String
statusCode	Code of the transaction status	String
externalRefNumber	External Reference Number	String
parentTxnId	Parent Transaction ID	String
status-desc	Status Description	String
gateway-transaction-details	Gateway Transaction Details gateWayTxnId- Gateway Transaction ID status- Transaction Status txnStatusCode- Transaction Status Code amount- Amount rrn- RRN beneName- Beneficiary Name charges- Charges createdDate- Created Date	String

Sample Response Body

Success:

{
"status": "SUCCESS",
"statusCode": "0",
"externalRefNumber": "DLC00000000032",
"parentTxnId": "4563379176284160",
"status-desc": "Transaction Successful",
"gateway-transaction-details": [
{
"gateWayTxnId": "45633791762841601",
"status": "SUCCESS",
"txnStausCode": "4",
"txnStatusDesc":
"Transaction Success",
"amount": 1.0,
"rrn": "310116908254",
"beneName": "rajkumar",
"charges": "0.0",
"createdDate": "Wed Mar 06 06:22:31 UTC 2024"
}
]
}

In Internal Bene Verification:

Success:

{
"status": "SUCCESS",
"statusCode": "0",
"externalRefNumber": "1000000000000095",
"parentTxnId": "1492211992633344",
"status-desc": "Transaction Successful",
"gateway-transaction-details": [
{
"gateWayTxnId": "14922119926333441",
"status": "SUCCESS",
"txnStausCode": "4",
"txnStatusDesc": "Bene verification successfully completed(I).",
"amount": 1.0,
"rrn": "NA",
"beneName": "Sangram Keshari Pradhan",
"charges": "0.0",
"createdDate": "Fri Sep 06 05:57:31 UTC 2024"
}
]
}

In Progress:

{
"status": "INPROGRESS",
"statusCode": "3",
"externalRefNumber": "DLC00000000033",
"parentTxnId": "4563379176284260",
"status-desc": "Transaction is Pending,We are Processing your Transaction",
"gateway-transaction-details": [
{
"gateWayTxnId": "45633791762842601",
"status": "INPROGRESS",
"txnStausCode": "20",
"txnStatusDesc": "Transaction Is In progress",
"amount": 1.0,
"rrn": "NA",
"beneName": "rajkumar",
"charges": "0.0",
"createdDate": "Wed Mar 06 06:22:31 UTC 2024"
}
]
}

Failed:

{
"status": "FAILED",
"statusCode": "1",
"externalRefNumber": "DLC00000000034",
"parentTxnId": "4563379176284360",
"status-desc": "Transaction Failed",
"gateway-transaction-details": [
{
"gateWayTxnId": "45633791762843601",
"status": "FAILED",
"txnStausCode": "3",
"txnStatusDesc": "Transaction Failed ",
"amount": 1.0,
"rrn": "310116908354",
"beneName": "rajkumar",
"charges": "0.0",
"createdDate": "Wed Mar 06 06:22:31 UTC 2024"
}
]
}

Money Transfer API

Description: This API enables the user to perform DMT transaction seamlessly. A successful transaction here means that the amount has been transferred successfully.

Base URL: https://apidev.iserveu.online/{EndPoint}

Endpoint: /common/dmt-lite/unified/transaction/moneytransfer-wb

Headers

Content-Type: application/JSON

client_id: To be shared during integration

client_secret: To be shared during integration

Request Body Parameters

Parameters	Description	Data Type	Validation with Sample	Mandatory/ Optional
externalRefNumber	External Reference Number	String	min-6 & max-22 char/digit E.g-DLC00000000035	Mandatory
requestedAmount	Requested Amount	String	101	Mandatory
accountNumber	Bene Account Number	String	min-8 & max-20 char/digit E.g-11100000000001	Mandatory
beneBankName	Bene Bank Name	String	STATE BANK OF INDIA	Mandatory
beneMobileNumber	Bene Mobile Number	String	!0 digit mobile number E.g-8637277058	Mandatory
beneName	Beneficiary Name	String	rajkumar	Mandatory
bankCode	Beneficiary Bank Code	String	min-4 & max-4 E.g-SBIN	Mandatory
beneIfscCode	Beneficiary IFSC Code	String	Exactly 11 Alphanumeric (the first four representing the bank code, the fifth is always 0, and the last six represent the branch code) E.g-SBIN0225500	Mandatory
transactionMode	Transaction Mode	String	IMPS	Mandatory
customerName	Customer Name	String	max-30 char E.g-Naresh	Mandatory
customerMobileNumber	Customer Mobile Number	String	10 digit mobile number E.g-8337946326	Mandatory
pincode	Pincode	String	6 digit pincode E.g-751080	Optional
address	Customer Address	String	Bhubaneswar	Optional
isHoldTransaction	Hold Transaction Details	Boolean	false	Mandatory
username	Username	String	isutestapi1	Mandatory
latLong	Latitude Longitude	String	123.23,21.345	Mandatory
customerIP	Customer IP	String	12.32.78.90	Mandatory
otp	OTP (One Time Password)	String	E.g. - 873877	Mandatory

Sample Request Body

{ "externalRefNumber":"DLC00000000035", "requestedAmount":"101", "accountNumber":"11100000000001", "beneBankName":"STATE BANK OF INDIA", "beneMobileNumber":"8637277058", "beneName":"rajkumar", "bankCode":"SBIN", "beneIfscCode":"SBIN0225500", "transactionMode":"IMPS", "customerName":"Naresh", "customerMobileNumber":"8337946006", "pincode":"751080", "address":"Bhubaneswar", "isHoldTransaction":false, "username":"isutestapi1", "latLong":"5125", "customerIP":"626,37", "otp":"873877" }

Response Body Parameters

Parameters	Description	Data Type
status	Status of transaction	String
statusDesc	Status Description	String
gatewayTxnStatusList	Gateway Transaction Status List gateWayTxnId- Gateway Transaction ID status- Transaction Status txnStausCode- Transaction Status Code txnStatusDesc- Transaction Status Description amount- Amount rrn- RRN beneName- Beneficiary Name charges- Charges createdDate- Created Date	String
statusCode	Status Code	String
externalRefNumber	External Reference Number	String
parentTxnId	Parent Transaction ID	String

Sample Response Body

Success:

{
"status": "SUCCESS",
"statusDesc": "Transaction Successful",
"gatewayTxnStatusList": [
{
"gateWayTxnId": "45633791930613761",
"status": "SUCCESS",
"txnStausCode": "4",
"txnStatusDesc": "Transaction Success",
"amount": 101.0,
"rrn": "879478367868",
"beneName": "Dr. rajkumar",
"charges": "12.0",
"createdDate": "Wed Mar 06 06:52:49 UTC 2024"
}
],
"statusCode": "0",
"externalRefNumber": "DLC00000000035",
"parentTxnId": "4563379193061376"
}

In Progress:

{
"status": "INPROGRESS",
"statusDesc": "Transaction is Pending,We are Processing your Transaction",
"gatewayTxnStatusList": [
{
"gateWayTxnId": "45633791930614761",
"status": "INPROGRESS",
"txnStausCode": "20",
"txnStatusDesc": "Transaction Is In progress",
"amount": 101.0,
"rrn": "NA",
"beneName": "Dr. rajkumar",
"charges": "12.0",
"createdDate": "Wed Mar 06 06:52:49 UTC 2024"
}
],
"statusCode": "3",
"externalRefNumber": "DLC00000000036",
"parentTxnId": "4563379193061476"
}

Failed:

{
"status": "FAILED",
"statusDesc": "Transaction Failed",
"gatewayTxnStatusList": [
{
"gateWayTxnId": "45633791930615761",
"status": "FAILED",
"txnStausCode": "3",
"txnStatusDesc": "Transaction Failed",
"amount": 101.0,
"rrn": "872637468798",
"beneName": "Dr. rajkumar",
"charges": "12.0",
"createdDate": "Wed Mar 06 06:52:49 UTC 2024"
}
],
"statusCode": "1",
"externalRefNumber": "DLC00000000037",
"parentTxnId": "4563379193061576"
}

{
"status":"FAILED",
"statusCode": -1,
"statusDesc": "DMTOTPFT-01-Invalid OTP Found During FUND TRANSFER Kindly provide valid OTP"
}

Response Codes

Sl No	Status	Status Code	Description	HTTP Status Code
1	SUCCESS	4	IMPS SUCCESS	200
2	SUCCESS	5	IMPS INPROGRESS TO SUCCESS	200
3	FAILED	3,12,8	IMPS and NEFT FAILED	200
4	INPROGRESS	20, 0, 1, 2,3,4,6,9	IMPS & NEFT INPROGRESS	200
5	SUCCESS	20	IMPS INPROGRESS TO SUCCESS	200
6	FAILED	0	IMPS & NEFT INPROGRESS TO FAILED	200
7	SUCCESS	22	IMPS SUCCESS TRANSACTION	200
8	REFUNDED	0,3	IMPS FAILED TRANSACTION	200
9	SUCCESS	6	NEFT INPROGRESS TO SUCCESS	200
10	FAILED	1	INTERNAL SERVER ERROR	200
11	FAILED	-1	VALIDATION FAILED	200

NOTE -

How do you maintain status code:

Here you have to always refer both "txnStausCode" & "status", for fate of transactions.
If you receive "txnStausCode" & "status" different from above mentioned table, treat this as an IMPS INPROGRESS.
Please utilize the transaction status check API if you receive the initial transaction status code of 10.
If customer KYC/OVD data is rejected, status code will be "-1" that corresponds to validation failed.