@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
@@ -70,7 +70,6 @@
70
70
  - [결제취소(환불) 연동하기](https://developers.portone.io/opi/ko/integration/cancel/v2/readme): 포트원 V2 결제취소 API를 이용한 결제취소 방법을 안내합니다.
71
71
  - [다날 본인인증](https://developers.portone.io/opi/ko/integration/pg/v2/danal-identity-verification): 다날 본인인증 연동 방법을 안내합니다.
72
72
  - [엑심베이](https://developers.portone.io/opi/ko/integration/pg/v2/eximbay-v2): 엑심베이 결제 연동 방법을 안내합니다.
73
- - [하이픈](https://developers.portone.io/opi/ko/integration/pg/v2/hyphen): 하이픈 결제 연동 방법을 안내합니다.
74
73
  - [KG이니시스 일본결제](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-jp): KG이니시스 일본결제 연동 방법을 안내합니다.
75
74
  - [KG이니시스 통합인증](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-unified-identity-verification): KG이니시스 통합인증 연동 방법을 안내합니다.
76
75
  - [KG이니시스](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-v2): KG이니시스 결제 연동 방법을 안내합니다.
@@ -2401,214 +2400,7 @@ const response = await axios({
2401
2400
 
2402
2401
  - 모바일 앱 내에서 결제를 연동할 경우 `appScheme` 파라미터를 설정하고 `bypass.eximbay_v2.settings.call_from_app` 파라미터를 "Y"로 설정해야 합니다.
2403
2402
 
2404
-
2405
- # https://developers.portone.io/opi/ko/integration/pg/v2/hyphen
2406
-
2407
- ---
2408
- title: 하이픈
2409
- description: 하이픈 결제 연동 방법을 안내합니다.
2410
- targetVersions:
2411
- - v2
2412
- versionVariants:
2413
- v1: /opi/ko/integration/pg/v1/hyphen
2414
- ---
2415
-
2416
- ## 채널 설정하기
2417
-
2418
- - [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기)의 내용을 참고하여 PG 설정을 진행합니다.
2419
-
2420
- ## 가능한 결제 수단
2421
-
2422
- - 간편 결제
2423
-
2424
- 하이픈은 계좌 간편 결제를 전용으로 지원하는 PG사로, 등록한 계좌를 이용한 결제만 가능하며 다른 결제 수단은 지원하지 않습니다.
2425
-
2426
- 따라서 `payMethod` 파라미터를 아래와 같이 설정해야 합니다.
2427
-
2428
- - 간편결제 : `EASY_PAY`
2429
-
2430
- ### 계좌 간편 결제란?
2431
-
2432
- 고객이 PG사에서 제공하는 결제 페이지에서 본인 명의의 계좌를 등록하고, 상품 구매 시 비밀번호 인증 등을 통해 등록된 계좌에서 출금하여 결제하는 서비스를 의미합니다.
2433
-
2434
- ### 계좌 간편 결제의 장점
2435
-
2436
- 계좌 간편 결제는 아래와 같은 장점을 제공합니다.
2437
-
2438
- 1. **우수한 사용성**
2439
-
2440
- 보안 프로그램이나 추가 앱 설치 과정이 필요하지 않습니다.
2441
- 또한 복잡한 계좌 입력이나 인증 과정 없이 최초 한 번만 계좌를 등록하고 이후에는 비밀번호를 통해 간편하게 인증할 수 있습니다.
2442
-
2443
- 2. **낮은 수수료**
2444
-
2445
- 바로 계좌 결제는 오픈 뱅킹 기반의 계좌 이체 서비스로, 신용카드 결제에 비해 낮은 수수료로 해당 서비스를 이용할 수 있습니다.
2446
-
2447
- 3. **빠른 정산 주기**
2448
-
2449
- 하이픈의 계좌 간편 결제 서비스는 통상 D+2일 주기로 정산을 해드리고 있습니다. 빠른 정산을 통해 현금 흐름을 효율적으로 관리할 수 있습니다.
2450
-
2451
- ## SDK 결제 요청하기
2452
-
2453
- 결제 요청 시에는 `requestPayment` 함수를 호출해야 합니다.
2454
- `channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 하이픈 채널 사용을 명시해주세요.
2455
-
2456
- 하이픈 기준으로 작성한 예시 코드는 아래와 같습니다.
2457
-
2458
- <div class="tabs-container">
2459
-
2460
- <div class="tabs-content" data-title="SDK 결제 요청">
2461
-
2462
- ```javascript
2463
- import * as PortOne from "@portone/browser-sdk/v2";
2464
- function requestPayment() {
2465
- PortOne.requestPayment({
2466
- storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요.
2467
- channelKey: "channel-key-9987cb87-6458-4888-b94e-68d9a2da896d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요.
2468
- paymentId: `payment${crypto.randomUUID()}`,
2469
- orderName: "나이키 와플 트레이너 2 SD",
2470
- totalAmount: 1000,
2471
- currency: "CURRENCY_KRW",
2472
- payMethod: "EASY_PAY",
2473
- storeDetails: {
2474
- businessName: "상호명",
2475
- },
2476
- customer: {
2477
- fullName: "포트원",
2478
- phoneNumber: "010-0000-1234",
2479
- email: "test@portone.io",
2480
- },
2481
- });
2482
- }
2483
- ```
2484
-
2485
- </div>
2486
-
2487
- </div>
2488
-
2489
- ### 주요 파라미터
2490
-
2491
- - storeId: string
2492
-
2493
- **상점 아이디**
2494
-
2495
- 포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다.
2496
-
2497
- - paymentId: string
2498
-
2499
- **고객사 주문 고유 번호**
2500
-
2501
- 고객사에서 채번하는 주문 고유 번호로 매번 고유하게 채번되어야 합니다. 이미 승인 완료된 `paymentId`로 결제를 시도하는 경우 에러가 발생합니다.
2502
-
2503
- - orderName: string
2504
-
2505
- **주문명**
2506
-
2507
- 주문명으로 고객사에서 자유롭게 입력합니다.
2508
-
2509
- - channelKey: string
2510
-
2511
- **채널 키**
2512
-
2513
- 포트원 콘솔 내 \[연동 관리] > \[연동 정보] > \[채널 관리] 화면에서 채널 추가 시 생성되는 값입니다. 결제 호출 시 채널을 지정할 때 사용됩니다.
2514
-
2515
- - totalAmount: number
2516
-
2517
- **결제 금액**
2518
-
2519
- 결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
2520
-
2521
- - currency: string
2522
-
2523
- **결제 통화**
2524
-
2525
- 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다.
2526
-
2527
- - payMethod: string
2528
-
2529
- **결제수단 구분코드**
2530
-
2531
- 결제 호출 시 결제수단을 지정할 때 사용됩니다. 하이픈의 경우 해당 값은 `EASY_PAY`로 고정해주세요.
2532
-
2533
- - customer?: object
2534
-
2535
- **고객 정보**
2536
-
2537
- - fullName?: string
2538
-
2539
- **구매자 전체 이름**
2540
-
2541
- - 하이픈의 경우 fullName 혹은 (firstName + lastName)을 필수로 입력해야 합니다.
2542
-
2543
- - firstName?: string
2544
-
2545
- **구매자 이름**
2546
-
2547
- - 하이픈의 경우 fullName 혹은 (firstName + lastName)을 필수로 입력해야 합니다.
2548
-
2549
- - lastName?: string
2550
-
2551
- **구매자 성**
2552
-
2553
- - 하이픈의 경우 fullName 혹은 (firstName + lastName)을 필수로 입력해야 합니다.
2554
-
2555
- - storeDetails?: object
2556
-
2557
- **상점 정보**
2558
-
2559
- - businessName?: string
2560
-
2561
- **상호명**
2562
-
2563
- - 결제창에 표시될 상호명입니다. 입력하지 않으면 포트원 대표상점명으로 표시됩니다.
2564
-
2565
- - bypass?: oneof object
2566
-
2567
- **PG사 결제창 호출 시 PG사로 그대로 bypass할 파라미터들의 모음**
2568
-
2569
- - hyphen?: object
2570
-
2571
- **하이픈에서 제공하는 파라미터 모음**
2572
-
2573
- - designCd?: string
2574
-
2575
- **결제창 디자인 색상 코드**
2576
-
2577
- - `#`으로 시작하는 여섯자리 Hex 값을 입력합니다. (ex. `#C1272C`)
2578
-
2579
- #### 예시 코드
2580
-
2581
- ```json title="bypass 예시 코드"
2582
- {
2583
- "bypass": {
2584
- "hyphen": {
2585
- "designCd": "#C1272C"
2586
- }
2587
- }
2588
- }
2589
- ```
2590
-
2591
- ### 유의사항
2592
-
2593
- <details>
2594
-
2595
- <summary>`paymentId` 허용 문자 및 길이 제한</summary>
2596
-
2597
- `paymentId` 에는 영문, 숫자, `_`(underscore) 만으로 이루어진 문자열만 입력할 수 있습니다.
2598
-
2599
- 여기에 포함되지 않는 한글이나 `♤`, `♡`, `♧` 등의 특수 문자는 허용되지 않습니다.
2600
-
2601
- 또한 `paymentId`의 최대 길이는 50자이므로, 해당 길이를 넘지 않는 값으로 결제를 요청해주세요.
2602
-
2603
- </details>
2604
-
2605
- <details>
2606
-
2607
- <summary>`orderName` 길이 제한</summary>
2608
-
2609
- `orderName`의 최대 길이는 100byte 입니다. (UTF-8 인코딩 기준)
2610
-
2611
- </details>
2403
+ - 엑심베이의 경우 결제창을 닫은 이후에 결제가 성공 처리될 수 있습니다. 웹훅을 연동하여 결제 실패 상태에서 결제 성공 상태로 바뀌는 경우를 처리해야 합니다.
2612
2404
 
2613
2405
 
2614
2406
  # https://developers.portone.io/opi/ko/integration/pg/v2/inicis-jp
@@ -9204,12 +8996,19 @@ targetVersions:
9204
8996
  빌링키 발급 및 결제 요청 시에는 [requestIssueBillingKeyAndPay](https://developers.portone.io/sdk/ko/v2-sdk/billing-key-and-pay-request?v=v2) 함수를 호출해야 합니다.
9205
8997
  `channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 페이레터 해외결제 채널 사용을 명시해주세요.
9206
8998
 
8999
+ ## 결제수단별 승인 가능 통화
9000
+
9001
+ - 카드: `KRW`, `USD`, `JPY`
9002
+ - Alipay: `USD`, `CNY`
9003
+ - Alipay+: `USD`
9004
+ - WeChatPay: `KRW`, `USD`, `CNY`
9005
+
9207
9006
  ## 유의사항
9208
9007
 
9209
9008
  - `paymentId` 에는 영문, 숫자만으로 이루어진 문자열만 입력할 수 있습니다.
9210
9009
  - 페이레터의 경우 구매자 이메일을 필수로 받고있어,`customer.email`을 필수로 입력하셔야 합니다.
9211
- - 해외결제시 카드는 `KRW`, `USD`, `JPY`, 알리페이⋅위챗페이는 `CNY`를 지원합니다.
9212
9010
  - WeChatPay, Alipay, Alipay+ 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
9011
+ - 페이레터의 경우 결제창을 닫은 이후에 결제가 성공 처리될 수 있습니다. 웹훅을 연동하여 결제 실패 상태에서 결제 성공 상태로 바뀌는 경우를 처리해야 합니다.
9213
9012
 
9214
9013
 
9215
9014
  # https://developers.portone.io/opi/ko/integration/pg/v2/paypal-v2
@@ -10976,7 +10775,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
10976
10775
  페이팔은 이상 거래를 줄이기 위해 Risk Data Acquisition 정책을 시행하고 있습니다.
10977
10776
  일반적으로 페이팔 창에서 진행되는 결제나 빌링키 발급은 페이팔이 구매자 접속 정보를 직접 확인하여 이상 거래를 판단합니다.
10978
10777
 
10979
- 하지만 발급된 빌링키로 브라우저에서 재결제하는 경우 \[고객사 브라우저]에서 \[포트원 API]를 통해 \[페이팔 API]가 호출되는 구조로 페이팔이 구매자 접속 정보를 직접 확인할 수 없어 이상거래를 판단하기 어렵습니다.
10778
+ 하지만 발급된 빌링키로 브라우저에서 결제하는 경우 \[고객사 브라우저]에서 \[포트원 API]를 통해 \[페이팔 API]가 호출되는 구조로 페이팔이 구매자 접속 정보를 직접 확인할 수 없어 이상거래를 판단하기 어렵습니다.
10980
10779
  따라서 구매자의 브라우저/디바이스 접속 정보를 페이팔에 전달해야 합니다.
10981
10780
  때문에 브라우저에서 발급된 빌링키를 이용하여 결제를 호출하는 경우 **고객사 클라이언트 페이지에 페이팔 Fraudnet 스크립트/Magnes SDK를 반드시 추가해야** 합니다.
10982
10781
 
@@ -11233,14 +11032,6 @@ versionVariants:
11233
11032
 
11234
11033
  - 간편결제 : 토스페이
11235
11034
 
11236
- - **하이픈**
11237
-
11238
- - 연동 기능 : 간편결제(결제창)
11239
-
11240
- - 결제 수단
11241
-
11242
- - 간편결제 : 바로계좌결제
11243
-
11244
11035
  #### 해외결제
11245
11036
 
11246
11037
  - **페이팔**
@@ -12995,7 +12786,7 @@ async function schedulePayment() {
12995
12786
  - 상품권 결제 요청 시, 사용하고자 하는 상품권 종류에 따라 아래 목록을 참고하여 `giftCertificateType` 파라미터를 입력해야 합니다.
12996
12787
  - 도서문화상품권 : `BOOKNLIFE`
12997
12788
  - 스마트문상 ((구)게임문화상품권) : `SMART_MUNSANG`
12998
- - 문화상품권 : `CULTURELAND`
12789
+ - 컬쳐랜드 문화상품권 : `CULTURELAND`
12999
12790
 
13000
12791
  - `paymentId`
13001
12792
  - 토스페이먼츠를 사용하는 경우 영문 대소문자, 숫자, 특수문자(-,\_)만 허용되며, 6자 이상 64자 이하만 가능합니다.
@@ -15455,7 +15246,6 @@ V2는 최신 결제 기능을 가장 빠르게 제공합니다.
15455
15246
  - **한국결제네트웍스(KPN)**
15456
15247
  - **NHN KCP**
15457
15248
  - **토스페이**
15458
- - **하이픈 바로계좌결제**
15459
15249
 
15460
15250
  ### 본인인증
15461
15251
 
@@ -15527,7 +15317,7 @@ Webhook을 활용하면 커스텀 기능이나 다른 애플리케이션과 연
15527
15317
  - `Transaction.PartialCancelled`: **결제가 부분 취소**되었을 때
15528
15318
  - `Transaction.Cancelled`: **결제가 완전 취소**되었을 때
15529
15319
  - `Transaction.Failed`: **결제(예약 결제 포함)가 실패**했을 때
15530
- - `Transaction.PayPending`: **결제 승인 대기** 상태가 되었을 때 (해외 결제시 발생 가능)
15320
+ - `Transaction.PayPending`: **결제 승인 대기** 상태가 되었을 때 (페이팔에서 발생 가능)
15531
15321
  - `Transaction.CancelPending`: (결제 취소가 비동기로 수행되는 경우) **결제 취소를 요청**했을 때
15532
15322
  - `Transaction.DisputeCreated`: **분쟁이 발생**되었을 때
15533
15323
  - `Transaction.DisputeResolved`: **분쟁이 해소**되었을 때
@@ -15608,7 +15398,7 @@ Webhook을 활용하면 커스텀 기능이나 다른 애플리케이션과 연
15608
15398
  - `PartialCancelled`: **결제가 부분 취소**되었을 때
15609
15399
  - `Cancelled`: **결제가 완전 취소**되었을 때
15610
15400
  - `Failed`: **결제(예약 결제 포함)가 실패**했을 때
15611
- - `PayPending`: **결제 승인 대기** 상태가 되었을 때 (해외 결제시 발생 가능)
15401
+ - `PayPending`: **결제 승인 대기** 상태가 되었을 때 (페이팔에서 발생 가능)
15612
15402
  - `CancelPending`: (결제 취소가 비동기로 수행되는 경우) **결제 취소를 요청**했을 때
15613
15403
 
15614
15404
  웹훅 payload 예시:
@@ -16246,16 +16036,6 @@ ni @portone/browser-sdk
16246
16036
 
16247
16037
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'inicis' END -->
16248
16038
 
16249
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' START -->
16250
-
16251
- <div class="hint" data-style="warning">
16252
-
16253
- 하이픈의 경우 영문 대소문자, 숫자, `_`만 허용되며, 50자 이하로 입력합니다.
16254
-
16255
- </div>
16256
-
16257
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' END -->
16258
-
16259
16039
  - orderName: string
16260
16040
 
16261
16041
  **주문명**
@@ -16327,16 +16107,6 @@ ni @portone/browser-sdk
16327
16107
 
16328
16108
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'naver' END -->
16329
16109
 
16330
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' START -->
16331
-
16332
- <div class="hint" data-style="warning">
16333
-
16334
- 하이픈의 경우 최대 1000바이트까지 입력할 수 있습니다.
16335
-
16336
- </div>
16337
-
16338
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' END -->
16339
-
16340
16110
  - totalAmount: number
16341
16111
 
16342
16112
  **결제 금액**
@@ -16566,11 +16336,11 @@ ni @portone/browser-sdk
16566
16336
 
16567
16337
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'kcp' END -->
16568
16338
 
16569
- <!-- CONDITIONAL CONTENT pgName=(name) => ['kakao', 'naver', 'tosspay', 'hyphen'].includes(name) START -->
16339
+ <!-- CONDITIONAL CONTENT pgName=(name) => ['kakao', 'naver', 'tosspay'].includes(name) START -->
16570
16340
 
16571
16341
  - 간편결제: `EASY_PAY`
16572
16342
 
16573
- <!-- CONDITIONAL CONTENT pgName=(name) => ['kakao', 'naver', 'tosspay', 'hyphen'].includes(name) END -->
16343
+ <!-- CONDITIONAL CONTENT pgName=(name) => ['kakao', 'naver', 'tosspay'].includes(name) END -->
16574
16344
 
16575
16345
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'eximbay' START -->
16576
16346
 
@@ -17320,19 +17090,19 @@ ni @portone/browser-sdk
17320
17090
 
17321
17091
  - `BOOKNLIFE` (도서문화상품권)
17322
17092
  - `SMART_MUNSANG` (스마트문상, (구)게임문화상품권)
17323
- - `CULTURELAND` (문화상품권)
17093
+ - `CULTURELAND` (컬쳐랜드 문화상품권)
17324
17094
 
17325
17095
  <!-- CONDITIONAL CONTENT pgName=(name) => ['toss', 'inicis'].includes(name) END -->
17326
17096
 
17327
17097
  <!-- CONDITIONAL CONTENT pgName=(name) => name === "nice" START -->
17328
17098
 
17329
- - `CULTURELAND` (문화상품권)
17099
+ - `CULTURELAND` (컬쳐랜드 문화상품권)
17330
17100
 
17331
17101
  <!-- CONDITIONAL CONTENT pgName=(name) => name === "nice" END -->
17332
17102
 
17333
17103
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'kcp' START -->
17334
17104
 
17335
- - `CULTURELAND` (문화상품권)
17105
+ - `CULTURELAND` (컬쳐랜드 문화상품권)
17336
17106
  - `BOOKNLIFE` (도서문화상품권)
17337
17107
 
17338
17108
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'kcp' END -->
@@ -17349,7 +17119,7 @@ ni @portone/browser-sdk
17349
17119
 
17350
17120
  `payMethod`가 `EASY_PAY`인 경우 간편결제와 관련한 추가 정보를 입력할 수 있습니다.
17351
17121
 
17352
- <!-- CONDITIONAL CONTENT pgName=(name) => !['kakao', 'naver', 'tosspay', 'hyphen'].includes(name) START -->
17122
+ <!-- CONDITIONAL CONTENT pgName=(name) => !['kakao', 'naver', 'tosspay'].includes(name) START -->
17353
17123
 
17354
17124
  - easyPayProvider?: string
17355
17125
 
@@ -17480,7 +17250,7 @@ ni @portone/browser-sdk
17480
17250
 
17481
17251
  </details>
17482
17252
 
17483
- <!-- CONDITIONAL CONTENT pgName=(name) => !['kakao', 'naver', 'tosspay', 'hyphen'].includes(name) END -->
17253
+ <!-- CONDITIONAL CONTENT pgName=(name) => !['kakao', 'naver', 'tosspay'].includes(name) END -->
17484
17254
 
17485
17255
  <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'ksnet'].includes(name) START -->
17486
17256
 
@@ -17508,7 +17278,7 @@ ni @portone/browser-sdk
17508
17278
 
17509
17279
  <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis'].includes(name) END -->
17510
17280
 
17511
- <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'naver', 'tosspay', 'hyphen'].includes(name) START -->
17281
+ <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'naver', 'tosspay'].includes(name) START -->
17512
17282
 
17513
17283
  - availableCards?: string\[]
17514
17284
 
@@ -17617,7 +17387,7 @@ ni @portone/browser-sdk
17617
17387
 
17618
17388
  </details>
17619
17389
 
17620
- <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'naver', 'tosspay', 'hyphen'].includes(name) END -->
17390
+ <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'naver', 'tosspay'].includes(name) END -->
17621
17391
 
17622
17392
  <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'naverpay'].includes(name) START -->
17623
17393
 
@@ -17901,16 +17671,6 @@ ni @portone/browser-sdk
17901
17671
 
17902
17672
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'naver' END -->
17903
17673
 
17904
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' START -->
17905
-
17906
- <div class="hint" data-style="warning">
17907
-
17908
- 하이픈의 경우 구매자 이름을 필수로 입력해야 합니다.
17909
-
17910
- </div>
17911
-
17912
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' END -->
17913
-
17914
17674
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'eximbay' START -->
17915
17675
 
17916
17676
  <div class="hint" data-style="warning">
@@ -18443,18 +18203,6 @@ ni @portone/browser-sdk
18443
18203
 
18444
18204
  <!-- CONDITIONAL CONTENT pgName=(name) => name === "tosspay" END -->
18445
18205
 
18446
- <!-- CONDITIONAL CONTENT pgName=(name) => name === "hyphen" START -->
18447
-
18448
- - hyphen?: object
18449
-
18450
- - designCd?: string
18451
-
18452
- **결제창 디자인 코드**
18453
-
18454
- `#`으로 시작하는 여섯 자리 16진수 코드입니다.
18455
-
18456
- <!-- CONDITIONAL CONTENT pgName=(name) => name === "hyphen" END -->
18457
-
18458
18206
  <!-- CONDITIONAL CONTENT pgName=(name) => name === "eximbay" START -->
18459
18207
 
18460
18208
  - eximbay?: object
@@ -18806,16 +18554,6 @@ ni @portone/browser-sdk
18806
18554
 
18807
18555
  **상점 사업자명**
18808
18556
 
18809
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' START -->
18810
-
18811
- <div class="hint" data-style="warning">
18812
-
18813
- 하이픈의 경우 미입력 시 대표상점명으로 설정됩니다.
18814
-
18815
- </div>
18816
-
18817
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' END -->
18818
-
18819
18557
  - businessRegistrationNumber?: string
18820
18558
 
18821
18559
  **상점 사업자 번호**
@@ -21587,7 +21325,7 @@ description: >-
21587
21325
  - 포트원을 통해 연동된 아래 12개의 PG사 내역을 조회할 수 있습니다.
21588
21326
  - 지원 PG : **KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜**
21589
21327
  - 고객사가 포트원을 통하지 않고 PG 직연동한 경우 지원 불가
21590
- - 9/26 이후 지원 예정 PG사 : KPN, 하이픈, KSNET
21328
+ - 9/26 이후 지원 예정 PG사 : KPN, KSNET
21591
21329
 
21592
21330
  - 고객사 주문번호를 정확하게 확인하기 위해서는 **실제 사용하시는 주문번호의 연동**이 필요합니다.
21593
21331
 
@@ -24599,7 +24337,6 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24599
24337
  - **이지페이(KICC)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24600
24338
  - **웰컴페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24601
24339
  - **엑심베이** : 카드
24602
- - **하이픈** : 실시간 계좌이체
24603
24340
 
24604
24341
  ### API 수기(키인)결제
24605
24342
 
@@ -25551,38 +25288,6 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
25551
25288
 
25552
25289
  <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
25553
25290
 
25554
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
25555
-
25556
- <details>
25557
-
25558
- <summary>하이픈</summary>
25559
-
25560
- 1. [HYPHEN PAY & 바로계좌결제 운영 백오피스](http://payadmin.hyphen.im/) 접속 후 **바로계좌결제** 선택 후
25561
- 로그인을 합니다.
25562
-
25563
- (이미지 첨부: HYPHEN 백오피스 로그인 화면)
25564
-
25565
- 2. \[상점관리]→\[바로계좌결제 상점정보관리]를 클릭합니다.
25566
-
25567
- 3. 상점명을 클릭합니다.
25568
-
25569
- (이미지 첨부: HYPHEN \[상점관리] - \[상점정보관리] 예시 화면)
25570
-
25571
- 4. \[상점 기본정보]에서 \[상점번호]를 확인합니다.
25572
-
25573
- (이미지 첨부: HYPHEN \[상점 기본정보] 예시 화면)
25574
-
25575
- 5. \[암호화 키, 토큰]에서 \[암호화 키]와 \[암호화 토큰]을 확인합니다.
25576
-
25577
- (이미지 첨부: HYPHEN \[암호화 키, 토큰] 예시 화면)
25578
-
25579
- 6. 포트원 콘솔에서 채널 추가 시 \[PG상점아이디(상점 번호)], \[암호화 키], \[암호화 토큰]을
25580
- 입력한 후 \[저장]을 클릭합니다.
25581
-
25582
- </details>
25583
-
25584
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
25585
-
25586
25291
  #### 해외 결제대행사
25587
25292
 
25588
25293
  <details>
@@ -25620,6 +25325,24 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
25620
25325
 
25621
25326
  3. 포트원 콘솔에서 채널 추가 시 \[Project Key], \[Secret Key]를 입력한 후 `저장`을 클릭합니다.
25622
25327
 
25328
+ #### 핑백(Pingback) URL 설정하기
25329
+
25330
+ 페이먼트월에서 포트원으로 결제 결과를 전달받기 위해 핑백 URL을 설정해야 합니다.
25331
+
25332
+ 1. [페이먼트월](https://api.paymentwall.com/developers/applications) 페이지에서 \[My Projects]를 클릭합니다.
25333
+
25334
+ (이미지 첨부: 페이먼트월 My Projects 메뉴)
25335
+
25336
+ 2. 사용할 프로젝트의 \[Settings] 탭을 클릭합니다.
25337
+
25338
+ (이미지 첨부: 페이먼트월 프로젝트 setting 탭)
25339
+
25340
+ 3. \[Pingback type]을 `URL`로 선택합니다.
25341
+ 4. \[Pingback URL]에 `https://service.iamport.kr/paymentwall/webhook`를 입력합니다.
25342
+ 5. \[Pingback signature version]을 `3`으로 설정합니다.
25343
+
25344
+ (이미지 첨부: 페이먼트월 Pingback 설정 화면)
25345
+
25623
25346
  </details>
25624
25347
 
25625
25348
  <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
@@ -30867,11 +30590,11 @@ writtenAt: 2024-09-30T00:00:00.000Z
30867
30590
  PG 거래대사 내의 **거래 정산 내역** 메뉴에서 정산일 또는 거래일을 기준으로,
30868
30591
  **거래 건별 조회** 메뉴에서는 정산일을 기준으로 최대 3개월 분량의 데이터를 엑셀로 다운로드할 수 있습니다.
30869
30592
 
30870
- ### **PG 거래대사**✔️ KSNET, KPN, 하이픈에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다.
30593
+ ### **PG 거래대사**✔️ KSNET, KPN에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다.
30871
30594
 
30872
30595
  기존에 12개 PG사 (KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠,
30873
- 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN, 하이픈까지 확장하여
30874
- 15개 PG사 데이터에 한하여 제공됩니다.
30596
+ 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN까지 확장하여
30597
+ 14개 PG사 데이터에 한하여 제공됩니다.
30875
30598
 
30876
30599
  (참고 : PG 거래대사 메뉴의 경우 클로즈 베타로 운영되고 있으며,
30877
30600
  사용을 원하시는 고객께서는 [PG거래대사 베타서비스 신청 바로가기](https://forms.gle/cZAqJLGqovC1STrS8)에서 신청해 주시길 바랍니다.)
@@ -4,7 +4,7 @@ description: PortOne 개발자센터 웹사이트 내 존재하는 문서들의
4
4
  targetVersions:
5
5
  - v1
6
6
  - v2
7
- date: 2025-10-30
7
+ date: 2025-11-25
8
8
  author: PortOne
9
9
  ---
10
10
 
@@ -84,7 +84,6 @@ author: PortOne
84
84
  - [결제취소(환불) 연동하기](https://developers.portone.io/opi/ko/integration/cancel/v2/readme): 포트원 V2 결제취소 API를 이용한 결제취소 방법을 안내합니다.
85
85
  - [다날 본인인증](https://developers.portone.io/opi/ko/integration/pg/v2/danal-identity-verification): 다날 본인인증 연동 방법을 안내합니다.
86
86
  - [엑심베이](https://developers.portone.io/opi/ko/integration/pg/v2/eximbay-v2): 엑심베이 결제 연동 방법을 안내합니다.
87
- - [하이픈](https://developers.portone.io/opi/ko/integration/pg/v2/hyphen): 하이픈 결제 연동 방법을 안내합니다.
88
87
  - [KG이니시스 일본결제](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-jp): KG이니시스 일본결제 연동 방법을 안내합니다.
89
88
  - [KG이니시스 통합인증](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-unified-identity-verification): KG이니시스 통합인증 연동 방법을 안내합니다.
90
89
  - [KG이니시스](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-v2): KG이니시스 결제 연동 방법을 안내합니다.
@@ -172,7 +171,6 @@ author: PortOne
172
171
  - [키움페이 (다우데이타/페이조아)](https://developers.portone.io/opi/ko/integration/pg/v1/daou/readme): 키움페이 연동 방법을 안내합니다.
173
172
  - [키움페이 유의사항](https://developers.portone.io/opi/ko/integration/pg/v1/daou/undefined): 결제 연동시 유의사항을 안내합니다.
174
173
  - [엑심베이](https://developers.portone.io/opi/ko/integration/pg/v1/eximbay): 엑심베이 결제 연동 방법을 안내합니다.
175
- - [하이픈](https://developers.portone.io/opi/ko/integration/pg/v1/hyphen): 하이픈 결제 연동 방법을 안내합니다.
176
174
  - [KG이니시스](https://developers.portone.io/opi/ko/integration/pg/v1/inicis): KG이니시스 결제창 연동 가이드입니다.
177
175
  - [카카오페이](https://developers.portone.io/opi/ko/integration/pg/v1/kakaopay): 카카오페이 연동 방법을 안내합니다.
178
176
  - [NHN KCP(신모듈) 본인인증 연동하기](https://developers.portone.io/opi/ko/integration/pg/v1/kcp-v2-identity-verification): NHN KCP(신모듈) 본인인증 연동 방법을 안내합니다.
package/manifest.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "dxt_version": "0.1",
3
3
  "name": "portone-mcp-server",
4
- "version": "0.15.0-alpha.0",
4
+ "version": "0.15.0-alpha.1",
5
5
  "description": "PortOne MCP Server for Developers",
6
6
  "author": {
7
7
  "name": "PortOne",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@portone/mcp-server",
3
- "version": "0.15.0-alpha.0",
3
+ "version": "0.15.0-alpha.1",
4
4
  "description": "포트원 사용자를 위한 MCP (Model Context Protocol) 서버입니다. 포트원 개발자센터, 헬프센터 등 공식 문서 내용을 LLM(Large Language Model)에 제공해 정확한 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.",
5
5
  "main": "server/index.js",
6
6
  "type": "module",
package/server/index.js CHANGED
@@ -15,7 +15,7 @@ import { GraphQLClient } from "graphql-request";
15
15
  // package.json
16
16
  var package_default = {
17
17
  name: "@portone/mcp-server",
18
- version: "0.15.0-alpha.0",
18
+ version: "0.15.0-alpha.1",
19
19
  description: "\uD3EC\uD2B8\uC6D0 \uC0AC\uC6A9\uC790\uB97C \uC704\uD55C MCP (Model Context Protocol) \uC11C\uBC84\uC785\uB2C8\uB2E4. \uD3EC\uD2B8\uC6D0 \uAC1C\uBC1C\uC790\uC13C\uD130, \uD5EC\uD504\uC13C\uD130 \uB4F1 \uACF5\uC2DD \uBB38\uC11C \uB0B4\uC6A9\uC744 LLM(Large Language Model)\uC5D0 \uC81C\uACF5\uD574 \uC815\uD655\uD55C \uC815\uBCF4\uB97C \uBC14\uD0D5\uC73C\uB85C \uC0AC\uC6A9\uC790\uC758 \uC5F0\uB3D9 \uBC0F \uC9C8\uC758\uB97C \uB3D5\uB3C4\uB85D \uD569\uB2C8\uB2E4.",
20
20
  main: "server/index.js",
21
21
  type: "module",