회원 고유키(Customer Key)

발급 API

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

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

필드명	타입	길이	필수여부	설명
requestTid	String	60Byte	✅	제휴사 요청 고유번호 인증등록 시 전송한 값
registerTid	String	60Byte	✅	인증등록 고유번호
certSeqNo	String	60Byte	✅	본인인증 처리고유번호

요청 예시
{  
  "requestTid": "{제휴사 요청 고유번호}", 
  "registerTid": "{인증등록 고유번호}", 
  "certSeqNo": "{본인인증 처리고유번호}"
}

필드명	타입	길이	설명
resCd	String	4Byte	결과코드(정상 : “0000”)
resMsg	String	1000Byte	결과 메시지
customerKey	String	60Byte	간편결제 고객 고유식별번호
shopUserId	String	60Byte	제휴사에서 관리하는 고객 식별번호

응답 예시
{
  "resCd": "0000",
  "resMsg": "정상처리",
  "customerKey": "{간편결제 고객 고유식별번호}",
  "shopUserId": "{제휴사에서 관리하는 고객 식별번호}"
}   

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

필드명	타입	길이	필수여부	설명
customerKey	String	60Byte	✅	간편결제 회원 고유키
shopUserId	String	60Byte	✅	제휴사에서 관리하는 고객 식별번호

요청 예시
{
  "customerKey": "{간편결제 회원 고유키}",
  "shopUserId": "{제휴사에서 관리하는 고객 식별번호}"
}

필드명	타입	길이	설명
resCd	String	4Byte	결과코드(정상 : “0000”)
resMsg	String	1000Byte	결과 메시지
isExpired	Boolean		만료여부 만료: true, 미만료: false

응답 예시
{
  "resCd": "0000",
  "resMsg": "정상처리",
  "isExpired": true
}   