Search

group_key

Reference
실행 그룹 키
Request Type (Length)
aN(64)
Request Value
"Q0RSSkYzWUI3..."
Response Type
aN(64)
Response Value
"Q0RSSkYzWUI3..."
필수여부
Y

정의

group_key지급이체 요청을 수행한 하나 이상의 거래건들을 하나의 그룹으로 묶은 키로, 지급이체 실행 요청시 그룹키를 기준으로 지급이체를 수행하게 됩니다.
여러건의 지급이체 요청(request)이 지급이체 실행(execute) 요청 전에 하나의 그룹으로 구분되는데, 이때 구분하는 값이 그룹키입니다.
예시) 지급이체 요청 5건(A)이 하나의 그룹키(a)로 묶임
지급이체 요청 5건(A)을 모두 실행(execute)하여 지급이체를 완료한 후,
새로운 지급이체 요청 3건(B)을 요청하면 새로운 그룹키(b) 생성

참고

하나의 그룹키에 묶인 여러 지급이체 요청 건 중 일부만 지급이체 실행이 되었을 때,
지급이체 실행이 되지 않은 요청건은 그대로 같은 그룹키를 가지고 있으며,
새로운 지급이체 요청시 새로운 그룹키가 생성됩니다

생성로직

그룹키는 지급이체 실행(execute)시 마다 변경되는 임의의 난수값입니다.
지급이체 요청(request)시에는 그룹키가 변경되지 않습니다. 즉, 지급이체 실행(execute)을 하지 않았다면 같은 그룹키에 여러 요청이 담기게 됩니다.
다시 말해서, 지급이체 실행(execute)이후 새로운 지급이체 요청(request)시, 새로운 그룹키가 발급되는 것입니다.

주의사항

group_key에 지급이체 요청건이 없으면 입금이체 실행이 거부됩니다.