Customer API | API Developer Portal

Get Customer

Description: This API allows to retrieve detailed information about a customer.

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

Endpoint: /common/dmt-lite/unified/customer/get-customer

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
mobileNumber	Mobile Number	String	10 digit mobile number E.g.8765432345	Mandatory
username	User name	String	isutestapi1	Mandatory
latlong	Latitude Longitude	String	123,234	Mandatory
publicIP	Public IP	String	123.123.123.133	Mandatory

Sample Request Body

{ "mobileNumber":"8765432345", "username":"isutestapi1", "latlong":"123,234", "publicIP":"123.123.123.133" }

Sample Request Body(Encrypted)

{ "RequestData": "QRw4nlzy1nDD8N5Wcb4CAY4Zyfa /aHxpLwY6KtdS1dYyNau3aEz1f0BpRdaVfjelrJwO696ywz683kzmySqeBsmfnFlL+9pydUpDHUvi0ePJvJSbvH3BCUjbJEJ+Km51XxxAqQTtW1zN+RwO+H BrhQu3FLCQX97XPgOKWtIRhO4=" }

Response Body Parameters

Parameters	Description	Data Type
status	Status of transaction	String
statusDesc	Status Description	String
statusCode	Code of the transaction status	String
name	Name of Customer	String
mobileNumber	Customer Mobile Number	String
KYCTypeFlag	KYC Type Flag	Boolean

Sample Response Body

Success:

{
"name": "Chandan Pradhan",
"mobileNumber": "8144094480",
"statusCode": "0", //customer Not Exits,kindly onboard
"statusDesc": "customer Not Exits,kindly onboard",
"KYCTypeFlag": false,
"status":"SUCCESS"
}
………………
{
"name": "Chandan Pradhan",
"mobileNumber": "8144094480",
"statusCode": "1", //customer created but not verified
"statusDesc": "Customer created but not verified",
"KYCTypeFlag": false,
"status":"SUCCESS"
}
………………
{
"name": "Chandan Pradhan",
"mobileNumber": "8144094480",
"statusCode": "2", ////customer is created and verified, OVD is also verified. (This is for new Customer)
"statusDesc": "Customer verified successfully",
"KYCTypeFlag": true,
"status":"SUCCESS"
}
……………….
{
"name": "Chandan Pradhan",
"mobileNumber": "8144094480",
"statusCode": "3", ////customer created and verified but OVD not verified.
"statusDesc": "Customer verified successfully",
"KYCTypeFlag": false,
"status":"SUCCESS"
}

Notes -

KYCTypeFlag: true, means OVD is present.
KYCTypeFlag: false, means OVD data is not present.

Failed:

{
"mobileNumber": "8144094480",
"statusCode": "-1",
"statusDesc": "Invalid mobile number",
"KYCTypeFlag": false,
"status":"FAILED"
}
………………
{
"mobileNumber": "8144094480",
"statusCode": "-1",
"statusDesc": "Username Must not be Empty",
"KYCTypeFlag": false,
"status":"FAILED"
}
………………..
{
"mobileNumber": "8144094480",
"statusCode": "-1",
"statusDesc": "User not onboarded",
"KYCTypeFlag": false,
"status":"FAILED"
}
…………………
{
"mobileNumber": "8144094480",
"statusCode": "4",
"statusDesc": "Internal Server Issue",
"KYCTypeFlag": false,
"status":"FAILED"
}

Sample Response Body(Encrypted)

{ "ResponseData": "eHPLXnzD6LsKsw66V5WtdAWDB7gj1dhegyayzrAaPP1BENgVD2HS /Vbz81INfYYktscJOM0jfIMZtXriz0w6u0OZpOoTeesWe6NGqk7z0uLCZG32lVzO+QYUc8Dn7bkPFOWR23ngYuFBLhzByEUau23wcaQL4eCBOvEUWyrjs3 uB69eGxzv4A7JWLeZgide3YBj/4+2HJVJn4oLtcyvqTA==" }

Response Codes

Status Code	Response Type	Description	HTTP Status Code
0	SUCCESS	customer Not Exits,kindly onboard	200
1	SUCCESS	Customer created but not verified	200
2	SUCCESS	Customer verified successfully	200
3	SUCCESS	Customer verified successfully	200
-1	FAILED	Username Must not be Empty	200
4	FAILED	Internal Server Issue	200

Process Customer

Description: This API enables businesses to create new customer profiles by collecting essential information.

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

Endpoint: /common/dmt-lite/unified/customer/process-customer-registration

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
mobileNumber	Mobile Number	String	10 digit mobile number E.g.8618743463	Mandatory
name	Customer name	String	Sangram Keshari pradhan	Mandatory
address	Address	String	Bhubaneswar	Optional
pincode	Pin Code	String	6 digit pin code E.g-751002	Optional
ovdType	OVD Type	String	Aadhaar Card	Optional
ovdData	OVD Data	String	12 digit Aadhaar number E.g-765386439745	Optional
otp	OTP (One Time Password)	String	898943	Mandatory
username	User name	String	isutestapi1	Mandatory
latlong	Latitude Longitude	String	123,234	Mandatory
publicIP	Public IP	String	123.123.123.133	Mandatory
paramA	To be used as per client requirement	String	to be used as per descretion	Optional
paramB	To be used as per client requirement	String	to be used as per descretion	Optional
paramC	To be used as per client requirement	String	to be used as per descretion	Optional

