@nhnpayco-dev/mcp-devcenter 1.0.0

package/dist/data/guides/online-easypay.md

@@ -0,0 +1,530 @@
+# 결제 연동하기
+
+> **원본:** https://devcenter.payco.com/guide/online/easypay/flow?id=220401002
+> **카테고리:** `online-easypay`
+> **포함 단계 (LNB):**
+> - ③ 결제 승인 (`/guide/online/easypay/approval?id=220401005`)
+> - ④ 결제 취소 (`/guide/online/easypay/cancel?id=220401006`)
+> - 결제 연동하기 (`/guide/online/easypay/flow?id=220401002`)
+> - 결제 연동하기 (`/guide/online/easypay/reserve?id=220401002`)
+> - ① 결제창 호출 (`/guide/online/easypay/reserve?id=220401003`)
+> - ② 결제 인증 (`/guide/online/easypay/return?id=220401004`)
+
+---
+
+## 결제 연동하기 연동 프로세스 및 API 안내
+
+PAYCO 결제 연동 API 상세 내용을 안내합니다.
+
+### 연동 프로세스 이해하기
+
+![간편결제 flow 이미지](/img/@easypay_flow.72901f4b.png)
+
+### 연동 API 상세
+
+1. #### 주문 예약 API로 결제창 호출하기
+
+   - 주문 예약 API를 호출하여 응답 받은 주문서 URL를 팝업으로 노출하여 PAYCO 결제창을 호출합니다.
+
+   연동 API 상세
+
+   |  |  |
+   | --- | --- |
+   | URL | /outseller/order/reserve |
+   | Method | POST |
+
+   **잠깐만요!**
+
+   결제창 팝업 오픈 시 팝업차단으로 열리지 않을 수 있어요.  
+   가맹점 페이지에서 API 호출 후 응답 받은 주문서 URL로 redirect 하여 팝업 차단을 방지할 수 있습니다.  
+   결제창 팝업 오픈은 POST 방식의 submit은 지양해주세요.
+
+   #### ※ 개발환경 테스트 가맹점 정보 확인
+
+   온라인 결제 연동 시 개발환경에서 테스트 가능한 가맹점 코드를 확인해주세요.
+
+   - 개발환경 결제는 실결제가 이루어지지 않습니다.
+   - 테스트하기 페이지를 참고하여 테스트에 필요한 APP, PAYCO 포인트, 쿠폰 등을 받아 보세요.
+
+   개발 테스트 가맹점키
+
+   |  |  |
+   | --- | --- |
+   | sellerKey | S0FSJE |
+   | cpId | PARTNERTEST |
+   | productId | PROD_EASY |
+
+   - ##### 주문예약 API - REQUEST
+
+     주문예약 API - REQUEST
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | sellerKey(필수 / string) | PAYCO에서 전달받은 가맹점 고유 코드입니다.(가맹점 정보) |
+     | 2 | sellerOrderReferenceKey(필수 / string) | 가맹점에서 사용하는 거래 주문번호(고유번호) 이며,  기본적으로 값은 유니크 해야합니다. |
+     | 3 | sellerOrderReferenceKeyType(string) | 가맹점 주문번호 타입입니다.  - UNIQUE_KEY : 유니크한 값 (Default)  - DUPLICATE_KEY : 중복가능한 값 – 가맹점 주문번호가 중복 가능한 경우에 사용합니다. |
+     | 4 | currency(string) | 통화 단위를 표기합니다.(Default : KRW) |
+     | 5 | totalPaymentAmt(필수 / number) | 총 결제할 금액을 표기합니다.  면세, 과세, 부가세 금액의 총합이 되어야합니다. |
+     | 6 | totalTaxfreeAmt(number) | 면세금액(면세상품 공급가액의 합) |
+     | 7 | totalTaxableAmt(number) | 과세금액(과세상품 공급가액의 합) |
+     | 8 | totalVatAmt(number) | 부가세(과세상품 부가세의 합) |
+     | 9 | totalGreenDepositAmt(number) | 컵보증금 |
+     | 10 | orderTitle(필수 / string) | 결제에 대한 가맹점 주문명 입니다. |
+     | 11 | returnUrl(필수 / string) | 주문완료 후 redirect 되는 URL 입니다. |
+     | 12 | returnUrlParam(string) | 주문완료 후 redirect 되는 URL로 함께 전달 되어야하는 파라미터 입니다. (Json 형태의 String 문자열 형태 입니다) |
+     | 13 | nonBankbookDepositInformUrl(string) | 무통장 입금완료 통보를 위한 URL 입니다. |
+     | 14 | orderMethod(필수 / string) | 결제 주문유형을 구분합니다.  - CHECKOUT: 바로구매형   - EASYPAY_F: 가맹점 회원결제   - EASYPAY: 가맹점 비회원결제 |
+     | 15 | orderChannel(필수 / string) | 결제(주문) 유입 채널을 구분합니다. (PC, MOBILE / Default : PC) |
+     | 16 | inAppYn(필수 / string) | 인앱결제 여부를 구분합니다. (Y, N) (진입경로가 가맹점 App 인 경우 ‘Y’ 사용) [App결제 연동 안내](/guide/online/extra/start?id=220401016) |
+     | 17 | payMode(필수 / string) | PAYCO의 결제모드를 선택합니다.(Default : PAY2) |
+     | 18 | orderProducts(필수 / array) | 결제 주문상품 List를 표기합니다.  [* 상세내용 확인하기](/guide/online/easypay/orderproducts?id=220401003) |
+     | 19 | extraData(string) | 결제 부가정보를 표기합니다.  [* 상세내용 확인하기](/guide/online/easypay/extradata?id=220401003) |
+
+     **잠깐만요!**
+
+     IOS에서 유니버셜 링크 비활성화로 인해 PAYCO 앱 결제가 안될 수 있어요!  
+     앱 결제를 위해 가맹점 앱 내부에서 completionHandler 를 사용하거나 앱스킴 등록 후 canOpenURL 를 사용해주세요.  
+     자세한 내용은 'APP 결제 연동 주의사항' 을 확인해주세요.
+   - ##### 주문상품 List(orderProducts) 상세
+
+     주문상품 List(orderProducts) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | cpId(필수 / string) | PAYCO에서 발급받은 상점ID값 입니다.(가맹점 정보) |
+     | 2 | productId(필수 / string) | PAYCO에서 발급받은 상품ID값 입니다.(가맹점 정보) |
+     | 3 | productAmt(필수 / number) | 가맹점의 결제 상품 원금액(할인 프로모션 등 미적용) 입니다. (상품단가*수량 총합이 되어야 합니다) |
+     | 4 | productPaymentAmt(필수 / number) | 가맹점의 결제 상품 실결제 금액(할인 프로모션 등 적용) 입니다. (상품단가*수량 총합이 되어야 합니다) |
+     | 5 | orderQuantity(필수 / string) | 상품 주문 수량을 표기합니다. |
+     | 6 | sortOrdering(필수 / number) | 상품 노출 순서를 정합니다. |
+     | 7 | productName(필수 / string) | 결제 상품명을 기재합니다. |
+     | 8 | sellerOrderProductReferenceKey(필수 / string) | 가맹점에서 관리하는 주문상품 연동키(고유코드) 입니다. |
+     | 9 | taxationType(string) | 주문상품에 대한 과세타입 구분값 입니다.  - DUTYFREE: 면세상품   - TAXATION: 과세상품(Default)   - COMBINE: 결합상품 |
+
+     **잠깐만요!**
+
+     주문상품 LIST에 상품은 1가지만 등록해주시고 상품금액과 결제금액을 확인해주세요.  
+     총 결제금액(totalPaymentAmt) = 상품별 결제금액 합계(productPaymentAmt)
+   - ##### 가맹점 부가정보(extraData) 상세
+
+     가맹점 부가정보(extraData) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | payExpiryYmdt(string) | PAYCO 결제창 호출 유효시간을 지정합니다. (해당 일시 이후 결제창 호출 불가) Default : 30분 / ex) YYYYMMDDHHmmss 형식 |
+     | 2 | virtualAccountExpiryYmd(string) | 가상계좌 만료일시를 지정합니다. (Default : 3일) ex) YYYYMMDD or YYYYMMDDHHmmss 형식 / YYYYMMDD인 경우 당일 24시 만료 |
+     | 3 | cancelMobileUrl(string) | Mobile 결제창에서 ‘취소’버튼 클릭 시 이동할 URL을 지정합니다. 미설정 시 주문예약(reserve) 호출 시 전달받은 returnUrl로 이동합니다. |
+     | 4 | viewOptions(string) | PAYCO 결제창 화면 UI 옵션을 지정합니다. [* 상세내용 확인하기](/guide/online/easypay/viewoptions?id=220401003) |
+     | 5 | appUrl(필수 / string) | iOS App을 통해 PAYCO 호출이 발생하는 경우 결제완료 후 복귀할 App Url 입니다. (iOS App 호출의 경우만 필수값 입니다) |
+   - ##### PAYCO 결제창 화면 UI 옵션(viewOptions)
+
+     PAYCO 결제창 화면 UI 옵션(viewOptions)
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | iframeYn(string) | iframe 호출여부를 기재합니다. (Default : N) |
+     | 2 | languageCode(string) | PAYCO 결제창 언어 코드를 지정합니다. (Default : KR) |
+     | 3 | iframeCloseBtnYn(string) | PAYCO 비로그인 상태로 결제창을 iframe 호출하는 경우 로그인 화면에 ‘닫기’버튼 노출여부를 선택합니다. (Default : N) |
+     | 4 | showLoginCloseBtnYn(string) | PAYCO 비로그인 상태로 결제창을 호출하는 경우 로그인 화면에 ‘닫기’버튼 노출여부를 선택합니다. (Default : N) |
+
+     **주문예약 API - REQUEST Sample 코드**
+
+     ```
+     {
+       "sellerKey": "S0FSJE",
+       "sellerOrderReferenceKey": "testno00001",
+       "totalPaymentAmt": "67300",
+       "totalGreenDepositAmt": "300",
+       "orderMethod": "EASYPAY",
+       "payMode": "PAY2",
+       "returnUrl": "https://devcenter.payco.com/demo/easyPay2Return",
+       "orderChannel": "PC",
+       "inAppYn": "N",
+       "orderProducts": [{
+         "cpId": "PARTNERTEST",
+         "productId": "PROD_EASY",
+         "productAmt": "67000",
+         "productPaymentAmt": "67000",
+         "orderQuantity": "1",
+         "sortOrdering": "1",
+         "productName": "TEST_PRODUCT_NAME",
+         "sellerOrderProductReferenceKey": "testno00001"
+     }]
+     }
+     ```- ##### 주문예약 API - RESPONSE
+
+     주문예약 API - RESPONSE
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | reserveOrderNo(string) | 주문예약 API 호출에 따른 PAYCO 주문예약 번호입니다. |
+     | 2 | orderSheetUrl(string) | PAYCO 결제창(주문서) URL 입니다. 해당 URL을 팝업으로 Open 하시면 결제창이 호출됩니다. |
+
+     **주문예약 API - RESPONSE Sample 코드**
+
+     ```
+     {
+     "result": {
+       "reserveOrderNo": "202302082005802285",
+       "orderSheetUrl": "https://alpha-bill.payco.com/easyLogin/202302082005802285"
+     },
+       "code": 0,
+       "message": "success"
+     }
+     ```2. #### 결제인증 완료 페이지로 인증 데이터 전달받기
+
+   이용자 결제인증(비밀번호 or 지문) 완료 후 가맹점 인증완료 페이지(returnUrl)로 데이터를 전달합니다.  
+    가맹점에서 결제 가능 여부를 확인 후 팝업창을 닫고 승인요청 API를 호출 해주세요.
+
+   - ##### returnUrl로 전달되는 파라미터 정보
+
+     returnUrl로 전달되는 파라미터 정보
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | reserveOrderNo(string) | 결제건에 대한 PAYCO 주문예약번호 입니다. ex) 202112132005557446 |
+     | 2 | sellerOrderReferenceKey(string) | 가맹점에서 사용하는 거래 주문번호(고유번호) 입니다. ex) mallSeq1639391629325 |
+     | 3 | paymentCertifyToken(string) | 결제승인을 위한 결제인증토큰 입니다. 결제승인 API 호출 시 필요합니다. ex) mxtjrpRpuQXxt4TgXivo1WPMIcbx7AabB3BP53s_XIivb9RXDvdXkMAT4U38JSTJ |
+     | 4 | totalPaymentAmt(필수 / number) | 총 결제할 금액 입니다. ex) 10000 |
+     | 5 | totalRemoteAreaDeliveryFreeAmt(number) | 총 도서산간 배송비용 입니다. ex) 0 |
+     | 6 | discountAmt(number) | 결제건에 사용된 쿠폰할인금액 입니다. ex) 3000 |
+     | 7 | pointAmt(number) | 결제건에 사용된 PAYCO 포인트 사용금액 입니다. ex) 1500 |
+     | 8 | mainPgCode(number) | 결제건에 대항하는 주결제수단 코드 입니다. ex) 31, 98 등 |
+     | 9 | code(number) | ex) 0(정상처리) 또는 1 이상(오류)의 값 |
+
+     **returnUrl 전달 파라미터 Sample**
+
+     ```
+     code=0
+     &reserveOrderNo=202302082005802285
+     &sellerOrderReferenceKey=testno00001
+     &mainPgCode=31
+     &totalPaymentAmt=67300
+     &totalRemoteAreaDeliveryFeeAmt=0
+     &discountAmt=0
+     &pointAmt=0
+     &paymentCertifyToken=JeF_D0w-1OW2b50Wj6tgFGkfDfDj8Ru5HfkopM5EPczgOXaZPNBfFtZPdPqRLIS0
+     ```3. #### 결제 승인 요청하기
+
+   - 이용자 결제인증 데이터를 통해 결제 승인을 요청 합니다.
+   - 인증 후 30분 내로 승인 처리가 필요해요.
+   - 승인 응답 Timeout 시간으로 30초 이상을 권장 드립니다.
+
+   |  |  |
+   | --- | --- |
+   | URL | /outseller/payment/approval |
+   | Method | POST |
+
+   - ##### 결제승인 API - REQUEST
+
+     결제승인 API - REQUEST
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | sellerKey(필수 / string) | PAYCO에서 전달받은 가맹점 고유 코드입니다.(가맹점 정보) |
+     | 2 | reserveOrderNo(필수 / string) | 결제건에 대한 PAYCO 주문예약번호 입니다. ex) 202112132005557446 |
+     | 3 | sellerOrderReferenceKey(필수 / string) | 가맹점에서 사용하는 거래 주문번호(고유번호) 이며, 기본적으로 값은 유니크 해야합니다. |
+     | 4 | paymentCertifyToken(필수 / string) | 결제승인을 위한 결제인증토큰 입니다. 결제승인 API 호출 시 필요합니다. |
+     | 5 | totalPaymentAmt(필수 / number) | 총 결제할 금액을 표기합니다. 면세, 과세, 부가세 금액의 총합이 되어야합니다. |
+     | 6 | totalTaxfreeAmt(number) | 면세금액(면세상품 공급가액의 합) 입니다. |
+     | 7 | totalTaxableAmt(number) | 과세금액(과세상품 공급가액의 합) 입니다. |
+     | 8 | totalVatAmt(number) | 부가세(과세상품 부가세의 합) 입니다. |
+     | 9 | totalGreenDepositAmt(number) | 컵보증금 |
+
+     **승인 요청 API - REQUEST Sample 코드**
+
+     ```
+     {
+     "totalPaymentAmt": 67300,
+     "sellerKey": "S0FSJE",
+     "reserveOrderNo": "202302082005802285",
+     "sellerOrderReferenceKey": "testno00001",
+     "paymentCertifyToken": "JeF_D0w-1OW2b50Wj6tgFGkfDfDj8Ru5HfkopM5EPczgOXaZPNBfFtZPdPqRLIS0",
+     "totalGreenDepositAmt": 300
+     }
+     ```- ##### 결제승인 API - RESPONSE
+
+     결제승인 API - RESPONSE
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | sellerOrderReferenceKey(string) | 가맹점에서 사용하는 거래 주문번호(고유번호) 입니다. |
+     | 2 | reserveOrderNo(string) | 결제건에 대한 PAYCO 주문예약번호 입니다. ex) 202112142005557446 |
+     | 3 | orderNo(string) | 결제건에 대한 PAYCO 주문번호 입니다. ex) 202112142002669697 |
+     | 4 | memberName(string) | 주문자명을 일부 마스킹 처리하여 표기합니다. ex) 박** |
+     | 5 | memberEmail(string) | 주문자 EMAIL을 일부 마스킹 처리하여 표기합니다. ex) ac**** |
+     | 6 | orderChannel(string) | 결제(주문) 유입 채널을 표기합니다. (PC/MOBILE) |
+     | 7 | totalOrderAmt(number) | 총 주문금액을 표기합니다. |
+     | 8 | totalDeliveryFeeAmt(number) | 총 배송비 금액을 표기합니다. |
+     | 9 | totalRemoteAreaDeliveryFeeAmt(number) | 총 도서산간비 금액을 표기합니다. |
+     | 10 | totalPaymentAmt(필수 / number) | 총 결제금액을 표기합니다. |
+     | 11 | totalGreenDepositAmt(number) | 총 컵보증금 |
+     | 12 | orderProducts(array) | 결제 주문상품 List를 표기합니다. [* 상세내용 확인하기](/guide/online/easypay/orderproductsRes?id=220401004) |
+     | 13 | paymentDetails(array) | 결제내역 List를 표기하며, 각각의 결제수단별 array list로 구성되어 리턴됩니다. [* 상세내용 확인하기](/guide/online/easypay/paymentdetails?id=220401004) |
+     | 14 | orderCertifyKey(string) | 주문인증키값을 표기하며, 이 값으로 취소요청을 할 수 있습니다. [* 결제취소 상세내용 확인하기](/guide/online/easypay/cancel?id=220401004) |
+     | 15 | paymentCompletionYn(string) | 결제완료 여부를 표기합니다. (Y/N) |
+     | 16 | paymentCompleteYmdt(string) | 최종 결제일시를 표기합니다.  ex) YYYYMMDDHHmmss 형식 |
+   - ##### 주문상품 List(orderProducts) 상세
+
+     주문상품 List(orderProducts) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | orderProductNo(string) | PAYCO에서 생성된 주문상품번호 입니다. ex) 202112142002935076 |
+     | 2 | sellerOrderProductReferenceKey(string) | 가맹점에서 사용하는 주문상품 연동키(코유코드) 입니다. ex) ITEM_100001 |
+     | 3 | orderProductStatusCode(string) | PAYCO에서 생성된 주문상품상태코드 입니다. ex) OPSPAED |
+     | 4 | orderProductStatusName(string) | 주문상품상태코드에 따른 주문상품상태명 입니다. ex) 결제완료 |
+     | 5 | cpId(string) | PAYCO에서 발급받은 상점ID값 입니다.(가맹점 정보) |
+     | 6 | productId(string) | PAYCO에서 발급받은 상품ID값 입니다.(가맹점 정보) |
+     | 7 | productKindCode(string) | PAYCO에서 생성된 상품타입 입니다. (사용된 productId에 따라 값이 달라집니다) ex) GENERAL_PRODUCT, DELIVERY_FREE |
+     | 8 | productPaymentAmt(float) | 상품결제금액 입니다. 배송비 상품의 경우 ‘원 상품결제금액+추가배송비’ 로 변경될 수 있습니다. |
+     | 9 | originalProductPaymentAmt(float) | 원 상품결제금액 입니다 |
+   - ##### 결제내역 List(paymentDetails) 상세
+
+     결제내역 List(paymentDetails) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | paymentTradeNo(string) | PAYCO 결제번호 입니다. ex) 202112142004291664 |
+     | 2 | paymentMethodCode(string) | PAYCO 결제수단코드 입니다. ex) 31, 98 등 |
+     | 3 | paymentMethodName(string) | 결제수단 코드에 대한 결제수단명 입니다. ex) 신용카드, PAYCO 포인트 등 |
+     | 4 | paymentAmt(number) | 총 결제금액 입니다. |
+     | 5 | taxfreeAmt(number) | 총 면세금액 입니다. |
+     | 6 | taxableAmt(number) | 총 과세금액 입니다. |
+     | 7 | vatAmt(number) | 총 부가세 입니다. |
+     | 8 | serviceAmt(number) | 총 봉사료 입니다. |
+     | 9 | greenDepositAmt(number) | 컵보증금 |
+     | 10 | tradeYmdt(string) | 결제일시 ex) YYYYMMDDHHmmss 형식 |
+     | 11 | pgAdmissionNo(string) | PG 승인번호 |
+     | 12 | pgAdmissionYmdt(string) | PG 승인일시 ex) YYYYMMDDHHmmss 형식 |
+     | 13 | easyPaymentYn(string) | PAYCO 간편결제여부 입니다. (Y/N) |
+     | 14 | cardSettleInfo(object) | 신용카드 결제정보 상세 필드 입니다. [* 상세내용 확인하기](/guide/online/easypay/cardSettleInfo?id=220401004) |
+     | 15 | cellphoneSettleInfo(object) | 휴대폰 결제정보 상세 필드 입니다. [* 상세내용 확인하기](/guide/online/easypay/cellphoneSettleInfo?id=220401004) |
+     | 16 | realtimeAccountTransferSettleInfo(object) | 실시간계좌이체 결제정보 상세 필드 입니다. [* 상세내용 확인하기](/guide/online/easypay/realtimeAccountTransferSettleInfo?id=220401004) |
+     | 17 | nonBankbookSettleInfo(object) | 무통장입금 결제정보 상세 필드 입니다. [* 상세내용 확인하기](/guide/online/easypay/nonBankbookSettleInfo?id=220401004) |
+     | 18 | couponSettleInfo(object) | 쿠폰 결제정보 상세 필드 입니다. [* 상세내용 확인하기](/guide/online/easypay/couponSettleInfo?id=220401004) |
+   - ##### 신용카드 결제정보 필드(cardSettleInfo) 상세
+
+     신용카드 결제정보 필드(cardSettleInfo) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | cardCompanyName(string) | 결제 카드사명 입니다. ex) KB국민카드 |
+     | 2 | cardCompanyCode(string) | 결제 카드사코드 입니다. ex) CCKM |
+     | 3 | cardNo(string) | 결제 카드번호 입니다. ex) 374725********** |
+     | 4 | cardInstallmentMonthNumber(string) | 결제건 할부개월수 입니다. |
+     | 5 | cardAdmissionNo(string) | 카드사 승인번호 입니다. |
+     | 6 | cardInterestFreeYn(string) | 무이자여부를 표기합니다. (Y/N) |
+     | 7 | corporateCardYn(string) | 법인카드 여부를 표기합니다. (Y: 법인 / N: 개인) |
+     | 8 | partCancelPossibleYn(string) | 부분취소가능 여부를 표기합니다. (Y/N) |
+     | 9 | acquirersCorporationCode(string) | 매입사 코드 입니다. ex) CCKM |
+   - ##### 휴대폰 결제정보 필드(cellphoneSettleInfo) 상세
+
+     휴대폰 결제정보 필드(cellphoneSettleInfo) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | companyName(string) | 통신사명 입니다. ex) SKT |
+     | 2 | cellphoneNo(string) | 휴대폰 번호 입니다. |
+   - ##### 실시간계좌이체 결제정보 필드(realtimeAccountTrasferSettleInfo) 상세
+
+     실시간계좌이체 결제정보 필드(realtimeAccountTrasferSettleInfo) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | bankName(string) | 은행명 입니다. ex) 신한 |
+     | 2 | bankCode(string) | 은행코드 입니다. ex) 88 |
+   - ##### 무통장입금 결제정보 필드(nonBankbookSettleInfo) 상세
+
+     무통장입금 결제정보 필드(nonBankbookSettleInfo) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | bankName(string) | 은행명 입니다. ex) 신한 |
+     | 2 | bankCode(string) | 은행코드 입니다. ex) 88 |
+     | 3 | accountNo(string) | 계좌번호 입니다. ex) 88 |
+     | 4 | paymentExpirationYmd(string) | 입금만료일 입니다. ex) YYYYMMDD 형식 |
+   - ##### 쿠폰 결제정보 필드(couponSettleInfo) 상세
+
+     쿠폰 결제정보 필드(couponSettleInfo) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | discountAmt(string) | 쿠폰 할인금액 입니다. |
+     | 2 | discountConditionAmt(string) | 쿠폰 할인조건 입니다. |
+
+     **승인 요청 API - RESPONSE Sample 코드**
+
+     ```
+     {
+     "result": {
+       "sellerOrderReferenceKey": "testno00001",
+       "reserveOrderNo": "202302082005802285",
+       "orderNo": "202302082002764740",
+       "memberName": "최**",
+       "memberEmail": "ev****",
+       "orderChannel": "PC",
+       "totalOrderAmt": 67300,
+       "totalDeliveryFeeAmt": 0,
+       "totalRemoteAreaDeliveryFeeAmt": 0,
+       "totalPaymentAmt": 67300,
+       "totalGreenDepositAmt": 300,
+       "receiptPaycoPointAmt": 0,
+       "receiptPaycoPointTaxfreeAmt": 0,
+       "receiptPaycoPointTaxableAmt": 0,
+       "receiptPaycoPointVatAmt": 0,
+       "receiptPaycoPointServiceAmt": 0,
+       "orderProducts": [{
+         "orderProductNo": "202302082003060489",
+         "sellerOrderProductReferenceKey": "testno00001",
+         "orderProductStatusCode": "OPSPAED",
+         "orderProductStatusName": "결제완료",
+         "cpId": "PARTNERTEST",
+         "productId": "PROD_EASY",
+         "productKindCode": "GENERAL_PRODUCT",
+         "productPaymentAmt": 67000,
+         "originalProductPaymentAmt": 67000
+       }],
+       "paymentDetails": [{
+         "cardSettleInfo": {
+           "cardCompanyName": "신한카드",
+           "cardCompanyCode": "CCLG",
+           "cardNo": "941084******9410",
+           "cardInstallmentMonthNumber": "00",
+           …
+         },
+         "paymentTradeNo": "202302082004749621",
+         "paymentMethodCode": "31",
+         "paymentMethodName": "신용카드",
+         "paymentAmt": 67300,
+         "taxfreeAmt": 0,
+         "taxableAmt": 60909,
+         "vatAmt": 6091,
+         "serviceAmt": 0,
+         "greenDepositAmt": 300,
+         "tradeYmdt": "20230208111759",
+         "pgAdmissionNo": "23669985037116",
+         "pgAdmissionYmdt": "20230208111759",
+         "easyPaymentYn": "Y"
+       }],
+       "orderCertifyKey": "GiB3gCceGTsWAvgs79ni8QBR3Jw3exDHu5s85YyG9pwCC",
+       "paymentCompletionYn": "Y",
+       "paymentCompleteYmdt": "20230208111759"
+     },
+     "code": 0,
+     "message": "success"
+     }
+     ```4. #### 결제 취소 요청하기
+
+   승인된 결제 데이터를 통해 결제 취소 요청을 합니다.  
+   전체취소, 부분취소 모두 가능해요.
+
+   |  |  |
+   | --- | --- |
+   | URL | /outseller/order/cancel |
+   | Method | POST |
+
+   - ##### 결제취소 API - REQUEST
+
+     결제취소 API - REQUEST
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | sellerKey(필수 / string) | PAYCO에서 전달받은 가맹점 고유 코드입니다.(가맹점 정보) |
+     | 2 | orderNo(필수 / string) | 결제건에 대한 PAYCO 주문번호 입니다. |
+     | 3 | cancelTotalAmt(필수 / number) | 취소할 총 금액 입니다. 면세/과세/부가세 금액을 입력하는 경우 총 합이 되어야 합니다. |
+     | 4 | totalCancelTaxfreeAmt(number) | 취소할 면세금액(면세상품 공급가액의 합) 입니다. |
+     | 5 | totalCancelTaxableAmt(number) | 취소할 과세금액(과세상품 공급가액의 합) 입니다. |
+     | 6 | totalCancelVatAmt(number) | 취소할 부가세(과세상품 부가세의 합) 입니다. |
+     | 7 | totalCancelGreenDepositAmt(number) | 총 취소할 컵보증금 입니다. |
+     | 8 | totalCancelPossibleAmt(number) | 취소요청 시점의 취소 가능금액을 입력합니다. 해당 값을 통해 취소처리를 검증할 수 있으며, 간단한 예시를 아래에 안내 드립니다. |
+     | 9 | orderCertifyKey(필수 / string) | 승인건의 주문인증키를 입력합니다. |
+     | 10 | requestMemo(string) | 취소처리 요청 메모를 입력합니다. |
+
+     **취소 요청 API - REQUEST Sample 코드**
+
+     ```
+     {
+     "orderNo": "202302082002764740",
+     "orderCertifyKey": "GiB3gCceGTsWAvgs79ni8QBR3Jw3exDHu5s85YyG9pwCC",
+     "cancelTotalAmt": "67300",
+     "totalCancelGreenDepositAmt": "300",
+     "sellerKey": "S0FSJE"
+     }
+     ```- ##### 결제취소 API - RESPONSE
+
+     결제취소 API - RESPONSE
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | orderNo(string) | 결제건에 대한 PAYCO 주문번호 입니다. |
+     | 2 | cancelTradeSeq(number) | PAYCO 취소내역번호 입니다. |
+     | 3 | totalCancelPaymentAmt(number) | 결제 취소된 총 금액 입니다. |
+     | 4 | totalCancelGreenDepositAmt(number) | 총 취소 컵보증금 입니다. |
+     | 5 | remainCancelPossibleAmt(number) | 잔여 취소 가능금액 입니다. |
+     | 6 | cancelPaymentDetails(array) | 취소 결제내역 List 입니다. 상세 필드는 아래 별도 안내 되어있습니다. |
+     | 7 | cancelYmdt(string) | 결제 취소일시를 표기합니다. ex) YYYYMMDDHHmmss 형식 |
+   - ##### 취소 결제내역 List(cancelPaymentDetails) 상세
+
+     취소 결제내역 List(cancelPaymentDetails) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | paymentTradeNo(string) | PAYCO 결제번호 입니다. ex) 202112142002669715 |
+     | 2 | paymentMethodCode(string) | 취소된 결제수단코드 입니다. ex) 31, 98 등 |
+     | 3 | paymentMethodName(string) | 결제수단코드에 대한 명칭 입니다. ex) 신용카드 |
+     | 4 | cancelPaymentAmt(number) | 결제 취소된 금액입니다. |
+     | 5 | tradeYmdt(string) | 결제 취소일시 입니다. ex) YYYYMMDDHHmmss 형식 |
+     | 6 | cancelPaymentTradeNo(string) | 취소거래내역 결제번호 입니다. ex) 202112142004292460 |
+     | 7 | cancelTaxableAmt(number) | 결취소 과세금액 입니다. |
+     | 8 | cancelTaxfreeAmt(number) | 취소 면세금액 입니다. |
+     | 9 | cancelVatAmt(number) | 취소 부가세 입니다. |
+     | 10 | cancelGreenDepositAmt(number) | 취소 컵보증금 입니다. |
+
+     **취소 요청 API - RESPONSE Sample 코드**
+
+     ```
+     {
+     "result": {
+       "orderNo": "202302082002764740",
+       "cancelTradeSeq": 2000680844,
+       "totalCancelPaymentAmt": 67300.0,
+       "totalCancelGreenDepositAmt": 300,
+       "remainCancelPossibleAmt": 0.0,
+       "cancelPaymentDetails": [{
+         "paymentTradeNo": "202302082004749621",
+         "paymentMethodCode": "31",
+         "paymentMethodName": "신용카드",
+         "cancelPaymentAmt": 67300.0,
+         "tradeYmdt": "20230208112216",
+         "cancelPaymentTradeNo": "202302082004749638",
+         "cancelTaxableAmt": 60909.0,
+         "cancelTaxfreeAmt": 0.0,
+         "cancelVatAmt": 6091.0,
+         "cancelServiceAmt": 0.0,
+         "cancelGreenDepositAmt": 300.0
+       }],
+       "cancelReceiptPaycoPointAmt": 0.0,
+       "cancelReceiptPaycoPointTaxfreeAmt": 0.0,
+       "cancelReceiptPaycoPointTaxableAmt": 0.0,
+       "cancelReceiptPaycoPointVatAmt": 0.0,
+       "cancelReceiptPaycoPointServiceAmt": 0.0,
+       "cancelYmdt": "20230208112216"
+     },
+     "code": 0,
+     "message": "success"
+     }
+     ```잠깐만요!**
+
+     취소 가능금액(totalCancelPossibleAmt)을 이용하여 중복 취소를 방지할 수 있어요!  
+     취소 가능금액을 입력하여 취소요청 하는 경우 아래와 같은 응답으로 중복 취소요청을 방지할 수 있습니다.  
+      - code : 1001 / message : 주문취소 가능금액이 일치하지 않습니다.
+
+     **잠깐만요!**
+
+     잠깐! 복합결제 시 부분취소 상세 조건을 확인해보세요.  
+       
+      예시) 신용카드/포인트 10,000원 + 쿠폰 1,000원 = 11,000원 결제 (쿠폰 조건 : 2,000원 이상 결제 시 1,000원 할인)  
+      Case 1: 8,000원 부분취소 → 신용카드/포인트 8,000원 부분취소  
+      Case 2: 9,000원 부분취소 → 신용카드/포인트 8,000원 + 쿠폰 1,000원 부분취소  
+                      ※ 취소 잔여금액이 쿠폰 사용조건에 미달되므로 쿠폰 우선취소

