본문으로 건너뛰기

회원 고유키(Customer Key)

발급 API​

사용자 등록 처리가 완료된 고객의 고유키(Customer Key)를 발급 받는 API 입니다.
이지페이 간편결제를 사용하는 고객의 고유키(Customer Key)로 결제수단 조회, 결제, 결제수단 관리 등에 필요합니다.

요청​

요청 URL
POST https://{API 도메인}/easypay/user/customerkey/generation.do
Content-type: application/json; charset=euc-kr

파라미터​

필드명타입길이필수여부설명
requestTidString60Byte✅제휴사 요청 고유번호 인증등록 시 전송한 값
registerTidString60Byte✅인증등록 고유번호
certSeqNoString60Byte✅본인인증 처리고유번호
요청 예시
{  
"requestTid": "{제휴사 요청 고유번호}",
"registerTid": "{인증등록 고유번호}",
"certSeqNo": "{본인인증 처리고유번호}"
}

응답​

파라미터​

필드명타입길이설명
resCdString4Byte결과코드(정상 : “0000”)
resMsgString1000Byte결과 메시지
customerKeyString60Byte간편결제 고객 고유식별번호
shopUserIdString60Byte제휴사에서 관리하는 고객 식별번호
응답 예시
{
"resCd": "0000",
"resMsg": "정상처리",
"customerKey": "{간편결제 고객 고유식별번호}",
"shopUserId": "{제휴사에서 관리하는 고객 식별번호}"
}

삭제 API​

사용자 등록 처리가 완료된 고객의 고유키(Customer Key)를 발급 받는 API 입니다.
이지페이 간편결제를 사용하는 고객의 고유키(Customer Key)로 결제수단 조회, 결제, 결제수단 관리 등에 필요합니다.

요청​

요청 URL
POST https://{API 도메인}/easypay/user/customerkey/expiration.do
Content-type: application/json; charset=euc-kr

파라미터​

필드명타입길이필수여부설명
customerKeyString60Byte✅간편결제 회원 고유키
shopUserIdString60Byte✅제휴사에서 관리하는 고객 식별번호
요청 예시
{
"customerKey": "{간편결제 회원 고유키}",
"shopUserId": "{제휴사에서 관리하는 고객 식별번호}"
}

응답​

파라미터​

필드명타입길이설명
resCdString4Byte결과코드(정상 : “0000”)
resMsgString1000Byte결과 메시지
isExpiredBoolean만료여부 만료: true, 미만료: false
응답 예시
{
"resCd": "0000",
"resMsg": "정상처리",
"isExpired": true
}