등록

등록흐름

가맹점의 회원을 이지페이 간편결제 서비스에 등록하는 절차입니다.

사용자 등록, 인증, CustomerKey발급을 통해 고객을 등록하는 절차가 있습니다.

01사용자 인증등록

고객정보를 등록하고 고객 본인확인 및 결제수단을 등록하기 위한 사용자 인증 URL을 응답으로 받을 수 있습니다.
HTTP POST 방식으로 호출 바랍니다.

요청

URL 정보

테스트	https://testapi.easypay.co.kr/easypay/cert/userCertReg.do
운영	https://api.easypay.co.kr/easypay/cert/userCertReg.do

파라미터

필드명	타입	최대크기	필수여부	설명
mallId	String	8 Byte	필수	KICC에서 부여한 상점ID
requestTid	String	60 Byte	필수	가맹점 요청 고유번호 매 요청마다 Unique 보장
shopUserId	String	60 Byte	필수	상점에서 관리하는 고객 식별번호
certType	String	10 Byte	필수	고객 식별용 인증타입 "CI" or "NONE"
certValue	String	200 Byte		고객 인증값 고객 식별용 인증타입이 "CI"일 경우 고객 CI정보 SEED 암호화 하여 전송함
returnUrl	String	256 Byte	필수	사용자 인증 후 되돌아갈 상점의 URL 정보 해당 URL로 Redirect됨(HTTPS만 허용)
shopParameter	String	4000 Byte	필수	가맹점 예비필드 개인정보에 해당하는 데이터는 제외하여 전달해야 합니다.

요청 예

{

"mallId": "T0001004",

"requestTid": "202006180000001abcdef-123-qwer",

"shopUserId": "pang-su-14",

"certType": "CI",

"certValue":"70E054F9CD568E6A3726632C12C6E8074460AA797BC6FD03EF34C20A8B89ED346315C1DC035B4BFDC194F355D58E470EA86799D3E4552F167C3B6CDE",

"returnUrl": "https://www.pangsu.com/pangpay/regAction.do"

}

응답

Body

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

응답 예

{

"resCd" : "0000",

"resMsg" : "정상",

"registerTid": "wAb0pFc28zLjXolutFEol1eB2AIMnY++Y0THUA0F7b4=",

"requestTid": "202006180000001abcdef-123-qwer",

"isSignUpUser": false,

"easyPayCertPageUrl": "https://api.easypay.co.kr/easypay/cert/userCertPage.do?registerTid=B922D56D1D5C9875E518E2F5BCDF3B0AE90409E2"

}

02사용자 인증페이지 호출

인증창을 호출하여 본인인증 및 결제수단 등록을 진행 합니다.
인증완료 후 인증등록 시 받은 returnUrl로 인증완료에 대한 응답을 POST로 전송합니다.
HTTP GET 방식으로 호출 바랍니다.

요청

URL 정보

결제등록 응답 easyPayCertPageUrl

응답

필드명	타입	최대크기	필수여부	설명
resCd	String	4 Byte	필수	결과코드(정상 : "0000")
resMsg	String	1000 Byte	필수	결과 메시지 URL Encoding 됨
certSeqNo	String	40 Byte		본인인증 처리고유번호 Customer Key 발급 시 필요
requestTid	String	60 Byte		가맹점 요청 고유번호 인증등록시 전송한 값 Customer Key 발급 시 필요
registerTid	String	60 Byte		인증등록 고유번호 Customer Key 발급 시 필요
shopParameter	String	4000 Byte		가맹점 예비필드

03Customer Key 발급 API

본인인증, 결제수단 등록, PIN번호 등록 등 처리가 완료된 고객의 고유 Key를 발급 받는 API 입니다.
간편결제를 사용하는 회원의 고유식별번호로 결제수단 조회/결제/결제수단 관리 등에 필요합니다.
HTTP POST 방식으로 호출 바랍니다.

요청

URL 정보

테스트	https://testapi.easypay.co.kr/easypay/user/customerkey/generation.do
운영	https://api.easypay.co.kr/easypay/user/customerkey/generation.do

파라미터

필드명	타입	최대크기	필수여부	설명
mallId	String	8 Byte	필수	KICC에서 부여한 상점ID
requestTid	String	60 Byte	필수	가맹점 요청 고유번호 인증등록 시 전송한 값
registerTid	String	60 Byte	필수	인증등록 고유번호
certSeqNo	String	60 Byte	필수	본인인증 처리고유번호

요청 예

{

"mallId": "T0001004",

"requestTid": "202006180000001abcdef-123-qwer",

"registerTid": "B922D56D1D5C9875E518E2F5BCDF3B0AE90409E2",

"certSeqNo": "BA20D76918529F75E81FE7F1BEDB3E0C4C273443"

}

응답

Body

필드명	타입	최대크기	필수여부	설명
resCd	String	4 Byte	필수	결과코드(정상 : "0000")
resMsg	String	1000 Byte	필수	결과 메시지
customerKey	String	60 Byte		간편결제 고객 고유식별번호
shopUserId	String	60 Byte		상점에서 관리하는 고객 식별번호

요청 예

{

"resCd" : "0000",

"resMsg" : "정상",

"customerKey" : "BB2BDC6A1B519C7EE31EE6FAB5D83D0FC2E80B86",

"shopUserId" : "pang-su-14"

}

04Customer Key 삭제

간편결제 해지를 할 경우 사용됩니다. HTTP POST 방식으로 호출 바랍니다.

요청

URL 정보

테스트	https://testapi.easypay.co.kr/easypay/user/customerkey/expiration.do
운영	https://api.easypay.co.kr/easypay/user/customerkey/expiration.do

파라미터

필드명	타입	최대크기	필수여부	설명
mallId	String	8 Byte	필수	KICC에서 부여한 상점ID
customerKey	String	60 Byte	필수	간편결제 고객 고유식별번호
shopUserId	String	60 Byte	필수	상점에서 관리하는 고객 식별번호

요청 예

{

"mallId": "T0001004",

"customerKey": "BB2BDC6A1B519C7EE31EE6FAB5D83D0FC2E80B86",

"shopUserId": "pang-su-14"

}

응답

Body

필드명	타입	최대크기	필수여부	설명
resCd	String	4 Byte	필수	결과코드(정상 : "0000")
resMsg	String	1000 Byte	필수	결과 메시지
isExpired	Boolean			만료여부

응답 예

{

resCd : "0000",

resMsg : "정상처리",

isExpired: true

}