API를 통해서 review result 제공 받는 방법

<aside> 💡 useB.eKYC API Guide https://kyc-api-swagger.useb.co.kr/

해당 링크를 통해서 eKYC에서 사용되는 API의 테스트가 가능합니다.

</aside>

1. reviewer account 와 Access Token 취득

<aside> 💡 Server API를 사용하고 싶은 고객사는 reviewer account가 별도로 있어야 합니다. reviewer account의 정보를 활용하여 Access Token 발급이 가능합니다.

</aside>

2. 인증 심사 완료 후 postMessage 샘플

<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
      }
    }
	}
}

3. result_type별 API 종류

<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 (수동심사대상)