package/dist/data/guides/online-easypay.meta.json

@@ -0,0 +1,50 @@
+{
+  "slug": "online-easypay",
+  "id": "220401002",
+  "url": "https://devcenter.payco.com/guide/online/easypay/flow?id=220401002",
+  "path": "/guide/online/easypay/flow",
+  "title": "결제 연동하기",
+  "menu_text": "결제 연동하기",
+  "sections": [
+    {
+      "label": "③ 결제 승인",
+      "path": "/guide/online/easypay/approval",
+      "id": "220401005"
+    },
+    {
+      "label": "④ 결제 취소",
+      "path": "/guide/online/easypay/cancel",
+      "id": "220401006"
+    },
+    {
+      "label": "결제 연동하기",
+      "path": "/guide/online/easypay/flow",
+      "id": "220401002"
+    },
+    {
+      "label": "결제 연동하기",
+      "path": "/guide/online/easypay/reserve",
+      "id": "220401002"
+    },
+    {
+      "label": "① 결제창 호출",
+      "path": "/guide/online/easypay/reserve",
+      "id": "220401003"
+    },
+    {
+      "label": "② 결제 인증",
+      "path": "/guide/online/easypay/return",
+      "id": "220401004"
+    }
+  ],
+  "h2_sections": [
+    "결제 연동하기 연동 프로세스 및 API 안내"
+  ],
+  "h3_sections": [
+    "연동 프로세스 이해하기",
+    "연동 API 상세"
+  ],
+  "table_count": 22,
+  "code_block_count": 7,
+  "text_length": 16602
+}