간편결제 관리 서비스

제휴사에서 간편결제를 보다 쉽게 관리할 수 있도록 제공되는 서비스 입니다.

참고

• 본 서비스를 이용하기 위해서는 반드시 일회성 키(OneTimeAccessKey)가 필요합니다.
• 결제수단 관리, 결제수단 등록, 비밀번호 변경, 매출전표 페이지가 제공됩니다.

결제수단 관리페이지

결제수단 관리페이지 호출

간편결제 회원이 등록한 결제수단을 조회, 추가등록 등 기능을 제공하는 페이지 입니다.

요청

요청 URL

GET https://{API 도메인}/easypay/user/paymentMethodManagement.do?oneTimeAccessKey={일회성 키}&returnUrl={제휴사 리턴 URL}
Content-type: text/html

파라미터

필드명	타입	길이	필수여부	설명
oneTimeAccessKey	String	60Byte	✅	일회성 키
returnUrl	String	256Byte	✅	제휴사 리턴 URL(HTTPS만 허용, URL Encoding)

결제수단 등록페이지

결제수단 등록페이지 호출

간편결제 결제수단을 등록하는 페이지 입니다.
결제수단 등록 완료 후 returnUrl로 응답값을 POST 방식으로 전달됩니다.

요청

요청 URL

GET https://{API 도메인}/easypay/user/paymentMethodReg.do?oneTimeAccessKey={일회성 키}&returnUrl={제휴사 리턴 URL}&payMethodTypeCode={결제수단 코드}
Content-type: text/html

파라미터

필드명	타입	길이	필수여부	설명
oneTimeAccessKey	String	60Byte	✅	일회성 키
returnUrl	String	256Byte	✅	제휴사 리턴 URL(HTTPS만 허용, URL Encoding)
payMethodTypeCode	String	2Byte		등록할 결제수단 코드 신용카드: "11", 계좌: "21", Null일 경우 KICC등록 결제수단으로 처리

응답

파라미터

필드명	타입	길이	설명
resCd	String	4Byte	결과코드(정상 : “0000”)
resMsg	String	1000Byte	결과 메시지
payMethodTypeCode	String	2Byte	결제수단 코드 참고
payMethodDetailCode	String	3Byte	카드코드 또는 은행코드

결제 PIN번호 변경페이지

결제 PIN번호 변경페이지 호출

간편결제 결제 PIN번호를 변경하는 페이지 입니다.

요청

요청 URL

GET https://{API 도메인}/easypay/user/passwordModification.do?oneTimeAccessKey={일회성 키}&returnUrl={제휴사 리턴 URL}
Content-type: text/html

파라미터

필드명	타입	길이	필수여부	설명
oneTimeAccessKey	String	60Byte	✅	일회성 키
returnUrl	String	256Byte	✅	제휴사 리턴 URL(HTTPS만 허용, URL Encoding)

응답

파라미터

필드명	타입	길이	설명
resCd	String	4Byte	결과코드(정상 : “0000”)
resMsg	String	1000Byte	결과 메시지

매출전표 페이지

매출전표 페이지 호출

간편결제 매출전표를 조회하는 페이지 입니다.

요청

요청 URL

GET https://{API 도메인}/easypay/payment/receipt.do?oneTimeAccessKey={일회성 키}&returnUrl={제휴사 리턴 URL}&pgCno={PG 거래고유번호}
Content-type: text/html 

파라미터

필드명	타입	길이	설명
oneTimeAccessKey	String	60Byte	일회성 키
pgCno	String	20Byte	PG 거래고유번호
returnUrl	String	256Byte	제휴사 리턴 URL(HTTPS만 허용, URL Encoding)