Transaction Service

post-request

NOTE -
  • External reference number must be unique in every request body.
  • Maximum Amount of 5000 is allowed for a single request.

Headers

Content-Type: application/JSON
client_id: To be shared during integration
client_secret: To be shared during integration

Request Body Parameters

Field Description Sample with validation Data type Mandatory/ Not Mandatory
externalRefNumber External Reference
Number		 externalRefNumber should have a
min length of 16 and max length of
18. E.g. -2345671870801723		 String Mandatory
requestedAmount Transaction amount Requested txn amount E.g.-120 String Mandatory
accountNumber Bene Account Number Beneficiary account number. E.g.-72348568326432 String Mandatory
beneBankName Bene bank name Beneficiary bank name E.g.-state bank of India String Mandatory
beneMobile Number Bene mobile number Beneficiary mobile number E.g.-9090172546 String Mandatory
beneName Beneficiary name Beneficiary name E.g.-Jane String Mandatory
bankCode Beneficiary bank Code Beneficiary bankCode E.g.-SBIN String Mandatory
beneIfscCode Beneficiary ifsc Code Beneficiary ifsc Code E.g.-SBIN0225500 String Mandatory
transactionMode Transaction mode Transaction mode E.g.-IMPS/NEFT String Mandatory
customerName Customer name Customer name E.g.- Jane String Mandatory
Customer MobileNumber Customer mobile number Customer mobile number E.g.- 8658733463 String Mandatory
Pincode Customer address pincode Customer address pincode.
Should be exactly of 6 digits. E.g.
-752031		 String Mandatory
Address Customer address Customer address String Mandatory
isHoldTransaction Hold txn details E.g.-false Boolean Mandatory
username Retailer User ID E.g.- AG98947 String Mandatory
customerIP Customer IP 19.38.394.33 String Mandatory
latLong Latitude and Longitude 30.34N,25.73E String Mandatory

 

Request Body

OR

Sample Response Body

OR

Failed Request and Response
External Reference Number Must Not be EMPTY OR Invalid pattern
Request Body

{
"externalRefNumber": "",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username":"upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

OR

{
"externalRefNumber": "391469530448441@",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "8127683292",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "751024",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username":"AG98947,"
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 -- External Reference Number Must Not be EMPTY Or Only Number Allowed With 16 Digit"
}

 

Duplicate Client Reference ID

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "10",
"statusDesc": "DMTCFT004 ---- Duplicate External Reference ID found For Id: XLBRS000110700005"
}

 

Amount Must Not be EMPTY

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --Requested Amount Must Not be EMPTY Or Only Number Allowed"
}

 

Amount Must Not Be Greater Than 5000

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "5001",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret"
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "1",
"statusDesc": "DMTFTM001 ---- Requested Amount Limit Exceeded ..,Maximum 5000 Allowed."
}

 

Beneficiary Account Number Must Not be EMPTY OR Invalid Pattern

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

OR

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609#",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --Beneficiary Account Number Must Not be EMPTY Or Only Number Allowed"
}

 

BankName must not be EMPTY

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --BankName must not be EMPTY."
}

 

Beneficiary MobileNumber must not be EMPTY OR Invalid Pattern

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "",
"beneBankName": "Bank Of India",
"beneMobileNumber": "",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

OR

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609#",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172542@",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --Beneficiary MobileNumber must not be EMPTY,Should be 10 digits"
}

 

Beneficiary Name must not be EMPTY

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "",
"beneMobileNumber": "9090172546",
"beneName": "Bank Of India",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --Beneficiary Name must not be EMPTY, Only Character Allowed."
}

 

BankCode must not be EMPTY

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --BankCode must not be EMPTY,should be 4 Digits."
}

IFSC Code must not be EMPTY

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --Beneficiary ifscCode must not be EMPTY Or Invalid Pattern Found."
}

 

TransactionMode must Not be EMPTY OR Invalid Pattern

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

OR

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "@IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --Transaction Mode Must Not Be EMPTY Or Only IMPS Transaction Mode Allowed."
}

 

