Table of Contents |
---|
...
Version History:
Version | Description | Author | Date (dd/mm/yyyy) |
1.0.0 | DRAP Onboarding Service (without eKYC flow) Document | Ajai Antony | 07/06/2024 |
1.0.1 | Customer updation failure response | Ajai Antony | 14/06/2024 |
1.0.2 | AML Alert Closure CallBack API updates | Ajai Antony | 15/10/2024 |
CLASSIFICATION: PUBLIC
The partner will conduct e-KYC or KYC procedures autonomously and employ the listed APIs to enroll customers onto the Customer Data Platform (CDP). They will supply essential customer details obtained from a trusted data source (such as an e-KYC provider or government database), additional information based on country requirements, along with customer documents, including front and back images of the customer's ID, a facial image, and any e-KYC verification or confirmation reports if applicable using the customer onboard API.
...
API to be used to look up customer information by ID type and ID number.
...
Authorization
...
String
...
Status | ||||
---|---|---|---|---|
|
...
Authorization Token
Payload
Name
Data Type
Max Length
Mandatory
Description
idType
String
API | ||||||
Authorization | Bearer Token | |||||
Method | POST | |||||
Headers | Content-Type:application/json | |||||
Payload |
| |||||
Success Response HttpStatusCode : 200 |
| |||||
Customer Not Found HttpStatusCode : 200 |
| |||||
Subscription Pending Response HttpStatusCode : 200 |
| |||||
Bad Request HttpStatusCode : 200 |
| |||||
Internal Server Error HttpStatusCode : 200 |
| |||||
Authentication Validation Failure Response - Customer Under Compliance Investigation HttpStatusCode : 401200 |
|
Header
...
Name
...
Data Type
...
Max Length
...
Mandatory
...
Description
...
Content-Type
...
String
...
36
...
Status | ||||
---|---|---|---|---|
|
...
Content type
Validation Failure Response - Blocked Customer HttpStatusCode : 200 |
| |||||
Authentication Failure Response HttpStatusCode : 401 |
|
Header
Name | Data Type | Max Length | Mandatory | Description | |||||
---|---|---|---|---|---|---|---|---|---|
Content-Type | String | 36 |
|
Content type |
Authorization | String |
30
|
Customer id Number
...
Authorization Token |
Payload
Name | Data Type | Max Length | Mandatory | Description |
---|
idType | String |
3 |
|
|
|
|
-
| Customer id type code |
idNumber |
String |
-
30 |
| Customer id Number |
Response
Name | Data Type | Max Length | Description | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
status | String | 255 | status description | ||||||||||||||||||||||||||||||
statusCode | Integer | - | Status code | ||||||||||||||||||||||||||||||
errorCode | Integer | - | Error code if any error encountered. | ||||||||||||||||||||||||||||||
message | String | 255 | Message | ||||||||||||||||||||||||||||||
data | Object | - | Data object | ||||||||||||||||||||||||||||||
ecrn | String | 20 | Customer unique identification number | ||||||||||||||||||||||||||||||
first_name | String | 100 | Customer first name | ||||||||||||||||||||||||||||||
middle_name | String | 60 | Customer middle name | ||||||||||||||||||||||||||||||
last_name | String | 60 | Customer last name | ||||||||||||||||||||||||||||||
agent_location_id | String | 10 | Onboarded Agent | ||||||||||||||||||||||||||||||
primary_mobile_number | String | 20 | Customer mobile no | ||||||||||||||||||||||||||||||
email_id | String | 255 | Customer email | ||||||||||||||||||||||||||||||
customer_status | String | 20 | Customer Status
| ||||||||||||||||||||||||||||||
aml_scan_status | String | 20 | AML Scanned Status “Accepted” / “Rejected“ / “Under Investigation”/ “Failed” | ||||||||||||||||||||||||||||||
id_status | String | 20 | Possible values : "Active", "Expired",”Inactive” | ||||||||||||||||||||||||||||||
id_date_of_expiry | String | 50 | YYYY-MM-DD format |
...
API to be used to onboard a customer.
Name
Data Type
Max Length
Mandatory
Description
Content-Type
String
API | https://{{baseUrl}}/caas-lcm/api/v1/CAAS/onBoarding/customer | |||||||||||
Authorization | Bearer Token | |||||||||||
Method | POST | |||||||||||
Headers | Content-Type:application/json | |||||||||||
Payload |
| |||||||||||
Success Response HttpStatusCode : 200 |
| |||||||||||
Validation Failure Response - Customer Under Compliance Investigation HttpStatusCode : 406 |
| |||||||||||
Validation Failure Response - Blocked Customer HttpStatusCode : 406 |
| |||||||||||
Validation Failure Response - Invalid Master Data HttpStatusCode : 400 |
| |||||||||||
Validation Failure Response - Mandatory Field Missing HttpStatusCode : 400 |
| |||||||||||
Customer Updation Failure Responce |
| |||||||||||
Authentication Failure Response HttpStatusCode : 401 |
| |||||||||||
Bad Request Http Staus Code:400Internal Server Error HttpStatusCode : 502 |
Internal Server Error HttpStatusCode : 502 |
|
Header
Header
Name | Data Type | Max Length | Mandatory | Description | ||||||
---|---|---|---|---|---|---|---|---|---|---|
Content-Type | String |
|
| Content Type | ||||||
Authorization | String |
|
| Authorization Token |
...
API | ||||||
Authorization | Bearer Token | |||||
Method | GET | |||||
Headers | Content-Type: application/json | |||||
Payload |
| |||||
Success Response HttpStatusCode: 200 Code Block | | |||||
|
| |||||
Authentication Failure Response HttpStatusCode: 401 |
| |||||
Customer Not Subscribed Failure Response HttpStatusCode: 200 |
| |||||
Customer not found Failure Response HttpStatusCode: 200 |
|
...
Name | Data Type | Max Length | Description |
---|---|---|---|
agent_location_id | String | 30 | Agent Location Id |
channel | String | 30 | Channel |
salutation | String | 3 | Salutation(Mr, Ms) |
first_name | String | 100 | First Name |
middle_name | String | 60 | Middle Name |
last_name | String | 60 | Last Name |
preferred_name | String | 255 | Preferred Name |
nationality | String | 2 | Nationality |
second_nationality | String | 2 | Second Nationality of Customer |
native_region | Integer |
| Native Region |
date_of_birth | Date |
| Date of Birth |
country_of_birth | String | 2 | Country of Birth |
place_of_birth | String | 100 | Place of Birth |
resident_type_id | Long |
| Resident Type Id |
country_of_residence | String | 2 | Country of Residence |
gender | Male | 12 | Gender |
mothers_maiden_name | String | 30 | Mothers Name |
primary_mobile_number | String | 20 | Primary Mobile Number |
secondary_mobile_number | String | 20 | Secondary Mobile Number |
email_id | String | 30 | Email Id |
phone_number | String | 20 | Phone Number |
occupation_id | Long |
| Occupation Id |
political_exposed_person | Boolean |
| Political Exposed Person |
additional_docs | Object |
| Data Object |
idNameId | String |
| Id name id |
base64_data | String |
|
|
content_type | String |
| Content Type |
id_details | Object |
| Data Object |
id_type | Long |
| Id Type |
id_number | String | 30 | Id Number |
name_as_per_id | String | 30 | Name as per Id |
issued_country | String | 2 | Issued Country |
issued_by | String | 30 | Issued By |
issued_at | String | 30 | Issued At |
issued_on | Date |
| Issued On |
date_of_expiry | Date |
| Date of Expiry |
visa_number | String | 30 | Visa Number |
visa_expiry_date | Date |
| Visa Expiry Date |
default_status | String | 30 | Default Status |
active_status | String | 30 | Active Status |
id_front | Object |
| Data Object |
base64_data | String |
| Base 64 Data |
content_type | String |
| Content Type |
id_back | Object |
| Data Object |
base64_data | String |
| Base 64 Data |
content_type | String |
| Content Type |
addressList | Object |
| Data Object |
address_type_id | Long |
| Address Type Id |
building_name | String | 255 | Building Name |
street_name | String | 255 | Street Name |
landmark | String | 255 | Landmark |
country | String | 2 | Country |
state | String | 255 | State |
district | String | 255 | District |
city | String | 60 | City |
zip | Long |
| Zip |
mobile_number | String | 20 | Mobile Number |
status | String | 30 | Disable |
customer_classification | Object |
| Data Object |
customer_type_id | Long |
| Customer Type Id |
annual_income_range_id | Long |
| Annual Income Range |
annual_income_currency_code | String | 30 | Annual Income Currency Code |
social_security_number | String | 30 | Social Security Number |
tax_registration_number | Long |
| Tax Registration Number |
txn_issued_country | String | 2 | Tax Issued Country |
employer_name | String | 30 | Employer Name |
employer_address | String | 30 | Employer Address |
employer_phone | String | 20 | Employer Phone |
employer_ecrn | String | 16 | Employer ECRN |
employer_establishment_id | String | 30 | Employer Establishment ID |
risk_rating_id | Long |
| Risk Rating ID |
compliance_category_id | Long |
| Compliance Category ID |
last_review_date | Date |
| Last review Date |
next_review_date | Date |
| Next Review Date |
pep_category | Integer |
| Pep Category |
group_companies | Integer |
| Group Company |
group_employer_code | String | 30 | Group Employee Code |
personal_mohre_id | String | 30 | Personal Mohre Id |
customer_cards | String | 30 | Customer Cards |
card_number | String | 30 | Card Number |
income_type | String | 30 | Income Type |
profession_category | String | 30 | Profession Category |
reason_for_acc | String | 30 | Reason for ACC |
referred_by_type | Integer |
| Referred By Type |
referred_by | String | 30 | Reffered By |
txn_vol_month | String | 30 | Transaction Volume Month |
txn_count_month | String | 30 | Transaction Count Month |
show_remarks_on_txn | Boolean |
| show Remarks on transaction |
customer_remarks | String | 30 | Remarks on Transaction |
agent_ref_no | String | 30 | Agent reference number |
ekyc_provider | String | 30 | ekyc provider |
ekyc_ref_no | String | 30 | ekyc ref number |
social_links | Object |
| Data Object |
social_links_id | Long |
| Social Link Id |
text_field | String | 30 | Text Field |
subscriptions | Object |
| Data Object |
subsciption_type | String | 30 | Subscription Type |
subscription_id | String | 30 | Subscription Id |
status | String | 30 | Status |
first_language | String | 3 | Customer Preferred Language |
marital_status | Integer |
| Marital Status |
profile_category | Integer |
| Profile Category |
dnfbp | Boolean |
| Designated Non-Financial Business and Professions |
dpms | Boolean |
| Dealers in Precious Metals and Stones |
AML Alert Closure CallBack Api
We will be calling partner API to update the customer status and AML status.
Payload
...
language | json |
---|
...
ref number | |||
social_links | Object |
| Data Object |
social_links_id | Long |
| Social Link Id |
text_field | String | 30 | Text Field |
subscriptions | Object |
| Data Object |
subsciption_type | String | 30 | Subscription Type |
subscription_id | String | 30 | Subscription Id |
status | String | 30 | Status |
first_language | String | 3 | Customer Preferred Language |
marital_status | Integer |
| Marital Status |
profile_category | Integer |
| Profile Category |
dnfbp | Boolean |
| Designated Non-Financial Business and Professions |
dpms | Boolean |
| Dealers in Precious Metals and Stones |
AML Alert Closure CallBack Api
We will be calling partner API to update the customer status and AML status.
Payload
Code Block |
---|
{
"aml_scan_status": "Accepted",
"ecrn": "1058021235161541",
"customer_status": "ACTIVE"
} |
Name | Data Type | Max Length | Description | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ecrn | String | 20 | CDP Customer Unique Identification Number will be present if customer is onboarded to CDP | ||||||||||||||||||||||||||||||
aml_scan_status | String | 20 | AML Scanned Status will be p[resent if customer is onboarded to CDP “Accepted” / “Rejected“ / “Under Investigation”/ “Failed” / “N/A” (not available when screening not done) | ||||||||||||||||||||||||||||||
customer_status | String | 20 | Customer Status will be present if customer is onboarded to CDP
|
Master Data
View file | ||
---|---|---|
|
...