Beneficiary Verification API

post-request

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 Example Mandatory/ Optional
externalRefNumber External Reference Number String DLC00000000032 Mandatory
accountNumber Bene Account Number String 11100000000001 Mandatory
beneBankName Bene Bank Name String STATE BANK OF INDIA Mandatory
beneMobileNumber Bene Mobile Number String 8637277058 Mandatory
beneName Beneficiary Name String rajkumar Mandatory
bankCode Beneficiary Bank Code String SBIN Mandatory
beneIfscCode Beneficiary IFSC Code String SBIN0225500 Mandatory
transactionMode Transaction Mode String IMPS Mandatory
customerName Customer Name String Naresh Mandatory
customerMobileNumber Customer Mobile Number String 8337946326 Mandatory
pincode Pincode String 751080 Mandatory
address Customer Address String Bhubaneswar Mandatory
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 same externalRefNumber will be used for Beneficiary Verification, Money Transfer, and in Send OTP APIs.

Sample Request Body

OR

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

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

ss

Request Body Parameters

Parameters Description Data Type Example Mandatory/ Optional
externalRefNumber External Reference Number String DLC00000000035 Mandatory
requestedAmount Requested Amount String 101 Mandatory
accountNumber Bene Account Number String 11100000000001 Mandatory
beneBankName Bene Bank Name String STATE BANK OF INDIA Mandatory
beneMobileNumber Bene Mobile Number String 8637277058 Mandatory
beneName Beneficiary Name String rajkumar Mandatory
bankCode Beneficiary Bank Code String SBIN Mandatory
beneIfscCode Beneficiary IFSC Code String SBIN0225500 Mandatory
transactionMode Transaction Mode String IMPS Mandatory
customerName Customer Name String Naresh Mandatory
customerMobileNumber Customer Mobile Number String 8337946326 Mandatory
pincode Pincode String 751080 Mandatory
address Customer Address String Bhubaneswar Mandatory
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

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.