Sample Request Body

{ "mobileNumber": "8618743463", "name": "Sangram Keshari pradhan", "address":"Bhubaneswar", "pincode":"751002", "ovdType":"Aadhaar Card", "ovdData":"765386439745 ", "otp":"898943", "username":"isutestapi1", "latlong":"123.23,21.345", "publicIP":"192.168.1.1", "paramA": "", "paramB": "", "paramC": "" }

Sample Request Body(Encrypted)

{ "RequestData": "TS69VcUKX5qOfzX1Ua9JY890HIhcGLqcOWlJSk7q5P7DV1qZ9SuOWDVukKlHZLuoPUFg2H5rj4cUwvOVXbZ3mBsl9EhwhPSSAWwR4XmqihyAU4kM2 H/WwDAnFTCf5tzPdOGdKBSILZ8KsaUNWqO3RQbl2DqfQYrQrfhfXIYv /wxMzgEn2m7rCKmyq+PvEHJCRCTuz1T1YUdgSe+X5zCHCyXyI0Arn9WodW15bdl7+EkCoHCmgIbaypIdhrOp86DCCnQpOWWqlSLMREpq7Rz9C3zh5 hvhHxyfN9nYk5hueJZVPEpAcWnlCPgd3zB8k2nB3P8Zd4uOq6WvHGbsbYMn2gI+BVQxhHdj6MRK6uCrGu5K28XONs3wWADgZXLbAiV+UmVVtFYLOzr muhhRMWT9/Q==" }

Response Body Parameters

Parameters	Description	Data Type
status	Status of transaction	String
statusDesc	Status Description	String
statusCode	Status Code	String
name	Customer Name	String
mobileNumber	Customer Mobile Number	String
KYCTypeFlag	KYC Type Flag	Boolean
paramA	To be used as per the client requirement	String
paramB	To be used as per the client requirement	String
paramC	To be used as per the client requirement	String

Sample Response Body

Success:

{
"name": "Sangram Keshari pradhan",
"mobileNumber": "8658733463",
"statusCode": "2",
"statusDesc": "Customer verified successfully and Ovd Data Updated",
"KYCTypeFlag": true,
"status":"SUCCESS"
"paramA": "",
"paramB": "",
"paramC": ""
}

Failed:

{
"name": "Sangram Keshari pradhan",
"mobileNumber": "8658733463",
"statusCode": "-1",
"statusDesc": "Name Must Not Be Empty or Null",
"status":"FAILED"
"paramA": "",
"paramB": "",
"paramC": ""
}
……..
{
"name": "Sangram Keshari pradhan",
"mobileNumber": "8658733463",
"statusCode": "-1",
"statusDesc": "Mobile number must Not Be Empty or Null",
"KYCTypeFlag": false,
"status":"FAILED"
"paramA": "",
"paramB": "",
"paramC": ""
}
………
{
"name": "Sangram Keshari pradhan",
"mobileNumber": "8658733463",
"statusCode": "4",
"statusDesc": "Internal Server Issue, Kindly Try After Sometime",
"KYCTypeFlag": false,
"status":"FAILED"
"paramA": "",
"paramB": "",
"paramC": ""
}
………
{
"name": "Sangram Keshari pradhan",
"mobileNumber": "8658733463",
"statusCode": " 4",
"statusDesc": "Internal Server Issue, Kindly Try After Sometime",
"KYCTypeFlag": false,
"status":"FAILED"
"paramA": "",
"paramB": "",
"paramC": ""
}
……….
{
"mobileNumber": "8144094480",
"statusCode": "-1",
"statusDesc": "User not onboarded",
"KYCTypeFlag": false,
"status":"FAILED"
"paramA": "",
"paramB": "",
"paramC": ""
}

Sample Response Body(Encrypted)

{ "ResponseData": "QP /rmWaYXiPnQD1Bozgfmh7RP5jeVGhs8t6h9KjJLJTblAHLwJeLZ9ldgTsyqpkE3vEtsRcyztsG7bLpxItjj2rncVi2hxDDFsz59Hb9pAdn2mMZLKe32w1bj3N9Lr G7jhpBZzHhKcWAbAq/cr25RrxFIRyyJCUAIYxUQT1FqFVr5M335laaXdKFjDw+Pi/BohDtleUOnz+pOknwEThe4usu021J/vFuLpp1wxviifE=" }

Response Codes

Status Code	Response Type	Description	HTTP Status Code
2	SUCCESS	Customer verified successfully and Ovd Data Updated	200
-1	FAILED	Mobile number Must not Be Empty or Null	200
4	FAILED	Internal Server Issue, Kindly Try After Sometime	200
-1	FAILED	User not onboarded	200