@portone/mcp-server 0.15.0-alpha.0 → 0.15.0-alpha.1
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/content61.md +0 -2
- package/assets/docs/help/core-service/channel-setting/eximbay.md +216 -15
- package/assets/docs/help/core-service/how-to-use/eximbay-contract.md +1 -1
- package/assets/docs/help/core-service/how-to-use/high-risk-industry.md +1 -1
- package/assets/docs/help/core-service/how-to-use/information-pg.md +0 -6
- package/assets/docs/help/core-service/how-to-use/kakao-contract.md +2 -2
- package/assets/docs/help/core-service/how-to-use/nice-contract.md +1 -1
- package/assets/docs/help/core-service/how-to-use/shopify-guide.md +1 -1
- package/assets/docs/help/core-service/payment-type/payletter-international.md +3 -2
- package/assets/docs/help/core-service/payment-type/paypal-payment-status.md +3 -3
- package/assets/docs/help/faq/console-faq/change-console-url.md +2 -0
- package/assets/docs/help/notice-v1-api-2025-11-24.md +78 -0
- package/assets/docs/help/notice-v1-api-2025-11-25.md +59 -0
- package/assets/docs/help/pricing/pg/domestic-and-oversea-fees.md +1 -1
- package/assets/docs/help/pricing/portone/portone-pricing.md +1 -1
- package/assets/docs/help/procedure/recommendation/package.md +10 -4
- package/assets/docs/opi/ko/etc/recon.md +1 -1
- package/assets/docs/opi/ko/extra/smart-routing/intro.md +0 -1
- package/assets/docs/opi/ko/integration/pg/v1/danal.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +2 -2
- package/assets/docs/opi/ko/integration/pg/v1/inicis.md +2 -2
- package/assets/docs/opi/ko/integration/pg/v1/ksnet/readme.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/newtoss/readme.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp.md +37 -10
- package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/nice.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md +7 -2
- package/assets/docs/opi/ko/integration/pg/v1/readme.md +0 -2
- package/assets/docs/opi/ko/integration/pg/v1/rt/readme.md +3 -3
- package/assets/docs/opi/ko/integration/pg/v1/rt/warning.md +2 -2
- package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/smartro-v2/caution.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/tosspay-v2/readme.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v2/eximbay-v2.md +2 -0
- package/assets/docs/opi/ko/integration/pg/v2/hyphen.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v2/payletter-global.md +8 -1
- package/assets/docs/opi/ko/integration/pg/v2/paypal-v2.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v2/readme.md +0 -8
- package/assets/docs/opi/ko/integration/pg/v2/tosspayments.md +1 -1
- package/assets/docs/opi/ko/integration/ready/readme.md +18 -32
- package/assets/docs/opi/ko/integration/start/v2/readme.md +0 -1
- package/assets/docs/opi/ko/integration/webhook/readme-v2.md +2 -2
- package/assets/docs/opi/ko/quick-guide/payment.md +9 -61
- package/assets/docs/release-notes/api-sdk/2024-09-27.md +3 -3
- package/assets/docs/schema/browser-sdk.schema.json +510 -0
- package/assets/docs/schema/v1.openapi.json +694 -683
- package/assets/docs/schema/v1.openapi.yml +940 -1550
- package/assets/docs/schema/v2.openapi.json +2795 -1928
- package/assets/docs/schema/v2.openapi.yml +2647 -1237
- package/assets/docs/sdk/ko/v2-mobile-sdk/android.md +1 -1
- package/assets/docs/v1-docs-full.md +46 -259
- package/assets/docs/v2-docs-full.md +44 -321
- package/assets/docs/website-links.md +1 -3
- package/manifest.json +1 -1
- package/package.json +1 -1
- package/server/index.js +1 -1
- package/assets/docs/api/rest-v1/_components/v1auth.md +0 -103
- package/assets/docs/help/core-service/payment-type/tosspayments-easypay-hub-fee.md +0 -42
- package/assets/docs/opi/ko/integration/ready/_components/integration-guide/hyphen.md +0 -27
- package/assets/docs/opi/ko/integration/ready/_components/integration-guide/inicis.md +0 -64
- package/assets/docs/opi/ko/integration/ready/_components/integration-guide/kcp-v2.md +0 -70
- package/assets/docs/opi/ko/integration/ready/_components/integration-guide/paypal-v2.md +0 -25
- package/assets/docs/opi/ko/integration/ready/_components/integration-guide/tosspayments.md +0 -15
- package/assets/docs/opi/ko/integration/start/_components/sdk-installation.md +0 -71
- package/assets/docs/sdk/ko/v2-sdk/_components/sdk-installation.md +0 -71
|
@@ -96,7 +96,6 @@
|
|
|
96
96
|
- [키움페이 (다우데이타/페이조아)](https://developers.portone.io/opi/ko/integration/pg/v1/daou/readme): 키움페이 연동 방법을 안내합니다.
|
|
97
97
|
- [키움페이 유의사항](https://developers.portone.io/opi/ko/integration/pg/v1/daou/undefined): 결제 연동시 유의사항을 안내합니다.
|
|
98
98
|
- [엑심베이](https://developers.portone.io/opi/ko/integration/pg/v1/eximbay): 엑심베이 결제 연동 방법을 안내합니다.
|
|
99
|
-
- [하이픈](https://developers.portone.io/opi/ko/integration/pg/v1/hyphen): 하이픈 결제 연동 방법을 안내합니다.
|
|
100
99
|
- [KG이니시스](https://developers.portone.io/opi/ko/integration/pg/v1/inicis): KG이니시스 결제창 연동 가이드입니다.
|
|
101
100
|
- [카카오페이](https://developers.portone.io/opi/ko/integration/pg/v1/kakaopay): 카카오페이 연동 방법을 안내합니다.
|
|
102
101
|
- [NHN KCP(신모듈) 본인인증 연동하기](https://developers.portone.io/opi/ko/integration/pg/v1/kcp-v2-identity-verification): NHN KCP(신모듈) 본인인증 연동 방법을 안내합니다.
|
|
@@ -3517,7 +3516,7 @@ IMP.request_pay(
|
|
|
3517
3516
|
- trans (실시간 계좌이체)
|
|
3518
3517
|
- vbank(가상계좌)
|
|
3519
3518
|
- phone(휴대폰 소액결제) : 휴대폰 결제인 경우 pg 파라미터는 **`danal`** 로 지정하면 됩니다.
|
|
3520
|
-
- cultureland (문화상품권)
|
|
3519
|
+
- cultureland (컬쳐랜드 문화상품권)
|
|
3521
3520
|
- booknlife (도서문화상품권)
|
|
3522
3521
|
|
|
3523
3522
|
- merchant\_uid: string
|
|
@@ -3952,7 +3951,7 @@ IMP.request_pay(
|
|
|
3952
3951
|
- payco (페이코)
|
|
3953
3952
|
- samsung (삼성페이)
|
|
3954
3953
|
- applepay (애플페이)
|
|
3955
|
-
- cultureland (문화상품권)
|
|
3954
|
+
- cultureland (컬쳐랜드 문화상품권)
|
|
3956
3955
|
- smartculture (스마트문화상품권)
|
|
3957
3956
|
- booknlife (도서문화상품권)
|
|
3958
3957
|
|
|
@@ -4052,7 +4051,7 @@ curl -H "Content-Type: application/json" \
|
|
|
4052
4051
|
|
|
4053
4052
|
**빌링키로 결제 요청하기**
|
|
4054
4053
|
|
|
4055
|
-
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서
|
|
4054
|
+
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서 빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
|
|
4056
4055
|
|
|
4057
4056
|
```sh
|
|
4058
4057
|
curl -H "Content-Type: application/json" \
|
|
@@ -4631,206 +4630,6 @@ IMP.request_pay({
|
|
|
4631
4630
|
</div>
|
|
4632
4631
|
|
|
4633
4632
|
|
|
4634
|
-
# https://developers.portone.io/opi/ko/integration/pg/v1/hyphen
|
|
4635
|
-
|
|
4636
|
-
---
|
|
4637
|
-
title: 하이픈
|
|
4638
|
-
description: 하이픈 결제 연동 방법을 안내합니다.
|
|
4639
|
-
targetVersions:
|
|
4640
|
-
- v1
|
|
4641
|
-
versionVariants:
|
|
4642
|
-
v2: /opi/ko/integration/pg/v2/hyphen
|
|
4643
|
-
---
|
|
4644
|
-
|
|
4645
|
-
## 채널 설정하기
|
|
4646
|
-
|
|
4647
|
-
- [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기)의 내용을 참고하여 PG 설정을 진행합니다.
|
|
4648
|
-
|
|
4649
|
-
## 가능한 결제 수단
|
|
4650
|
-
|
|
4651
|
-
- 간편 결제
|
|
4652
|
-
|
|
4653
|
-
하이픈은 계좌 간편 결제를 전용으로 지원하는 PG사로, 등록한 계좌를 이용한 결제만 가능하며 다른 결제 수단은 지원하지 않습니다.
|
|
4654
|
-
|
|
4655
|
-
따라서 `pay_method` 파라미터를 아래와 같이 설정해야 합니다.
|
|
4656
|
-
|
|
4657
|
-
- 계좌이체 : `trans`
|
|
4658
|
-
|
|
4659
|
-
### 계좌 간편 결제란?
|
|
4660
|
-
|
|
4661
|
-
고객이 PG사에서 제공하는 결제 페이지에서 본인 명의의 계좌를 등록하고, 상품 구매 시 비밀번호 인증 등을 통해 등록된 계좌에서 출금하여 결제하는 서비스를 의미합니다.
|
|
4662
|
-
|
|
4663
|
-
### 계좌 간편 결제의 장점
|
|
4664
|
-
|
|
4665
|
-
계좌 간편 결제는 아래와 같은 장점을 제공합니다.
|
|
4666
|
-
|
|
4667
|
-
1. **우수한 사용성**
|
|
4668
|
-
|
|
4669
|
-
보안 프로그램이나 추가 앱 설치 과정이 필요하지 않습니다.
|
|
4670
|
-
또한 복잡한 계좌 입력이나 인증 과정 없이 최초 한 번만 계좌를 등록하고 이후에는 비밀번호를 통해 간편하게 인증할 수 있습니다.
|
|
4671
|
-
|
|
4672
|
-
2. **낮은 수수료**
|
|
4673
|
-
|
|
4674
|
-
바로 계좌 결제는 오픈 뱅킹 기반의 계좌 이체 서비스로, 신용카드 결제에 비해 낮은 수수료로 해당 서비스를 이용할 수 있습니다.
|
|
4675
|
-
|
|
4676
|
-
3. **빠른 정산 주기**
|
|
4677
|
-
|
|
4678
|
-
하이픈의 계좌 간편 결제 서비스는 통상 D+2일 주기로 정산을 해드리고 있습니다. 빠른 정산을 통해 현금 흐름을 효율적으로 관리할 수 있습니다.
|
|
4679
|
-
|
|
4680
|
-
## SDK 결제 요청하기
|
|
4681
|
-
|
|
4682
|
-
하이픈 결제는 최신 SDK에서만 지원됩니다.
|
|
4683
|
-
|
|
4684
|
-
```html title="JS SDK"
|
|
4685
|
-
<script src="https://cdn.iamport.kr/v1/iamport.js"></script>
|
|
4686
|
-
```
|
|
4687
|
-
|
|
4688
|
-
[JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
|
|
4689
|
-
결제창을 호출할 수 있습니다. **결제결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
|
|
4690
|
-
**callback**으로 수신되고
|
|
4691
|
-
모바일의 경우 **m\_redirect\_url** 로 리디렉션됩니다.
|
|
4692
|
-
|
|
4693
|
-
하이픈 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
4694
|
-
|
|
4695
|
-
<div class="tabs-container">
|
|
4696
|
-
|
|
4697
|
-
<div class="tabs-content" data-title="SDK 결제 요청">
|
|
4698
|
-
|
|
4699
|
-
```ts
|
|
4700
|
-
IMP.request_pay(
|
|
4701
|
-
{
|
|
4702
|
-
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
4703
|
-
pay_method: "trans",
|
|
4704
|
-
merchant_uid: "orderMonthly0001", // 상점에서 관리하는 주문 번호
|
|
4705
|
-
name: "테스트결제",
|
|
4706
|
-
buyer_email: "test@portone.io",
|
|
4707
|
-
buyer_name: "포트원",
|
|
4708
|
-
buyer_tel: "02-1234-1234",
|
|
4709
|
-
m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}",
|
|
4710
|
-
amount: 1004,
|
|
4711
|
-
storeDetails: {
|
|
4712
|
-
businessName: "상호명",
|
|
4713
|
-
},
|
|
4714
|
-
bypass: {
|
|
4715
|
-
hyphen: {
|
|
4716
|
-
designCd: "#C1272C",
|
|
4717
|
-
},
|
|
4718
|
-
},
|
|
4719
|
-
},
|
|
4720
|
-
function (rsp) {
|
|
4721
|
-
// callback 로직
|
|
4722
|
-
},
|
|
4723
|
-
);
|
|
4724
|
-
```
|
|
4725
|
-
|
|
4726
|
-
</div>
|
|
4727
|
-
|
|
4728
|
-
</div>
|
|
4729
|
-
|
|
4730
|
-
### 주요 파라미터
|
|
4731
|
-
|
|
4732
|
-
- channelKey: string
|
|
4733
|
-
|
|
4734
|
-
**채널키**
|
|
4735
|
-
|
|
4736
|
-
결제를 진행할 채널을 지정합니다.
|
|
4737
|
-
|
|
4738
|
-
포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
|
|
4739
|
-
|
|
4740
|
-
(최신 JavaScript SDK 버전부터 사용 가능합니다.)
|
|
4741
|
-
|
|
4742
|
-
- pg?: string
|
|
4743
|
-
|
|
4744
|
-
**PG사 구분코드**
|
|
4745
|
-
|
|
4746
|
-
`hyphen.{MID}` 형태로 지정하여 사용해야 합니다.
|
|
4747
|
-
|
|
4748
|
-
<div class="hint" data-style="warning">
|
|
4749
|
-
|
|
4750
|
-
`pg` 파라미터는 지원 중단 예정입니다.
|
|
4751
|
-
|
|
4752
|
-
JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
|
|
4753
|
-
|
|
4754
|
-
</div>
|
|
4755
|
-
|
|
4756
|
-
- pay\_method: string
|
|
4757
|
-
|
|
4758
|
-
**결제수단 구분코드**
|
|
4759
|
-
|
|
4760
|
-
하이픈의 경우 `trans`만 지원됩니다.
|
|
4761
|
-
|
|
4762
|
-
- merchant\_uid: string
|
|
4763
|
-
|
|
4764
|
-
**고객사 주문 고유 번호**
|
|
4765
|
-
|
|
4766
|
-
고객사에서 채번하는 주문 고유 번호로 매번 고유하게 채번되어야 합니다.
|
|
4767
|
-
이미 승인 완료된 `merchant_uid`로 결제를 시도하는 경우 에러가 발생합니다.
|
|
4768
|
-
|
|
4769
|
-
- name: string
|
|
4770
|
-
|
|
4771
|
-
**주문명**
|
|
4772
|
-
|
|
4773
|
-
주문명으로 고객사에서 자유롭게 입력합니다.
|
|
4774
|
-
|
|
4775
|
-
- amount: number
|
|
4776
|
-
|
|
4777
|
-
**결제 금액**
|
|
4778
|
-
|
|
4779
|
-
결제 금액으로 number 형식만 허용됩니다.
|
|
4780
|
-
|
|
4781
|
-
- buyer\_name: string
|
|
4782
|
-
|
|
4783
|
-
**구매자 이름**
|
|
4784
|
-
|
|
4785
|
-
하이픈의 경우 필수로 입력해야 합니다.
|
|
4786
|
-
|
|
4787
|
-
- storeDetails?: object
|
|
4788
|
-
|
|
4789
|
-
**상점 정보**
|
|
4790
|
-
|
|
4791
|
-
- businessName?: string
|
|
4792
|
-
|
|
4793
|
-
**상호명**
|
|
4794
|
-
|
|
4795
|
-
- 결제창에 표시될 상호명입니다. 입력하지 않으면 포트원 대표상점명으로 표시됩니다.
|
|
4796
|
-
|
|
4797
|
-
- bypass?: oneof object
|
|
4798
|
-
|
|
4799
|
-
**PG사 결제창 호출 시 PG사로 그대로 bypass할 파라미터들의 모음**
|
|
4800
|
-
|
|
4801
|
-
- hyphen?: object
|
|
4802
|
-
|
|
4803
|
-
**하이픈에서 제공하는 파라미터 모음**
|
|
4804
|
-
|
|
4805
|
-
- designCd?: string
|
|
4806
|
-
|
|
4807
|
-
**결제창 디자인 색상 코드**
|
|
4808
|
-
|
|
4809
|
-
- `#`으로 시작하는 여섯자리 Hex 값을 입력합니다. (ex. `#C1272C`)
|
|
4810
|
-
|
|
4811
|
-
### 유의사항
|
|
4812
|
-
|
|
4813
|
-
<details>
|
|
4814
|
-
|
|
4815
|
-
<summary>`merchant_uid` 허용 문자 및 길이 제한</summary>
|
|
4816
|
-
|
|
4817
|
-
`merchant_uid` 에는 영문, 숫자, `_`(underscore) 만으로 이루어진 문자열만 입력할 수 있습니다.
|
|
4818
|
-
|
|
4819
|
-
여기에 포함되지 않는 한글이나 `♤`, `♡`, `♧` 등의 특수 문자는 허용되지 않습니다.
|
|
4820
|
-
|
|
4821
|
-
또한 `merchant_uid`의 최대 길이는 40자이므로, 해당 길이를 넘지 않는 값으로 결제를 요청해주세요.
|
|
4822
|
-
|
|
4823
|
-
</details>
|
|
4824
|
-
|
|
4825
|
-
<details>
|
|
4826
|
-
|
|
4827
|
-
<summary>`name` 길이 제한</summary>
|
|
4828
|
-
|
|
4829
|
-
`name`의 최대 길이는 40자입니다.
|
|
4830
|
-
|
|
4831
|
-
</details>
|
|
4832
|
-
|
|
4833
|
-
|
|
4834
4633
|
# https://developers.portone.io/opi/ko/integration/pg/v1/inicis
|
|
4835
4634
|
|
|
4836
4635
|
---
|
|
@@ -4945,7 +4744,7 @@ IMP.request_pay(
|
|
|
4945
4744
|
- `trans` (실시간 계좌이체)
|
|
4946
4745
|
- `vbank`(가상계좌)
|
|
4947
4746
|
- `phone` (휴대폰소액결제)
|
|
4948
|
-
- `cultureland` (문화상품권)
|
|
4747
|
+
- `cultureland` (컬쳐랜드 문화상품권)
|
|
4949
4748
|
- `smartculture` (스마트문상)
|
|
4950
4749
|
- `booknlife`(도서문화상품권)
|
|
4951
4750
|
|
|
@@ -5110,7 +4909,7 @@ curl -H "Content-Type: application/json" \
|
|
|
5110
4909
|
|
|
5111
4910
|
**빌링키로 결제 요청하기**
|
|
5112
4911
|
|
|
5113
|
-
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서
|
|
4912
|
+
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서 빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
|
|
5114
4913
|
|
|
5115
4914
|
```sh
|
|
5116
4915
|
curl -H "Content-Type: application/json" \
|
|
@@ -6539,7 +6338,7 @@ curl -H "Content-Type: application/json" \
|
|
|
6539
6338
|
|
|
6540
6339
|
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다.
|
|
6541
6340
|
보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서
|
|
6542
|
-
|
|
6341
|
+
빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
|
|
6543
6342
|
|
|
6544
6343
|
```sh
|
|
6545
6344
|
curl -H "Content-Type: application/json" \
|
|
@@ -7862,7 +7661,7 @@ curl -H "Content-Type: application/json" \
|
|
|
7862
7661
|
|
|
7863
7662
|
**빌링키로 결제 요청하기**
|
|
7864
7663
|
|
|
7865
|
-
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서
|
|
7664
|
+
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서 빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
|
|
7866
7665
|
|
|
7867
7666
|
```sh
|
|
7868
7667
|
curl -H "Content-Type: application/json" \
|
|
@@ -9804,7 +9603,7 @@ targetVersions:
|
|
|
9804
9603
|
|
|
9805
9604
|
## 비인증 결제
|
|
9806
9605
|
|
|
9807
|
-
(신) 나이스정보통신은 발급 된 빌링키로
|
|
9606
|
+
(신) 나이스정보통신은 발급 된 빌링키로 결제(`POST /subscribe/payments/again`),
|
|
9808
9607
|
키인 결제(`POST /subscribe/payments/onetime`) 그리고 스케줄 결제(`POST /subscribe/payments/schedule`)를
|
|
9809
9608
|
모두 지원하며 기본 파라미터 외에 아래 3개의 파라미터를 추가로 지원합니다.
|
|
9810
9609
|
|
|
@@ -10908,7 +10707,7 @@ curl -H "Content-Type: application/json" \
|
|
|
10908
10707
|
|
|
10909
10708
|
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다.
|
|
10910
10709
|
보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서
|
|
10911
|
-
|
|
10710
|
+
빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
|
|
10912
10711
|
|
|
10913
10712
|
```sh
|
|
10914
10713
|
curl -H "Content-Type: application/json" \
|
|
@@ -11345,11 +11144,16 @@ SDK 스크립트의 주소가 `https://cdn.iamport.kr/v1/iamport.js` 인지 확
|
|
|
11345
11144
|
|
|
11346
11145
|
</div>
|
|
11347
11146
|
|
|
11147
|
+
## 결제수단별 승인 가능 통화
|
|
11148
|
+
|
|
11149
|
+
- 카드: `KRW`, `USD`, `JPY`
|
|
11150
|
+
- Alipay: `USD`, `CNY`
|
|
11151
|
+
- WeChatPay: `KRW`, `USD`, `CNY`
|
|
11152
|
+
|
|
11348
11153
|
## 유의사항
|
|
11349
11154
|
|
|
11350
11155
|
- `merchant_uid` 에는 영문, 숫자만으로 이루어진 문자열만 입력할 수 있습니다.
|
|
11351
|
-
- 페이레터의 경우 구매자 이메일을 필수로
|
|
11352
|
-
- 해외결제시 카드는 `KRW`, `USD`, `JPY`, 알리페이⋅위챗페이는 `CNY`를 지원합니다.
|
|
11156
|
+
- 페이레터의 경우 구매자 이메일을 필수로 받고 있어,`buyer_email`을 필수로 입력하셔야 합니다.
|
|
11353
11157
|
- WeChatPay, Alipay 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
|
|
11354
11158
|
|
|
11355
11159
|
|
|
@@ -11864,8 +11668,6 @@ versionVariants:
|
|
|
11864
11668
|
|
|
11865
11669
|
[토스페이먼츠 브랜드페이](https://developers.portone.io/opi/ko/integration/pg/v1/toss-brandpay/readme)
|
|
11866
11670
|
|
|
11867
|
-
[하이픈](https://developers.portone.io/opi/ko/integration/pg/v1/hyphen)
|
|
11868
|
-
|
|
11869
11671
|
## 해외결제
|
|
11870
11672
|
|
|
11871
11673
|
[엑심베이](https://developers.portone.io/opi/ko/integration/pg/v1/eximbay)
|
|
@@ -12125,10 +11927,10 @@ status가 cancelled 이고 cancel\_history에 취소 요청 내역이 있는 경
|
|
|
12125
11927
|
|
|
12126
11928
|
페이팔은 이상 거래를 줄이기 위해 Risk Data Acquisition 정책을 시행하고 있습니다.
|
|
12127
11929
|
일반 결제나 빌링키 발급은 페이팔 버튼을 통해 진행되기 때문에 페이팔이 이상 거래 판단을 위한 구매자 접속 정보를 얻을 수 있지만,
|
|
12128
|
-
발급 된 빌링키로
|
|
11930
|
+
발급 된 빌링키로 결제 (again API 호출) 할때는 고객사 서버에서 포트원 API를 통해 페이팔 API가 호출되는 구조이기 때문에
|
|
12129
11931
|
이상 거래 판단을 위한 구매자 접속 정보를 얻을 수 없습니다.
|
|
12130
11932
|
|
|
12131
|
-
따라서 발급 된 빌링키로
|
|
11933
|
+
따라서 발급 된 빌링키로 결제를 할때는 구매자의 브라우저/디바이스 접속 정보를 페이팔에 전달할 수 있도록
|
|
12132
11934
|
**again API가 호출되는 고객사 클라이언트 페이지에 반드시 페이팔 Fraudnet 스크립트/Magnes SDK를 아래와 같이 추가해야** 합니다.
|
|
12133
11935
|
|
|
12134
11936
|
**페이팔 정기결제를 통한 again API 호출시에는 Magnes & Fraudnet 조치가
|
|
@@ -12218,7 +12020,7 @@ STC 기능을 사용하시기 위해 다음 정보를 확인하셔야 합니다.
|
|
|
12218
12020
|
|
|
12219
12021
|
1. 페이팔 Business 계정 가입시 산업 종류(Industry)를 결정하는데, 계정의 산업 종류를 확인해야 합니다.
|
|
12220
12022
|
|
|
12221
|
-
2. 계정의 산업 종류를 확인하신 뒤, loadUI 호출 해 빌링키를 발급 받을때 그리고 발급 된 빌링키로
|
|
12023
|
+
2. 계정의 산업 종류를 확인하신 뒤, loadUI 호출 해 빌링키를 발급 받을때 그리고 발급 된 빌링키로 결제(again API 호출)할 때
|
|
12222
12024
|
모두 bypass.paypal\_v2 객체에 아래와 같은 형식으로 전달해주셔야 합니다.
|
|
12223
12025
|
|
|
12224
12026
|
<details>
|
|
@@ -12426,10 +12228,10 @@ GET /subscribe/customers/{customer_uid}
|
|
|
12426
12228
|
페이팔은 이상 거래를 줄이기 위해 Risk Data Acquisition 정책을 시행하고 있습니다.
|
|
12427
12229
|
일반 결제나 빌링키 발급은 페이팔 버튼을 통해 진행되기 때문에
|
|
12428
12230
|
페이팔이 이상 거래 판단을 위한 구매자 접속 정보를 얻을 수 있지만,
|
|
12429
|
-
브라우저에서 발급 된 빌링키로
|
|
12231
|
+
브라우저에서 발급 된 빌링키로 결제 (again API 호출) 할때는 고객사 브라우저에서 포트원 API를 통해
|
|
12430
12232
|
페이팔 API가 호출되는 구조이기 때문에 이상 거래 판단을 위한 구매자 접속 정보를 얻을 수 없습니다.
|
|
12431
12233
|
|
|
12432
|
-
따라서 발급 된 빌링키로
|
|
12234
|
+
따라서 발급 된 빌링키로 결제를 할때는 구매자의 브라우저/디바이스 접속 정보를
|
|
12433
12235
|
페이팔에 전달할 수 있도록 **again API가 호출되는 고객사 클라이언트 페이지에
|
|
12434
12236
|
반드시 페이팔 Fraudnet 스크립트/Magnes SDK를 아래와 같이 추가해야** 합니다.
|
|
12435
12237
|
|
|
@@ -13167,7 +12969,7 @@ curl -H "Content-Type: application/json" \
|
|
|
13167
12969
|
|
|
13168
12970
|
**빌링키로 결제 요청하기**
|
|
13169
12971
|
|
|
13170
|
-
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서
|
|
12972
|
+
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서 빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
|
|
13171
12973
|
|
|
13172
12974
|
```sh
|
|
13173
12975
|
curl -H "Content-Type: application/json" \
|
|
@@ -13778,7 +13580,7 @@ PortOne.requestPayment({
|
|
|
13778
13580
|
### 주문 번호에 특수문자 입력 불가능
|
|
13779
13581
|
|
|
13780
13582
|
스마트로는 주문 번호(`merchant_uid`)에 특수문자를 허용하고 있지 않습니다.
|
|
13781
|
-
따라서 결제창에서 일반결제를 할 때와 발급된 빌링키로 API를 통해
|
|
13583
|
+
따라서 결제창에서 일반결제를 할 때와 발급된 빌링키로 API를 통해 결제를 하는 경우
|
|
13782
13584
|
숫자, 문자(알파벳 소문자와 대문자) 또는 그 조합으로 이루어진 주문 번호를 사용해주세요.
|
|
13783
13585
|
|
|
13784
13586
|
### 주문 번호 40자 길이 제한
|
|
@@ -17097,7 +16899,7 @@ IMP.request_pay(
|
|
|
17097
16899
|
|
|
17098
16900
|
**빌링키로 결제 요청하기**
|
|
17099
16901
|
|
|
17100
|
-
빌링키 발급 시 전달한 `customer_uid`를 이용해서
|
|
16902
|
+
빌링키 발급 시 전달한 `customer_uid`를 이용해서 빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
|
|
17101
16903
|
|
|
17102
16904
|
```ts
|
|
17103
16905
|
await fetch("https://api.iamport.kr/subscribe/payments/again", {
|
|
@@ -23369,7 +23171,7 @@ description: >-
|
|
|
23369
23171
|
- 포트원을 통해 연동된 아래 12개의 PG사 내역을 조회할 수 있습니다.
|
|
23370
23172
|
- 지원 PG : **KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜**
|
|
23371
23173
|
- 고객사가 포트원을 통하지 않고 PG 직연동한 경우 지원 불가
|
|
23372
|
-
- 9/26 이후 지원 예정 PG사 : KPN,
|
|
23174
|
+
- 9/26 이후 지원 예정 PG사 : KPN, KSNET
|
|
23373
23175
|
|
|
23374
23176
|
- 고객사 주문번호를 정확하게 확인하기 위해서는 **실제 사용하시는 주문번호의 연동**이 필요합니다.
|
|
23375
23177
|
|
|
@@ -26381,7 +26183,6 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
26381
26183
|
- **이지페이(KICC)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
26382
26184
|
- **웰컴페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
26383
26185
|
- **엑심베이** : 카드
|
|
26384
|
-
- **하이픈** : 실시간 계좌이체
|
|
26385
26186
|
|
|
26386
26187
|
### API 수기(키인)결제
|
|
26387
26188
|
|
|
@@ -27333,38 +27134,6 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
|
|
|
27333
27134
|
|
|
27334
27135
|
<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
|
|
27335
27136
|
|
|
27336
|
-
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
|
|
27337
|
-
|
|
27338
|
-
<details>
|
|
27339
|
-
|
|
27340
|
-
<summary>하이픈</summary>
|
|
27341
|
-
|
|
27342
|
-
1. [HYPHEN PAY & 바로계좌결제 운영 백오피스](http://payadmin.hyphen.im/) 접속 후 **바로계좌결제** 선택 후
|
|
27343
|
-
로그인을 합니다.
|
|
27344
|
-
|
|
27345
|
-
(이미지 첨부: HYPHEN 백오피스 로그인 화면)
|
|
27346
|
-
|
|
27347
|
-
2. \[상점관리]→\[바로계좌결제 상점정보관리]를 클릭합니다.
|
|
27348
|
-
|
|
27349
|
-
3. 상점명을 클릭합니다.
|
|
27350
|
-
|
|
27351
|
-
(이미지 첨부: HYPHEN \[상점관리] - \[상점정보관리] 예시 화면)
|
|
27352
|
-
|
|
27353
|
-
4. \[상점 기본정보]에서 \[상점번호]를 확인합니다.
|
|
27354
|
-
|
|
27355
|
-
(이미지 첨부: HYPHEN \[상점 기본정보] 예시 화면)
|
|
27356
|
-
|
|
27357
|
-
5. \[암호화 키, 토큰]에서 \[암호화 키]와 \[암호화 토큰]을 확인합니다.
|
|
27358
|
-
|
|
27359
|
-
(이미지 첨부: HYPHEN \[암호화 키, 토큰] 예시 화면)
|
|
27360
|
-
|
|
27361
|
-
6. 포트원 콘솔에서 채널 추가 시 \[PG상점아이디(상점 번호)], \[암호화 키], \[암호화 토큰]을
|
|
27362
|
-
입력한 후 \[저장]을 클릭합니다.
|
|
27363
|
-
|
|
27364
|
-
</details>
|
|
27365
|
-
|
|
27366
|
-
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
|
|
27367
|
-
|
|
27368
27137
|
#### 해외 결제대행사
|
|
27369
27138
|
|
|
27370
27139
|
<details>
|
|
@@ -27402,6 +27171,24 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
|
|
|
27402
27171
|
|
|
27403
27172
|
3. 포트원 콘솔에서 채널 추가 시 \[Project Key], \[Secret Key]를 입력한 후 `저장`을 클릭합니다.
|
|
27404
27173
|
|
|
27174
|
+
#### 핑백(Pingback) URL 설정하기
|
|
27175
|
+
|
|
27176
|
+
페이먼트월에서 포트원으로 결제 결과를 전달받기 위해 핑백 URL을 설정해야 합니다.
|
|
27177
|
+
|
|
27178
|
+
1. [페이먼트월](https://api.paymentwall.com/developers/applications) 페이지에서 \[My Projects]를 클릭합니다.
|
|
27179
|
+
|
|
27180
|
+
(이미지 첨부: 페이먼트월 My Projects 메뉴)
|
|
27181
|
+
|
|
27182
|
+
2. 사용할 프로젝트의 \[Settings] 탭을 클릭합니다.
|
|
27183
|
+
|
|
27184
|
+
(이미지 첨부: 페이먼트월 프로젝트 setting 탭)
|
|
27185
|
+
|
|
27186
|
+
3. \[Pingback type]을 `URL`로 선택합니다.
|
|
27187
|
+
4. \[Pingback URL]에 `https://service.iamport.kr/paymentwall/webhook`를 입력합니다.
|
|
27188
|
+
5. \[Pingback signature version]을 `3`으로 설정합니다.
|
|
27189
|
+
|
|
27190
|
+
(이미지 첨부: 페이먼트월 Pingback 설정 화면)
|
|
27191
|
+
|
|
27405
27192
|
</details>
|
|
27406
27193
|
|
|
27407
27194
|
<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
|
|
@@ -32649,11 +32436,11 @@ writtenAt: 2024-09-30T00:00:00.000Z
|
|
|
32649
32436
|
PG 거래대사 내의 **거래 정산 내역** 메뉴에서 정산일 또는 거래일을 기준으로,
|
|
32650
32437
|
**거래 건별 조회** 메뉴에서는 정산일을 기준으로 최대 3개월 분량의 데이터를 엑셀로 다운로드할 수 있습니다.
|
|
32651
32438
|
|
|
32652
|
-
### **PG 거래대사**✔️ KSNET, KPN
|
|
32439
|
+
### **PG 거래대사**✔️ KSNET, KPN에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다.
|
|
32653
32440
|
|
|
32654
32441
|
기존에 12개 PG사 (KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠,
|
|
32655
|
-
토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN
|
|
32656
|
-
총
|
|
32442
|
+
토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN까지 확장하여
|
|
32443
|
+
총 14개 PG사 데이터에 한하여 제공됩니다.
|
|
32657
32444
|
|
|
32658
32445
|
(참고 : PG 거래대사 메뉴의 경우 클로즈 베타로 운영되고 있으며,
|
|
32659
32446
|
사용을 원하시는 고객께서는 [PG거래대사 베타서비스 신청 바로가기](https://forms.gle/cZAqJLGqovC1STrS8)에서 신청해 주시길 바랍니다.)
|