@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.
Files changed (65) hide show
  1. package/assets/docs/help/content61.md +0 -2
  2. package/assets/docs/help/core-service/channel-setting/eximbay.md +216 -15
  3. package/assets/docs/help/core-service/how-to-use/eximbay-contract.md +1 -1
  4. package/assets/docs/help/core-service/how-to-use/high-risk-industry.md +1 -1
  5. package/assets/docs/help/core-service/how-to-use/information-pg.md +0 -6
  6. package/assets/docs/help/core-service/how-to-use/kakao-contract.md +2 -2
  7. package/assets/docs/help/core-service/how-to-use/nice-contract.md +1 -1
  8. package/assets/docs/help/core-service/how-to-use/shopify-guide.md +1 -1
  9. package/assets/docs/help/core-service/payment-type/payletter-international.md +3 -2
  10. package/assets/docs/help/core-service/payment-type/paypal-payment-status.md +3 -3
  11. package/assets/docs/help/faq/console-faq/change-console-url.md +2 -0
  12. package/assets/docs/help/notice-v1-api-2025-11-24.md +78 -0
  13. package/assets/docs/help/notice-v1-api-2025-11-25.md +59 -0
  14. package/assets/docs/help/pricing/pg/domestic-and-oversea-fees.md +1 -1
  15. package/assets/docs/help/pricing/portone/portone-pricing.md +1 -1
  16. package/assets/docs/help/procedure/recommendation/package.md +10 -4
  17. package/assets/docs/opi/ko/etc/recon.md +1 -1
  18. package/assets/docs/opi/ko/extra/smart-routing/intro.md +0 -1
  19. package/assets/docs/opi/ko/integration/pg/v1/danal.md +1 -1
  20. package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +2 -2
  21. package/assets/docs/opi/ko/integration/pg/v1/inicis.md +2 -2
  22. package/assets/docs/opi/ko/integration/pg/v1/ksnet/readme.md +1 -1
  23. package/assets/docs/opi/ko/integration/pg/v1/newtoss/readme.md +1 -1
  24. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp.md +37 -10
  25. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md +1 -1
  26. package/assets/docs/opi/ko/integration/pg/v1/nice.md +1 -1
  27. package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md +7 -2
  28. package/assets/docs/opi/ko/integration/pg/v1/readme.md +0 -2
  29. package/assets/docs/opi/ko/integration/pg/v1/rt/readme.md +3 -3
  30. package/assets/docs/opi/ko/integration/pg/v1/rt/warning.md +2 -2
  31. package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md +1 -1
  32. package/assets/docs/opi/ko/integration/pg/v1/smartro-v2/caution.md +1 -1
  33. package/assets/docs/opi/ko/integration/pg/v1/tosspay-v2/readme.md +1 -1
  34. package/assets/docs/opi/ko/integration/pg/v2/eximbay-v2.md +2 -0
  35. package/assets/docs/opi/ko/integration/pg/v2/hyphen.md +1 -1
  36. package/assets/docs/opi/ko/integration/pg/v2/payletter-global.md +8 -1
  37. package/assets/docs/opi/ko/integration/pg/v2/paypal-v2.md +1 -1
  38. package/assets/docs/opi/ko/integration/pg/v2/readme.md +0 -8
  39. package/assets/docs/opi/ko/integration/pg/v2/tosspayments.md +1 -1
  40. package/assets/docs/opi/ko/integration/ready/readme.md +18 -32
  41. package/assets/docs/opi/ko/integration/start/v2/readme.md +0 -1
  42. package/assets/docs/opi/ko/integration/webhook/readme-v2.md +2 -2
  43. package/assets/docs/opi/ko/quick-guide/payment.md +9 -61
  44. package/assets/docs/release-notes/api-sdk/2024-09-27.md +3 -3
  45. package/assets/docs/schema/browser-sdk.schema.json +510 -0
  46. package/assets/docs/schema/v1.openapi.json +694 -683
  47. package/assets/docs/schema/v1.openapi.yml +940 -1550
  48. package/assets/docs/schema/v2.openapi.json +2795 -1928
  49. package/assets/docs/schema/v2.openapi.yml +2647 -1237
  50. package/assets/docs/sdk/ko/v2-mobile-sdk/android.md +1 -1
  51. package/assets/docs/v1-docs-full.md +46 -259
  52. package/assets/docs/v2-docs-full.md +44 -321
  53. package/assets/docs/website-links.md +1 -3
  54. package/manifest.json +1 -1
  55. package/package.json +1 -1
  56. package/server/index.js +1 -1
  57. package/assets/docs/api/rest-v1/_components/v1auth.md +0 -103
  58. package/assets/docs/help/core-service/payment-type/tosspayments-easypay-hub-fee.md +0 -42
  59. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/hyphen.md +0 -27
  60. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/inicis.md +0 -64
  61. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/kcp-v2.md +0 -70
  62. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/paypal-v2.md +0 -25
  63. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/tosspayments.md +0 -15
  64. package/assets/docs/opi/ko/integration/start/_components/sdk-installation.md +0 -71
  65. package/assets/docs/sdk/ko/v2-sdk/_components/sdk-installation.md +0 -71
@@ -26,7 +26,7 @@ targetVersions:
26
26
  maven {
27
27
  url = uri("https://jitpack.io")
28
28
  }
29
- }
29
+ }
30
30
  }
31
31
 
32
32
  // build.gradle.kts
@@ -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`를 이용해서 재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
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`를 이용해서 재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
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
- 재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
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`를 이용해서 재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
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
- (신) 나이스정보통신은 발급 된 빌링키로 재결제(`POST /subscribe/payemnts/again`),
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
- 재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
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
- - 페이레터의 경우 구매자 이메일을 필수로 받고있어,`buyer_email`을 필수로 입력하셔야 합니다.
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
- 발급 된 빌링키로 재결제 (again API 호출) 할때는 고객사 서버에서 포트원 API를 통해 페이팔 API가 호출되는 구조이기 때문에
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 호출 해 빌링키를 발급 받을때 그리고 발급 된 빌링키로 재결제(again API 호출)할 때
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
- 브라우저에서 발급 된 빌링키로 재결제 (again API 호출) 할때는 고객사 브라우저에서 포트원 API를 통해
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`를 이용해서 재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
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`를 이용해서 재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
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, 하이픈, KSNET
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, 하이픈에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다.
32439
+ ### **PG 거래대사**✔️ KSNET, KPN에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다.
32653
32440
 
32654
32441
  기존에 12개 PG사 (KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠,
32655
- 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN, 하이픈까지 확장하여
32656
- 15개 PG사 데이터에 한하여 제공됩니다.
32442
+ 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN까지 확장하여
32443
+ 14개 PG사 데이터에 한하여 제공됩니다.
32657
32444
 
32658
32445
  (참고 : PG 거래대사 메뉴의 경우 클로즈 베타로 운영되고 있으며,
32659
32446
  사용을 원하시는 고객께서는 [PG거래대사 베타서비스 신청 바로가기](https://forms.gle/cZAqJLGqovC1STrS8)에서 신청해 주시길 바랍니다.)