사용자 인증 등록

제휴사의 고객정보를 등록요청 후 응답으로 사용자 등록창 호출 URL을 응답으로 받을 수 있는 API 입니다.

요청

요청 URL

POST https://{API 도메인}/easypay/cert/userCertReg.do
Content-type: application/json; charset=euc-kr

파라미터

필드명	타입	길이	필수여부	설명
requestTid	String	60Byte	✅	제휴사 요청 고유번호 매 요청마다 Unique 보장
shopUserId	String	60Byte	✅	제휴사에서 관리하는 고객 식별번호
shopUserMail	String	50Byte	✅	제휴사에서 관리하는 고객 e-mail
certType	String	10Byte	✅	고객 식별용 인증타입 “CI” or “NONE”
certValue	String	200Byte		고객 인증값 인증타입이 “CI”일 경우 고객 CI정보를 SEED 암호화 후 HexString으로 전송함
returnUrl	String	256Byte	✅	사용자 등록 후 되돌아갈 제휴사의 URL 정보 해당 URL로 Redirect됨(HTTPS만 허용)
shopParameter	String	4000Byte		제휴사 예비필드 (개인정보에 해당하는 데이터는 제외하여 전달해야 합니다.)

요청 예시

{  
  "requestTid": "{제휴사 요청 고유번호}", 
  "shopUserId": "{제휴사에서 관리하는 고객 식별번호}", 
  "shopUserMail": "{제휴사에서 관리하는 고객 e-mail}", 
  "certType": "CI", 
  "certValue": "{고객 인증값}", 
  "returnUrl": "{사용자 인증 후 되돌아갈 제휴사의 URL 정보}", 
  "shopParameter": "{제휴사 예비필드}"
}

응답

파라미터

필드명	타입	길이	설명
resCd	String	4Byte	결과코드(정상 : “0000”)
resMsg	String	1000Byte	결과 메시지
registerTid	String	60Byte	인증등록 고유번호 Customer Key 발급 시 필요
requestTid	String	60Byte	요청 시 전달된 requestTid Customer Key 발급 시 필요
isSignUpUser	Boolean		간편결제 가입여부 가입회원 : true, 미가입 : false
easyPayCertPageUrl	String	256Byte	사용자 등록창 호출 URL

응답 예시

{
  "resCd": "0000",
  "resMsg": "정상처리",
  "registerTid": "{인증등록 고유번호}",
  "requestTid": "{요청 시 전달된 requestTid}",
  "isSignUpUser": true,
  "easyPayCertPageUrl": "{사용자 등록창 호출 URL}"
}