추가 프로세스 (Injection)

"추가 프로세스 (Injection)" 은 submission을 대상으로 별도의 경로를 통해 정보를 업데이트하는 프로세스 입니다. 업데이트 되는 경우 기존에 동일 카테고리에 존재하는 정보는 업데이트로 인해 사용할 수 없습니다. 추가 프로세스 진행을 위해서는 사전에 라이브폼 또는 API 로 submission이 생성 되어있어야 합니다

1. Query String 으로 전송가능한 정보들 (Injection)

Query String으로 전송한 추가 정보는 API 호출 시 응답 데이터 값에 포함됩니다. API 호출 시 KYC 제출자 식별을 위한 고유 유저 ID를 생성할 수 있고, 커스텀 필드는 최대 3개까지 추가 가능합니다.

Query String 옵션은 Argos KYC 라이브폼을 이용하여 적용할 수있으며, 모든 쿼리 스트링 값은 URL에 인코딩 되어야 합니다.

Option	URL parameter
기본 폼 URL	https://form.argoskyc.com/?pid={project_Id}
Injection 포함 URL	https://form.argoskyc.com/?pid={project_id}&action=addveri&sid={submission_id}

Input Data

*이 붙은 것은 필수 파라미터 입니다.

Parameter	Type	Description
*pid	string	각각의 project 를 구분하는 고유의 구분자
*sid	string	각각의 submission 을 구분하는 고유의 구분자
*action=addveri	string	Injection 옵션 실행
cf1	string	사용자 정의 옵션 필드
cf2	string	사용자 정의 옵션 필드
cf3	string	사용자 정의 옵션 필드
userid	string	사용자의 사용자 지정 고유 식별자

Error Case

Error Case	Description
Invalid required	pid, sid, action=addveri 가 정상적으로 입력되지 않은 경우
required field is missing.	submissionId, projectId, 주소데이터 1개 이상 (globalCode, compoundCode, formatted_address) 은 필수 파라미터임
Invalid submissionId.	존재하지 않은 submission ID
Invalid projectId.	존재하지 않은 project ID
Error in injecting address: {errorStack}	정의되지 않은 불특정 에러 (DB Transaction / TypeError / 외부모듈 에러 등) : errorStack 에 에러 정보 함께 반환됨

2. Address 가 정상적으로 업데이트 된 경우

결과 페이지로 이동 후 "주소지 인증이 완료되었습니다." 텍스트가 디스플레이 됩니다.

3. Address 가 정상적으로 업데이트 되지 않은 경우

• 아래의오류 페이지를 호출하게 됩니다.

Case	Description	User UI
address_processing_error	주소지를 업데이트 하는 과정에서 알수 없는 서버 오류로 정상 진행이 되지 않는 경우	"주소지 정보를 처리하는 중 오류가 발생하였습니다. 다시 시도해주세요." 메세지 팝업 후 다시 주소지 인증이 진행 됩니다.