Customer Name must not be EMPTY

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --Customer Name must not be EMPTY, Only Character Allowed."
}

 

CustomerMobileNumber must not be EMPTY OR Invalid pattern

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

OR

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "1213456782@",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --CustomerMobileNumber must not be EMPTY,should be 10 Digits."
}

 

Pincode Must Not Be Empty

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --Pincode Must Not Be Empty."
}

Address Must Not be Empty

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --Address Must Not be Empty."
}

 

User name must not be Empty

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --User Name Or Retailer Must Not Be Empty."
}

 

Wrong username

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret@",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT017 --Retailer is Onboarded at ISU, Please Contact Your Support Team.isutestapi@."
}

 

Is Hold Transaction Must Not be Empty

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "DMTCFT001 --Is Hold Transaction Must Not be Empty,Pass false."
}

 

Inprogress Request and Response

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "INPROGRESS",
"gatewayTxnStatusList":
[{
"gateWayTxnId": "4336051236290561",
"status": " INPROGRESS ",
"txnStausCode": "20",
"txnStatusDesc": "Transaction Inprogress",
"amount": 102.0,
"rrn": "",
"charges": "10.0",
"createdDate": "Fri Nov 11 15:14:11 IST 2022"
}
],
"statusCode": "3",
"parentTxnId": "433605123629056",
"ClientreferenceId": "3914695304584414"
}

 

Success Request and Response

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "SUCCESS",
"gatewayTxnStatusList": [
{
"gateWayTxnId": "5336051236290561",
"status": "SUCCESS",
"txnStausCode": "20",
"txnStatusDesc": "Transaction Success",
"amount": 102.0,
"rrn": "231515957517",
"charges": "10.0",
"createdDate": "Fri Nov 11 15:14:11 IST 2022"
}
],
"statusCode": "0",
"parentTxnId": "533605123629056"
"externalRefNumber": "39146953044844144"
}

 

Failed Request and Response

Request Body

{
"externalRefNumber": "3941150430148446",
"requestedAmount": "102",
"accountNumber": "513910110000609",
"beneBankName": "Bank Of India",
"beneMobileNumber": "9090172546",
"beneName": "Mark Doe",
"bankCode": "SBOS",
"beneIfscCode": "SBOS0000200",
"transactionMode": "IMPS",
"customerName": "Jane",
"customerMobileNumber": "8658733463",
"pincode": "752031",
"address": "Bhubaneswar",
"isHoldTransaction": false,
"username": "upitestret",
"customerIP":"19.38.394.33",
"latLong":"30.34N,25.73E" }

Response Body

{
"status": "Failed",
"gatewayTxnStatusList": [
{
"gateWayTxnId": "4336051236290561",
"status": " Failed ",
"txnStausCode": "20",
"txnStatusDesc": "Transaction failed",
"amount": 102.0,
"rrn": "",
"charges": "10.0",
"createdDate": "Fri Nov 11 15:14:11 IST 2022"
}
],
"statusCode": "1",
"parentTxnId": "433605123629056"
"ClientreferenceId": "39146953045844142"
}

Success Status, Status Code and Status Description

Sl No Status Status Code Description Http Status Code
01 SUCCESS 4 IMPS SUCCESS 200
02 SUCCESS 5 IMPS IN PROGRESS TO SUCCESS 200
03 FAILED 3,12,8 IMPS & NEFT FAILED 200
04 INPROGRESS 20,0,1,2,3,4,6,9 IMPS & NEFT INPROGRESS 200
05 SUCCESS 20 IMPS INPROGRESS TO SUCCESS 200
06 FAILED 0 IMPS & NEFT IN PROGRESS TO FAILED 200
07 SUCESS 22 IMPS SUCCESS TRANSACTION 200
08 REFUNDED 0,3 IMPS FAILED TRANSACTION 200
09 SUCCESS 6 NEFT INPROGRESS TO SUCCESS 200
10 FAILED 1 INTERNAL SERVER ERROR 200
11 FAILED -1 VALIDATION FAILED 200