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

header_secrets: To be shared during integration

pass_key: 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.23.24_123.43.5	Mandatory
publicIP	Public IP	String	123.123.123.133	Mandatory

Sample Request Body

{ "mobileNumber":"8765432345", "username":"isutestapi1", "latlong":"123.23.24_123.43.5", "publicIP":"123.123.123.133" }

Sample Request Body(Encrypted)

{ "RequestData": "Oiw1XnTIn1NSxUaFqh/MgxHKPYyszh6JBZPy0rtmbfoyq8dUriGXJJgL+nJ7YMYPYEzoHekm0Do8Dd85C/u7KRAUSUTQcHUPTTUcN9Mur/ucxDnunxbZWu9QbMNXkWrn0z9g3ysLbUOt6bWnujm9tIKFlbYLjIoWhnprsoweBf4=" }

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:

{
"KYCTypeFlag": false,
"mobileNumber": "7682961956",
"status": "SUCCESS",
"statusCode": "0",
"statusDesc": "Customer not onboarded"
}

................

{
"name": "Chandan Pradhan",
"mobileNumber": "8144094480",
"statusCode": "1",
"statusDesc": "Customer created but not verified",
"KYCTypeFlag": false,
"status":"SUCCESS"
}

......................

{
"KYCTypeFlag": true,
"mobileNumber": "8249638187",
"status": "SUCCESS",
"statusCode": "2",
"statusDesc": "customer validated succesfully"
}

Notes -

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

Failed:

{
"KYCTypeFlag": false,
"mobileNumber": "",
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "Invalid mobile number"
}

{
"KYCTypeFlag": false,
"mobileNumber": "8249638187",
"status": "FAILED",
"statusCode": "-1",
"statusDesc": "User Name Must not be Empty"
}

Sample Response Body(Encrypted)

{ "ResponseData": "r2pAHAyDYKWnKwWnBB7LmVAlA9TCoHkIVgPkjxYvrCoLt5DzmEt7H1KbsqhNs0ZeeRgteB4cFPUGkkOp1SvHvWTnwU9wFvhYW9nA/VVShtR/MRmRdFcaGQDW0LGIlU/6/jycE4WkX+TC54i1MIAaRnOe23BhJ1xF2TVK3s70lmADFEUci99KQgWZcD9SJb3/xSkhFiMjWyVe1gOXcNkrbg==" }

Response Codes

Status Code	Response Type	Description	HTTP Status Code
0	SUCCESS	Customer Not onboarded	200
1	SUCCESS	Customer created but not verified	200
2	SUCCESS	Customer verified successfully	200
-1	FAILED	Username Must not be Empty	200
-1	FAILED	Invalid Mobile Number	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

header_secrets: To be shared during integration

pass_key: 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.8249638187	Mandatory
name	Customer name	String	Swagatika	Mandatory
address	Address	String	Bhubaneswar	Optional
pincode	Pin Code	String	6 digit pin code E.g-751002	Optional
ovdType	OVD Type	String	BioAuth	Optional
ovdData	OVD Data	String	12 digit Aadhaar number E.g-671211352822	Optional
otp	OTP (One Time Password)	String	123456	Mandatory
username	User name	String	isutestapi1	Mandatory
latlong	Latitude Longitude	String	123.23.24_123.43.5	Mandatory
publicIP	Public IP	String	192.168.1.1	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": "8249638187", "name": "Swagatika", "address": "", "pincode": "", "ovdType": "BioAuth", "ovdData": "", "otp": "123456", "username": "isutestapi1", "latlong": "123.23.24_123.43.5", "publicIP": "192.168.1.1", "paramA": "", "paramB": "", "paramC": "" }

Sample Request Body(Encrypted)

{ "RequestData": "H2RFoNdveCgunkhn9pL98JGCHOcWT0uUpg3fvSnH7DiK/S+UfmT0VD+OalkI+ZtMEPN/LcVOvC7X+O5BHQQIJ+ASbXy0uIHQYdmsfyG5OSr639jirBE/ngSAl55RYhM6iZUGoSGHkQS30hWWkcC+w9pcnM0L6PDQYSRdE64Hz46Qqmrt5oTQ9FaVwI5XXEOj9AsH3Delq1FGHMKafQWieM0u8wXkSixAxrmXSUZ4n5ajLeH7FO1xoMzzrnwJZOHmP6mekI0KEil2CPfk+4q7nMt31+dTGDlwEjTcD9ZdhIoM1K+Dzl/wRtBQ0a50P4fXWsy64AL7GRa6Z1Pw0/m4rA==" }

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:

{
"kyctypeFlag": true,
"mobileNumber": "8249638187",
"name": "Swagatika",
"status": "SUCCESS",
"statusCode": "0",
"statusDesc": "Customer verified successfully and Data Updated."
}

Failed:

Response-1:

{
"name": "Sonali Nayak",
"mobileNumber": "",
"statusCode": "-1",
"statusDesc": "Customer Mobile Number Must Not Be EMPTY Or Should be 10 Digits Start between 6 to 9",
"status": "FAILED",
"KYCTypeFlag": false
}

Response-2:

{
"name": "Sonali Nayak",
"mobileNumber": "8658480625",
"statusCode": "4",
"statusDesc": "Internal Server Issue",
"status": "FAILED",
"kyctypeFlag": **false**
}

Sample Response Body(Encrypted)

{ "ResponseData": "l/PC3ZwpFUK0XrJ15WWpUiq2PvSz3g20SsmEeE8WJaDLfqXB/BTtnD2tfC1XgFGzyxaL95uS/bQzslA4uNNAUBDdApheiua6CtW0ypSCSiFqIfetqdFfMw5A6Y1MtrkyTkOqcou91hJyc63e2qP2akUXYL1Pl5VqC19PU/klANo92vDWcLB1tgk/NwEIFSvKudRYpEWLiufM4xdcvvRzroPaIRJAPUiiIfH0ae2tam1ikNT9DyUYwf4IqJcdVKb9" }

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