<aside> 💡 useB.eKYC API Guide https://kyc-api-swagger.useb.co.kr/
해당 링크를 통해서 eKYC에서 사용되는 API의 테스트가 가능합니다.
</aside>
<aside> 💡 Server API를 사용하고 싶은 고객사는 reviewer account가 별도로 있어야 합니다. reviewer account의 정보를 활용하여 Access Token 발급이 가능합니다.
</aside>
유스비 담당자로부터 review account의 customer_id, username and password 를 확인합니다.
swagger 에서 하기 API를 활용하여 Access Token을 취득합니다.
post https://kyc-api-swagger.useb.co.kr/
{
"customer_id": 1,
"username": "samsungAdmin",
"password": "password123!"
}
{
"company": {
"name": "samsung",
"industry": 1,
"phone_number": "1500-0000"
},
"role": 1,
"name": "samsung_reviewer",
"username": "Reviewer0001",
"is_temp_password": true,
"token": "<token>",
"expire": "2022-01-06T11:41:42+09:00",
"api_response": {
"result_code": "N100",
"result_message": "OK."
}
}
<aside> 💡 고객사는 유스비로 API 호출을 하기 위해서, “id” 와 “result_type” 이 필요합니다.
</aside>
{
"review_result": {
/* reivew id */
"id" : 357
/* Request time */
"request_time": "2021-12-25T03:55:31.918Z",
/* User Information */
"name": "Gildong Hong",
"phone_number": "01012345678",
"birthday": "2000-01-01",
/* Result Type */
"result_type": 1,
/**
* result_type
* - 1: Automatic approval (auto_approve), automatic approval according to the OCR recognition result.
* - 2: Automatic rejection (auto_reject), automatic rejection due to failure of authenticity verification, such as 3 incorrect inputs of identity information / 3 failures of 1 won account verification.
* - 5: Need for examination (wait_review), if the user corrects the OCR recognition result of the ID card, it will be subject to examination.
* ex) When the name of the depositor is changed during the authentication of the one-won account
*/
/* Functions used in the authentication process */
"module": {
"id_card_ocr": true, // Whether ID OCR function is enabled,
"id_card_verification": false, // whether the identity verification function is enabled,
"face_authentication": false, // whether ID face vs selfie face comparison function is enabled,
"account_verification": true, // whether 1 won account authentication is enabled,
"liveness": false // whether face liveness is enabled,
},
"id_card": { // ID authentication results
/* idType : 1 (Resident Registration Card)
idType : 2 (Driver Registration Certificate)
idType : 3 (Korean Passport)
idType : 4 (Foreign Passport)
idType : 5-1 (Foreigner Registration Card)
idType : 5-2 (Certificate of Domestic Residence for Foreign National of Korean Heritage)
idType : 5-3 (Permanent Residency Certificate) */
},
"face_check": { // Facial authentication result
},
"account": { // 1-Won account verification result
}
}
}
}
<aside> 💡 고객사는 result_type별로 각각 다른 API를 호출해야 합니다. 때문에 API호출을 위해서 “id” 와 “result_type” 이 필요합니다.
</aside>
WHEN r.result_type = 1 THEN "auto_approve" (자동승인대상)
WHEN r.result_type = 2 THEN "auto_reject" (자동거부대상)
WHEN r.result_type = 5 THEN "wait_review" (수동심사대상)
1 : Automatic approval (자동승인대상)
2 : Automatic rejection (자동거부대상)
5 : Manual review target (수동심사대상)
kyc-api.useb.co.kr/review/results/{id}
kyc-api.useb.co.kr/review/manuals/{id}