@portone/mcp-server 0.15.0 → 0.16.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/docs/help/admin-console/pg-settlement/content30.md +2 -2
- package/assets/docs/help/admin-console/pg-settlement-history/content35.md +2 -2
- package/assets/docs/help/core-service/channel-setting/danal.md +4 -4
- package/assets/docs/help/core-service/channel-setting/daou.md +5 -0
- package/assets/docs/help/core-service/channel-setting/galaxia.md +2 -2
- package/assets/docs/help/core-service/channel-setting/inicis.md +30 -46
- package/assets/docs/help/core-service/channel-setting/kcp_channel.md +25 -13
- package/assets/docs/help/core-service/channel-setting/kpn.md +3 -2
- package/assets/docs/help/core-service/channel-setting/mobilians.md +22 -27
- package/assets/docs/help/core-service/channel-setting/nice.md +4 -4
- package/assets/docs/help/core-service/channel-setting/payco.md +5 -3
- package/assets/docs/help/core-service/channel-setting/payletter.md +3 -3
- package/assets/docs/help/core-service/how-to-use/additional-mobilians.md +15 -21
- package/assets/docs/help/core-service/how-to-use/content200009.md +10 -9
- package/assets/docs/help/core-service/how-to-use/high-risk-industry.md +2 -0
- package/assets/docs/help/core-service/how-to-use/information-pg.md +1 -1
- package/assets/docs/help/core-service/how-to-use/mobilians-contract.md +26 -21
- package/assets/docs/help/core-service/how-to-use/requirements.md +2 -0
- package/assets/docs/help/core-service/how-to-use/test-mode-cancel.md +1 -1
- package/assets/docs/help/core-service/how-to-use/wordpress-setting.md +2 -1
- package/assets/docs/help/core-service/payment-type/content200047.md +3 -1
- package/assets/docs/help/core-service/payment-type/content200052.md +8 -1
- package/assets/docs/help/core-service/payment-type/hub-service-fee.md +1 -1
- package/assets/docs/help/core-service/payment-type/internationl-high-risk-industry.md +1 -26
- package/assets/docs/help/faq/general-inquiry/confirm-process.md +5 -11
- package/assets/docs/help/faq/general-inquiry/real-channel-info.md +1 -1
- package/assets/docs/help/faq/payment-faq/pg-max-min-amount.md +3 -3
- package/assets/docs/help/faq/payment-faq/vbank-service-detail.md +1 -1
- package/assets/docs/help/pricing/pg/domestic-and-oversea-fees.md +1 -1
- package/assets/docs/help/pricing/portone/portone-pricing.md +2 -0
- package/assets/docs/help/procedure/pg-application/content54.md +2 -0
- package/assets/docs/help/procedure/pg-application/start.md +2 -0
- package/assets/docs/help/procedure/recommendation/package.md +4 -2
- package/assets/docs/help/service/pg/pg-service-list.md +8 -6
- package/assets/docs/opi/ko/extra/link-pay/readme-v1.md +36 -4
- package/assets/docs/opi/ko/extra/mobile-payment/readme-v2.md +610 -0
- package/assets/docs/opi/ko/extra/smart-routing/intro.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/blue.md +36 -0
- package/assets/docs/opi/ko/integration/pg/v1/danal.md +134 -4
- package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +103 -53
- package/assets/docs/opi/ko/integration/pg/v1/eximbay.md +121 -19
- package/assets/docs/opi/ko/integration/pg/v1/galaxia.md +12 -0
- package/assets/docs/opi/ko/integration/pg/v1/inicis-jp.md +57 -30
- package/assets/docs/opi/ko/integration/pg/v1/inicis.md +177 -0
- package/assets/docs/opi/ko/integration/pg/v1/kakaopay.md +128 -2
- package/assets/docs/opi/ko/integration/pg/v1/kg-mobilians-v2.md +19 -19
- package/assets/docs/opi/ko/integration/pg/v1/kg.md +65 -12
- package/assets/docs/opi/ko/integration/pg/v1/kicc.md +115 -2
- package/assets/docs/opi/ko/integration/pg/v1/ksnet/readme.md +14 -2
- package/assets/docs/opi/ko/integration/pg/v1/naver.md +60 -0
- package/assets/docs/opi/ko/integration/pg/v1/newtoss/readme.md +117 -7
- package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/kcp-quickpay.md +21 -32
- package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/readme.md +164 -3
- package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md +6 -6
- package/assets/docs/opi/ko/integration/pg/v1/nice-v2/readme.md +177 -2
- package/assets/docs/opi/ko/integration/pg/v1/nice.md +122 -3
- package/assets/docs/opi/ko/integration/pg/v1/payco.md +87 -3
- package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md +142 -1
- package/assets/docs/opi/ko/integration/pg/v1/paymentwall.md +45 -1
- package/assets/docs/opi/ko/integration/pg/v1/paypal.md +37 -1
- package/assets/docs/opi/ko/integration/pg/v1/readme.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/rt/readme.md +52 -14
- package/assets/docs/opi/ko/integration/pg/v1/settle/mybank.md +138 -56
- package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md +50 -0
- package/assets/docs/opi/ko/integration/pg/v1/smartro-v2/readme.md +126 -0
- package/assets/docs/opi/ko/integration/pg/v1/smartro.md +78 -0
- package/assets/docs/opi/ko/integration/pg/v1/smilepay.md +49 -3
- package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md +88 -25
- package/assets/docs/opi/ko/integration/pg/v1/toss-brandpay/module.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/toss-brandpay/readme.md +34 -2
- package/assets/docs/opi/ko/integration/pg/v1/toss.md +114 -1
- package/assets/docs/opi/ko/integration/pg/v1/tosspay-v2/readme.md +74 -15
- package/assets/docs/opi/ko/integration/pg/v1/tosspay.md +41 -1
- package/assets/docs/opi/ko/integration/pg/v1/welcome/readme.md +12 -0
- package/assets/docs/opi/ko/integration/pg/v2/inicis-jp.md +3 -15
- package/assets/docs/opi/ko/integration/pg/v2/triple-a.md +1 -0
- package/assets/docs/opi/ko/integration/ready/readme.md +14 -46
- package/assets/docs/opi/ko/integration/start/v1/non-auth.md +1 -1
- package/assets/docs/opi/ko/readme.md +2 -2
- package/assets/docs/opi/ko/support/code-info/pg-2.md +1 -1
- package/assets/docs/opi/ko/support/code-info/pg-3.md +3 -3
- package/assets/docs/opi/ko/support/code-info/pg.md +1 -1
- package/assets/docs/release-notes/api-sdk/2023-07-03.md +3 -3
- package/assets/docs/schema/v1.openapi.json +239 -3
- package/assets/docs/schema/v1.openapi.yml +174 -12
- package/assets/docs/schema/v2.openapi.json +225 -11
- package/assets/docs/schema/v2.openapi.yml +185 -3
- package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrq.md +10 -2
- package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrt.md +1 -1
- package/assets/docs/v1-docs-full.md +2892 -388
- package/assets/docs/v2-docs-full.md +639 -67
- package/assets/docs/website-links.md +4 -3
- package/manifest.json +1 -1
- package/package.json +1 -1
- package/server/index.js +1 -1
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
---
|
|
2
|
-
title: KG
|
|
3
|
-
description: KG
|
|
2
|
+
title: KG파이낸셜 (신모듈)
|
|
3
|
+
description: KG파이낸셜 (신모듈) 결제 연동 방법을 안내합니다.
|
|
4
4
|
targetVersions:
|
|
5
5
|
- v1
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
## 1. KG
|
|
8
|
+
## 1. KG파이낸셜 채널 설정하기
|
|
9
9
|
|
|
10
10
|
[결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
|
|
11
11
|
|
|
@@ -14,7 +14,7 @@ targetVersions:
|
|
|
14
14
|
## 2. 결제 요청하기
|
|
15
15
|
|
|
16
16
|
[JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
|
|
17
|
-
KG
|
|
17
|
+
KG파이낸셜 결제창을 호출할 수 있습니다.
|
|
18
18
|
**결제 결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후 **callback** 으로 수신되고
|
|
19
19
|
모바일의 경우 **m\_redirect\_url**로 리디렉션됩니다.
|
|
20
20
|
|
|
@@ -178,7 +178,7 @@ IMP.request_pay(
|
|
|
178
178
|
|
|
179
179
|
**카드 포인트 사용 여부 (일반 카드 결제시 사용가능)**
|
|
180
180
|
|
|
181
|
-
|
|
181
|
+
KG파이낸셜 서비스 ID에 포인트 사용 설정 필요
|
|
182
182
|
|
|
183
183
|
- card?: object
|
|
184
184
|
|
|
@@ -202,7 +202,7 @@ IMP.request_pay(
|
|
|
202
202
|
|
|
203
203
|
**카드사 다이렉트 호출 시 적용할 카드 포인트 사용 여부**
|
|
204
204
|
|
|
205
|
-
|
|
205
|
+
KG파이낸셜 서비스 ID에 포인트 사용 설정 필요
|
|
206
206
|
|
|
207
207
|
기본값: 사용자 선택
|
|
208
208
|
|
|
@@ -265,7 +265,7 @@ IMP.request_pay(
|
|
|
265
265
|
|
|
266
266
|
- mobilians\_v2?: object
|
|
267
267
|
|
|
268
|
-
|
|
268
|
+
**KG파이낸셜 전용 파라미터**
|
|
269
269
|
|
|
270
270
|
- cp\_logo?: string
|
|
271
271
|
|
|
@@ -276,7 +276,7 @@ IMP.request_pay(
|
|
|
276
276
|
|
|
277
277
|
기본값: `N`
|
|
278
278
|
|
|
279
|
-
사전에
|
|
279
|
+
사전에 KG파이낸셜 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
|
|
280
280
|
|
|
281
281
|
<div class="hint" data-style="info">
|
|
282
282
|
|
|
@@ -427,7 +427,7 @@ IMP.request_pay(
|
|
|
427
427
|
|
|
428
428
|
기본값: `N`
|
|
429
429
|
|
|
430
|
-
사전에
|
|
430
|
+
사전에 KG파이낸셜 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
|
|
431
431
|
|
|
432
432
|
- EMAIL\_HIDDEN?: string
|
|
433
433
|
|
|
@@ -550,7 +550,7 @@ IMP.request_pay(
|
|
|
550
550
|
|
|
551
551
|
- mobilians\_v2?: object
|
|
552
552
|
|
|
553
|
-
|
|
553
|
+
**KG파이낸셜 전용 파라미터**
|
|
554
554
|
|
|
555
555
|
- cp\_logo?: string
|
|
556
556
|
|
|
@@ -560,7 +560,7 @@ IMP.request_pay(
|
|
|
560
560
|
- `N`: 미표기
|
|
561
561
|
|
|
562
562
|
기본값: `N`
|
|
563
|
-
사전에
|
|
563
|
+
사전에 KG파이낸셜 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
|
|
564
564
|
|
|
565
565
|
- css\_type?: string
|
|
566
566
|
|
|
@@ -735,7 +735,7 @@ IMP.request_pay(
|
|
|
735
735
|
|
|
736
736
|
- mobilians\_v2?: object
|
|
737
737
|
|
|
738
|
-
|
|
738
|
+
**KG파이낸셜 전용 파라미터**
|
|
739
739
|
|
|
740
740
|
- cp\_logo?: string
|
|
741
741
|
|
|
@@ -745,7 +745,7 @@ IMP.request_pay(
|
|
|
745
745
|
- `N`: 미표기
|
|
746
746
|
|
|
747
747
|
기본값: `N`
|
|
748
|
-
사전에
|
|
748
|
+
사전에 KG파이낸셜 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
|
|
749
749
|
|
|
750
750
|
- css\_type?: string
|
|
751
751
|
|
|
@@ -798,7 +798,7 @@ IMP.request_pay(
|
|
|
798
798
|
|
|
799
799
|
<summary>매출전표 미지원</summary>
|
|
800
800
|
|
|
801
|
-
-
|
|
801
|
+
- KG파이낸셜 결제는 매출전표를 제공하지 않습니다.
|
|
802
802
|
|
|
803
803
|
</details>
|
|
804
804
|
|
|
@@ -831,11 +831,11 @@ IMP.request_pay(
|
|
|
831
831
|
|
|
832
832
|
<summary>결제 취소 시 과세 처리</summary>
|
|
833
833
|
|
|
834
|
-
- **과세**: 입력한 부가세와 상관없이
|
|
834
|
+
- **과세**: 입력한 부가세와 상관없이 KG파이낸셜에서 자동 계산된 부가세 기준으로 처리됩니다.
|
|
835
835
|
|
|
836
836
|
- **복합 과세**:
|
|
837
837
|
- 첫번째 취소: 입력한 면세액, 부가세액 기준으로 처리됨
|
|
838
|
-
- 두번째(마지막) 취소: 입력한 면세액, 부가세액과 상관없이
|
|
838
|
+
- 두번째(마지막) 취소: 입력한 면세액, 부가세액과 상관없이 KG파이낸셜에서 자동 계산된 나머지 금액을 취소함
|
|
839
839
|
|
|
840
840
|
</details>
|
|
841
841
|
|
|
@@ -852,7 +852,7 @@ IMP.request_pay(
|
|
|
852
852
|
<summary>면세액(`tax_free`), 부가세(`vat`) 파라미터 사용 관련</summary>
|
|
853
853
|
|
|
854
854
|
카드, 간편결제에서만 면세액(`tax_free`), 부가세(`vat`) 파라미터를 사용할 수 있습니다.
|
|
855
|
-
면세액과 부가세 파라미터 사용 시 올바르게 계산된 금액을 입력해야 합니다. 그렇지 않으면 결제가 실패하거나
|
|
855
|
+
면세액과 부가세 파라미터 사용 시 올바르게 계산된 금액을 입력해야 합니다. 그렇지 않으면 결제가 실패하거나 KG파이낸셜 측에서 계산된 금액이 적용되어 의도하지 않은 면세액, 부가세 정보로 거래가 발생할 수 있습니다.
|
|
856
856
|
|
|
857
857
|
</details>
|
|
858
858
|
|
|
@@ -868,7 +868,7 @@ IMP.request_pay(
|
|
|
868
868
|
|
|
869
869
|
<summary>가상계좌 환불 처리</summary>
|
|
870
870
|
|
|
871
|
-
|
|
871
|
+
KG파이낸셜 가상계좌 환불은 **매주 목요일 일괄 입금** 처리됩니다.
|
|
872
872
|
|
|
873
873
|
- **화요일까지 접수된 요청**: 같은 주 목요일 입금
|
|
874
874
|
- **수요일부터 접수된 요청**: 다음 주 목요일 입금
|
|
@@ -879,7 +879,7 @@ IMP.request_pay(
|
|
|
879
879
|
|
|
880
880
|
<summary>모바일 환경 이슈</summary>
|
|
881
881
|
|
|
882
|
-
- 아이폰 모바일 환경에서 크롬이나 인앱 브라우저에서 계좌이체를 하면 뱅크페이에서 결제 완료 후 **사파리로 이동하는 이슈**가 있습니다. (
|
|
882
|
+
- 아이폰 모바일 환경에서 크롬이나 인앱 브라우저에서 계좌이체를 하면 뱅크페이에서 결제 완료 후 **사파리로 이동하는 이슈**가 있습니다. (KG파이낸셜 측 수정 예정)
|
|
883
883
|
- 팝업을 사용할 수 없는 웹뷰 환경에서는 **애플페이 결제 불가**합니다.
|
|
884
884
|
|
|
885
885
|
</details>
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
---
|
|
2
|
-
title: KG
|
|
3
|
-
description: KG
|
|
2
|
+
title: KG파이낸셜 (구모듈)
|
|
3
|
+
description: KG파이낸셜 (구모듈) 결제 연동 방법을 안내합니다.
|
|
4
4
|
targetVersions:
|
|
5
5
|
- v1
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
## 1. KG
|
|
8
|
+
## 1. KG파이낸셜 채널 설정하기
|
|
9
9
|
|
|
10
10
|
[결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
|
|
11
11
|
|
|
@@ -14,7 +14,7 @@ targetVersions:
|
|
|
14
14
|
## 2. 결제 요청하기
|
|
15
15
|
|
|
16
16
|
[JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
|
|
17
|
-
KG
|
|
17
|
+
KG파이낸셜 결제창을 호출할 수 있습니다.
|
|
18
18
|
**결제 결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
|
|
19
19
|
**callback** 으로 수신되고
|
|
20
20
|
모바일의 경우 **m\_redirect\_url**로 리디렉션됩니다.
|
|
@@ -69,11 +69,10 @@ IMP.request_pay(
|
|
|
69
69
|
|
|
70
70
|
- pay\_method: string
|
|
71
71
|
|
|
72
|
-
**결제수단
|
|
72
|
+
**결제수단 구분코드**
|
|
73
73
|
|
|
74
|
-
- card (신용카드)
|
|
75
|
-
|
|
76
|
-
- phone (휴대폰 소액 결제)
|
|
74
|
+
- card (신용카드)
|
|
75
|
+
- phone (휴대폰 소액결제)
|
|
77
76
|
|
|
78
77
|
- merchant\_uid: string
|
|
79
78
|
|
|
@@ -81,12 +80,66 @@ IMP.request_pay(
|
|
|
81
80
|
|
|
82
81
|
매번 고유하게 채번되어야 합니다.
|
|
83
82
|
|
|
83
|
+
- name: string
|
|
84
|
+
|
|
85
|
+
**주문명**
|
|
86
|
+
|
|
84
87
|
- amount: number
|
|
85
88
|
|
|
86
89
|
**결제금액**
|
|
87
90
|
|
|
88
91
|
**string** 이 아닌점에 유의하세요
|
|
89
92
|
|
|
93
|
+
- buyer\_name?: string
|
|
94
|
+
|
|
95
|
+
**구매자 이름**
|
|
96
|
+
|
|
97
|
+
- buyer\_email?: string
|
|
98
|
+
|
|
99
|
+
**구매자 이메일**
|
|
100
|
+
|
|
101
|
+
- buyer\_tel?: string
|
|
102
|
+
|
|
103
|
+
**구매자 연락처**
|
|
104
|
+
|
|
105
|
+
- buyer\_addr?: string
|
|
106
|
+
|
|
107
|
+
**구매자 주소**
|
|
108
|
+
|
|
109
|
+
- buyer\_postcode?: string
|
|
110
|
+
|
|
111
|
+
**구매자 우편번호**
|
|
112
|
+
|
|
113
|
+
- vbank\_due?: string
|
|
114
|
+
|
|
115
|
+
**가상계좌 입금마감일시**
|
|
116
|
+
|
|
117
|
+
`YYYYMMDD` 형식으로 지정합니다. 미지정 시 5일 후로 자동 설정됩니다.
|
|
118
|
+
|
|
119
|
+
- m\_redirect\_url?: string
|
|
120
|
+
|
|
121
|
+
**모바일 결제 후 리디렉션 될 URL**
|
|
122
|
+
|
|
123
|
+
- app\_scheme?: string
|
|
124
|
+
|
|
125
|
+
**모바일 앱 URL scheme**
|
|
126
|
+
|
|
127
|
+
- notice\_url?: string | string\[]
|
|
128
|
+
|
|
129
|
+
**웹훅 수신 URL**
|
|
130
|
+
|
|
131
|
+
- confirm\_url?: string
|
|
132
|
+
|
|
133
|
+
**Confirm process URL**
|
|
134
|
+
|
|
135
|
+
- custom\_data?: object
|
|
136
|
+
|
|
137
|
+
**가맹점 커스텀 데이터**
|
|
138
|
+
|
|
139
|
+
- customer\_id?: string
|
|
140
|
+
|
|
141
|
+
**구매자 고유 ID**
|
|
142
|
+
|
|
90
143
|
인증결제창 호출 파라미터에서 **customer\_uid** 값을 추가하면 비 인증 결제창을 호출할 수 있습니다. 비
|
|
91
144
|
인증 결제창에서 빌링키를 발급받은 후 해당 빌링키로 결제를 요청합니다.
|
|
92
145
|
|
|
@@ -116,8 +169,8 @@ IMP.request_pay(
|
|
|
116
169
|
|
|
117
170
|
<div class="hint" data-style="info">
|
|
118
171
|
|
|
119
|
-
- 비 인증 결제를 위해서는 **KG
|
|
120
|
-
- **KG
|
|
172
|
+
- 비 인증 결제를 위해서는 **KG파이낸셜과 계약이 완료된 MID 정보를** 관리자콘솔에 설정하셔야 비 인증 결제창을 활성화시킬 수 있습니다.
|
|
173
|
+
- **KG파이낸셜 휴대폰 결제는** 빌링키 발급시 **실 결제가 발생됩니다.**
|
|
121
174
|
- 최초 승인일자 기준 매월 **동일한 일자에 동일 금액**이 재결제되어야 합니다.
|
|
122
175
|
|
|
123
176
|
</div>
|
|
@@ -138,7 +191,7 @@ IMP.request_pay(
|
|
|
138
191
|
|
|
139
192
|
**PG사 구분코드**
|
|
140
193
|
|
|
141
|
-
**`mobilians.<KG
|
|
194
|
+
**`mobilians.<KG파이낸셜과 계약이 완료된 MID>`** 로 지정하면 됩니다.
|
|
142
195
|
|
|
143
196
|
<div class="hint" data-style="warning">
|
|
144
197
|
|
|
@@ -174,4 +227,4 @@ curl -H "Content-Type: application/json" \
|
|
|
174
227
|
https://api.iamport.kr/subscribe/payments/again
|
|
175
228
|
```
|
|
176
229
|
|
|
177
|
-
**포트원을 통해 KG
|
|
230
|
+
**포트원을 통해 KG파이낸셜을 사용할 때에는 API 방식 비 인증 결제를 사용할 수 없습니다.**
|
|
@@ -84,9 +84,9 @@ IMP.request_pay(
|
|
|
84
84
|
|
|
85
85
|
고객사에서 매번 고유하게 채번되어야 합니다.
|
|
86
86
|
|
|
87
|
-
-
|
|
87
|
+
- name: string
|
|
88
88
|
|
|
89
|
-
|
|
89
|
+
**주문명**
|
|
90
90
|
|
|
91
91
|
- amount: number
|
|
92
92
|
|
|
@@ -94,12 +94,93 @@ IMP.request_pay(
|
|
|
94
94
|
|
|
95
95
|
**string** 이 아닌점에 유의하세요
|
|
96
96
|
|
|
97
|
+
- buyer\_name?: string
|
|
98
|
+
|
|
99
|
+
**구매자 이름**
|
|
100
|
+
|
|
101
|
+
- buyer\_email?: string
|
|
102
|
+
|
|
103
|
+
**구매자 이메일**
|
|
104
|
+
|
|
105
|
+
- buyer\_tel: string
|
|
106
|
+
|
|
107
|
+
**주문자 연락처**
|
|
108
|
+
|
|
109
|
+
- buyer\_addr?: string
|
|
110
|
+
|
|
111
|
+
**구매자 주소**
|
|
112
|
+
|
|
113
|
+
- buyer\_postcode?: string
|
|
114
|
+
|
|
115
|
+
**구매자 우편번호**
|
|
116
|
+
|
|
97
117
|
- escrow?: boolean
|
|
98
118
|
|
|
99
119
|
**에스크로 설정여부**
|
|
100
120
|
|
|
101
121
|
계좌이체, 가상계좌만 지원됩니다.
|
|
102
122
|
|
|
123
|
+
- tax\_free?: number
|
|
124
|
+
|
|
125
|
+
**면세금액**
|
|
126
|
+
|
|
127
|
+
- digital?: boolean
|
|
128
|
+
|
|
129
|
+
**디지털 컨텐츠 여부**
|
|
130
|
+
|
|
131
|
+
- `true`: 컨텐츠
|
|
132
|
+
- `false`: 실물 상품
|
|
133
|
+
|
|
134
|
+
- vbank\_due?: string
|
|
135
|
+
|
|
136
|
+
**가상계좌 입금마감일시**
|
|
137
|
+
|
|
138
|
+
- company?: string
|
|
139
|
+
|
|
140
|
+
**상호명**
|
|
141
|
+
|
|
142
|
+
카드사 다이렉트 호출 시 설정하지 않으면 `iamport`로 표기됩니다.
|
|
143
|
+
|
|
144
|
+
- auth\_mode?: string
|
|
145
|
+
|
|
146
|
+
**인증 방식**
|
|
147
|
+
|
|
148
|
+
- `key-in`: 키인결제 모드
|
|
149
|
+
|
|
150
|
+
- m\_redirect\_url?: string
|
|
151
|
+
|
|
152
|
+
**모바일 결제 후 리디렉션 될 URL**
|
|
153
|
+
|
|
154
|
+
- app\_scheme?: string
|
|
155
|
+
|
|
156
|
+
**모바일 앱 URL scheme** (모바일 전용)
|
|
157
|
+
|
|
158
|
+
- notice\_url?: string | string\[]
|
|
159
|
+
|
|
160
|
+
**웹훅 수신 URL**
|
|
161
|
+
|
|
162
|
+
- confirm\_url?: string
|
|
163
|
+
|
|
164
|
+
**Confirm process URL**
|
|
165
|
+
|
|
166
|
+
- custom\_data?: object
|
|
167
|
+
|
|
168
|
+
**가맹점 커스텀 데이터**
|
|
169
|
+
|
|
170
|
+
- customer\_id?: string
|
|
171
|
+
|
|
172
|
+
**구매자 고유 ID**
|
|
173
|
+
|
|
174
|
+
- bypass?: object
|
|
175
|
+
|
|
176
|
+
**KICC 전용 파라미터**
|
|
177
|
+
|
|
178
|
+
- kicc?: object
|
|
179
|
+
|
|
180
|
+
- disp\_cash\_yn?: string
|
|
181
|
+
|
|
182
|
+
**현금영수증 표시 여부**
|
|
183
|
+
|
|
103
184
|
</div>
|
|
104
185
|
|
|
105
186
|
<div class="tabs-content" data-title="비인증 결제(결제창)">
|
|
@@ -170,6 +251,14 @@ IMP.request_pay(
|
|
|
170
251
|
|
|
171
252
|
비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
|
|
172
253
|
|
|
254
|
+
- merchant\_uid: string
|
|
255
|
+
|
|
256
|
+
**주문번호**
|
|
257
|
+
|
|
258
|
+
- name: string
|
|
259
|
+
|
|
260
|
+
**주문명**
|
|
261
|
+
|
|
173
262
|
- amount: number
|
|
174
263
|
|
|
175
264
|
**결제금액**
|
|
@@ -178,6 +267,30 @@ IMP.request_pay(
|
|
|
178
267
|
|
|
179
268
|
(실 결제를 발생시키기 위해서는 **`customer_uid`** 로 **REST API 를 이용하여 결제요청**을 해 주셔야 합니다.)
|
|
180
269
|
|
|
270
|
+
- buyer\_name?: string
|
|
271
|
+
|
|
272
|
+
**구매자 이름**
|
|
273
|
+
|
|
274
|
+
- buyer\_email?: string
|
|
275
|
+
|
|
276
|
+
**구매자 이메일**
|
|
277
|
+
|
|
278
|
+
- buyer\_tel?: string
|
|
279
|
+
|
|
280
|
+
**구매자 연락처**
|
|
281
|
+
|
|
282
|
+
- m\_redirect\_url?: string
|
|
283
|
+
|
|
284
|
+
**모바일 결제 후 리디렉션 될 URL**
|
|
285
|
+
|
|
286
|
+
- notice\_url?: string | string\[]
|
|
287
|
+
|
|
288
|
+
**웹훅 수신 URL**
|
|
289
|
+
|
|
290
|
+
- custom\_data?: object
|
|
291
|
+
|
|
292
|
+
**가맹점 커스텀 데이터**
|
|
293
|
+
|
|
181
294
|
### 빌링키(`customer_uid`)로 결제 요청하기
|
|
182
295
|
|
|
183
296
|
빌링키 발급이 성공하면 실 빌링키는 `customer_uid` 와 1:1 매칭되어 **포트원 서버에 저장**됩니다. `customer_uid`를 고객사 내부서버에 저장하시고 [**비 인증 결제요청 REST API**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain) 를 호출하시면 결제를 발생시킬 수 있습니다.
|
|
@@ -60,7 +60,7 @@ IMP.request_pay(
|
|
|
60
60
|
name: "나이키 와플 트레이너 2 SD",
|
|
61
61
|
pay_method: "card",
|
|
62
62
|
escrow: false,
|
|
63
|
-
amount:
|
|
63
|
+
amount: 109000,
|
|
64
64
|
tax_free: 3000,
|
|
65
65
|
buyer_name: "홍길동",
|
|
66
66
|
buyer_email: "buyer@example.com",
|
|
@@ -160,10 +160,22 @@ IMP.request_pay(
|
|
|
160
160
|
|
|
161
161
|
**구매자명**
|
|
162
162
|
|
|
163
|
+
- buyer\_email?: string
|
|
164
|
+
|
|
165
|
+
**구매자 이메일**
|
|
166
|
+
|
|
163
167
|
- buyer\_tel?: string
|
|
164
168
|
|
|
165
169
|
**구매자 전화번호**
|
|
166
170
|
|
|
171
|
+
- buyer\_addr?: string
|
|
172
|
+
|
|
173
|
+
**구매자 주소**
|
|
174
|
+
|
|
175
|
+
- buyer\_postcode?: string
|
|
176
|
+
|
|
177
|
+
**구매자 우편번호**
|
|
178
|
+
|
|
167
179
|
- currency: string
|
|
168
180
|
|
|
169
181
|
**결제 통화**
|
|
@@ -245,7 +257,7 @@ IMP.request_pay(
|
|
|
245
257
|
|
|
246
258
|
**통신사 구분**
|
|
247
259
|
|
|
248
|
-
통신사에 따라 LG는 `lgt`, KT는 `
|
|
260
|
+
통신사에 따라 LG는 `lgt`, KT는 `ktf`, SKT는 `skt`로 입력해야 하며, 통신사 구분이 어려우신 경우
|
|
249
261
|
임의의 값을 입력하여 요청해도 무방합니다.
|
|
250
262
|
|
|
251
263
|
- url?: string
|
|
@@ -120,6 +120,46 @@ IMP.request_pay(
|
|
|
120
120
|
|
|
121
121
|
**string** 이 아닌점에 유의하세요
|
|
122
122
|
|
|
123
|
+
- buyer\_name?: string
|
|
124
|
+
|
|
125
|
+
**구매자 이름**
|
|
126
|
+
|
|
127
|
+
- buyer\_email?: string
|
|
128
|
+
|
|
129
|
+
**구매자 이메일**
|
|
130
|
+
|
|
131
|
+
- buyer\_tel?: string
|
|
132
|
+
|
|
133
|
+
**구매자 연락처**
|
|
134
|
+
|
|
135
|
+
- buyer\_addr?: string
|
|
136
|
+
|
|
137
|
+
**구매자 주소**
|
|
138
|
+
|
|
139
|
+
- buyer\_postcode?: string
|
|
140
|
+
|
|
141
|
+
**구매자 우편번호**
|
|
142
|
+
|
|
143
|
+
- tax\_free?: number
|
|
144
|
+
|
|
145
|
+
**면세금액**
|
|
146
|
+
|
|
147
|
+
- notice\_url?: string | string\[]
|
|
148
|
+
|
|
149
|
+
**웹훅 수신 URL**
|
|
150
|
+
|
|
151
|
+
- confirm\_url?: string
|
|
152
|
+
|
|
153
|
+
**Confirm process URL**
|
|
154
|
+
|
|
155
|
+
- custom\_data?: object
|
|
156
|
+
|
|
157
|
+
**가맹점 커스텀 데이터**
|
|
158
|
+
|
|
159
|
+
- customer\_id?: string
|
|
160
|
+
|
|
161
|
+
**구매자 고유 ID**
|
|
162
|
+
|
|
123
163
|
- naverUseCfm?: string
|
|
124
164
|
|
|
125
165
|
**이용 완료일** (`yyyyMMdd` 형식의 문자열로 **결제 당일 또는 미래의 일자**여야 함)
|
|
@@ -297,6 +337,26 @@ IMP.request_pay(
|
|
|
297
337
|
|
|
298
338
|
정기/반복 결제 등록과정에서는 결제승인이 이뤄지지 않습니다.
|
|
299
339
|
|
|
340
|
+
- buyer\_name?: string
|
|
341
|
+
|
|
342
|
+
**구매자 이름**
|
|
343
|
+
|
|
344
|
+
- buyer\_email?: string
|
|
345
|
+
|
|
346
|
+
**구매자 이메일**
|
|
347
|
+
|
|
348
|
+
- buyer\_tel?: string
|
|
349
|
+
|
|
350
|
+
**구매자 연락처**
|
|
351
|
+
|
|
352
|
+
- notice\_url?: string | string\[]
|
|
353
|
+
|
|
354
|
+
**웹훅 수신 URL**
|
|
355
|
+
|
|
356
|
+
- custom\_data?: object
|
|
357
|
+
|
|
358
|
+
**가맹점 커스텀 데이터**
|
|
359
|
+
|
|
300
360
|
- naverProductCode: string
|
|
301
361
|
|
|
302
362
|
**고객사의 상품코드**
|