1. 기존 방식: Client에서 직접 파라미터 전달

• useB.eKYC로 넘어오기 전에, 아래와 같이 필수 정보 4가지를 포함해 전달해야 인증 절차가 정상 작동합니다.

const params = {
  "access_token": "ACCESS_TOKEN_VALUE",
  "name": "홍길동",
  "birthday": "1981-11-23",
  "phone_number": "01012345678",
  "email": "[email protected]"
}

2. Server to Server 사전 등록 → transaction_id 활용

• /verifications API를 통해 귀사 서버에서 사전에 인증 정보를 등록할 수 있으며, 그 결과로 받은 transaction_id를 통해 iframe 및 webview를 진입할 수 있습니다.

• 요청 헤더

  <aside> 💡

  • [POST] https://kyc-api.useb.co.kr/verifications
    • Authorization: Bearer {access_token}
      • Content-Type: application/json </aside>

• 요청 Body (JSON)

  {
    "name": "홍길동",
    "birthday": "1981-11-23",
    "phone_number": "01012345678",
    "email": "[email protected]"
  }
  

• 응답 예시

  {
    "form": {
      "transaction_id": "1754035720510123456-6126383872156123456",
      "progress": {
        "is_id_card_checked": false,
        "is_account_checked": false,
        "is_face_checked": null,
        "is_custom_field_checked": null,
        "is_edd_field_checked": null
      },
      "module": {
        "id_card_ocr": true,
        "id_card_verification": true,
        "face_authentication": false,
        "account_verification": true,
        "liveness": false,
        "custom_field": false,
        "edd_field": false
      }
    },
    "api_response": {
      "result_code": "N100",
      "result_message": "OK."
    }
  }
  

• ifame 및 webview 진입 시 transaction_id만 전달

  • Server에서 받은 trasaction_id만 전달하면 됩니다.

  • 전달 예시

    const params = {
      "access_token" : "...", 
       "transaction_id": "1754035720510123456-6126383872156123456"
    }
    

  • 해당 방식으로도 기존과 동일하게 인증 프로세스를 수행할 수 있습니다.

  • Server to Server Swagger 명세서: https://kyc-api-swagger.useb.co.kr/#