결제수단 관리 및 매출전표 페이지를 호출하기 위한 서비스 입니다.
페이지 호출 전 반드시 OneTimeAccessKey를 받아 해당 페이지를 호출해야 합니다.
서비스 페이지 호출 전 일회성 Key를 발급이 필요합니다.
HTTP POST 방식으로 호출 바랍니다.
요청
URL 정보
| 테스트 | https://testapi.easypay.co.kr/easypay/user/oneTimeAccessKey.do |
| 운영 | https://api.easypay.co.kr/easypay/user/oneTimeAccessKey.do |
파라미터
| 필드명 | 타입 | 최대크기 | 필수여부 | 설명 |
|---|---|---|---|---|
| mallId | String | 8 Byte | 필수 | KICC에서 부여한 상점ID |
| customerKey | String | 60 Byte | 필수 | 간편결제 고객 고유식별번호 |
응답
Body
| 필드명 | 타입 | 최대크기 | 필수여부 | 설명 |
|---|---|---|---|---|
| resCd | String | 4 Byte | 필수 | 결과코드(정상 : "0000") |
| resMsg | String | 1000 Byte | 필수 | 결과 메시지 |
| oneTimeAccessKey | String | 60 Byte | 일회성 Key |
고객이 간편결제에 등록한 결제수단 정보를 조회, 추가등록 등 기능을 제공하는 페이지 입니다.
HTTP GET 방식으로 호출 바랍니다.
요청
URL 정보
| 테스트 | https://testapi.easypay.co.kr/easypay/user/paymentMethodManagement.do |
| 운영 | https://api.easypay.co.kr/easypay/user/paymentMethodManagement.do |
파라미터
| 필드명 | 타입 | 최대크기 | 필수여부 | 설명 |
|---|---|---|---|---|
| oneTimeAccessKey | String | 60 Byte | 필수 | 일회성 Key |
| returnUrl | String | 256 Byte | 필수 | 상점으로 이동할 상점 Url URL Encoding 필요 |
간편결제 결제수단을 등록하는 페이지 입니다.
HTTP GET 방식으로 호출 바랍니다.
요청
URL 정보
| 테스트 | https://testapi.easypay.co.kr/easypay/user/paymentMethodReg.do |
| 운영 | https://api.easypay.co.kr/easypay/user/paymentMethodReg.do |
파라미터
| 필드명 | 타입 | 최대크기 | 필수여부 | 설명 |
|---|---|---|---|---|
| oneTimeAccessKey | String | 60 Byte | 필수 | 일회성 Key |
| returnUrl | String | 256 Byte | 필수 | 상점으로 이동할 상점 Url URL Encoding 필요 |
| payMethodTypeCode | String | 60 Byte | 필수 | 등록할 결제수단 코드 Null일 경우 원장정보로 처리 신용카드 : "11", 계좌 : "21" |
Body
| 필드명 | 타입 | 최대크기 | 필수여부 | 설명 |
|---|---|---|---|---|
| resCd | String | 4 Byte | 필수 | 결과코드(정상 : "0000") |
| resMsg | String | 1000 Byte | 필수 | 결과 메시지 |
| payMethodTypeCode | String | 2 Byte | 등록한 결제수단 | |
| payMethodDetailCode | String | 3 Byte | 결제수단 세부 코드 카드 코드표 참조 |
간편결제 결제 비밀번호를 변경할 수 있는 페이지입니다.
HTTP GET 방식으로 호출 바랍니다.
요청
URL 정보
| 테스트 | https://testapi.easypay.co.kr/easypay/user/passwordModification.do |
| 운영 | https://api.easypay.co.kr/easypay/user/passwordModification.do |
파라미터
| 필드명 | 타입 | 최대크기 | 필수여부 | 설명 |
|---|---|---|---|---|
| oneTimeAccessKey | String | 60 Byte | 필수 | 일회성 Key |
| returnUrl | String | 256 Byte | 필수 | 상점으로 이동할 상점 Url URL Encoding 필요 |
응답
| resCd | String | 4 Byte | 필수 | 결과코드(정상 : "0000") |
| resMsg | String | 1000 Byte | 필수 | 결과 메시지 |
(온라인 승인거래만)승인/취소 거래에 대한 매출전표를 제공하는 페이지 입니다.
HTTP GET 방식으로 호출 바랍니다.
요청
URL 정보
| 테스트 | https://testapi.easypay.co.kr/easypay/payment/receipt.do |
| 운영 | https://api.easypay.co.kr/easypay/payment/receipt.do |
파라미터
| 필드명 | 타입 | 최대크기 | 필수여부 | 설명 |
|---|---|---|---|---|
| oneTimeAccessKey | String | 60 Byte | 필수 | 일회성 Key |
| pgCno | String | 256 Byte | 필수 | PG 승인 거래번호 |
| returnUrl | String | 60 Byte | 필수 | 상점으로 이동할 상점 Url URL Encoding 필요 |
등록된 결제수단을 삭제하는 API 입니다.
HTTP GET 방식으로 호출 바랍니다.
요청
URL 정보
| 테스트 | https://testapi.easypay.co.kr/easypay/user/paymethodDelete.do |
| 운영 | https://api.easypay.co.kr/easypay/user/paymethodDelete.do |
파라미터
| 필드명 | 타입 | 최대크기 | 필수여부 | 설명 |
|---|---|---|---|---|
| mallId | String | 8 Byte | 필수 | KICC에서 부여한 상점ID |
| customerKey | String | 60 Byte | 필수 | 간편결제 고객 고유식별번호 |
| easypayVirtualNo | String | 60 Byte | 필수 | 결제수단 가상번호 |
요청 예
{
"mallId": "T0001004",
"customerKey": "BB2BDC6A1B519C7EE31EE6FAB5D83D0FC2E80B86",
"easypayVirtualNo": "BF27D26918529C78E71FE1FBB4D83303058A94F3",
}
응답
Body
| 필드명 | 타입 | 최대크기 | 필수여부 | 설명 |
|---|---|---|---|---|
| resCd | String | 4Byte | 필수 | 결과코드(정상 : "0000") |
| resMsg | String | 1000Byte | 필수 | 결과 메시지 |
응답 예
{
"resCd" : "0000",
"resMsg" : "정상"
}