Beneficiary Verification API

post-request

Description: This API enables the verification of the details of a particular Beneficiary.
Base URL: https://apidev-sdk.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

OR

Sample Request Body(Encrypted)

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"
        }
    ]
}

Sample Response Body(Encrypted)

 

Money Transfer API

post-request

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-sdk.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

Sample Request Body(Encrypted)

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"
}

Sample Response Body(Encrypted)

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
Notes-

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.