@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.
Files changed (95) hide show
  1. package/assets/docs/help/admin-console/pg-settlement/content30.md +2 -2
  2. package/assets/docs/help/admin-console/pg-settlement-history/content35.md +2 -2
  3. package/assets/docs/help/core-service/channel-setting/danal.md +4 -4
  4. package/assets/docs/help/core-service/channel-setting/daou.md +5 -0
  5. package/assets/docs/help/core-service/channel-setting/galaxia.md +2 -2
  6. package/assets/docs/help/core-service/channel-setting/inicis.md +30 -46
  7. package/assets/docs/help/core-service/channel-setting/kcp_channel.md +25 -13
  8. package/assets/docs/help/core-service/channel-setting/kpn.md +3 -2
  9. package/assets/docs/help/core-service/channel-setting/mobilians.md +22 -27
  10. package/assets/docs/help/core-service/channel-setting/nice.md +4 -4
  11. package/assets/docs/help/core-service/channel-setting/payco.md +5 -3
  12. package/assets/docs/help/core-service/channel-setting/payletter.md +3 -3
  13. package/assets/docs/help/core-service/how-to-use/additional-mobilians.md +15 -21
  14. package/assets/docs/help/core-service/how-to-use/content200009.md +10 -9
  15. package/assets/docs/help/core-service/how-to-use/high-risk-industry.md +2 -0
  16. package/assets/docs/help/core-service/how-to-use/information-pg.md +1 -1
  17. package/assets/docs/help/core-service/how-to-use/mobilians-contract.md +26 -21
  18. package/assets/docs/help/core-service/how-to-use/requirements.md +2 -0
  19. package/assets/docs/help/core-service/how-to-use/test-mode-cancel.md +1 -1
  20. package/assets/docs/help/core-service/how-to-use/wordpress-setting.md +2 -1
  21. package/assets/docs/help/core-service/payment-type/content200047.md +3 -1
  22. package/assets/docs/help/core-service/payment-type/content200052.md +8 -1
  23. package/assets/docs/help/core-service/payment-type/hub-service-fee.md +1 -1
  24. package/assets/docs/help/core-service/payment-type/internationl-high-risk-industry.md +1 -26
  25. package/assets/docs/help/faq/general-inquiry/confirm-process.md +5 -11
  26. package/assets/docs/help/faq/general-inquiry/real-channel-info.md +1 -1
  27. package/assets/docs/help/faq/payment-faq/pg-max-min-amount.md +3 -3
  28. package/assets/docs/help/faq/payment-faq/vbank-service-detail.md +1 -1
  29. package/assets/docs/help/pricing/pg/domestic-and-oversea-fees.md +1 -1
  30. package/assets/docs/help/pricing/portone/portone-pricing.md +2 -0
  31. package/assets/docs/help/procedure/pg-application/content54.md +2 -0
  32. package/assets/docs/help/procedure/pg-application/start.md +2 -0
  33. package/assets/docs/help/procedure/recommendation/package.md +4 -2
  34. package/assets/docs/help/service/pg/pg-service-list.md +8 -6
  35. package/assets/docs/opi/ko/extra/link-pay/readme-v1.md +36 -4
  36. package/assets/docs/opi/ko/extra/mobile-payment/readme-v2.md +610 -0
  37. package/assets/docs/opi/ko/extra/smart-routing/intro.md +1 -1
  38. package/assets/docs/opi/ko/integration/pg/v1/blue.md +36 -0
  39. package/assets/docs/opi/ko/integration/pg/v1/danal.md +134 -4
  40. package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +103 -53
  41. package/assets/docs/opi/ko/integration/pg/v1/eximbay.md +121 -19
  42. package/assets/docs/opi/ko/integration/pg/v1/galaxia.md +12 -0
  43. package/assets/docs/opi/ko/integration/pg/v1/inicis-jp.md +57 -30
  44. package/assets/docs/opi/ko/integration/pg/v1/inicis.md +177 -0
  45. package/assets/docs/opi/ko/integration/pg/v1/kakaopay.md +128 -2
  46. package/assets/docs/opi/ko/integration/pg/v1/kg-mobilians-v2.md +19 -19
  47. package/assets/docs/opi/ko/integration/pg/v1/kg.md +65 -12
  48. package/assets/docs/opi/ko/integration/pg/v1/kicc.md +115 -2
  49. package/assets/docs/opi/ko/integration/pg/v1/ksnet/readme.md +14 -2
  50. package/assets/docs/opi/ko/integration/pg/v1/naver.md +60 -0
  51. package/assets/docs/opi/ko/integration/pg/v1/newtoss/readme.md +117 -7
  52. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/kcp-quickpay.md +21 -32
  53. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/readme.md +164 -3
  54. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md +6 -6
  55. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/readme.md +177 -2
  56. package/assets/docs/opi/ko/integration/pg/v1/nice.md +122 -3
  57. package/assets/docs/opi/ko/integration/pg/v1/payco.md +87 -3
  58. package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md +142 -1
  59. package/assets/docs/opi/ko/integration/pg/v1/paymentwall.md +45 -1
  60. package/assets/docs/opi/ko/integration/pg/v1/paypal.md +37 -1
  61. package/assets/docs/opi/ko/integration/pg/v1/readme.md +1 -1
  62. package/assets/docs/opi/ko/integration/pg/v1/rt/readme.md +52 -14
  63. package/assets/docs/opi/ko/integration/pg/v1/settle/mybank.md +138 -56
  64. package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md +50 -0
  65. package/assets/docs/opi/ko/integration/pg/v1/smartro-v2/readme.md +126 -0
  66. package/assets/docs/opi/ko/integration/pg/v1/smartro.md +78 -0
  67. package/assets/docs/opi/ko/integration/pg/v1/smilepay.md +49 -3
  68. package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md +88 -25
  69. package/assets/docs/opi/ko/integration/pg/v1/toss-brandpay/module.md +1 -1
  70. package/assets/docs/opi/ko/integration/pg/v1/toss-brandpay/readme.md +34 -2
  71. package/assets/docs/opi/ko/integration/pg/v1/toss.md +114 -1
  72. package/assets/docs/opi/ko/integration/pg/v1/tosspay-v2/readme.md +74 -15
  73. package/assets/docs/opi/ko/integration/pg/v1/tosspay.md +41 -1
  74. package/assets/docs/opi/ko/integration/pg/v1/welcome/readme.md +12 -0
  75. package/assets/docs/opi/ko/integration/pg/v2/inicis-jp.md +3 -15
  76. package/assets/docs/opi/ko/integration/pg/v2/triple-a.md +1 -0
  77. package/assets/docs/opi/ko/integration/ready/readme.md +14 -46
  78. package/assets/docs/opi/ko/integration/start/v1/non-auth.md +1 -1
  79. package/assets/docs/opi/ko/readme.md +2 -2
  80. package/assets/docs/opi/ko/support/code-info/pg-2.md +1 -1
  81. package/assets/docs/opi/ko/support/code-info/pg-3.md +3 -3
  82. package/assets/docs/opi/ko/support/code-info/pg.md +1 -1
  83. package/assets/docs/release-notes/api-sdk/2023-07-03.md +3 -3
  84. package/assets/docs/schema/v1.openapi.json +239 -3
  85. package/assets/docs/schema/v1.openapi.yml +174 -12
  86. package/assets/docs/schema/v2.openapi.json +225 -11
  87. package/assets/docs/schema/v2.openapi.yml +185 -3
  88. package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrq.md +10 -2
  89. package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrt.md +1 -1
  90. package/assets/docs/v1-docs-full.md +2892 -388
  91. package/assets/docs/v2-docs-full.md +639 -67
  92. package/assets/docs/website-links.md +4 -3
  93. package/manifest.json +1 -1
  94. package/package.json +1 -1
  95. package/server/index.js +1 -1
@@ -101,8 +101,8 @@
101
101
  - [KG이니시스](https://developers.portone.io/opi/ko/integration/pg/v1/inicis): KG이니시스 결제창 연동 가이드입니다.
102
102
  - [카카오페이](https://developers.portone.io/opi/ko/integration/pg/v1/kakaopay): 카카오페이 연동 방법을 안내합니다.
103
103
  - [NHN KCP(신모듈) 본인인증 연동하기](https://developers.portone.io/opi/ko/integration/pg/v1/kcp-v2-identity-verification): NHN KCP(신모듈) 본인인증 연동 방법을 안내합니다.
104
- - [KG모빌리언스 (신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kg-mobilians-v2): KG모빌리언스 (신모듈) 결제 연동 방법을 안내합니다.
105
- - [KG모빌리언스 (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kg): KG모빌리언스 (구모듈) 결제 연동 방법을 안내합니다.
104
+ - [KG파이낸셜 (신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kg-mobilians-v2): KG파이낸셜 (신모듈) 결제 연동 방법을 안내합니다.
105
+ - [KG파이낸셜 (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kg): KG파이낸셜 (구모듈) 결제 연동 방법을 안내합니다.
106
106
  - [이지페이(KICC) 해외결제](https://developers.portone.io/opi/ko/integration/pg/v1/kicc-v2): 이지페이(KICC) 해외결제 결제 연동 방법을 안내합니다.
107
107
  - [이지페이(KICC) (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kicc): 이지페이(KICC) (구모듈) 결제창 연동 방법을 안내합니다.
108
108
  - [KSNET](https://developers.portone.io/opi/ko/integration/pg/v1/ksnet/readme): KSNET 결제창 연동 가이드입니다.
@@ -2020,12 +2020,28 @@ Content-Type : Application.json;charset=UTF-8
2020
2020
 
2021
2021
  - pay\_methods: object\[]
2022
2022
 
2023
- - pg?: string
2023
+ - channelKey?: string
2024
+
2025
+ 채널키
2026
+
2027
+ 결제를 진행할 채널을 지정합니다.
2028
+
2029
+ 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
2030
+
2031
+ - pg(deprecated)?: string
2024
2032
 
2025
2033
  pg사 구분코드
2026
2034
 
2027
2035
  [pg 파라미터 가이드 바로가기](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/payrq?v=v1#pg-string)
2028
2036
 
2037
+ <div class="hint" data-style="warning">
2038
+
2039
+ pg 파라미터는 지원 중단 예정입니다.
2040
+
2041
+ `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
2042
+
2043
+ </div>
2044
+
2029
2045
  - pay\_method?: string
2030
2046
 
2031
2047
  결제수단 구분코드
@@ -2038,12 +2054,28 @@ Content-Type : Application.json;charset=UTF-8
2038
2054
 
2039
2055
  - direct?: object
2040
2056
 
2041
- - pg?: string
2057
+ - channelKey?: string
2058
+
2059
+ 채널키
2060
+
2061
+ 결제를 진행할 채널을 지정합니다.
2062
+
2063
+ 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
2064
+
2065
+ - pg(deprecated)?: string
2042
2066
 
2043
2067
  pg사 구분코드 ex. paymentwall.mid
2044
2068
 
2045
2069
  [pg 파라미터 가이드 바로가기](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/payrq?v=v1#pg-string)
2046
2070
 
2071
+ <div class="hint" data-style="warning">
2072
+
2073
+ pg 파라미터는 지원 중단 예정입니다.
2074
+
2075
+ `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
2076
+
2077
+ </div>
2078
+
2047
2079
  - pay\_method?: string
2048
2080
 
2049
2081
  결제수단 구분코드. (하나의 결제수단만 선택 가능합니다.)
@@ -2064,14 +2096,14 @@ Content-Type : Application.json;charset=UTF-8
2064
2096
 
2065
2097
  ```json title="일반 호출"
2066
2098
  {
2067
- "payment_info": "{\"title\":\"테스트고객사\",\"user_code\":\"imp68124833\",\"amount\":10000,\"merchant_uid\":\"merchant_1630665784552\",\"name\":\"결제링크 테스트\",\"tax_free\":\"면세공급가액\",\"currency\":\"KRW\",\"language\":\"ko\",\"buyer_name\":\"\",\"buyer_tel\":\"\",\"buyer_addr\":\"\",\"buyer_email\":\"\",\"buyer_postcode\":\"\",\"custom_data\":\"json_object\",\"notice_url\":\"결제 결과를 받을 url\",\"pay_methods\":[{\"pg\":\"INIpayTest\",\"pay_method\":\"card\",\"label\":\"신용/체크카드\"},{\"pg\":\"INIpayTest\",\"pay_method\":\"naverpay\",\"label\":\"네이버페이\"},{\"pg\":\"INIpayTest\",\"pay_method\":\"kakaopay\",\"label\":\"카카오페이\"},{\"pg\":\"INIpayTest\",\"pay_method\":\"phone\",\"label\":\"핸드폰 소액결제\"},{\"pg\":\"INIpayTest\",\"pay_method\":\"trans\",\"label\":\"계좌이체\"},{\"pg\":\"INIpayTest\",\"pay_method\":\"vbank\",\"label\":\"가상계좌\"}]}",
2099
+ "payment_info": "{\"title\":\"테스트고객사\",\"user_code\":\"imp68124833\",\"amount\":10000,\"merchant_uid\":\"merchant_1630665784552\",\"name\":\"결제링크 테스트\",\"tax_free\":\"면세공급가액\",\"currency\":\"KRW\",\"language\":\"ko\",\"buyer_name\":\"\",\"buyer_tel\":\"\",\"buyer_addr\":\"\",\"buyer_email\":\"\",\"buyer_postcode\":\"\",\"custom_data\":\"json_object\",\"notice_url\":\"결제 결과를 받을 url\",\"pay_methods\":[{\"channelKey\":\"channel-key-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\"pay_method\":\"card\",\"label\":\"신용/체크카드\"},{\"channelKey\":\"channel-key-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\"pay_method\":\"naverpay\",\"label\":\"네이버페이\"},{\"channelKey\":\"channel-key-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\"pay_method\":\"kakaopay\",\"label\":\"카카오페이\"},{\"channelKey\":\"channel-key-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\"pay_method\":\"phone\",\"label\":\"핸드폰 소액결제\"},{\"channelKey\":\"channel-key-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\"pay_method\":\"trans\",\"label\":\"계좌이체\"},{\"channelKey\":\"channel-key-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\"pay_method\":\"vbank\",\"label\":\"가상계좌\"}]}",
2068
2100
  "expired_at": 1634324016
2069
2101
  }
2070
2102
  ```
2071
2103
 
2072
2104
  ```json title="PG사 결제창 다이렉트 호출"
2073
2105
  {
2074
- "payment_info": "{\"title\":\"테스트고객사\",\"user_code\":\"imp68124833\",\"amount\":1000,\"merchant_uid\":\"merchant_16306657845522\",\"name\":\"결제링크 테스트\",\"tax_free\":\"면세공급가액\",\"currency\":\"KRW\",\"language\":\"ko\",\"buyer_name\":\"\",\"buyer_tel\":\"\",\"buyer_addr\":\"\",\"buyer_email\":\"\",\"direct\":{\"pg\":\"tosspayments\",\"pay_method\":\"card\"}}",
2106
+ "payment_info": "{\"title\":\"테스트고객사\",\"user_code\":\"imp68124833\",\"amount\":1000,\"merchant_uid\":\"merchant_16306657845522\",\"name\":\"결제링크 테스트\",\"tax_free\":\"면세공급가액\",\"currency\":\"KRW\",\"language\":\"ko\",\"buyer_name\":\"\",\"buyer_tel\":\"\",\"buyer_addr\":\"\",\"buyer_email\":\"\",\"direct\":{\"channelKey\":\"channel-key-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\"pay_method\":\"card\"}}",
2075
2107
  "expired_at": 1634324016
2076
2108
  }
2077
2109
  ```
@@ -3427,12 +3459,48 @@ IMP.request_pay(
3427
3459
 
3428
3460
  고객사에서 매번 고유하게 채번되어야 합니다.
3429
3461
 
3462
+ - name: string
3463
+
3464
+ **주문명**
3465
+
3430
3466
  - amount: number
3431
3467
 
3432
3468
  **결제금액**
3433
3469
 
3434
3470
  지정하지 않은 경우 0원입니다.
3435
3471
 
3472
+ - buyer\_name?: string
3473
+
3474
+ **구매자 이름**
3475
+
3476
+ - buyer\_email?: string
3477
+
3478
+ **구매자 이메일**
3479
+
3480
+ - buyer\_tel?: string
3481
+
3482
+ **구매자 연락처**
3483
+
3484
+ - buyer\_addr?: string
3485
+
3486
+ **구매자 주소**
3487
+
3488
+ - buyer\_postcode?: string
3489
+
3490
+ **구매자 우편번호**
3491
+
3492
+ - notice\_url?: string | string\[]
3493
+
3494
+ **웹훅 수신 URL**
3495
+
3496
+ - confirm\_url?: string
3497
+
3498
+ **Confirm process URL**
3499
+
3500
+ - custom\_data?: object
3501
+
3502
+ **가맹점 커스텀 데이터**
3503
+
3436
3504
  </div>
3437
3505
 
3438
3506
  <div class="tabs-content" data-title="비 인증결제">
@@ -3522,10 +3590,10 @@ IMP.request_pay(
3522
3590
 
3523
3591
  - card (신용카드)
3524
3592
  - trans (실시간 계좌이체)
3525
- - vbank(가상계좌)
3526
- - phone(휴대폰 소액결제) : 휴대폰 결제인 경우 pg 파라미터는 **`danal`** 로 지정하면 됩니다.
3593
+ - vbank (가상계좌)
3594
+ - phone (휴대폰 소액결제) : 휴대폰 결제인 경우 pg 파라미터는 **`danal`** 로 지정하면 됩니다.
3527
3595
  - cultureland (컬쳐랜드 문화상품권)
3528
- - booknlife (도서문화상품권)
3596
+ - happymoney (해피머니 문화상품권)
3529
3597
 
3530
3598
  - merchant\_uid: string
3531
3599
 
@@ -3533,28 +3601,106 @@ IMP.request_pay(
3533
3601
 
3534
3602
  고객사에서 매번 고유하게 채번되어야 합니다.
3535
3603
 
3604
+ - name: string
3605
+
3606
+ **주문명**
3607
+
3608
+ - buyer\_name?: string
3609
+
3610
+ **구매자 이름**
3611
+
3612
+ - buyer\_email?: string
3613
+
3614
+ **구매자 이메일**
3615
+
3536
3616
  - buyer\_tel: string
3537
3617
 
3538
3618
  **주문자 연락처**
3539
3619
 
3540
3620
  미 설정 시 다날 결제창에서 오류 발생 가능
3541
3621
 
3622
+ - buyer\_addr?: string
3623
+
3624
+ **구매자 주소**
3625
+
3626
+ - buyer\_postcode?: string
3627
+
3628
+ **구매자 우편번호**
3629
+
3542
3630
  - amount: number
3543
3631
 
3544
3632
  **결제금액**
3545
3633
 
3546
3634
  지정하지 않은 경우 0원입니다.
3547
3635
 
3636
+ - tax\_free?: number
3637
+
3638
+ **면세금액** (휴대폰 결제 외)
3639
+
3548
3640
  - biz\_num?: string
3549
3641
 
3550
3642
  **사업자등록번호**
3551
3643
 
3552
3644
  가상계좌 결제창 호출 시 `사업자등록번호 10자리` 필수 입력 (미설정 시 다날 결제창에서 오류 발생 가능)
3553
3645
 
3646
+ - vbank\_due?: string
3647
+
3648
+ **가상계좌 입금마감일시**
3649
+
3554
3650
  - company?: string
3555
3651
 
3556
3652
  휴대폰 결제시 결제창에 표시될 표시될 상호명. 입력하지 않으면 포트원 대표상점명으로 표시됩니다.
3557
3653
 
3654
+ - appCard?: boolean
3655
+
3656
+ **앱카드 전용 모드** (휴대폰 결제 외)
3657
+
3658
+ - auth\_mode?: string
3659
+
3660
+ **인증 방식** (휴대폰 결제 외)
3661
+
3662
+ - `key-in`: 키인 결제 모드로 결제창을 호출합니다.
3663
+
3664
+ - m\_redirect\_url?: string
3665
+
3666
+ **모바일 결제 후 리디렉션 될 URL**
3667
+
3668
+ - app\_scheme?: string
3669
+
3670
+ **모바일 앱 URL scheme** (모바일 전용, 휴대폰 결제 외)
3671
+
3672
+ - notice\_url?: string | string\[]
3673
+
3674
+ **웹훅 수신 URL**
3675
+
3676
+ - confirm\_url?: string
3677
+
3678
+ **Confirm process URL**
3679
+
3680
+ - custom\_data?: object
3681
+
3682
+ **가맹점 커스텀 데이터**
3683
+
3684
+ - customer\_id?: string
3685
+
3686
+ **구매자 고유 ID**
3687
+
3688
+ - bypass?: object
3689
+
3690
+ **다날 전용 파라미터** (휴대폰 결제 외)
3691
+
3692
+ - danal?: object
3693
+
3694
+ - COLOR?: string
3695
+
3696
+ **결제창 색상**
3697
+
3698
+ - ISCASHRECEIPTUI?: string
3699
+
3700
+ **현금영수증 발급 UI 표시 여부** (계좌이체/가상계좌)
3701
+
3702
+ - `N`: 현금영수증 발급 UI를 숨깁니다.
3703
+
3558
3704
  </div>
3559
3705
 
3560
3706
  <div class="tabs-content" data-title="비인증 결제(결제창 방식)">
@@ -3632,12 +3778,40 @@ IMP.request_pay(
3632
3778
 
3633
3779
  비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
3634
3780
 
3635
- - amount: Integer
3781
+ - merchant\_uid: string
3782
+
3783
+ **고객사 채번 주문 고유번호**
3784
+
3785
+ - name: string
3786
+
3787
+ **주문명**
3788
+
3789
+ - amount: integer
3636
3790
 
3637
3791
  **결제금액**
3638
3792
 
3639
3793
  0원으로 설정시 빌링키만 발급되며 **0원 이상 설정시 실결제와 빌링키 발급이 동시**에 이루어 집니다.
3640
3794
 
3795
+ - buyer\_name?: string
3796
+
3797
+ **구매자 이름**
3798
+
3799
+ - buyer\_email?: string
3800
+
3801
+ **구매자 이메일**
3802
+
3803
+ - buyer\_tel?: string
3804
+
3805
+ **구매자 연락처**
3806
+
3807
+ - buyer\_addr?: string
3808
+
3809
+ **구매자 주소**
3810
+
3811
+ - buyer\_postcode?: string
3812
+
3813
+ **구매자 우편번호**
3814
+
3641
3815
  - period?: object
3642
3816
 
3643
3817
  정기결제시 고객이 구매하는 제품에 대한 제공기간을 명시합니다. 해당 일자가 다날 결제창에 표기 됩니다.
@@ -3650,6 +3824,30 @@ IMP.request_pay(
3650
3824
 
3651
3825
  **YYYYMMDD**
3652
3826
 
3827
+ - text?: string
3828
+
3829
+ **결제창 표기용 제공기간 문구** (휴대폰 빌링키 발급 시 사용)
3830
+
3831
+ - m\_redirect\_url?: string
3832
+
3833
+ **모바일 결제 후 리디렉션 될 URL**
3834
+
3835
+ - app\_scheme?: string
3836
+
3837
+ **모바일 앱 URL scheme** (모바일 전용, 휴대폰 결제 외)
3838
+
3839
+ - notice\_url?: string | string\[]
3840
+
3841
+ **웹훅 수신 URL**
3842
+
3843
+ - custom\_data?: object
3844
+
3845
+ **가맹점 커스텀 데이터**
3846
+
3847
+ - customer\_id?: string
3848
+
3849
+ **구매자 고유 ID**
3850
+
3653
3851
  ### 빌링키(customer\_uid)로 결제 요청하기
3654
3852
 
3655
3853
  빌링키 발급이 성공하면 실 빌링키는 customer\_uid 와 1:1 매칭되어 **포트원 서버에 저장**됩니다. customer\_uid를 고객사 내부서버에 저장하시고 [**비 인증 결제요청 REST API**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)를 호출하시면 결제를 발생시킬 수 있습니다.
@@ -3964,86 +4162,130 @@ IMP.request_pay(
3964
4162
 
3965
4163
  매번 고유하게 채번되어야 합니다.
3966
4164
 
3967
- - digital: string
4165
+ - name: string
4166
+
4167
+ **주문명**
4168
+
4169
+ - amount: number
4170
+
4171
+ **결제금액**
4172
+
4173
+ **string** 이 아닌 점에 유의하세요.
4174
+
4175
+ - buyer\_name?: string
4176
+
4177
+ **구매자 이름**
4178
+
4179
+ - buyer\_email?: string
4180
+
4181
+ **구매자 이메일**
4182
+
4183
+ - buyer\_tel?: string
4184
+
4185
+ **구매자 연락처**
4186
+
4187
+ - buyer\_addr?: string
4188
+
4189
+ **구매자 주소**
4190
+
4191
+ - buyer\_postcode?: string
4192
+
4193
+ **구매자 우편번호**
4194
+
4195
+ - digital: boolean
3968
4196
 
3969
4197
  **디지털 컨텐츠 여부**
3970
4198
 
3971
4199
  고객사 <-> 키움페이간 계약 상태에 따라 정해진 올바른 값을 넣어야 함. 그렇지 않은 경우 결제 진행 불가
3972
4200
 
3973
- - bypass.daou.PRODUCTCODE?: string
4201
+ - tax\_free?: number
3974
4202
 
3975
- **결제 상품 고유 번호**
4203
+ **면세금액**
3976
4204
 
3977
- 값에 대해 정해진 규격이 없고 보내지 않을 경우 포트원에서 기본값(iamport)을 설정해 키움페이 측으로 전달
4205
+ - vbank\_due?: string
3978
4206
 
3979
- - bypass.daou.CASHRECEIPTFLAG?: number
4207
+ **가상계좌 입금마감일시**
3980
4208
 
3981
- **현금영수증 발급 구분코드**
4209
+ - m\_redirect\_url?: string
3982
4210
 
3983
- 실시간 계좌이체, 가상계좌, 카카오페이 거래 시 키움페이에서 현금영수증 자동발급 여부 구분코드
4211
+ **모바일 결제 리디렉션 URL**
3984
4212
 
3985
- - 실시간 계좌이체, 가상계좌인 경우
3986
- - `1`: 허용
3987
- - `0`: 차단
4213
+ - notice\_url?: string | string\[]
3988
4214
 
3989
- - 카카오페이인 경우
3990
- - `Y`: 허용
3991
- - `N`: 차단
4215
+ **웹훅 수신 URL**
3992
4216
 
3993
- - bypass.daou.DIRECT\_YN?: string
4217
+ - custom\_data?: object
3994
4218
 
3995
- **카드, 간편결제 다이렉트 호출 시 키움페이 페이지 노출여부**
4219
+ **가맹점 커스텀 데이터**
3996
4220
 
3997
- 'Y'로 입력하는 경우 키움페이 화면이 노출되지 않고 바로 카드사, 간편결제 결제창이 호출됩니다.
4221
+ - bypass?: object
3998
4222
 
3999
- - bypass.daou.CARDQUOTA?: string
4223
+ **키움페이 전용 파라미터**
4000
4224
 
4001
- **카드사별 할부개월 수 설정**
4225
+ - daou?: object
4002
4226
 
4003
- ^ 로 구분된 다수의 카드 할부 설정 그룹으로 구성되며, 각 그룹은 `{키움페이_카드사_코드}-{할부_개월수_옵션1}:{할부_개월수_옵션2}:...` 형식으로 구성하여 카드사별 할부 개월 수를 지정합니다.
4227
+ - PRODUCTCODE?: string
4004
4228
 
4005
- 예시로 `CCBC-0:2:3:4:5:6^CCNH-0:2:3^CCKM-0:2:3:4` 입력하는 경우 BC카드는 일시불, 2, 3, 4, 5, 6개월, 농협카드는 일시불, 2, 3개월, 국민카드는 일시불, 2, 3, 4개월 할부가 선택 가능하도록 표시됩니다.
4229
+ **결제 상품 고유 번호**
4006
4230
 
4007
- 카드사 코드
4231
+ 값에 대해 정해진 규격이 없고 보내지 않을 경우 포트원에서 기본값(iamport)을 설정해 키움페이 측으로 전달
4008
4232
 
4009
- |카드사 명 |코드|
4010
- |------------|----|
4011
- |비씨카드 |CCBC|
4012
- |국민카드 |CCKM|
4013
- |제주은행 |CCCJ|
4014
- |신한카드 |CCLG|
4015
- |씨티은행 |CCCT|
4016
- |롯데카드 |CCLO|
4017
- |신협카드 |CCCU|
4018
- |새마을금고 |CCMG|
4019
- |현대카드 |CCDI|
4020
- |NH카드 |CCNH|
4021
- |현대증권 |CCHD|
4022
- |우리카드 |CCPH|
4023
- |하나SK카드 |CCHN|
4024
- |우체국카드 |CCPO|
4025
- |전북은행 |CCJB|
4026
- |저축은행카드|CCSB|
4027
- |카카오뱅크 |CCKA|
4028
- |삼성카드 |CCSS|
4029
- |산은카드 |CCKD|
4030
- |수협 |CCSU|
4031
- |하나은행 |CCKE|
4032
- |토스뱅크 |CCTS|
4033
- |광주은행 |CCKJ|
4034
- |K뱅크 |CKBK|
4233
+ - CASHRECEIPTFLAG?: number | string
4035
4234
 
4036
- - app\_scheme?: string
4235
+ **현금영수증 발급 구분코드**
4037
4236
 
4038
- **모바일 URL Scheme**
4237
+ 실시간 계좌이체, 가상계좌, 카카오페이 거래 시 키움페이에서 현금영수증 자동발급 여부 구분코드
4039
4238
 
4040
- 모바일 환경에서 결제시 필수 파라미터
4239
+ - 실시간 계좌이체, 가상계좌인 경우
4240
+ - `1`: 허용
4241
+ - `0`: 차단
4041
4242
 
4042
- - amount: number
4243
+ - 카카오페이인 경우
4244
+ - `Y`: 허용
4245
+ - `N`: 차단
4043
4246
 
4044
- **결제금액**
4247
+ - DIRECT\_YN?: string
4045
4248
 
4046
- **string** 아닌 점에 유의하세요.
4249
+ **간편결제 다이렉트 호출 키움페이 페이지 노출여부**
4250
+
4251
+ `Y`로 입력하는 경우 키움페이 화면이 노출되지 않고 바로 간편결제 결제창이 호출됩니다.
4252
+
4253
+ - CARDQUOTA?: string
4254
+
4255
+ **카드사별 할부개월 수 설정**
4256
+
4257
+ `^` 로 구분된 다수의 카드 할부 설정 그룹으로 구성되며, 각 그룹은 `{키움페이_카드사_코드}-{할부_개월수_옵션1}:{할부_개월수_옵션2}:...` 형식으로 구성하여 카드사별 할부 개월 수를 지정합니다.
4258
+
4259
+ 예시로 `CCBC-0:2:3:4:5:6^CCNH-0:2:3^CCKM-0:2:3:4` 를 입력하는 경우 BC카드는 일시불, 2, 3, 4, 5, 6개월, 농협카드는 일시불, 2, 3개월, 국민카드는 일시불, 2, 3, 4개월 할부가 선택 가능하도록 표시됩니다.
4260
+
4261
+ 카드사 코드
4262
+
4263
+ |카드사 명 |코드|
4264
+ |------------|----|
4265
+ |비씨카드 |CCBC|
4266
+ |국민카드 |CCKM|
4267
+ |제주은행 |CCCJ|
4268
+ |신한카드 |CCLG|
4269
+ |씨티은행 |CCCT|
4270
+ |롯데카드 |CCLO|
4271
+ |신협카드 |CCCU|
4272
+ |새마을금고 |CCMG|
4273
+ |현대카드 |CCDI|
4274
+ |NH카드 |CCNH|
4275
+ |현대증권 |CCHD|
4276
+ |우리카드 |CCPH|
4277
+ |하나SK카드 |CCHN|
4278
+ |우체국카드 |CCPO|
4279
+ |전북은행 |CCJB|
4280
+ |저축은행카드|CCSB|
4281
+ |카카오뱅크 |CCKA|
4282
+ |삼성카드 |CCSS|
4283
+ |산은카드 |CCKD|
4284
+ |수협 |CCSU|
4285
+ |하나은행 |CCKE|
4286
+ |토스뱅크 |CCTS|
4287
+ |광주은행 |CCKJ|
4288
+ |K뱅크 |CKBK|
4047
4289
 
4048
4290
  - escrow?: boolean
4049
4291
 
@@ -4051,6 +4293,12 @@ IMP.request_pay(
4051
4293
 
4052
4294
  계좌이체,가상계좌만 지원됩니다.
4053
4295
 
4296
+ - app\_scheme?: string
4297
+
4298
+ **모바일 앱 URL Scheme**
4299
+
4300
+ 모바일 앱 환경에서 결제시 필수 파라미터
4301
+
4054
4302
  </div>
4055
4303
 
4056
4304
  <div class="tabs-content" data-title="비 인증 API 요청">
@@ -4623,14 +4871,34 @@ IMP.request_pay(
4623
4871
 
4624
4872
  매번 고유하게 채번되어야 합니다.
4625
4873
 
4626
- - buyer: string
4874
+ - name: string
4875
+
4876
+ **주문명**
4877
+
4878
+ - buyer\_name: string
4627
4879
 
4628
4880
  **구매자명**
4629
4881
 
4882
+ - buyer\_email?: string
4883
+
4884
+ **구매자 이메일**
4885
+
4630
4886
  - buyer\_tel: string
4631
4887
 
4632
4888
  **구매자 연락처**
4633
4889
 
4890
+ - buyer\_addr?: string
4891
+
4892
+ **구매자 주소**
4893
+
4894
+ `bypass.shipTo_street1`의 기본값으로 사용됩니다.
4895
+
4896
+ - buyer\_postcode?: string
4897
+
4898
+ **구매자 우편번호**
4899
+
4900
+ `bypass.shipTo_postalCode`의 기본값으로 사용됩니다.
4901
+
4634
4902
  - amount: number
4635
4903
 
4636
4904
  **결제금액**
@@ -4639,26 +4907,104 @@ IMP.request_pay(
4639
4907
 
4640
4908
  - currency?: string
4641
4909
 
4642
- **결제통화코드**
4910
+ **결제통화코드** (기본값: USD)
4643
4911
 
4644
- - KRW
4645
- - USD
4646
- - EUR
4647
- - GBP
4648
- - JPY
4649
- - THB
4650
- - SGD
4651
- - RUB
4652
- - HKD
4653
- - CAD
4654
- - AUD
4912
+ KRW, USD, EUR, GBP, JPY, THB, SGD, RUB, HKD, CAD, AUD
4655
4913
 
4656
4914
  - language?: string
4657
4915
 
4658
- - 한국어 : ko
4659
- - 영어 : en
4660
- - 중국어 : zh
4661
- - 일본어 : jp
4916
+ **결제창 언어**
4917
+
4918
+ - `ko`: 한국어
4919
+ - `en`: 영어
4920
+ - `zh`: 중국어
4921
+ - `jp`: 일본어
4922
+
4923
+ - popup?: boolean
4924
+
4925
+ **팝업창 활성화 여부**
4926
+
4927
+ - m\_redirect\_url?: string
4928
+
4929
+ **모바일 결제 후 리디렉션 될 URL**
4930
+
4931
+ - notice\_url?: string | string\[]
4932
+
4933
+ **웹훅 수신 URL**
4934
+
4935
+ - custom\_data?: object
4936
+
4937
+ **가맹점 커스텀 데이터**
4938
+
4939
+ - bypass?: object
4940
+
4941
+ **엑심베이 전용 파라미터**
4942
+
4943
+ - eximbay?: object
4944
+
4945
+ - issuercountry?: string
4946
+
4947
+ **국내 결제창 호출 시 `KR`로 설정**
4948
+
4949
+ - shipTo\_city?: string
4950
+
4951
+ **배송지 도시**
4952
+
4953
+ - shipTo\_country?: string
4954
+
4955
+ **배송지 국가코드**
4956
+
4957
+ - shipTo\_firstName?: string
4958
+
4959
+ **수취인 이름**
4960
+
4961
+ - shipTo\_lastName?: string
4962
+
4963
+ **수취인 성**
4964
+
4965
+ - shipTo\_phoneNumber?: string
4966
+
4967
+ **수취인 연락처**
4968
+
4969
+ - shipTo\_state?: string
4970
+
4971
+ **배송지 주/도**
4972
+
4973
+ - billTo\_city?: string
4974
+
4975
+ **청구지 도시**
4976
+
4977
+ - billTo\_country?: string
4978
+
4979
+ **청구지 국가코드**
4980
+
4981
+ - billTo\_firstName?: string
4982
+
4983
+ **청구인 이름**
4984
+
4985
+ - billTo\_lastName?: string
4986
+
4987
+ **청구인 성**
4988
+
4989
+ - billTo\_phoneNumber?: string
4990
+
4991
+ **청구인 연락처**
4992
+
4993
+ - billTo\_postalCode?: string
4994
+
4995
+ **청구지 우편번호**
4996
+
4997
+ - billTo\_state?: string
4998
+
4999
+ **청구지 주/도**
5000
+
5001
+ - billTo\_street1?: string
5002
+
5003
+ **청구지 주소**
5004
+
5005
+ - siteforeigncur?: string
5006
+
5007
+ **외화 표시 통화**
4662
5008
 
4663
5009
  </div>
4664
5010
 
@@ -4716,7 +5062,9 @@ IMP.request_pay(
4716
5062
  ```json
4717
5063
  {
4718
5064
  "bypass": {
4719
- "issuercountry": "KR"
5065
+ "eximbay": {
5066
+ "issuercountry": "KR"
5067
+ }
4720
5068
  }
4721
5069
  }
4722
5070
  ```
@@ -4753,7 +5101,9 @@ IMP.request_pay({
4753
5101
  buyer_postcode: "123-456",
4754
5102
  popup: false,
4755
5103
  bypass: {
4756
- issuercountry: "KR",
5104
+ eximbay: {
5105
+ issuercountry: "KR",
5106
+ },
4757
5107
  },
4758
5108
  });
4759
5109
  ```
@@ -4927,12 +5277,24 @@ IMP.request_pay(
4927
5277
 
4928
5278
  **구매자 이메일 주소**
4929
5279
 
5280
+ - buyer\_addr?: string
5281
+
5282
+ **구매자 주소**
5283
+
5284
+ - buyer\_postcode?: string
5285
+
5286
+ **구매자 우편번호**
5287
+
4930
5288
  - m\_redirect\_url?: string
4931
5289
 
4932
5290
  **모바일 환경에서 트랜잭션 종료 후 302 리디렉션 될 URL**
4933
5291
 
4934
5292
  주의: 갤럭시아머니트리의 경우 **모바일 환경에서 필수 입력**입니다.
4935
5293
 
5294
+ - custom\_data?: object
5295
+
5296
+ **가맹점 커스텀 데이터**
5297
+
4936
5298
  - notice\_url?: string 또는 **string\[]**
4937
5299
 
4938
5300
  **트랜잭션 종료 후 웹훅이 발송 될 고객사 서버 URL**
@@ -5380,7 +5742,7 @@ targetVersions:
5380
5742
  ## SDK 결제 요청하기
5381
5743
 
5382
5744
  [JavaScript SDK (신규)](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme)의 `IMP.request_pay(param, callback)`을 호출하여
5383
- KSNET 결제창을 호출할 수 있습니다. **결제결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
5745
+ 이니시스 일본결제 결제창을 호출할 수 있습니다. **결제결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
5384
5746
  **callback**으로 수신되고 모바일의 경우 **m\_redirect\_url**로 리디렉션됩니다.
5385
5747
 
5386
5748
  <div class="hint" data-style="info">
@@ -5444,10 +5806,8 @@ IMP.request_pay(
5444
5806
  close: "23:00",
5445
5807
  },
5446
5808
  },
5447
- card: {
5448
- display: {
5449
- card_quota: [0, 3, 5, 6, 10, 12],
5450
- },
5809
+ display: {
5810
+ card_quota: [0, 3, 5, 6, 10, 12],
5451
5811
  },
5452
5812
  cvs: {
5453
5813
  payment_deadline: {
@@ -5500,6 +5860,8 @@ IMP.request_pay(
5500
5860
 
5501
5861
  고객사에서 매번 고유하게 채번되어야 합니다.
5502
5862
 
5863
+ 알파벳 대소문자, 숫자 및 일부 특수문자만 사용이 가능하여 사용에 유의가 필요합니다.
5864
+
5503
5865
  - name: string
5504
5866
 
5505
5867
  **주문명**
@@ -5524,7 +5886,7 @@ IMP.request_pay(
5524
5886
 
5525
5887
  **결제창 팝업 여부**
5526
5888
 
5527
- 이니시스 일본결제는 팝업 결제창만 지원합니다. (iframe 미지원)
5889
+ 이니시스 일본결제는 PC환경에서는 팝업 결제창만 지원합니다. (iframe 미지원)
5528
5890
 
5529
5891
  - buyer\_name: string
5530
5892
 
@@ -5610,20 +5972,17 @@ IMP.request_pay(
5610
5972
 
5611
5973
  HH:mm 포맷으로 입력해야하며 00:00\~23:59 범위의 값만 허용합니다.
5612
5974
 
5613
- - card?: object
5614
-
5615
- **카드 결제 시 파라미터**
5616
-
5617
- - display?: object
5975
+ - display?: object
5618
5976
 
5619
- - card\_quota?: number\[]
5977
+ - card\_quota?: number\[]
5620
5978
 
5621
- **카드 할부 개월수 리스트**
5979
+ **카드 할부 개월수 리스트**
5622
5980
 
5623
- 이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
5981
+ 이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
5624
5982
 
5625
- - `[]`: 할부개월 수로 일시불만 노출
5626
- - `[3, 5, 6]`: 할부개월 수로 일시불 및 3, 5, 6개월 노출
5983
+ - `[0]`: 일시불만 노출
5984
+ - `[3, 5, 6]`: 할부개월 수로 3, 5, 6개월 노출
5985
+ - `[0, 3, 5, 6]`: 할부개월 수로 일시불 및 3, 5, 6개월 노출
5627
5986
 
5628
5987
  - cvs?: object
5629
5988
 
@@ -5637,9 +5996,9 @@ IMP.request_pay(
5637
5996
 
5638
5997
  - valid\_hours?: integer
5639
5998
 
5640
- **유효 시간**
5999
+ **유효 시간 (시간 단위)**
5641
6000
 
5642
- 이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
6001
+ 편의점 결제의 지불기한을 시간 단위로 지정합니다. 현재 시간 기준으로 계산되며 최소 1일\~최대 30일 범위의 일수로 변환됩니다.
5643
6002
 
5644
6003
  - due\_date?: string
5645
6004
 
@@ -5647,6 +6006,18 @@ IMP.request_pay(
5647
6006
 
5648
6007
  시간은 ISO8601 형식으로 입력해야 합니다.
5649
6008
 
6009
+ - m\_redirect\_url?: string
6010
+
6011
+ **모바일 결제 후 리디렉션 될 URL**
6012
+
6013
+ - notice\_url?: string | string\[]
6014
+
6015
+ **웹훅 수신 URL**
6016
+
6017
+ - custom\_data?: object
6018
+
6019
+ **가맹점 커스텀 데이터**
6020
+
5650
6021
  - bypass?: object
5651
6022
 
5652
6023
  - inicis\_jp?: object
@@ -5698,12 +6069,11 @@ IMP.request_pay(
5698
6069
  buyer_name: "Port One",
5699
6070
  buyer_email: "buyer@example.com",
5700
6071
  buyer_tel: "0216705176",
6072
+ customer_id: "customer_portone",
5701
6073
  m_redirect_url: "https://helloworld.com/payments/result",
5702
6074
  notice_url: "https://helloworld.com/api/v1/payments/notice",
5703
- card: {
5704
- display: {
5705
- card_quota: [0, 3, 5, 6, 10, 12],
5706
- },
6075
+ display: {
6076
+ card_quota: [0, 3, 5, 6, 10, 12],
5707
6077
  },
5708
6078
  bypass: {
5709
6079
  inicis_jp: {
@@ -5744,6 +6114,8 @@ IMP.request_pay(
5744
6114
 
5745
6115
  고객사에서 매번 고유하게 채번되어야 합니다.
5746
6116
 
6117
+ 알파벳 대소문자, 숫자 및 일부 특수문자만 사용이 가능하여 사용에 유의가 필요합니다.
6118
+
5747
6119
  - name: string
5748
6120
 
5749
6121
  **주문명**
@@ -5768,7 +6140,7 @@ IMP.request_pay(
5768
6140
 
5769
6141
  **결제창 팝업 여부**
5770
6142
 
5771
- 이니시스 일본결제는 팝업 결제창만 지원합니다. (iframe 미지원)
6143
+ 이니시스 일본결제는 PC환경에서는 팝업 결제창만 지원합니다. (iframe 미지원)
5772
6144
 
5773
6145
  - buyer\_name: string
5774
6146
 
@@ -5782,18 +6154,35 @@ IMP.request_pay(
5782
6154
 
5783
6155
  **주문자 연락처**
5784
6156
 
5785
- - card?: object
6157
+ - customer\_id: string
6158
+
6159
+ **구매자 ID**
6160
+
6161
+ CBT 유형이 SBPS인 경우 필수 입력이며 최대 30자로 설정해야합니다.
6162
+
6163
+ - display?: object
6164
+
6165
+ - card\_quota?: number\[]
5786
6166
 
5787
- - display?: object
6167
+ **카드 할부 개월수 리스트**
6168
+
6169
+ 이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
5788
6170
 
5789
- - card\_quota?: number\[]
6171
+ - `[0]`: 일시불만 노출
6172
+ - `[3, 5, 6]`: 할부개월 수로 3, 5, 6개월 노출
6173
+ - `[0, 3, 5, 6]`: 할부개월 수로 일시불 및 3, 5, 6개월 노출
5790
6174
 
5791
- **카드 할부 개월수 리스트**
6175
+ - m\_redirect\_url?: string
5792
6176
 
5793
- 이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
6177
+ **모바일 결제 리디렉션 URL**
6178
+
6179
+ - notice\_url?: string | string\[]
5794
6180
 
5795
- - `[]`: 할부개월 수로 일시불만 노출
5796
- - `[3, 5, 6]`: 할부개월 수로 일시불 및 3, 5, 6개월 노출
6181
+ **웹훅 수신 URL**
6182
+
6183
+ - custom\_data?: object
6184
+
6185
+ **가맹점 커스텀 데이터**
5797
6186
 
5798
6187
  - bypass?: object
5799
6188
 
@@ -5956,6 +6345,7 @@ IMP.request_pay(
5956
6345
  - `phone` (휴대폰소액결제)
5957
6346
  - `cultureland` (컬쳐랜드 문화상품권)
5958
6347
  - `smartculture` (스마트문상)
6348
+ - `happymoney` (해피머니 문화상품권)
5959
6349
  - `booknlife`(도서문화상품권)
5960
6350
 
5961
6351
  </details>
@@ -5966,22 +6356,93 @@ IMP.request_pay(
5966
6356
 
5967
6357
  매번 고유하게 채번되어야 합니다.
5968
6358
 
6359
+ - name: string
6360
+
6361
+ **주문명**
6362
+
5969
6363
  - amount: number
5970
6364
 
5971
6365
  **결제금액**
5972
6366
 
5973
6367
  **string** 이 아닌점에 유의하세요
5974
6368
 
6369
+ - buyer\_name?: string
6370
+
6371
+ **구매자 이름**
6372
+
6373
+ - buyer\_email?: string
6374
+
6375
+ **구매자 이메일**
6376
+
5975
6377
  - buyer\_tel: string
5976
6378
 
5977
6379
  **주문자연락처**
5978
6380
 
5979
6381
  필수 파라미터 입니다.
5980
6382
 
6383
+ - buyer\_addr?: string
6384
+
6385
+ **구매자 주소**
6386
+
6387
+ - buyer\_postcode?: string
6388
+
6389
+ **구매자 우편번호**
6390
+
6391
+ - escrow?: boolean
6392
+
6393
+ **에스크로 결제 여부**
6394
+
6395
+ - tax\_free?: number
6396
+
6397
+ **면세금액**
6398
+
5981
6399
  - vbank\_due?: string
5982
6400
 
5983
6401
  가상계좌 입금마감일시를 지정할수 있습니다.(미 지정시 Default 30일)
5984
6402
 
6403
+ - m\_redirect\_url?: string
6404
+
6405
+ **모바일 결제 후 리디렉션 될 URL**
6406
+
6407
+ - app\_scheme?: string
6408
+
6409
+ **모바일 앱 URL scheme** (모바일 전용)
6410
+
6411
+ 모바일 앱에서 결제 시 ISP/앱카드 등에서 결제 완료 후 가맹점 앱으로 돌아올 때 사용됩니다.
6412
+
6413
+ - notice\_url?: string | string\[]
6414
+
6415
+ **웹훅 수신 URL**
6416
+
6417
+ 포트원 관리자 콘솔에 설정한 웹훅 URL 대신 사용할 URL을 지정합니다.
6418
+
6419
+ - confirm\_url?: string
6420
+
6421
+ **Confirm process URL**
6422
+
6423
+ - custom\_data?: object
6424
+
6425
+ **가맹점 커스텀 데이터**
6426
+
6427
+ 결제 정보와 함께 저장할 커스텀 데이터입니다. 결제 조회 시 반환됩니다.
6428
+
6429
+ - customer\_id?: string
6430
+
6431
+ **구매자 고유 ID**
6432
+
6433
+ - digital?: boolean
6434
+
6435
+ **디지털 컨텐츠 여부**
6436
+
6437
+ 휴대폰 소액결제 시 디지털 컨텐츠(`true`)인지 실물 상품(`false`)인지 구분합니다.
6438
+
6439
+ - language?: string
6440
+
6441
+ **결제창 언어**
6442
+
6443
+ - `ko`: 한국어 (기본값)
6444
+ - `en`: 영어
6445
+
5985
6446
  - period?: object
5986
6447
 
5987
6448
  고객이 구매하는 제품에 대한 제공기간을 명시합니다.
@@ -5994,6 +6455,58 @@ IMP.request_pay(
5994
6455
 
5995
6456
  **YYYYMMDD**
5996
6457
 
6458
+ - bypass?: object
6459
+
6460
+ **KG이니시스 전용 파라미터**
6461
+
6462
+ PC와 모바일에서 사용하는 파라미터가 다릅니다.
6463
+
6464
+ - acceptmethod?: string
6465
+
6466
+ **PC 전용 옵션** (콜론 `:` 구분자로 여러 값 연결)
6467
+
6468
+ - `noeasypay`: 간편결제 버튼을 통합결제창에서 제외
6469
+ - `CARDPOINT`: 카드사 포인트 사용
6470
+ - `no_receipt`: 현금영수증 미발행
6471
+ - `SKIN(색상)`: 결제창 배경색상 변경. 색상표 값으로 설정 가능 (예: `SKIN(BLUE)`). 미설정 시 기본값 `#c1272c`
6472
+ - `cardshowopt(카드코드-호출옵션)`: 신용카드 ACS 창에서 앱카드/안심클릭/간편결제 UI 표시 옵션. 카드코드와 호출옵션은 `-`로 구분 (예: `cardshowopt(04-6)`)
6473
+ - `disablepoint`: 현대카드 M포인트 강제 미사용
6474
+ - `usespcp`: 현대카드 M포인트 사용
6475
+ - `cd_ps(카드코드-할부개월)`: 신한카드 제휴 옵션 (배송비 혜택)
6476
+
6477
+ 예시: `"acceptmethod": "noeasypay:CARDPOINT:SKIN(BLUE)"`
6478
+
6479
+ - P\_RESERVED?: string
6480
+
6481
+ **모바일 전용 옵션** (`&` 구분자로 여러 값 연결)
6482
+
6483
+ - `noeasypay=Y`: 간편결제 버튼을 통합결제창에서 제외
6484
+ - `cp_yn=Y`: 신용카드 포인트 사용
6485
+ - `dcp_yn=Y`: 카드사 다이렉트 호출 시 카드 포인트 사용
6486
+ - `vbank_receipt=Y`: 가상계좌 현금영수증 입력란 표시 (기본적으로 미표시)
6487
+ - `bank_receipt=N`: 계좌이체 현금영수증 입력란 숨김 (기본적으로 표시)
6488
+ - `twotrs_bank=Y`: 계좌이체 거래 시 필수 입력 값
6489
+ - `apprun_check=Y`: 앱 호출 시 Intent 방식으로 호출 (Android 전용, `app_scheme`과 같이 사용 불가)
6490
+ - `app_scheme=스키마명://`: 가맹점 앱 scheme 설정 (iOS 지원, ISP/뱅크월렛/은련카드/LPAY/페이코 등)
6491
+ - `iosapp=Y`: iOS 앱에서 결제 시 설정
6492
+ - `cardshowopt=카드코드:호출옵션`: 신용카드 ACS 창 표시 옵션
6493
+
6494
+ 예시: `"P_RESERVED": "noeasypay=Y&twotrs_bank=Y&apprun_check=Y"`
6495
+
6496
+ - ini\_PAYSHOT\_KEY?: string
6497
+
6498
+ **현대카드 Payshot 고객 Key** (PC 전용)
6499
+
6500
+ 현대카드 Payshot 사용 시 필수 입력합니다.
6501
+ 형식: `{가맹점구분}{YYYYMMDDHHMMSSmsec}{고객id}`
6502
+
6503
+ - P\_PAYSHOT\_KEY?: string
6504
+
6505
+ **현대카드 Payshot 고객 Key** (모바일 전용)
6506
+
6507
+ 현대카드 Payshot 사용 시 필수 입력합니다.
6508
+ 형식: `{가맹점구분}{YYYYMMDDHHMMSSmsec}{고객id}`
6509
+
5997
6510
  </div>
5998
6511
 
5999
6512
  <div class="tabs-content" data-title="비인증 결제창 요청">
@@ -6062,12 +6575,65 @@ IMP.request_pay(
6062
6575
 
6063
6576
  비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
6064
6577
 
6578
+ - merchant\_uid: string
6579
+
6580
+ **주문번호**
6581
+
6582
+ - name: string
6583
+
6584
+ **주문명**
6585
+
6065
6586
  - amount: number
6066
6587
 
6067
6588
  **결제금액**
6068
6589
 
6069
6590
  결제창에 표시될 금액으로 실제 승인은 이루어지지 않습니다.(실 결제를 발생시키기 위해서는 **customer\_uid** 로 **REST API 를 이용하여 결제요청**을 해주셔야 합니다.)
6070
6591
 
6592
+ - buyer\_name?: string
6593
+
6594
+ **구매자 이름**
6595
+
6596
+ - buyer\_email?: string
6597
+
6598
+ **구매자 이메일**
6599
+
6600
+ - buyer\_tel?: string
6601
+
6602
+ **구매자 연락처**
6603
+
6604
+ - m\_redirect\_url?: string
6605
+
6606
+ **모바일 결제 후 리디렉션 될 URL**
6607
+
6608
+ - app\_scheme?: string
6609
+
6610
+ **모바일 앱 URL scheme** (모바일 전용)
6611
+
6612
+ - notice\_url?: string | string\[]
6613
+
6614
+ **웹훅 수신 URL**
6615
+
6616
+ - custom\_data?: object
6617
+
6618
+ **가맹점 커스텀 데이터**
6619
+
6620
+ - customer\_id?: string
6621
+
6622
+ **구매자 고유 ID**
6623
+
6624
+ - bypass?: object
6625
+
6626
+ **빌링키 발급 전용 파라미터**
6627
+
6628
+ - inicis?: object
6629
+
6630
+ - authtype?: string
6631
+
6632
+ **빌링키 발급 결제창 표시 구분** (모바일 전용)
6633
+
6634
+ - `01`: 카드번호, 유효기간, 생일 입력 부분만 표시
6635
+ - 미전달: 카드번호, 유효기간, 주민번호, 비밀번호 입력 부분 표시
6636
+
6071
6637
  **빌링키(customer\_uid)로 결제 요청하기**
6072
6638
 
6073
6639
  빌링키 발급이 성공하면 실 빌링키는 customer\_uid 와 1:1 매칭되어 **포트원 서버에 저장**됩니다. customer\_uid를 고객사 내부서버에 저장하시고 [**비 인증 결제요청 REST API**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)를 호출하시면 결제를 발생시킬 수 있습니다.
@@ -6436,12 +7002,98 @@ IMP.request_pay(
6436
7002
 
6437
7003
  매번 고유하게 채번되어야 합니다.
6438
7004
 
7005
+ - name: string
7006
+
7007
+ **주문명**
7008
+
6439
7009
  - amount: number
6440
7010
 
6441
7011
  **결제금액**
6442
7012
 
6443
7013
  **string** 이 아닌점에 유의하세요
6444
7014
 
7015
+ - buyer\_name?: string
7016
+
7017
+ **구매자 이름**
7018
+
7019
+ - buyer\_email?: string
7020
+
7021
+ **구매자 이메일**
7022
+
7023
+ - buyer\_tel?: string
7024
+
7025
+ **구매자 연락처**
7026
+
7027
+ - buyer\_addr?: string
7028
+
7029
+ **구매자 주소**
7030
+
7031
+ - buyer\_postcode?: string
7032
+
7033
+ **구매자 우편번호**
7034
+
7035
+ - tax\_free?: number
7036
+
7037
+ **면세금액**
7038
+
7039
+ - m\_redirect\_url?: string
7040
+
7041
+ **모바일 결제 후 리디렉션 될 URL**
7042
+
7043
+ - app\_scheme?: string
7044
+
7045
+ **모바일 앱 URL scheme** (모바일 전용, iOS만 지원)
7046
+
7047
+ 카카오페이 정책에 따라 iOS에서만 사용 가능합니다.
7048
+
7049
+ - notice\_url?: string | string\[]
7050
+
7051
+ **웹훅 수신 URL**
7052
+
7053
+ - confirm\_url?: string
7054
+
7055
+ **Confirm process URL**
7056
+
7057
+ - custom\_data?: object
7058
+
7059
+ **가맹점 커스텀 데이터**
7060
+
7061
+ - customer\_id?: string
7062
+
7063
+ **구매자 고유 ID**
7064
+
7065
+ - display?: object
7066
+
7067
+ **카드 할부 설정**
7068
+
7069
+ - card\_quota?: number\[]
7070
+
7071
+ **할부 개월수**
7072
+
7073
+ 단일 값만 지정 가능합니다. 지정 시 해당 개월수로 고정됩니다.
7074
+
7075
+ - card?: object
7076
+
7077
+ **카드 필터링**
7078
+
7079
+ - detail?: object\[]
7080
+
7081
+ **사용 가능한 카드사 목록**
7082
+
7083
+ - card\_code?: string
7084
+
7085
+ **카드사 코드**
7086
+
7087
+ - enabled?: boolean
7088
+
7089
+ **활성화 여부**
7090
+
7091
+ - kakaopayMobileAsPC?: boolean
7092
+
7093
+ **모바일에서 PC URL 사용 여부** (모바일 전용)
7094
+
7095
+ `true` 설정 시 모바일 환경에서 PC용 결제 URL을 사용합니다.
7096
+
6445
7097
  - bypass?: object
6446
7098
 
6447
7099
  **PG사 전용 파라미터**
@@ -6459,6 +7111,10 @@ IMP.request_pay(
6459
7111
 
6460
7112
  미입력 시 사용 가능한 전체 결제수단 허용
6461
7113
 
7114
+ - custom\_message?: string
7115
+
7116
+ **카카오페이 결제 UI에 표시되는 커스텀 메시지**
7117
+
6462
7118
  </div>
6463
7119
 
6464
7120
  <div class="tabs-content" data-title="정기결제창 요청">
@@ -6530,6 +7186,14 @@ IMP.request_pay(
6530
7186
 
6531
7187
  비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
6532
7188
 
7189
+ - merchant\_uid: string
7190
+
7191
+ **주문번호**
7192
+
7193
+ - name: string
7194
+
7195
+ **주문명**
7196
+
6533
7197
  - amount: number
6534
7198
 
6535
7199
  **결제금액**
@@ -6538,6 +7202,34 @@ IMP.request_pay(
6538
7202
 
6539
7203
  (실 결제를 원하지 않은 경우 amount 금액을 0원으로 설정합니다.)
6540
7204
 
7205
+ - buyer\_name?: string
7206
+
7207
+ **구매자 이름**
7208
+
7209
+ - buyer\_email?: string
7210
+
7211
+ **구매자 이메일**
7212
+
7213
+ - buyer\_tel?: string
7214
+
7215
+ **구매자 연락처**
7216
+
7217
+ - m\_redirect\_url?: string
7218
+
7219
+ **모바일 결제 후 리디렉션 될 URL**
7220
+
7221
+ - notice\_url?: string | string\[]
7222
+
7223
+ **웹훅 수신 URL**
7224
+
7225
+ - custom\_data?: object
7226
+
7227
+ **가맹점 커스텀 데이터**
7228
+
7229
+ - customer\_id?: string
7230
+
7231
+ **구매자 고유 ID**
7232
+
6541
7233
  **빌링키(customer\_uid)로 결제 요청하기**
6542
7234
 
6543
7235
  빌링키 발급이 성공하면 실 빌링키는 customer\_uid 와 1:1 매칭되어 **포트원 서버에 저장**됩니다. customer\_uid를 고객사 내부서버에 저장하시고 [**비 인증 결제요청 REST API**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)를 호출하시면 결제를 발생시킬 수 있습니다.
@@ -6556,9 +7248,9 @@ curl -H "Content-Type: application/json" \
6556
7248
 
6557
7249
  <details>
6558
7250
 
6559
- <summary> 부가세 지정 미지원</summary>
7251
+ <summary> 부가세(`vat_amount`) 지정 미지원</summary>
6560
7252
 
6561
- - 카카오페이 결제 시 부가세 지정은 지원하지 않습니다.
7253
+ - 카카오페이 결제 시 `vat_amount`(부가세) 직접 지정은 지원하지 않습니다. `tax_free`(면세금액)는 지원됩니다.
6562
7254
  - 카카오페이 결제 취소 시 부가세 지정은 지원하지 않습니다.
6563
7255
 
6564
7256
  </details>
@@ -6782,13 +7474,13 @@ const response = await fetch(
6782
7474
  # https://developers.portone.io/opi/ko/integration/pg/v1/kg-mobilians-v2
6783
7475
 
6784
7476
  ---
6785
- title: KG모빌리언스 (신모듈)
6786
- description: KG모빌리언스 (신모듈) 결제 연동 방법을 안내합니다.
7477
+ title: KG파이낸셜 (신모듈)
7478
+ description: KG파이낸셜 (신모듈) 결제 연동 방법을 안내합니다.
6787
7479
  targetVersions:
6788
7480
  - v1
6789
7481
  ---
6790
7482
 
6791
- ## 1. KG모빌리언스 채널 설정하기
7483
+ ## 1. KG파이낸셜 채널 설정하기
6792
7484
 
6793
7485
  [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
6794
7486
 
@@ -6797,7 +7489,7 @@ targetVersions:
6797
7489
  ## 2. 결제 요청하기
6798
7490
 
6799
7491
  [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
6800
- KG 모빌리언스 결제창을 호출할 수 있습니다.
7492
+ KG파이낸셜 결제창을 호출할 수 있습니다.
6801
7493
  **결제 결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후 **callback** 으로 수신되고
6802
7494
  모바일의 경우 **m\_redirect\_url**로 리디렉션됩니다.
6803
7495
 
@@ -6961,7 +7653,7 @@ IMP.request_pay(
6961
7653
 
6962
7654
  **카드 포인트 사용 여부 (일반 카드 결제시 사용가능)**
6963
7655
 
6964
- 모빌리언스 서비스 ID에 포인트 사용 설정 필요
7656
+ KG파이낸셜 서비스 ID에 포인트 사용 설정 필요
6965
7657
 
6966
7658
  - card?: object
6967
7659
 
@@ -6985,7 +7677,7 @@ IMP.request_pay(
6985
7677
 
6986
7678
  **카드사 다이렉트 호출 시 적용할 카드 포인트 사용 여부**
6987
7679
 
6988
- 모빌리언스 서비스 ID에 포인트 사용 설정 필요
7680
+ KG파이낸셜 서비스 ID에 포인트 사용 설정 필요
6989
7681
 
6990
7682
  기본값: 사용자 선택
6991
7683
 
@@ -7048,7 +7740,7 @@ IMP.request_pay(
7048
7740
 
7049
7741
  - mobilians\_v2?: object
7050
7742
 
7051
- **모빌리언스 전용 파라미터**
7743
+ **KG파이낸셜 전용 파라미터**
7052
7744
 
7053
7745
  - cp\_logo?: string
7054
7746
 
@@ -7059,7 +7751,7 @@ IMP.request_pay(
7059
7751
 
7060
7752
  기본값: `N`
7061
7753
 
7062
- 사전에 모빌리언스 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
7754
+ 사전에 KG파이낸셜 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
7063
7755
 
7064
7756
  <div class="hint" data-style="info">
7065
7757
 
@@ -7210,7 +7902,7 @@ IMP.request_pay(
7210
7902
 
7211
7903
  기본값: `N`
7212
7904
 
7213
- 사전에 모빌리언스 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
7905
+ 사전에 KG파이낸셜 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
7214
7906
 
7215
7907
  - EMAIL\_HIDDEN?: string
7216
7908
 
@@ -7333,7 +8025,7 @@ IMP.request_pay(
7333
8025
 
7334
8026
  - mobilians\_v2?: object
7335
8027
 
7336
- **모빌리언스 전용 파라미터**
8028
+ **KG파이낸셜 전용 파라미터**
7337
8029
 
7338
8030
  - cp\_logo?: string
7339
8031
 
@@ -7343,7 +8035,7 @@ IMP.request_pay(
7343
8035
  - `N`: 미표기
7344
8036
 
7345
8037
  기본값: `N`
7346
- 사전에 모빌리언스 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
8038
+ 사전에 KG파이낸셜 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
7347
8039
 
7348
8040
  - css\_type?: string
7349
8041
 
@@ -7518,7 +8210,7 @@ IMP.request_pay(
7518
8210
 
7519
8211
  - mobilians\_v2?: object
7520
8212
 
7521
- **모빌리언스 전용 파라미터**
8213
+ **KG파이낸셜 전용 파라미터**
7522
8214
 
7523
8215
  - cp\_logo?: string
7524
8216
 
@@ -7528,7 +8220,7 @@ IMP.request_pay(
7528
8220
  - `N`: 미표기
7529
8221
 
7530
8222
  기본값: `N`
7531
- 사전에 모빌리언스 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
8223
+ 사전에 KG파이낸셜 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
7532
8224
 
7533
8225
  - css\_type?: string
7534
8226
 
@@ -7581,7 +8273,7 @@ IMP.request_pay(
7581
8273
 
7582
8274
  <summary>매출전표 미지원</summary>
7583
8275
 
7584
- - 모빌리언스 결제는 매출전표를 제공하지 않습니다.
8276
+ - KG파이낸셜 결제는 매출전표를 제공하지 않습니다.
7585
8277
 
7586
8278
  </details>
7587
8279
 
@@ -7614,11 +8306,11 @@ IMP.request_pay(
7614
8306
 
7615
8307
  <summary>결제 취소 시 과세 처리</summary>
7616
8308
 
7617
- - **과세**: 입력한 부가세와 상관없이 모빌리언스에서 자동 계산된 부가세 기준으로 처리됩니다.
8309
+ - **과세**: 입력한 부가세와 상관없이 KG파이낸셜에서 자동 계산된 부가세 기준으로 처리됩니다.
7618
8310
 
7619
8311
  - **복합 과세**:
7620
8312
  - 첫번째 취소: 입력한 면세액, 부가세액 기준으로 처리됨
7621
- - 두번째(마지막) 취소: 입력한 면세액, 부가세액과 상관없이 모빌리언스에서 자동 계산된 나머지 금액을 취소함
8313
+ - 두번째(마지막) 취소: 입력한 면세액, 부가세액과 상관없이 KG파이낸셜에서 자동 계산된 나머지 금액을 취소함
7622
8314
 
7623
8315
  </details>
7624
8316
 
@@ -7635,7 +8327,7 @@ IMP.request_pay(
7635
8327
  <summary>면세액(`tax_free`), 부가세(`vat`) 파라미터 사용 관련</summary>
7636
8328
 
7637
8329
  카드, 간편결제에서만 면세액(`tax_free`), 부가세(`vat`) 파라미터를 사용할 수 있습니다.
7638
- 면세액과 부가세 파라미터 사용 시 올바르게 계산된 금액을 입력해야 합니다. 그렇지 않으면 결제가 실패하거나 모빌리언스 측에서 계산된 금액이 적용되어 의도하지 않은 면세액, 부가세 정보로 거래가 발생할 수 있습니다.
8330
+ 면세액과 부가세 파라미터 사용 시 올바르게 계산된 금액을 입력해야 합니다. 그렇지 않으면 결제가 실패하거나 KG파이낸셜 측에서 계산된 금액이 적용되어 의도하지 않은 면세액, 부가세 정보로 거래가 발생할 수 있습니다.
7639
8331
 
7640
8332
  </details>
7641
8333
 
@@ -7651,7 +8343,7 @@ IMP.request_pay(
7651
8343
 
7652
8344
  <summary>가상계좌 환불 처리</summary>
7653
8345
 
7654
- 모빌리언스 가상계좌 환불은 **매주 목요일 일괄 입금** 처리됩니다.
8346
+ KG파이낸셜 가상계좌 환불은 **매주 목요일 일괄 입금** 처리됩니다.
7655
8347
 
7656
8348
  - **화요일까지 접수된 요청**: 같은 주 목요일 입금
7657
8349
  - **수요일부터 접수된 요청**: 다음 주 목요일 입금
@@ -7662,7 +8354,7 @@ IMP.request_pay(
7662
8354
 
7663
8355
  <summary>모바일 환경 이슈</summary>
7664
8356
 
7665
- - 아이폰 모바일 환경에서 크롬이나 인앱 브라우저에서 계좌이체를 하면 뱅크페이에서 결제 완료 후 **사파리로 이동하는 이슈**가 있습니다. (모빌리언스 수정 예정)
8357
+ - 아이폰 모바일 환경에서 크롬이나 인앱 브라우저에서 계좌이체를 하면 뱅크페이에서 결제 완료 후 **사파리로 이동하는 이슈**가 있습니다. (KG파이낸셜 수정 예정)
7666
8358
  - 팝업을 사용할 수 없는 웹뷰 환경에서는 **애플페이 결제 불가**합니다.
7667
8359
 
7668
8360
  </details>
@@ -7671,13 +8363,13 @@ IMP.request_pay(
7671
8363
  # https://developers.portone.io/opi/ko/integration/pg/v1/kg
7672
8364
 
7673
8365
  ---
7674
- title: KG모빌리언스 (구모듈)
7675
- description: KG모빌리언스 (구모듈) 결제 연동 방법을 안내합니다.
8366
+ title: KG파이낸셜 (구모듈)
8367
+ description: KG파이낸셜 (구모듈) 결제 연동 방법을 안내합니다.
7676
8368
  targetVersions:
7677
8369
  - v1
7678
8370
  ---
7679
8371
 
7680
- ## 1. KG모빌리언스 채널 설정하기
8372
+ ## 1. KG파이낸셜 채널 설정하기
7681
8373
 
7682
8374
  [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
7683
8375
 
@@ -7686,7 +8378,7 @@ targetVersions:
7686
8378
  ## 2. 결제 요청하기
7687
8379
 
7688
8380
  [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
7689
- KG 모빌리언스 결제창을 호출할 수 있습니다.
8381
+ KG파이낸셜 결제창을 호출할 수 있습니다.
7690
8382
  **결제 결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
7691
8383
  **callback** 으로 수신되고
7692
8384
  모바일의 경우 **m\_redirect\_url**로 리디렉션됩니다.
@@ -7741,11 +8433,10 @@ IMP.request_pay(
7741
8433
 
7742
8434
  - pay\_method: string
7743
8435
 
7744
- **결제수단 구분 코드**}
7745
-
7746
- - card (신용카드)
8436
+ **결제수단 구분코드**
7747
8437
 
7748
- - phone (휴대폰 소액 결제)
8438
+ - card (신용카드)
8439
+ - phone (휴대폰 소액결제)
7749
8440
 
7750
8441
  - merchant\_uid: string
7751
8442
 
@@ -7753,12 +8444,66 @@ IMP.request_pay(
7753
8444
 
7754
8445
  매번 고유하게 채번되어야 합니다.
7755
8446
 
8447
+ - name: string
8448
+
8449
+ **주문명**
8450
+
7756
8451
  - amount: number
7757
8452
 
7758
8453
  **결제금액**
7759
8454
 
7760
8455
  **string** 이 아닌점에 유의하세요
7761
8456
 
8457
+ - buyer\_name?: string
8458
+
8459
+ **구매자 이름**
8460
+
8461
+ - buyer\_email?: string
8462
+
8463
+ **구매자 이메일**
8464
+
8465
+ - buyer\_tel?: string
8466
+
8467
+ **구매자 연락처**
8468
+
8469
+ - buyer\_addr?: string
8470
+
8471
+ **구매자 주소**
8472
+
8473
+ - buyer\_postcode?: string
8474
+
8475
+ **구매자 우편번호**
8476
+
8477
+ - vbank\_due?: string
8478
+
8479
+ **가상계좌 입금마감일시**
8480
+
8481
+ `YYYYMMDD` 형식으로 지정합니다. 미지정 시 5일 후로 자동 설정됩니다.
8482
+
8483
+ - m\_redirect\_url?: string
8484
+
8485
+ **모바일 결제 후 리디렉션 될 URL**
8486
+
8487
+ - app\_scheme?: string
8488
+
8489
+ **모바일 앱 URL scheme**
8490
+
8491
+ - notice\_url?: string | string\[]
8492
+
8493
+ **웹훅 수신 URL**
8494
+
8495
+ - confirm\_url?: string
8496
+
8497
+ **Confirm process URL**
8498
+
8499
+ - custom\_data?: object
8500
+
8501
+ **가맹점 커스텀 데이터**
8502
+
8503
+ - customer\_id?: string
8504
+
8505
+ **구매자 고유 ID**
8506
+
7762
8507
  인증결제창 호출 파라미터에서 **customer\_uid** 값을 추가하면 비 인증 결제창을 호출할 수 있습니다. 비
7763
8508
  인증 결제창에서 빌링키를 발급받은 후 해당 빌링키로 결제를 요청합니다.
7764
8509
 
@@ -7788,8 +8533,8 @@ IMP.request_pay(
7788
8533
 
7789
8534
  <div class="hint" data-style="info">
7790
8535
 
7791
- - 비 인증 결제를 위해서는 **KG모빌리언스와 계약이 완료된 MID 정보를** 관리자콘솔에 설정하셔야 비 인증 결제창을 활성화시킬 수 있습니다.
7792
- - **KG모빌리언스 휴대폰 결제는** 빌링키 발급시 **실 결제가 발생됩니다.**
8536
+ - 비 인증 결제를 위해서는 **KG파이낸셜과 계약이 완료된 MID 정보를** 관리자콘솔에 설정하셔야 비 인증 결제창을 활성화시킬 수 있습니다.
8537
+ - **KG파이낸셜 휴대폰 결제는** 빌링키 발급시 **실 결제가 발생됩니다.**
7793
8538
  - 최초 승인일자 기준 매월 **동일한 일자에 동일 금액**이 재결제되어야 합니다.
7794
8539
 
7795
8540
  </div>
@@ -7810,7 +8555,7 @@ IMP.request_pay(
7810
8555
 
7811
8556
  **PG사 구분코드**
7812
8557
 
7813
- **`mobilians.<KG모빌리언스와 계약이 완료된 MID>`** 로 지정하면 됩니다.
8558
+ **`mobilians.<KG파이낸셜과 계약이 완료된 MID>`** 로 지정하면 됩니다.
7814
8559
 
7815
8560
  <div class="hint" data-style="warning">
7816
8561
 
@@ -7846,7 +8591,7 @@ curl -H "Content-Type: application/json" \
7846
8591
  https://api.iamport.kr/subscribe/payments/again
7847
8592
  ```
7848
8593
 
7849
- **포트원을 통해 KG 모빌리언스를 사용할 때에는 API 방식 비 인증 결제를 사용할 수 없습니다.**
8594
+ **포트원을 통해 KG파이낸셜을 사용할 때에는 API 방식 비 인증 결제를 사용할 수 없습니다.**
7850
8595
 
7851
8596
 
7852
8597
  # https://developers.portone.io/opi/ko/integration/pg/v1/kicc-v2
@@ -8216,9 +8961,9 @@ IMP.request_pay(
8216
8961
 
8217
8962
  고객사에서 매번 고유하게 채번되어야 합니다.
8218
8963
 
8219
- - buyer\_tel: string
8964
+ - name: string
8220
8965
 
8221
- **`주문자 연락처`**
8966
+ **주문명**
8222
8967
 
8223
8968
  - amount: number
8224
8969
 
@@ -8226,12 +8971,93 @@ IMP.request_pay(
8226
8971
 
8227
8972
  **string** 이 아닌점에 유의하세요
8228
8973
 
8974
+ - buyer\_name?: string
8975
+
8976
+ **구매자 이름**
8977
+
8978
+ - buyer\_email?: string
8979
+
8980
+ **구매자 이메일**
8981
+
8982
+ - buyer\_tel: string
8983
+
8984
+ **주문자 연락처**
8985
+
8986
+ - buyer\_addr?: string
8987
+
8988
+ **구매자 주소**
8989
+
8990
+ - buyer\_postcode?: string
8991
+
8992
+ **구매자 우편번호**
8993
+
8229
8994
  - escrow?: boolean
8230
8995
 
8231
8996
  **에스크로 설정여부**
8232
8997
 
8233
8998
  계좌이체, 가상계좌만 지원됩니다.
8234
8999
 
9000
+ - tax\_free?: number
9001
+
9002
+ **면세금액**
9003
+
9004
+ - digital?: boolean
9005
+
9006
+ **디지털 컨텐츠 여부**
9007
+
9008
+ - `true`: 컨텐츠
9009
+ - `false`: 실물 상품
9010
+
9011
+ - vbank\_due?: string
9012
+
9013
+ **가상계좌 입금마감일시**
9014
+
9015
+ - company?: string
9016
+
9017
+ **상호명**
9018
+
9019
+ 카드사 다이렉트 호출 시 설정하지 않으면 `iamport`로 표기됩니다.
9020
+
9021
+ - auth\_mode?: string
9022
+
9023
+ **인증 방식**
9024
+
9025
+ - `key-in`: 키인결제 모드
9026
+
9027
+ - m\_redirect\_url?: string
9028
+
9029
+ **모바일 결제 후 리디렉션 될 URL**
9030
+
9031
+ - app\_scheme?: string
9032
+
9033
+ **모바일 앱 URL scheme** (모바일 전용)
9034
+
9035
+ - notice\_url?: string | string\[]
9036
+
9037
+ **웹훅 수신 URL**
9038
+
9039
+ - confirm\_url?: string
9040
+
9041
+ **Confirm process URL**
9042
+
9043
+ - custom\_data?: object
9044
+
9045
+ **가맹점 커스텀 데이터**
9046
+
9047
+ - customer\_id?: string
9048
+
9049
+ **구매자 고유 ID**
9050
+
9051
+ - bypass?: object
9052
+
9053
+ **KICC 전용 파라미터**
9054
+
9055
+ - kicc?: object
9056
+
9057
+ - disp\_cash\_yn?: string
9058
+
9059
+ **현금영수증 표시 여부**
9060
+
8235
9061
  </div>
8236
9062
 
8237
9063
  <div class="tabs-content" data-title="비인증 결제(결제창)">
@@ -8302,6 +9128,14 @@ IMP.request_pay(
8302
9128
 
8303
9129
  비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
8304
9130
 
9131
+ - merchant\_uid: string
9132
+
9133
+ **주문번호**
9134
+
9135
+ - name: string
9136
+
9137
+ **주문명**
9138
+
8305
9139
  - amount: number
8306
9140
 
8307
9141
  **결제금액**
@@ -8310,6 +9144,30 @@ IMP.request_pay(
8310
9144
 
8311
9145
  (실 결제를 발생시키기 위해서는 **`customer_uid`** 로 **REST API 를 이용하여 결제요청**을 해 주셔야 합니다.)
8312
9146
 
9147
+ - buyer\_name?: string
9148
+
9149
+ **구매자 이름**
9150
+
9151
+ - buyer\_email?: string
9152
+
9153
+ **구매자 이메일**
9154
+
9155
+ - buyer\_tel?: string
9156
+
9157
+ **구매자 연락처**
9158
+
9159
+ - m\_redirect\_url?: string
9160
+
9161
+ **모바일 결제 후 리디렉션 될 URL**
9162
+
9163
+ - notice\_url?: string | string\[]
9164
+
9165
+ **웹훅 수신 URL**
9166
+
9167
+ - custom\_data?: object
9168
+
9169
+ **가맹점 커스텀 데이터**
9170
+
8313
9171
  ### 빌링키(`customer_uid`)로 결제 요청하기
8314
9172
 
8315
9173
  빌링키 발급이 성공하면 실 빌링키는 `customer_uid` 와 1:1 매칭되어 **포트원 서버에 저장**됩니다. `customer_uid`를 고객사 내부서버에 저장하시고 [**비 인증 결제요청 REST API**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain) 를 호출하시면 결제를 발생시킬 수 있습니다.
@@ -8506,7 +9364,7 @@ IMP.request_pay(
8506
9364
  name: "나이키 와플 트레이너 2 SD",
8507
9365
  pay_method: "card",
8508
9366
  escrow: false,
8509
- amount: "109000",
9367
+ amount: 109000,
8510
9368
  tax_free: 3000,
8511
9369
  buyer_name: "홍길동",
8512
9370
  buyer_email: "buyer@example.com",
@@ -8606,10 +9464,22 @@ IMP.request_pay(
8606
9464
 
8607
9465
  **구매자명**
8608
9466
 
9467
+ - buyer\_email?: string
9468
+
9469
+ **구매자 이메일**
9470
+
8609
9471
  - buyer\_tel?: string
8610
9472
 
8611
9473
  **구매자 전화번호**
8612
9474
 
9475
+ - buyer\_addr?: string
9476
+
9477
+ **구매자 주소**
9478
+
9479
+ - buyer\_postcode?: string
9480
+
9481
+ **구매자 우편번호**
9482
+
8613
9483
  - currency: string
8614
9484
 
8615
9485
  **결제 통화**
@@ -8691,7 +9561,7 @@ IMP.request_pay(
8691
9561
 
8692
9562
  **통신사 구분**
8693
9563
 
8694
- 통신사에 따라 LG는 `lgt`, KT는 `kgf`, SKT는 `skt`로 입력해야 하며, 통신사 구분이 어려우신 경우
9564
+ 통신사에 따라 LG는 `lgt`, KT는 `ktf`, SKT는 `skt`로 입력해야 하며, 통신사 구분이 어려우신 경우
8695
9565
  임의의 값을 입력하여 요청해도 무방합니다.
8696
9566
 
8697
9567
  - url?: string
@@ -9290,6 +10160,46 @@ IMP.request_pay(
9290
10160
 
9291
10161
  **string** 이 아닌점에 유의하세요
9292
10162
 
10163
+ - buyer\_name?: string
10164
+
10165
+ **구매자 이름**
10166
+
10167
+ - buyer\_email?: string
10168
+
10169
+ **구매자 이메일**
10170
+
10171
+ - buyer\_tel?: string
10172
+
10173
+ **구매자 연락처**
10174
+
10175
+ - buyer\_addr?: string
10176
+
10177
+ **구매자 주소**
10178
+
10179
+ - buyer\_postcode?: string
10180
+
10181
+ **구매자 우편번호**
10182
+
10183
+ - tax\_free?: number
10184
+
10185
+ **면세금액**
10186
+
10187
+ - notice\_url?: string | string\[]
10188
+
10189
+ **웹훅 수신 URL**
10190
+
10191
+ - confirm\_url?: string
10192
+
10193
+ **Confirm process URL**
10194
+
10195
+ - custom\_data?: object
10196
+
10197
+ **가맹점 커스텀 데이터**
10198
+
10199
+ - customer\_id?: string
10200
+
10201
+ **구매자 고유 ID**
10202
+
9293
10203
  - naverUseCfm?: string
9294
10204
 
9295
10205
  **이용 완료일** (`yyyyMMdd` 형식의 문자열로 **결제 당일 또는 미래의 일자**여야 함)
@@ -9467,6 +10377,26 @@ IMP.request_pay(
9467
10377
 
9468
10378
  정기/반복 결제 등록과정에서는 결제승인이 이뤄지지 않습니다.
9469
10379
 
10380
+ - buyer\_name?: string
10381
+
10382
+ **구매자 이름**
10383
+
10384
+ - buyer\_email?: string
10385
+
10386
+ **구매자 이메일**
10387
+
10388
+ - buyer\_tel?: string
10389
+
10390
+ **구매자 연락처**
10391
+
10392
+ - notice\_url?: string | string\[]
10393
+
10394
+ **웹훅 수신 URL**
10395
+
10396
+ - custom\_data?: object
10397
+
10398
+ **가맹점 커스텀 데이터**
10399
+
9470
10400
  - naverProductCode: string
9471
10401
 
9472
10402
  **고객사의 상품코드**
@@ -9784,7 +10714,7 @@ IMP.request_pay(
9784
10714
  name: "나이키 와플 트레이너 2 SD",
9785
10715
  pay_method: "card",
9786
10716
  escrow: false,
9787
- amount: "109000",
10717
+ amount: 109000,
9788
10718
  tax_free: 3000,
9789
10719
  buyer_name: "홍길동",
9790
10720
  buyer_email: "buyer@example.com",
@@ -9856,7 +10786,7 @@ IMP.request_pay(
9856
10786
  - 카카오페이 (kakaopay)
9857
10787
  - 네이버페이 (naverpay)
9858
10788
  - 엘페이 (lpay)
9859
- - 삼성페이(samsung)
10789
+ - 삼성페이(samsungpay)
9860
10790
  - SSGpay (ssgpay)
9861
10791
  - 애플페이 (applepay)
9862
10792
  - 페이코 (payco)
@@ -9868,6 +10798,10 @@ IMP.request_pay(
9868
10798
 
9869
10799
  매번 고유하게 채번되어야 합니다.
9870
10800
 
10801
+ - name: string
10802
+
10803
+ **주문명**
10804
+
9871
10805
  - amount: number
9872
10806
 
9873
10807
  **결제금액**
@@ -9882,10 +10816,52 @@ IMP.request_pay(
9882
10816
 
9883
10817
  **구매자 email 주소**
9884
10818
 
10819
+ - buyer\_tel?: string
10820
+
10821
+ **구매자 연락처**
10822
+
10823
+ - buyer\_addr?: string
10824
+
10825
+ **구매자 주소**
10826
+
10827
+ - buyer\_postcode?: string
10828
+
10829
+ **구매자 우편번호**
10830
+
10831
+ - escrow?: boolean
10832
+
10833
+ **에스크로 결제 여부**
10834
+
10835
+ - tax\_free?: number
10836
+
10837
+ **면세금액**
10838
+
9885
10839
  - currency?: string
9886
10840
 
9887
10841
  **통화구분코드**
9888
10842
 
10843
+ - m\_redirect\_url?: string
10844
+
10845
+ **모바일 결제 후 리디렉션 될 URL**
10846
+
10847
+ 모바일 환경에서 필수 입력합니다.
10848
+
10849
+ - app\_scheme?: string
10850
+
10851
+ **모바일 앱 URL scheme** (모바일 전용)
10852
+
10853
+ - notice\_url?: string | string\[]
10854
+
10855
+ **웹훅 수신 URL**
10856
+
10857
+ - confirm\_url?: string
10858
+
10859
+ **Confirm process URL**
10860
+
10861
+ - custom\_data?: object
10862
+
10863
+ **가맹점 커스텀 데이터**
10864
+
9889
10865
  - appCard?: boolean
9890
10866
 
9891
10867
  카드 결제시, 카드 결제창에 앱카드만 선택 가능하도록 할지 여부 (기본값: **false**)
@@ -9904,20 +10880,32 @@ IMP.request_pay(
9904
10880
 
9905
10881
  - isCulturalExpense?: boolean
9906
10882
 
9907
- 문화비 지출여부
10883
+ **문화비 지출 여부** (bypass 루트 레벨, 계좌이체/가상계좌 전용)
9908
10884
 
9909
- - useInternationalCardOnly?: boolean
9910
-
9911
- 해외카드(Visa, MasterCard, UnionPay) 결제 여부입니다. 값이 `true`면 해외카드 결제가 가능한 영문 결제창이 열립니다.
10885
+ `pay_method`가 `trans` 또는 `vbank`일 때만 토스페이먼츠에 전달됩니다.
9912
10886
 
9913
10887
  - cashReceiptType?: string
9914
10888
 
9915
- 현금성 결제(계좌이체, 가상계좌)창에서 선택할 수 있는 현금영수증 발급 유형 (기본값: 결제창에서 선택 가능)
10889
+ **현금영수증 발급 유형** (bypass 루트 레벨, 계좌이체/가상계좌 전용)
10890
+
10891
+ `pay_method`가 `trans` 또는 `vbank`일 때만 토스페이먼츠에 전달됩니다. 미지정 시 결제창에서 선택 가능합니다.
9916
10892
 
9917
10893
  - anonymous (미발행, 자진발급)
9918
10894
  - personal (소득공제)
9919
10895
  - corporate (지출증빙)
9920
10896
 
10897
+ - tosspayments?: object
10898
+
10899
+ **토스페이먼츠 전용 파라미터** (카드 결제 전용)
10900
+
10901
+ - useInternationalCardOnly?: boolean
10902
+
10903
+ 해외카드(Visa, MasterCard, UnionPay) 결제 여부입니다. 값이 `true`면 해외카드 결제가 가능한 영문 결제창이 열립니다.
10904
+
10905
+ - discountCode?: string
10906
+
10907
+ **카드사 할인코드**
10908
+
9921
10909
  ```json
9922
10910
  {
9923
10911
  "pay_method": "trans",
@@ -9928,6 +10916,18 @@ IMP.request_pay(
9928
10916
  }
9929
10917
  ```
9930
10918
 
10919
+ ```json
10920
+ {
10921
+ "pay_method": "card",
10922
+ "bypass": {
10923
+ "tosspayments": {
10924
+ "useInternationalCardOnly": true,
10925
+ "discountCode": "카드사 할인코드"
10926
+ }
10927
+ }
10928
+ }
10929
+ ```
10930
+
9931
10931
  </details>
9932
10932
 
9933
10933
  </div>
@@ -9996,12 +10996,52 @@ IMP.request_pay(
9996
10996
 
9997
10997
  비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
9998
10998
 
10999
+ - name: string
11000
+
11001
+ **주문명**
11002
+
9999
11003
  - amount: number
10000
11004
 
10001
11005
  **결제금액**
10002
11006
 
10003
11007
  결제창에 표시될 금액으로 실제 승인은 이루어지지 않습니다.(실 결제를 발생시키기 위해서는 **customer\_uid** 로 **REST API 를 이용하여 결제요청**을 해주셔야 합니다.)
10004
11008
 
11009
+ - buyer\_name?: string
11010
+
11011
+ **구매자 이름**
11012
+
11013
+ - buyer\_email?: string
11014
+
11015
+ **구매자 이메일**
11016
+
11017
+ - buyer\_tel?: string
11018
+
11019
+ **구매자 연락처**
11020
+
11021
+ - buyer\_addr?: string
11022
+
11023
+ **구매자 주소**
11024
+
11025
+ - buyer\_postcode?: string
11026
+
11027
+ **구매자 우편번호**
11028
+
11029
+ - m\_redirect\_url?: string
11030
+
11031
+ **모바일 결제 후 리디렉션 될 URL**
11032
+
11033
+ - app\_scheme?: string
11034
+
11035
+ **모바일 앱 URL scheme** (모바일 전용)
11036
+
11037
+ - notice\_url?: string | string\[]
11038
+
11039
+ **웹훅 수신 URL**
11040
+
11041
+ - custom\_data?: object
11042
+
11043
+ **가맹점 커스텀 데이터**
11044
+
10005
11045
  - customer\_id?: string
10006
11046
 
10007
11047
  **`구매자 식별자`**
@@ -10732,7 +11772,6 @@ IMP.request_pay(
10732
11772
  channelKey: "{콘솔 내 연동 정보의 채널키}",
10733
11773
  merchant_uid: "order_no_0001",
10734
11774
  name: "PIN 변경",
10735
- customer_uid: "use_your_unique_id", //`bypass.kcpQuick.memberId`와 동일하게 입력
10736
11775
  bypass: {
10737
11776
  kcpQuick: {
10738
11777
  actionType: "PinChange",
@@ -10761,7 +11800,6 @@ IMP.request_pay(
10761
11800
  pay_method: "card",
10762
11801
  merchant_uid: "order_no_0001",
10763
11802
  name: "PIN 초기화",
10764
- customer_uid: "use_your_unique_id", // `bypass.kcpQuick.memberId`와 동일하게 입력
10765
11803
  bypass: {
10766
11804
  kcpQuick: {
10767
11805
  actionType: "PinReset",
@@ -10790,7 +11828,6 @@ IMP.request_pay(
10790
11828
  pay_method: "card",
10791
11829
  merchant_uid: "order_no_0001",
10792
11830
  name: "PIN 확인",
10793
- customer_uid: "use_your_unique_id", // `bypass.kcpQuick.memberId`와 동일하게 입력
10794
11831
  bypass: {
10795
11832
  kcpQuick: {
10796
11833
  actionType: "PinCheck",
@@ -10822,7 +11859,6 @@ IMP.request_pay(
10822
11859
  channelKey: "{콘솔 내 연동 정보의 채널키}",
10823
11860
  merchant_uid: "order_no_0001",
10824
11861
  name: "전화번호 변경",
10825
- customer_uid: "use_your_unique_id", // `bypass.kcpQuick.memberId`와 동일하게 입력
10826
11862
  bypass: {
10827
11863
  kcpQuick: {
10828
11864
  actionType: "PhoneChange",
@@ -10892,7 +11928,6 @@ IMP.request_pay(
10892
11928
  channelKey: "{콘솔 내 연동 정보의 채널키}",
10893
11929
  merchant_uid: "order_no_0001",
10894
11930
  name: "간편결제 서비스 해지",
10895
- customer_uid: "use_your_unique_id", //`bypass.kcpQuick.memberId`와 동일하게 입력
10896
11931
  bypass: {
10897
11932
  kcpQuick: {
10898
11933
  actionType: "Terminate",
@@ -10965,7 +12000,7 @@ IMP.request_pay(
10965
12000
  name: "선불머니 환급계좌 등록 및 변경",
10966
12001
  bypass: {
10967
12002
  kcpQuick: {
10968
- actionType: "RefundAccount",
12003
+ actionType: "PrepaidRefundAccount",
10969
12004
  encryptedCI: "encrypted_ci",
10970
12005
  memberID: "use_your_unique_id",
10971
12006
  },
@@ -11111,6 +12146,7 @@ IMP.request_pay(
11111
12146
  - PinCheck : PIN 확인
11112
12147
  - PhoneChange : 전화번호 변경
11113
12148
  - Terminate : 간편결제 서비스 해지
12149
+ - RegisterFido : 생체인증 등록
11114
12150
  - SignUp : 간편결제+선불머니 서비스 유저 등록 (사전 협의 필요)
11115
12151
  - Leave : 간편결제+선불머니 서비스 해지 (사전 협의 필요)
11116
12152
  - PrepaidRefundAccount: 선불머니 환급계좌 등록 및 변경 (사전 협의 필요)
@@ -11145,6 +12181,7 @@ IMP.request_pay(
11145
12181
 
11146
12182
  **디바이스 식별값**
11147
12183
 
12184
+ 고객 단말기별 고유한 아이디를 전달해주시면 됩니다.
11148
12185
  미 입력시 고객이 사용한 브라우저 정보(User-Agent)가 입력됩니다.
11149
12186
 
11150
12187
  - noAuth?: boolean
@@ -11175,16 +12212,6 @@ IMP.request_pay(
11175
12212
 
11176
12213
  <details>
11177
12214
 
11178
- <summary>`customer_uid` 파라미터 안내</summary>
11179
-
11180
- 결제수단 등록/삭제, 결제 요청시에는 결제수단을 식별하는 `customer_uid`를 입력한 후 사용해야 합니다.
11181
- 이 외의 PIN 변경/확인/초기화, 사용자 등록, 해지 요청시에는 `customer_uid`에 결제수단 등록시 입력한 `memberID`를 입력해야 합니다.
11182
- 위의 경우에 `customer_uid` 파라미터에 발급시 입력했던 `customer_uid`를 입력하는 경우 에러가 리턴됩니다.
11183
-
11184
- </details>
11185
-
11186
- <details>
11187
-
11188
12215
  <summary>`encryptedCI` 파라미터 안내</summary>
11189
12216
 
11190
12217
  본인인증 후 전달받은 CI 값을 아래 방법으로 암호화하여 입력해야합니다.
@@ -11291,31 +12318,33 @@ PIN 초기화 이후 [빌링키 삭제 API](https://developers.portone.io/api/re
11291
12318
 
11292
12319
  <details>
11293
12320
 
11294
- <summary>무인증 결제 안내</summary>
11295
-
11296
- 결제 수단 등록, PIN 체크시 `noAuth:true` 파라미터를 추가하여 요청한 경우 무인증 등록이 가능합니다.
11297
- 등록 이후 결제 요청하는 경우 무인증 결제를 이용할 수 있습니다. 무인증 결제시 PIN 입력 과정이 생략되며,
11298
- 바로 결제가 진행됩니다.
11299
-
11300
- 만약 무인증 등록과정 없이 무인증 결제가 요청되는 경우 PIN 입력 화면이 표시되고, 올바른 PIN 입력시 무인증 등록 및 결제가 진행됩니다.
12321
+ <summary>선불머니 기능 이용 시 선불머니 거래사전 등록 API 선행 필요</summary>
11301
12322
 
11302
- </details>
12323
+ 선불머니 관련 기능을 이용하기 위해서는
12324
+ [**선불머니 거래사전 등록 API**](https://developers.portone.io/api/rest-v1/pg.kcpquick?v=v1#post%20%2Fkcpquick%2Fprepare%2F%7Bmerchant_uid%7D)가 반드시 선행되어야 합니다.
11303
12325
 
11304
- <details>
12326
+ **대상 기능 목록:**
11305
12327
 
11306
- <summary>선불머니 결제의 경우 부분취소 불가</summary>
12328
+ - `SignUp`: 간편결제+선불머니 서비스 유저 등록
12329
+ - `Leave`: 간편결제+선불머니 서비스 해지
12330
+ - `PrepaidRefundAccount`: 선불머니 환급계좌 등록 및 변경
12331
+ - `PrepaidRefund`: 선불머니 환급 요청
12332
+ - `PrepaidLimitRaise`: 선불머니 보유한도 상향 요청
12333
+ - `PrepaidKYC`: 선불머니 고객 확인 재이행
11307
12334
 
11308
- 선불머니 결제는 KCP 정책상 부분취소를 지원하지 않으며 전체취소만 가능합니다.
12335
+ 거래사전 등록 API를 호출하지 않은 상태에서 선불머니 기능을 요청하는 경우 에러가 발생할 있으니 유의하시기 바랍니다.
11309
12336
 
11310
- **대안 방법:**
12337
+ </details>
11311
12338
 
11312
- - 부분 환불이 필요한 경우: 전체 취소 후 차액만큼 재결제 진행
12339
+ <details>
11313
12340
 
11314
- <div class="hint" data-style="info">
12341
+ <summary>무인증 결제 안내</summary>
11315
12342
 
11316
- KCP에서 선불머니 부분취소 기능 지원 예정이나, 현재로서는 위의 대안 방법을 활용하시기 바랍니다.
12343
+ 결제 수단 등록, PIN 체크시 `noAuth:true` 파라미터를 추가하여 요청한 경우 무인증 등록이 가능합니다.
12344
+ 등록 이후 결제 요청하는 경우 무인증 결제를 이용할 수 있습니다. 무인증 결제시 PIN 입력 과정이 생략되며,
12345
+ 바로 결제가 진행됩니다.
11317
12346
 
11318
- </div>
12347
+ 만약 무인증 등록과정 없이 무인증 결제가 요청되는 경우 PIN 입력 화면이 표시되고, 올바른 PIN 입력시 무인증 등록 및 결제가 진행됩니다.
11319
12348
 
11320
12349
  </details>
11321
12350
 
@@ -11363,6 +12392,7 @@ targetVersions:
11363
12392
  - 카카오페이 : `kakaopay`
11364
12393
  - 네이버페이 : `naverpay`
11365
12394
  - 애플페이 : `applepay`
12395
+ - 토스페이 : `tosspay`
11366
12396
 
11367
12397
  - 베네피아 포인트 : `point`
11368
12398
 
@@ -11467,12 +12497,15 @@ IMP.request_pay(
11467
12497
  - `cultureland` (컬쳐랜드 문화상품권)
11468
12498
  - `smartculture` (스마트문상)
11469
12499
  - `booknlife` (도서문화상품권)
12500
+ - `happymoney` (해피머니 문화상품권)
11470
12501
  - `payco` (페이코)
11471
12502
  - `lpay` (L페이)
11472
12503
  - `kakaopay` (카카오페이)
11473
12504
  - `naverpay` (네이버페이)
11474
12505
  - `samsung` (삼성페이)
12506
+ - `ssgpay` (SSG페이)
11475
12507
  - `applepay` (애플페이)
12508
+ - `tosspay` (토스페이)
11476
12509
  - `point` (베네피아 포인트)
11477
12510
 
11478
12511
  - merchant\_uid: string
@@ -11481,10 +12514,81 @@ IMP.request_pay(
11481
12514
 
11482
12515
  고객사에서 채번하는 주문 고유 번호로 매번 고유하게 채번되어야 합니다.
11483
12516
 
12517
+ - name: string
12518
+
12519
+ **주문명**
12520
+
11484
12521
  - amount: integer
11485
12522
 
11486
12523
  **결제금액**
11487
12524
 
12525
+ - buyer\_name?: string
12526
+
12527
+ **구매자 이름**
12528
+
12529
+ - buyer\_email?: string
12530
+
12531
+ **구매자 이메일**
12532
+
12533
+ - buyer\_tel?: string
12534
+
12535
+ **구매자 연락처**
12536
+
12537
+ - buyer\_addr?: string
12538
+
12539
+ **구매자 주소**
12540
+
12541
+ - buyer\_postcode?: string
12542
+
12543
+ **구매자 우편번호**
12544
+
12545
+ - escrow?: boolean
12546
+
12547
+ **에스크로 결제 여부**
12548
+
12549
+ - tax\_free?: number
12550
+
12551
+ **면세금액**
12552
+
12553
+ - vbank\_due?: string
12554
+
12555
+ **가상계좌 입금마감일시**
12556
+
12557
+ `YYYYMMDD` 또는 `YYYYMMDDHHmmss` 형식으로 지정합니다. 시간 미지정 시 23:59:59로 설정됩니다.
12558
+
12559
+ - m\_redirect\_url?: string
12560
+
12561
+ **모바일 결제 후 리디렉션 될 URL**
12562
+
12563
+ - app\_scheme?: string
12564
+
12565
+ **모바일 앱 URL scheme** (모바일 전용)
12566
+
12567
+ 모바일 앱에서 결제 시 ISP/앱카드 등에서 결제 완료 후 가맹점 앱으로 돌아올 때 사용됩니다.
12568
+
12569
+ - notice\_url?: string | string\[]
12570
+
12571
+ **웹훅 수신 URL**
12572
+
12573
+ 포트원 관리자 콘솔에 설정한 웹훅 URL 대신 사용할 URL을 지정합니다.
12574
+
12575
+ - confirm\_url?: string
12576
+
12577
+ **Confirm process URL**
12578
+
12579
+ - custom\_data?: object
12580
+
12581
+ **가맹점 커스텀 데이터**
12582
+
12583
+ 결제 정보와 함께 저장할 커스텀 데이터입니다. 결제 조회 시 반환됩니다.
12584
+
12585
+ - language?: string
12586
+
12587
+ **결제창 언어**
12588
+
12589
+ - `ko`: 한국어 (기본값)
12590
+ - `en`: 영어
12591
+
11488
12592
  <br />
11489
12593
 
11490
12594
  #### 기타 파라미터
@@ -11500,8 +12604,10 @@ IMP.request_pay(
11500
12604
  예시
11501
12605
 
11502
12606
  - `[]`: 일시불만 결제 가능
11503
- - `2,3,4,5,6`: 일시불을 포함한 2, 3, 4, 5, 6개월까지 할부개월 선택 가능
11504
- - `3`: 일시불을 포함한 2,3개월까지 할부개월 선택 가능
12607
+ - `[2,3,4,5,6]`: 일시불을 포함한 2, 3, 4, 5, 6개월까지 할부개월 선택 가능
12608
+ - `[3]`: 일시불을 포함한 2, 3개월까지 할부개월 선택 가능
12609
+
12610
+ 배열 내 최댓값을 기준으로 일시불부터 해당 개월수까지 할부가 활성화됩니다.
11505
12611
 
11506
12612
  예시코드
11507
12613
 
@@ -11512,7 +12618,7 @@ IMP.request_pay(
11512
12618
  ```json
11513
12619
  {
11514
12620
  "display": {
11515
- "card_quota": [6] // 할부개월 6개월까지만 활성화
12621
+ "card_quota": [2, 3, 4, 5, 6] // 할부개월 6개월까지만 활성화
11516
12622
  }
11517
12623
  }
11518
12624
  ```
@@ -11623,6 +12729,76 @@ IMP.request_pay(
11623
12729
 
11624
12730
  </div>
11625
12731
 
12732
+ - company?: string
12733
+
12734
+ **상호명**
12735
+
12736
+ 결제창 및 카드사 모듈에 표시되는 상호명입니다. 카드사 다이렉트 호출 시 설정하지 않으면 `iamport`로 표기됩니다.
12737
+
12738
+ - auth\_mode?: string
12739
+
12740
+ **인증 방식**
12741
+
12742
+ 키인결제(일회성 결제) 이용 시 설정합니다.
12743
+
12744
+ - `key-in`: 키인결제 모드로 결제창을 호출합니다.
12745
+
12746
+ - bypass?: object
12747
+
12748
+ **KCP 전용 파라미터**
12749
+
12750
+ KCP 결제창에 직접 전달되는 파라미터입니다. PC와 모바일에서 지원되는 항목이 다릅니다.
12751
+
12752
+ - shop\_user\_id?: string
12753
+
12754
+ **고객사 회원 ID**
12755
+
12756
+ 상품권 결제 및 휴대폰 소액결제 시 필수 입력해야 합니다. (PC, 모바일)
12757
+
12758
+ - coupon\_apply\_yn?: string
12759
+
12760
+ **할인쿠폰 영역 활성/비활성화**
12761
+
12762
+ KCP와 협의 후 사용 가능합니다. (PC, 모바일)
12763
+
12764
+ - `Y`: 활성
12765
+ - `N`: 비활성
12766
+
12767
+ - skin\_indx?: string
12768
+
12769
+ **결제창 스킨 유형** (PC 전용)
12770
+
12771
+ 1\~11 사이의 숫자로 지정 가능합니다.
12772
+
12773
+ - site\_logo?: string
12774
+
12775
+ **결제창 로고 URL** (PC 전용)
12776
+
12777
+ - complex\_pnt\_yn?: string
12778
+
12779
+ **포인트 복합결제 시 신용카드 결제 여부** (PC 전용)
12780
+
12781
+ 포인트 결제 시 일부 금액을 신용카드로 결제할 수 있는지 여부를 설정합니다.
12782
+
12783
+ - `Y`: 포인트 + 신용카드 복합결제 허용
12784
+ - `N`: 전액 포인트결제
12785
+
12786
+ - pt\_memcorp\_cd?: string
12787
+
12788
+ **베네피아 회원 코드** (PC, 모바일)
12789
+
12790
+ 베네피아 포인트 결제 시 필수 입력해야 합니다.
12791
+
12792
+ - app\_flag?: string
12793
+
12794
+ **KB국민카드 다이렉트 호출 시 앱카드 사용 여부** (PC, 모바일)
12795
+
12796
+ `card.direct`로 KB국민카드 다이렉트 호출 시 결제 방식을 지정합니다.
12797
+
12798
+ - `Y`: 앱카드(KB Pay) 사용
12799
+ - `N`: ISP 결제 사용
12800
+ - `S`: 앱카드(KB Pay)와 ISP 선택지 제공 (모바일 전용)
12801
+
11626
12802
  #### 유의사항
11627
12803
 
11628
12804
  <details>
@@ -11851,6 +13027,20 @@ IMP.request_pay(
11851
13027
 
11852
13028
  결제창에 표시되는 금액입니다.
11853
13029
 
13030
+ - bypass?: object
13031
+
13032
+ **KCP 빌링키 발급 전용 파라미터**
13033
+
13034
+ - site\_logo?: string
13035
+
13036
+ **결제창 로고 URL** (PC 전용)
13037
+
13038
+ - batch\_birth\_day\_yn?: string
13039
+
13040
+ **생년월일 입력 박스 항상 표시 여부** (PC 전용)
13041
+
13042
+ - `Y`: 초기 화면에서 생년월일 입력 박스가 항상 표시됩니다.
13043
+
11854
13044
  #### 유의사항
11855
13045
 
11856
13046
  <details>
@@ -12017,11 +13207,11 @@ targetVersions:
12017
13207
 
12018
13208
  **간편결제 (카카오페이, 네이버페이) 빌링키로 결제 시에는 할부결제가 불가능하기 때문에 `card_quota` 파라미터 없이 요청해야 합니다.**
12019
13209
 
12020
- |파라미터 |데이터 타입 |의미 |
12021
- |-----------------------------|----------------------|---------------------------------------------------------------------------------------------------|
12022
- |vat\_amount |double |총 결제 금액 중 부가세 금액. 부가세 직접 입력 방식을 위해 사용. 단, 나이스정보통신와 사전 협의 필요|
12023
- |intereset\_free\_by\_merchant|boolean(기본값: false)|상점 부담 무이자 할부 적용 여부. 단, 나이스정보통신와 사전 협의 필요 |
12024
- |use\_card\_point |boolean(기본값: false)|카드사 포인트 사용 여부. 단, 나이스정보통신와 사전 협의 필요 |
13210
+ |파라미터 |데이터 타입 |의미 |
13211
+ |----------------------------|----------------------|---------------------------------------------------------------------------------------------------|
13212
+ |vat\_amount |double |총 결제 금액 중 부가세 금액. 부가세 직접 입력 방식을 위해 사용. 단, 나이스정보통신와 사전 협의 필요|
13213
+ |interest\_free\_by\_merchant|boolean(기본값: false)|상점 부담 무이자 할부 적용 여부. 단, 나이스정보통신와 사전 협의 필요 |
13214
+ |use\_card\_point |boolean(기본값: false)|카드사 포인트 사용 여부. 단, 나이스정보통신와 사전 협의 필요 |
12025
13215
 
12026
13216
  ## 가상계좌
12027
13217
 
@@ -12098,7 +13288,7 @@ POST /receipts/{imp_uid}
12098
13288
  // ...중략
12099
13289
  "type": "personal", // 현금영수증 발급 유형: 소득공제
12100
13290
  "identifier": "01012345678", // 현금영수증 발행 식별 정보: 휴대폰 번호
12101
- "wdentifier_type": "phone" // 현금영수증 발행 식별 정보 유형: 휴대폰 번호
13291
+ "identifier_type": "phone" // 현금영수증 발행 식별 정보 유형: 휴대폰 번호
12102
13292
  }
12103
13293
  ```
12104
13294
 
@@ -12732,6 +13922,9 @@ IMP.request_pay(
12732
13922
  - ssgpay\_bank (SSGPAY 은행계좌)
12733
13923
  - lpay (LPAY)
12734
13924
  - applepay (애플페이)
13925
+ - tosspay\_card (토스페이 - 카드)
13926
+ - tosspay\_money (토스페이 - 머니)
13927
+ - alipay (알리페이)
12735
13928
 
12736
13929
  - merchant\_uid: string
12737
13930
 
@@ -12757,20 +13950,89 @@ IMP.request_pay(
12757
13950
 
12758
13951
  소수점 두번째 자리까지 허용합니다.
12759
13952
 
13953
+ - buyer\_name?: string
13954
+
13955
+ **구매자 이름**
13956
+
13957
+ - buyer\_email?: string
13958
+
13959
+ **구매자 이메일**
13960
+
12760
13961
  - buyer\_tel: string
12761
13962
 
12762
13963
  **구매자 전화번호**
12763
13964
 
13965
+ - buyer\_addr?: string
13966
+
13967
+ **구매자 주소**
13968
+
13969
+ - buyer\_postcode?: string
13970
+
13971
+ **구매자 우편번호**
13972
+
13973
+ - tax\_free?: number
13974
+
13975
+ **면세금액**
13976
+
13977
+ - vat\_amount?: number
13978
+
13979
+ **부가세**
13980
+
12764
13981
  - vbank\_due: string
12765
13982
 
12766
- **가상계좌 입금기한 (YYYY-MM-DD)**
13983
+ **가상계좌 입금기한**
12767
13984
 
12768
- (신) 나이스정보통신의 경우 필수 입력이며 날짜는 무조건 23:59:59로 설정 됨
13985
+ `YYYY-MM-DD` 또는 `YYYY-MM-DD HH:mm:ss` 형식으로 지정합니다. (신) 나이스정보통신의 경우 필수 입력입니다.
12769
13986
 
12770
13987
  - escrow: boolean
12771
13988
 
12772
13989
  **에스크로 결제 여부**
12773
13990
 
13991
+ - digital?: boolean
13992
+
13993
+ **디지털 컨텐츠 여부**
13994
+
13995
+ 휴대폰 소액결제 시 필수 입력합니다. 디지털 컨텐츠(`true`), 실물 상품(`false`)
13996
+
13997
+ - language?: string
13998
+
13999
+ **결제창 언어**
14000
+
14001
+ - `ko`: 한국어 (기본값)
14002
+ - `en`: 영어
14003
+ - `zh`: 중국어
14004
+
14005
+ - currency?: string
14006
+
14007
+ **결제 통화 (기본값: KRW)**
14008
+
14009
+ - KRW (한국 원)
14010
+ - USD (미국 달러)
14011
+
14012
+ - m\_redirect\_url?: string
14013
+
14014
+ **모바일 결제 후 리디렉션 될 URL**
14015
+
14016
+ - app\_scheme?: string
14017
+
14018
+ **모바일 앱 URL scheme** (모바일 전용)
14019
+
14020
+ - notice\_url?: string | string\[]
14021
+
14022
+ **웹훅 수신 URL**
14023
+
14024
+ 포트원 관리자 콘솔에 설정한 웹훅 URL 대신 사용할 URL을 지정합니다.
14025
+
14026
+ - confirm\_url?: string
14027
+
14028
+ **Confirm process URL**
14029
+
14030
+ - custom\_data?: object
14031
+
14032
+ **가맹점 커스텀 데이터**
14033
+
14034
+ 결제 정보와 함께 저장할 커스텀 데이터입니다. 결제 조회 시 반환됩니다.
14035
+
12774
14036
  - period?: object
12775
14037
 
12776
14038
  **서비스 제공 기간**
@@ -12785,6 +14047,82 @@ IMP.request_pay(
12785
14047
 
12786
14048
  **YYYYMMDD**
12787
14049
 
14050
+ - bypass?: object
14051
+
14052
+ **나이스정보통신(신모듈) 전용 파라미터**
14053
+
14054
+ - nice\_v2?: object
14055
+
14056
+ - LogoImage?: string
14057
+
14058
+ **로고 이미지 URL** (full URL)
14059
+
14060
+ - NPDisableScroll?: string
14061
+
14062
+ **결제창 스크롤 미사용 여부** (PC 전용)
14063
+
14064
+ - `Y`: 미사용 (기본값)
14065
+ - `N`: 사용
14066
+
14067
+ - SkinType?: string
14068
+
14069
+ **결제창 스킨 색상**
14070
+
14071
+ - `red`, `green`, `purple`, `gray`, `dark`
14072
+
14073
+ - UserCI?: string
14074
+
14075
+ **문화상품권 결제 시 사용자 CI 정보**
14076
+
14077
+ 아이디/비밀번호 외 추가로 CI 인증이 필요한 경우 사용합니다. 사전 협의 필요.
14078
+
14079
+ - MallUserID?: string
14080
+
14081
+ **상점 사용자 아이디**
14082
+
14083
+ 문화상품권 결제 시 필수 입력합니다.
14084
+
14085
+ - DirectCouponYN?: string
14086
+
14087
+ **신용카드 쿠폰 자동 적용 여부**
14088
+
14089
+ - `Y`: 사전 등록된 선 할인 쿠폰 자동 적용
14090
+ - `N`: 쿠폰 미적용 (기본값)
14091
+
14092
+ - DirectShowOpt?: string
14093
+
14094
+ **다이렉트 호출 결제 수단**
14095
+
14096
+ - `BANK`: 계좌이체 다이렉트 호출
14097
+ - `CELLPHONE`: 휴대폰 소액결제 다이렉트 호출
14098
+
14099
+ - CardShowOpt?: string
14100
+
14101
+ **카드사별 호출 방식**
14102
+
14103
+ 형식: `카드코드:노출유형|카드코드:노출유형`
14104
+
14105
+ 노출 유형: `1`(안심클릭), `2`(간편결제), `3`(앱카드 직접 호출)
14106
+
14107
+ 예시: `"08:3|02:3"` (롯데카드, 국민카드 앱카드 직접 호출)
14108
+
14109
+ - PaycoClientId?: string
14110
+
14111
+ **페이코 자동 로그인용 ClientId**
14112
+
14113
+ 페이코에서 가맹점에 발급한 ClientId입니다. 사전 협의 필요.
14114
+
14115
+ - PaycoAccessToken?: string
14116
+
14117
+ **페이코 자동 로그인용 접속 토큰**
14118
+
14119
+ - SamPayMallType?: string
14120
+
14121
+ **삼성페이 가맹점 유형**
14122
+
14123
+ - `01`: 삼성페이 내 쇼핑
14124
+ - `99`: 기타 (기본값)
14125
+
12788
14126
  </details>
12789
14127
 
12790
14128
  <details>
@@ -12810,6 +14148,9 @@ IMP.request_pay(
12810
14148
  - ssgpay\_bank
12811
14149
  - lpay
12812
14150
  - applepay
14151
+ - tosspay\_card
14152
+ - tosspay\_money
14153
+ - alipay
12813
14154
 
12814
14155
  </details>
12815
14156
 
@@ -12900,10 +14241,26 @@ JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미
12900
14241
  - 사용 불가 : **% & | $ - + = \[ ]**
12901
14242
  - 사용 가능하나 권장하지 않음 : **( )**
12902
14243
 
14244
+ - buyer\_name?: string
14245
+
14246
+ **구매자 이름**
14247
+
14248
+ - buyer\_email?: string
14249
+
14250
+ **구매자 이메일**
14251
+
12903
14252
  - buyer\_tel: string
12904
14253
 
12905
14254
  **구매자 전화번호**
12906
14255
 
14256
+ - buyer\_addr?: string
14257
+
14258
+ **구매자 주소**
14259
+
14260
+ - buyer\_postcode?: string
14261
+
14262
+ **구매자 우편번호**
14263
+
12907
14264
  - customer\_uid: string
12908
14265
 
12909
14266
  **빌링키 발급을 위한 결제 수단을 특정하는 고유 번호**
@@ -12922,6 +14279,14 @@ JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미
12922
14279
 
12923
14280
  리다이렉트 방식으로 진행할 경우, 트랜잭션 종료 이후 302 리디렉션 될 고객사 URL
12924
14281
 
14282
+ - notice\_url?: string | string\[]
14283
+
14284
+ **웹훅 수신 URL**
14285
+
14286
+ - custom\_data?: object
14287
+
14288
+ **가맹점 커스텀 데이터**
14289
+
12925
14290
  </details>
12926
14291
 
12927
14292
  </div>
@@ -13044,12 +14409,76 @@ IMP.request_pay(
13044
14409
 
13045
14410
  매번 고유하게 채번되어야 합니다.
13046
14411
 
14412
+ - name: string
14413
+
14414
+ **주문명**
14415
+
13047
14416
  - amount: number
13048
14417
 
13049
14418
  **결제금액**
13050
14419
 
13051
14420
  **string** 이 아닌점에 유의하세요
13052
14421
 
14422
+ - buyer\_name?: string
14423
+
14424
+ **구매자 이름**
14425
+
14426
+ - buyer\_email?: string
14427
+
14428
+ **구매자 이메일**
14429
+
14430
+ - buyer\_tel?: string
14431
+
14432
+ **구매자 연락처**
14433
+
14434
+ - buyer\_addr?: string
14435
+
14436
+ **구매자 주소**
14437
+
14438
+ - buyer\_postcode?: string
14439
+
14440
+ **구매자 우편번호**
14441
+
14442
+ - tax\_free?: number
14443
+
14444
+ **면세금액**
14445
+
14446
+ - vat\_amount?: number
14447
+
14448
+ **부가세**
14449
+
14450
+ - vbank\_due?: string
14451
+
14452
+ **가상계좌 입금마감일시**
14453
+
14454
+ `YYYYMMDD` 또는 `YYYYMMDDHHmm` 형식으로 지정합니다. 미지정 시 기본 30일입니다.
14455
+
14456
+ - m\_redirect\_url?: string
14457
+
14458
+ **모바일 결제 후 리디렉션 될 URL**
14459
+
14460
+ - app\_scheme?: string
14461
+
14462
+ **모바일 앱 URL scheme** (모바일 전용)
14463
+
14464
+ 모바일 앱에서 결제 시 ISP/앱카드 등에서 결제 완료 후 가맹점 앱으로 돌아올 때 사용됩니다.
14465
+
14466
+ - notice\_url?: string | string\[]
14467
+
14468
+ **웹훅 수신 URL**
14469
+
14470
+ 포트원 관리자 콘솔에 설정한 웹훅 URL 대신 사용할 URL을 지정합니다.
14471
+
14472
+ - confirm\_url?: string
14473
+
14474
+ **Confirm process URL**
14475
+
14476
+ - custom\_data?: object
14477
+
14478
+ **가맹점 커스텀 데이터**
14479
+
14480
+ 결제 정보와 함께 저장할 커스텀 데이터입니다. 결제 조회 시 반환됩니다.
14481
+
13053
14482
  - niceMobileV2?: boolean
13054
14483
 
13055
14484
  나이스 모바일 신규버전 적용 여부(기본 값: `false`)
@@ -13058,12 +14487,65 @@ IMP.request_pay(
13058
14487
 
13059
14488
  **에스크로 설정여부**
13060
14489
 
14490
+ - digital?: boolean
14491
+
14492
+ **디지털 컨텐츠 여부**
14493
+
14494
+ 휴대폰 소액결제 시 디지털 컨텐츠(`true`)인지 실물 상품(`false`)인지 구분합니다.
14495
+
14496
+ - language?: string
14497
+
14498
+ **결제창 언어**
14499
+
14500
+ - `ko`: 한국어 (기본값)
14501
+ - `en`: 영어
14502
+ - `zh`: 중국어
14503
+
13061
14504
  - currency?: string
13062
14505
 
13063
14506
  **결제 통화(기본 값: KRW)**
13064
14507
 
13065
14508
  - KRW(한국 원)
13066
- - USD(미국 달러)(모바일의 경우 `niceMobileV2` 파라미터가 `true`일 경우에만 사용 가능)
14509
+ - USD(미국 달러)
14510
+
14511
+ - period?: object
14512
+
14513
+ **서비스 제공기간**
14514
+
14515
+ 고객이 구매하는 제품에 대한 제공기간을 명시합니다.
14516
+
14517
+ - from?: string
14518
+
14519
+ **시작일 (YYYYMMDD)**
14520
+
14521
+ - to?: string
14522
+
14523
+ **종료일 (YYYYMMDD)**
14524
+
14525
+ - interval?: string
14526
+
14527
+ **정기결제 간격**
14528
+
14529
+ `from`/`to` 대신 사용할 수 있습니다.
14530
+
14531
+ - `month`: 월간
14532
+ - `year`: 연간
14533
+
14534
+ - appCard?: boolean
14535
+
14536
+ **앱카드 전용 모드**
14537
+
14538
+ `true` 설정 시 앱카드 결제만 활성화됩니다.
14539
+
14540
+ - bypass?: object
14541
+
14542
+ **나이스정보통신(구모듈) 전용 파라미터**
14543
+
14544
+ - CardShowOpt?: string
14545
+
14546
+ **카드사별 호출 방식** (모바일 전용, `niceMobileV2: true` 시에만 동작)
14547
+
14548
+ 형식: `카드코드:노출유형|카드코드:노출유형`
13067
14549
 
13068
14550
  </div>
13069
14551
 
@@ -13163,8 +14645,10 @@ curl -H "Content-Type: application/json" \
13163
14645
  예시
13164
14646
 
13165
14647
  - `[]`: 일시불만 결제 가능
13166
- - `2,3,4,5,6`: 일시불을 포함한 2, 3, 4, 5, 6개월까지 할부개월 선택 가능
13167
- - `3`: 일시불을 포함한 2,3개월까지 할부개월 선택 가능
14648
+ - `[2, 3, 4, 5, 6]`: 일시불을 포함한 2, 3, 4, 5, 6개월 할부 선택 가능
14649
+ - `[3]`: 일시불과 3개월 할부만 선택 가능
14650
+
14651
+ 배열에 포함된 개월수만 개별적으로 활성화됩니다.
13168
14652
 
13169
14653
  <div class="hint" data-style="info">
13170
14654
 
@@ -13357,17 +14841,73 @@ IMP.request_pay(
13357
14841
 
13358
14842
  매번 고유하게 채번되어야 합니다.
13359
14843
 
14844
+ - name: string
14845
+
14846
+ **주문명**
14847
+
14848
+ - amount: number
14849
+
14850
+ **결제금액**
14851
+
14852
+ **string** 이 아닌점에 유의하세요
14853
+
14854
+ - buyer\_name?: string
14855
+
14856
+ **구매자 이름**
14857
+
14858
+ - buyer\_email?: string
14859
+
14860
+ **구매자 이메일**
14861
+
13360
14862
  - buyer\_tel: string
13361
14863
 
13362
14864
  **구매자 연락처**
13363
14865
 
13364
14866
  필수 파라미터 입니다.
13365
14867
 
13366
- - amount: number
14868
+ - buyer\_addr?: string
13367
14869
 
13368
- **결제금액**
14870
+ **구매자 주소**
13369
14871
 
13370
- **string** 아닌점에 유의하세요
14872
+ - buyer\_postcode?: string
14873
+
14874
+ **구매자 우편번호**
14875
+
14876
+ - tax\_free?: number
14877
+
14878
+ **면세금액**
14879
+
14880
+ - vbank\_due?: string
14881
+
14882
+ **가상계좌 입금마감일시**
14883
+
14884
+ - language?: string
14885
+
14886
+ **결제창 언어**
14887
+
14888
+ - m\_redirect\_url?: string
14889
+
14890
+ **모바일 결제 후 리디렉션 될 URL**
14891
+
14892
+ - app\_scheme?: string
14893
+
14894
+ **모바일 앱 URL scheme** (모바일 전용)
14895
+
14896
+ - notice\_url?: string | string\[]
14897
+
14898
+ **웹훅 수신 URL**
14899
+
14900
+ - confirm\_url?: string
14901
+
14902
+ **Confirm process URL**
14903
+
14904
+ - custom\_data?: object
14905
+
14906
+ **가맹점 커스텀 데이터**
14907
+
14908
+ - customer\_id?: string
14909
+
14910
+ **구매자 고유 ID**
13371
14911
 
13372
14912
  </div>
13373
14913
 
@@ -13443,12 +14983,40 @@ IMP.request_pay(
13443
14983
 
13444
14984
  비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
13445
14985
 
14986
+ - merchant\_uid: string
14987
+
14988
+ **주문번호**
14989
+
14990
+ - name: string
14991
+
14992
+ **주문명**
14993
+
13446
14994
  - amount: number
13447
14995
 
13448
14996
  **결제금액**
13449
14997
 
13450
14998
  금액이 설정되어도 실 결제는 발생되지 않습니다.
13451
14999
 
15000
+ - buyer\_name?: string
15001
+
15002
+ **구매자 이름**
15003
+
15004
+ - buyer\_email?: string
15005
+
15006
+ **구매자 이메일**
15007
+
15008
+ - buyer\_tel?: string
15009
+
15010
+ **구매자 연락처**
15011
+
15012
+ - notice\_url?: string | string\[]
15013
+
15014
+ **웹훅 수신 URL**
15015
+
15016
+ - custom\_data?: object
15017
+
15018
+ **가맹점 커스텀 데이터**
15019
+
13452
15020
  **빌링키(`customer_uid`)로 결제 요청하기**
13453
15021
 
13454
15022
  빌링키 발급이 성공하면 실 빌링키는 `customer_uid` 와 1:1 매칭되어 **포트원 서버에 저장**됩니다. `customer_uid`를 고객사 내부서버에 저장하시고 [**비 인증 결제요청 REST API**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)를 호출하시면 결제를 발생시킬 수 있습니다.
@@ -13505,6 +15073,83 @@ targetVersions:
13505
15073
 
13506
15074
  결제 요청 시에는 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출해야 합니다.
13507
15075
 
15076
+ ### 주요 파라미터 설명
15077
+
15078
+ - channelKey: string
15079
+
15080
+ **채널키**
15081
+
15082
+ 결제를 진행할 채널을 지정합니다.
15083
+
15084
+ 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
15085
+
15086
+ - merchant\_uid: string
15087
+
15088
+ **주문번호**
15089
+
15090
+ 매번 고유하게 채번되어야 합니다. 영문, 숫자만 입력 가능합니다.
15091
+
15092
+ - name: string
15093
+
15094
+ **주문명**
15095
+
15096
+ - amount: number
15097
+
15098
+ **결제금액**
15099
+
15100
+ - currency: string
15101
+
15102
+ **결제 통화**
15103
+
15104
+ 카드: `KRW`, `USD`, `JPY` / Alipay: `USD`, `CNY` / WeChatPay: `KRW`, `USD`, `CNY`
15105
+
15106
+ - buyer\_email: string
15107
+
15108
+ **구매자 이메일** (필수)
15109
+
15110
+ - buyer\_name?: string
15111
+
15112
+ **구매자 이름**
15113
+
15114
+ - buyer\_tel?: string
15115
+
15116
+ **구매자 연락처**
15117
+
15118
+ - m\_redirect\_url?: string
15119
+
15120
+ **모바일 결제 후 리디렉션 될 URL**
15121
+
15122
+ - notice\_url?: string | string\[]
15123
+
15124
+ **웹훅 수신 URL**
15125
+
15126
+ - custom\_data?: object
15127
+
15128
+ **가맹점 커스텀 데이터**
15129
+
15130
+ - bypass?: object
15131
+
15132
+ - payletter\_global?: object
15133
+
15134
+ - pginfo?: string
15135
+
15136
+ **결제 수단 지정**
15137
+
15138
+ 특정 결제 수단만 결제창에 노출하고 싶은 경우 설정합니다.
15139
+
15140
+ - `PLCreditCard`: 해외카드 비인증
15141
+ - `PLCreditCardMpi`: 해외카드 인증(3DS)
15142
+ - `PLUnionPay_HC`: 유니온페이
15143
+ - `WeChatPayQRCodePayment`: 위챗페이 PC결제
15144
+ - `WeChatPayH5Payment`: 위챗페이 모바일결제
15145
+ - `ICBAlipay`: 알리페이
15146
+
15147
+ - servicename?: string
15148
+
15149
+ **서비스명**
15150
+
15151
+ WeChatPay, Alipay 결제 시 필수 입력합니다.
15152
+
13508
15153
  ## 가능한 빌링키 발급 및 결제 수단
13509
15154
 
13510
15155
  - **빌링키 발급 및 결제**
@@ -13525,13 +15170,77 @@ targetVersions:
13525
15170
 
13526
15171
  빌링키 발급 및 결제 요청 시에는 `customer_uid` 파라미터를 포함하여 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출해야 합니다.
13527
15172
 
15173
+ ### 주요 파라미터 설명
15174
+
15175
+ - channelKey: string
15176
+
15177
+ **채널키**
15178
+
15179
+ - merchant\_uid: string
15180
+
15181
+ **주문번호**
15182
+
15183
+ - name: string
15184
+
15185
+ **주문명**
15186
+
15187
+ - amount: number
15188
+
15189
+ **결제금액**
15190
+
15191
+ - currency: string
15192
+
15193
+ **결제 통화**
15194
+
15195
+ - customer\_uid: string
15196
+
15197
+ **빌링키**
15198
+
15199
+ 빌링키 발급 시 필수 입력입니다.
15200
+
15201
+ - buyer\_email: string
15202
+
15203
+ **구매자 이메일** (필수)
15204
+
15205
+ - buyer\_name?: string
15206
+
15207
+ **구매자 이름**
15208
+
15209
+ - buyer\_tel?: string
15210
+
15211
+ **구매자 연락처**
15212
+
15213
+ - m\_redirect\_url?: string
15214
+
15215
+ **모바일 결제 후 리디렉션 될 URL**
15216
+
15217
+ - notice\_url?: string | string\[]
15218
+
15219
+ **웹훅 수신 URL**
15220
+
15221
+ - custom\_data?: object
15222
+
15223
+ **가맹점 커스텀 데이터**
15224
+
15225
+ - bypass?: object
15226
+
15227
+ - payletter\_global?: object
15228
+
15229
+ - pginfo?: string
15230
+
15231
+ **결제 수단 지정**
15232
+
15233
+ - `PLCreditCard`: 해외카드 비인증
15234
+ - `PLCreditCardMpi`: 해외카드 인증(3DS)
15235
+ - `PLUnionPay_HC`: 유니온페이
15236
+
13528
15237
  <div class="hint" data-style="warning">
13529
15238
 
13530
15239
  페이레터 해외결제는 **SDK 1.3.0 부터 사용 가능**합니다.
13531
15240
 
13532
15241
  SDK 스크립트의 주소가 `https://cdn.iamport.kr/v1/iamport.js` 인지 확인해주세요.
13533
15242
 
13534
- 위 JS SDK 를 이용하여 페이팔 정기결제 연동시 callback Data는 아래와 같이 두가지 형태로만 내려갑니다.
15243
+ 위 JS SDK 를 이용하여 페이레터 해외결제 연동시 callback Data는 아래와 같이 두가지 형태로만 내려갑니다.
13535
15244
 
13536
15245
  - `imp_uid`
13537
15246
  - `merchant_uid`
@@ -13709,13 +15418,41 @@ IMP.request_pay(
13709
15418
  });
13710
15419
  ```
13711
15420
 
15421
+ - buyer\_tel?: string
15422
+
15423
+ **구매자 연락처**
15424
+
15425
+ - buyer\_addr?: string
15426
+
15427
+ **구매자 주소**
15428
+
15429
+ - buyer\_postcode?: string
15430
+
15431
+ **구매자 우편번호**
15432
+
15433
+ - language?: string
15434
+
15435
+ **결제창 언어**
15436
+
15437
+ - m\_redirect\_url?: string
15438
+
15439
+ **모바일 결제 후 리디렉션 될 URL**
15440
+
15441
+ - notice\_url?: string | string\[]
15442
+
15443
+ **웹훅 수신 URL**
15444
+
15445
+ - custom\_data?: object
15446
+
15447
+ **가맹점 커스텀 데이터**
15448
+
13712
15449
  - bypass: object
13713
15450
 
13714
15451
  **페이먼트월 전용 파라미터**
13715
15452
 
13716
15453
  - widget\_code?: string
13717
15454
 
13718
- 터미날3 인 경우 `t3_1`로 파라미터를 설정해야 합니다. 미설정시 Default(일반) 결제창이 활성화됩니다.
15455
+ 터미날3 인 경우 `t3_1`로 파라미터를 설정해야 합니다. 미설정시 Default(`pw_1`) 결제창이 활성화됩니다.
13719
15456
 
13720
15457
  - ps?: string
13721
15458
 
@@ -13725,6 +15462,22 @@ IMP.request_pay(
13725
15462
 
13726
15463
  지정된 국가에서 지원되는 결제수단이 위젯상에 노출됩니다. 다음 문서를 참고하여 해당하는 국가코드를 입력해야 합니다. [→ 국가코드 바로가기](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
13727
15464
 
15465
+ - logo\_url?: string
15466
+
15467
+ **결제창 로고 URL**
15468
+
15469
+ - project\_name?: string
15470
+
15471
+ **프로젝트명**
15472
+
15473
+ - product\_price\_without\_tax?: number
15474
+
15475
+ **세전 가격** (PaymentWall 대시보드 표시용)
15476
+
15477
+ - sales\_tax?: number
15478
+
15479
+ **판매세** (PaymentWall 대시보드 표시용)
15480
+
13728
15481
  </div>
13729
15482
 
13730
15483
  <div class="tabs-content" data-title="비 인증 결제">
@@ -13865,7 +15618,7 @@ targetVersions:
13865
15618
 
13866
15619
  페이팔 Express checkout 방식으로 신규 가입 및 연동이 불가합니다.
13867
15620
  페이팔 연동을 원하는 경우, [페이팔 일반 결제(Smart Payment Buttons) 연동 가이드](https://developers.portone.io/opi/ko/integration/pg/v1/spb/readme)
13868
- 또는 [페이팔 정기 결제(Reference Transaciton) 연동 가이드](https://developers.portone.io/opi/ko/integration/pg/v1/rt/readme)를 참고하여 진행해주세요.
15621
+ 또는 [페이팔 정기 결제(Reference Transaction) 연동 가이드](https://developers.portone.io/opi/ko/integration/pg/v1/rt/readme)를 참고하여 진행해주세요.
13869
15622
 
13870
15623
  </div>
13871
15624
 
@@ -13946,12 +15699,36 @@ IMP.request_pay(
13946
15699
 
13947
15700
  매번 고유하게 채번되어야 합니다.
13948
15701
 
15702
+ - name: string
15703
+
15704
+ **주문명**
15705
+
13949
15706
  - amount: number
13950
15707
 
13951
15708
  **결제금액**
13952
15709
 
13953
15710
  **string** 이 아닌점에 유의하세요
13954
15711
 
15712
+ - buyer\_name?: string
15713
+
15714
+ **구매자 이름**
15715
+
15716
+ - buyer\_email?: string
15717
+
15718
+ **구매자 이메일**
15719
+
15720
+ - buyer\_tel?: string
15721
+
15722
+ **구매자 연락처**
15723
+
15724
+ - buyer\_addr?: string
15725
+
15726
+ **구매자 주소**
15727
+
15728
+ - buyer\_postcode?: string
15729
+
15730
+ **구매자 우편번호**
15731
+
13955
15732
  - currency: string
13956
15733
 
13957
15734
  **결제통화코드**
@@ -13964,6 +15741,18 @@ IMP.request_pay(
13964
15741
 
13965
15742
  PC환경 모바일 환경 모두 해당 값을 필수로 설정해야 결과를 받아볼수 있습니다.
13966
15743
 
15744
+ - notice\_url?: string | string\[]
15745
+
15746
+ **웹훅 수신 URL**
15747
+
15748
+ - confirm\_url?: string
15749
+
15750
+ **Confirm process URL**
15751
+
15752
+ - custom\_data?: object
15753
+
15754
+ **가맹점 커스텀 데이터**
15755
+
13967
15756
  </div>
13968
15757
 
13969
15758
  </div>
@@ -14052,7 +15841,7 @@ versionVariants:
14052
15841
 
14053
15842
  [헥토파이낸셜](https://developers.portone.io/opi/ko/integration/pg/v1/settle/readme)
14054
15843
 
14055
- [KG모빌리언스 (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kg)
15844
+ [KG파이낸셜 (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kg)
14056
15845
 
14057
15846
  [KSNET](https://developers.portone.io/opi/ko/integration/pg/v1/ksnet/readme)
14058
15847
 
@@ -14265,17 +16054,55 @@ attribute가 `paypal-rt`인 elemente도 2개 이상인 경우, “동일한 data
14265
16054
 
14266
16055
  ## loadUI 요청 객체
14267
16056
 
14268
- |파라미터 |데이터타입|필수여부 |의미 |
14269
- |------------------|----------|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
14270
- |merchant\_uid |string |required |주문 번호 (고객사에서 고유하게 채번하여 사용해야 합니다.) |
14271
- |name |string |optional |제품명 |
14272
- |~~pg(deprecated)~~|~~string~~|~~required~~|~~결제대행사 구분 (코드 구분 : paypal\_v2)~~ |
14273
- |channelKey |string |required |<p>paypal\_v2 채널의 채널 키 </p><p>(포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.)</p> |
14274
- |pay\_method |string |required |<p>결제수단 (코드 구분 값 : paypal)</p><p>(페이팔의 경우 결제수단은 paypal로 지정한 후 호출해야 합니다.)</p> |
14275
- |customer\_uid |string |required |<p>포트원 빌링키</p><p>(고객사에서 빌링키 발급 시 고유하게 채번하여 요청해야 합니다. 빌링키 결제 시 해당 값을 이용하여 결제를 요청해야 하기 때문에 고객사에서 별도로 저장하셔야 합니다.)</p> |
14276
- |customer\_id |string |optional |<p>고객 식별 아이디</p><p>(고객사에서 구매자를 특정하기 위해 고유하게 채번하여 사용하는 아이디로 빌링키 발급시 필수 입력해야 합니다.)</p> |
14277
- |notice\_url |string |optional |<p>웹훅 수신 주소</p><p>(결제창에서 빌링키 발급 완료 후 발송되는 웹훅 수신 주소로 URL string 또는 string\[]로 N개 설정 가능합니다.</p><p>웹훅 발송 여부는 콘솔 내 \[결제 > 상세 내역 조회] 메뉴에서 해당 거래 건 클릭하여 웹훅 발송 내역을 확인할 수 있습니다.)</p>|
14278
- |custom\_data |object |optional |<p>사용자 정의 데이터</p><p>(빌링키 발급 정보와 함께 고객사에서 관리하고 싶은 데이터를 저장할 수 있으며 JSON 형식으로 요청해야합니다.)</p> |
16057
+ - channelKey: string
16058
+
16059
+ **채널키**
16060
+
16061
+ paypal\_v2 채널의 채널 키입니다. 포트원 콘솔 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
16062
+
16063
+ - pg(deprecated)?: string
16064
+
16065
+ ~~`paypal_v2`로 지정합니다.~~
16066
+
16067
+ - pay\_method: string
16068
+
16069
+ **결제수단 구분코드**
16070
+
16071
+ `paypal`로 지정합니다.
16072
+
16073
+ - merchant\_uid: string
16074
+
16075
+ **주문 번호**
16076
+
16077
+ 고객사에서 고유하게 채번하여 사용해야 합니다.
16078
+
16079
+ - name?: string
16080
+
16081
+ **제품명**
16082
+
16083
+ - customer\_uid: string
16084
+
16085
+ **포트원 빌링키**
16086
+
16087
+ 고객사에서 빌링키 발급 시 고유하게 채번하여 요청해야 합니다. 빌링키 결제 시 해당 값을 이용하여 결제를 요청해야 하기 때문에 고객사에서 별도로 저장하셔야 합니다.
16088
+
16089
+ - customer\_id?: string
16090
+
16091
+ **고객 식별 아이디**
16092
+
16093
+ 고객사에서 구매자를 특정하기 위해 고유하게 채번하여 사용하는 아이디입니다.
16094
+
16095
+ - notice\_url?: string | string\[]
16096
+
16097
+ **웹훅 수신 URL**
16098
+
16099
+ 빌링키 발급 완료 후 웹훅이 발송됩니다.
16100
+
16101
+ - custom\_data?: object
16102
+
16103
+ **사용자 정의 데이터**
16104
+
16105
+ 빌링키 발급 정보와 함께 고객사에서 관리하고 싶은 데이터를 JSON 형식으로 저장할 수 있습니다.
14279
16106
 
14280
16107
  <div class="hint" data-style="warning">
14281
16108
 
@@ -14479,7 +16306,7 @@ IMP.loadUI(
14479
16306
  },
14480
16307
  {
14481
16308
  key: "sender_create_date", // 고객사 고객 계정이 생성된 날짜
14482
- value: "2023-10-10T23:59:59+09:00", // IOS8601 형식
16309
+ value: "2023-10-10T23:59:59+09:00", // ISO 8601 형식
14483
16310
  },
14484
16311
  ],
14485
16312
  },
@@ -14542,8 +16369,8 @@ await fetch("https://api.iamport.kr/subscribe/payments/again", {
14542
16369
  value: "KR", // ISO Alpha-2 형식 국가 코드
14543
16370
  },
14544
16371
  {
14545
- key: "sender_create_date", // 고객사의 account에 등록 국가 코드
14546
- value: "2023-10-10T23:59:59+09:00", // IOS8601 형식
16372
+ key: "sender_create_date", // 고객사 고객 계정이 생성된 날짜
16373
+ value: "2023-10-10T23:59:59+09:00", // ISO 8601 형식
14547
16374
  },
14548
16375
  ],
14549
16376
  },
@@ -14994,63 +16821,108 @@ IMP.request_pay(
14994
16821
 
14995
16822
  매번 고유하게 채번되어야 합니다.
14996
16823
 
16824
+ - buyer\_name?: string
16825
+
16826
+ **구매자 이름**
16827
+
16828
+ - buyer\_email?: string
16829
+
16830
+ **구매자 이메일**
16831
+
14997
16832
  - buyer\_tel: string
14998
16833
 
14999
16834
  **구매자 연락처**
15000
16835
 
15001
16836
  필수 파라미터 입니다.
15002
16837
 
16838
+ - buyer\_addr?: string
16839
+
16840
+ **구매자 주소**
16841
+
16842
+ - buyer\_postcode?: string
16843
+
16844
+ **구매자 우편번호**
16845
+
15003
16846
  - amount: integer
15004
16847
 
15005
16848
  **결제금액**
15006
16849
 
15007
- - bypass?: oneof object
16850
+ - tax\_free?: number
16851
+
16852
+ **면세금액**
16853
+
16854
+ - vat\_amount?: number
16855
+
16856
+ **부가세**
16857
+
16858
+ - m\_redirect\_url?: string
16859
+
16860
+ **모바일 결제 후 리디렉션 될 URL**
16861
+
16862
+ - notice\_url?: string | string\[]
16863
+
16864
+ **웹훅 수신 URL**
16865
+
16866
+ - confirm\_url?: string
16867
+
16868
+ **Confirm process URL**
16869
+
16870
+ - custom\_data?: object
16871
+
16872
+ **가맹점 커스텀 데이터**
16873
+
16874
+ - bypass?: object
15008
16875
 
15009
16876
  **PG사 결제창 호출 시 PG사로 그대로 bypass할 값들의 모음**
15010
16877
 
15011
- - custCi: string
16878
+ - settle?: object
15012
16879
 
15013
- **주문자 CI**
16880
+ - custCi?: string
15014
16881
 
15015
- <div class="hint" data-style="warning">
16882
+ **주문자 CI**
15016
16883
 
15017
- 본인인증 전달받은 CI 값을 AES-256-ECB 방식을 사용해 암호화하여 16진수로 인코딩한 결과를 입력해야합니다.
15018
- 암호화 키(key)는 포트원 관리자콘솔 채널 등록 시 "암호화 키" 항목에 입력한 값을 사용합니다.
16884
+ 고객사가 보유한 회원 CI 설정하면 내통장 결제에 등록한 CI와 비교하여 동일인인지 자동검증되며 일치하지 않은 경우 결제가 중단됩니다.
15019
16885
 
15020
- ```pseudo
15021
- INPUT: ci (string), key (string)
15022
- OUTPUT: custCI (string)
16886
+ <div class="hint" data-style="warning">
15023
16887
 
15024
- BEGIN
15025
- # Step 1: CI 데이터를 AES-256-ECB 방식으로 암호화
15026
- binaryData ← AES256ECB(key, ci)
16888
+ 본인인증 후 전달받은 CI 값을 AES-256-ECB 방식을 사용해 암호화하여 16진수로 인코딩한 결과를 입력해야합니다.
16889
+ 암호화 키(key)는 포트원 관리자콘솔 채널 등록 "암호화 키" 항목에 입력한 값을 사용합니다.
15027
16890
 
15028
- # Step 2: 암호화된 데이터를 16진수 문자열로 변환
15029
- custCI ConvertToHex(binaryData)
16891
+ ```pseudo
16892
+ INPUT: ci (string), key (string)
16893
+ OUTPUT: custCI (string)
15030
16894
 
15031
- # Step 3: 결과 반환
15032
- RETURN custCI
15033
- END
15034
- ```
16895
+ BEGIN
16896
+ # Step 1: CI 데이터를 AES-256-ECB 방식으로 암호화
16897
+ binaryData ← AES256ECB(key, ci)
15035
16898
 
15036
- </div>
16899
+ # Step 2: 암호화된 데이터를 16진수 문자열로 변환
16900
+ custCI ← ConvertToHex(binaryData)
15037
16901
 
15038
- 고객사가 보유한 회원 CI를 설정하면 내통장 결제에 등록한 CI와 비교하여 동일인인지 자동검증되며
15039
- 일치하지 않은 경우 결제가 중단됩니다.
16902
+ # Step 3: 결과 반환
16903
+ RETURN custCI
16904
+ END
16905
+ ```
15040
16906
 
15041
- - addDeductionYn?: string
16907
+ </div>
16908
+
16909
+ - addDeductionYn?: string
16910
+
16911
+ **추가공제구분**
15042
16912
 
15043
- **추가공제구분**
16913
+ 대중교통: Y, 도서 및 공연비: C, 추가공제없음: N
15044
16914
 
15045
- 대중교통: Y, 도서 및 공연비: C, 추가공제없음: N
16915
+ 계약 사용 가능합니다.
15046
16916
 
15047
- 계약 사용 가능합니다.
16917
+ - criPsblYn?: string
15048
16918
 
15049
- - criPsblYn?: string
16919
+ **현금영수증 발행가능 여부**
15050
16920
 
15051
- **현금영수증 발행가능 여부**
16921
+ Y or N or "", 빈문자열은 Y로 인식
15052
16922
 
15053
- Y or N or "", 빈문자열은 Y로 인식
16923
+ - payLimitCd?: string
16924
+
16925
+ **결제 한도 코드**
15054
16926
 
15055
16927
  <div class="hint" data-style="info">
15056
16928
 
@@ -15138,59 +17010,96 @@ IMP.request_pay(
15138
17010
 
15139
17011
  등록 계좌정보와 1:1로 매칭될 빌링키를 지정합니다.
15140
17012
 
17013
+ - merchant\_uid: string
17014
+
17015
+ **주문번호**
17016
+
17017
+ - name: string
17018
+
17019
+ **주문명**
17020
+
15141
17021
  - amount?: integer
15142
17022
 
15143
17023
  **결제금액**
15144
17024
 
15145
17025
  0원으로 입력시 빌링키만 발급됩니다. 금액 설정시 결제와 동시에 빌링키가 발급됩니다.
15146
17026
 
15147
- - bypass?: oneof object
17027
+ - buyer\_name?: string
17028
+
17029
+ **구매자 이름**
17030
+
17031
+ - buyer\_email?: string
17032
+
17033
+ **구매자 이메일**
17034
+
17035
+ - buyer\_tel?: string
17036
+
17037
+ **구매자 연락처**
17038
+
17039
+ - m\_redirect\_url?: string
17040
+
17041
+ **모바일 결제 후 리디렉션 될 URL**
17042
+
17043
+ - notice\_url?: string | string\[]
17044
+
17045
+ **웹훅 수신 URL**
17046
+
17047
+ - custom\_data?: object
17048
+
17049
+ **가맹점 커스텀 데이터**
17050
+
17051
+ - bypass?: object
15148
17052
 
15149
17053
  **PG사 결제창 호출 시 PG사로 그대로 bypass할 값들의 모음**
15150
17054
 
15151
- - custCi: string
17055
+ - settle?: object
15152
17056
 
15153
- **주문자 CI**
17057
+ - custCi?: string
15154
17058
 
15155
- <div class="hint" data-style="warning">
17059
+ **주문자 CI**
15156
17060
 
15157
- 본인인증 전달받은 CI 값을 AES-256-ECB 방식을 사용해 암호화하여 16진수로 인코딩한 결과를 입력해야합니다.
15158
- 암호화 키(key)는 포트원 관리자콘솔 채널 등록 시 "암호화 키" 항목에 입력한 값을 사용합니다.
17061
+ 고객사가 보유한 회원 CI 설정하면 내통장 결제에 등록한 CI와 비교하여 동일인인지 자동검증되며 일치하지 않은 경우 결제가 중단됩니다.
15159
17062
 
15160
- ```pseudo
15161
- INPUT: ci (string), key (string)
15162
- OUTPUT: custCI (string)
17063
+ <div class="hint" data-style="warning">
15163
17064
 
15164
- BEGIN
15165
- # Step 1: CI 데이터를 AES-256-ECB 방식으로 암호화
15166
- binaryData ← AES256ECB(key, ci)
17065
+ 본인인증 후 전달받은 CI 값을 AES-256-ECB 방식을 사용해 암호화하여 16진수로 인코딩한 결과를 입력해야합니다.
17066
+ 암호화 키(key)는 포트원 관리자콘솔 채널 등록 "암호화 키" 항목에 입력한 값을 사용합니다.
15167
17067
 
15168
- # Step 2: 암호화된 데이터를 16진수 문자열로 변환
15169
- custCI ConvertToHex(binaryData)
17068
+ ```pseudo
17069
+ INPUT: ci (string), key (string)
17070
+ OUTPUT: custCI (string)
15170
17071
 
15171
- # Step 3: 결과 반환
15172
- RETURN custCI
15173
- END
15174
- ```
17072
+ BEGIN
17073
+ # Step 1: CI 데이터를 AES-256-ECB 방식으로 암호화
17074
+ binaryData ← AES256ECB(key, ci)
15175
17075
 
15176
- </div>
17076
+ # Step 2: 암호화된 데이터를 16진수 문자열로 변환
17077
+ custCI ← ConvertToHex(binaryData)
15177
17078
 
15178
- 고객사가 보유한 회원 CI를 설정하면 내통장 결제에 등록한 CI와 비교하여 동일인인지 자동검증되며
15179
- 일치하지 않은 경우 결제가 중단됩니다.
17079
+ # Step 3: 결과 반환
17080
+ RETURN custCI
17081
+ END
17082
+ ```
17083
+
17084
+ </div>
15180
17085
 
15181
- - addDeductionYn?: string
17086
+ - addDeductionYn?: string
15182
17087
 
15183
- **추가공제구분**
17088
+ **추가공제구분**
15184
17089
 
15185
- 대중교통: Y, 도서 및 공연비: C, 추가공제없음: N
17090
+ 대중교통: Y, 도서 및 공연비: C, 추가공제없음: N
15186
17091
 
15187
- 계약 후 사용 가능합니다.
17092
+ 계약 후 사용 가능합니다.
15188
17093
 
15189
- - criPsblYn?: string
17094
+ - criPsblYn?: string
15190
17095
 
15191
- **현금영수증 발행가능 여부**
17096
+ **현금영수증 발행가능 여부**
15192
17097
 
15193
- Y or N or "", 빈문자열은 Y로 인식
17098
+ Y or N or "", 빈문자열은 Y로 인식
17099
+
17100
+ - payLimitCd?: string
17101
+
17102
+ **결제 한도 코드**
15194
17103
 
15195
17104
  #### 빌링키(customer\_uid)로 결제 요청하기
15196
17105
 
@@ -15323,12 +17232,62 @@ IMP.request_pay(
15323
17232
 
15324
17233
  **휴대폰, 가상계좌** 결제 요청인 경우 필수 파라미터
15325
17234
 
17235
+ - buyer\_name?: string
17236
+
17237
+ **구매자 이름**
17238
+
17239
+ - buyer\_email?: string
17240
+
17241
+ **구매자 이메일**
17242
+
17243
+ - buyer\_addr?: string
17244
+
17245
+ **구매자 주소**
17246
+
17247
+ - buyer\_postcode?: string
17248
+
17249
+ **구매자 우편번호**
17250
+
15326
17251
  - company\_en?: string
15327
17252
 
15328
17253
  **회사명(영문)**
15329
17254
 
15330
17255
  **휴대폰** 결제 요청인 경우 필수 파라미터
15331
17256
 
17257
+ - vbank\_due?: string
17258
+
17259
+ **가상계좌 입금마감일시**
17260
+
17261
+ `YYYYMMDD` 형식으로 지정합니다.
17262
+
17263
+ - m\_redirect\_url?: string
17264
+
17265
+ **모바일 결제 후 리디렉션 될 URL**
17266
+
17267
+ - app\_scheme?: string
17268
+
17269
+ **모바일 앱 URL scheme** (모바일 전용)
17270
+
17271
+ - notice\_url?: string | string\[]
17272
+
17273
+ **웹훅 수신 URL**
17274
+
17275
+ - custom\_data?: object
17276
+
17277
+ **가맹점 커스텀 데이터**
17278
+
17279
+ - bypass?: object
17280
+
17281
+ **헥토파이낸셜 전용 파라미터**
17282
+
17283
+ - settle?: object
17284
+
17285
+ - vbank010?: boolean
17286
+
17287
+ **010 가상계좌 사용 여부**
17288
+
17289
+ `true`로 설정 시 010 가상계좌 전용 플로우로 진행됩니다. 사전에 헥토파이낸셜과 계약이 필요합니다.
17290
+
15332
17291
  </div>
15333
17292
 
15334
17293
  <div class="tabs-content" data-title="비인증 결제창 요청">
@@ -16201,12 +18160,32 @@ IMP.request_pay(
16201
18160
 
16202
18161
  소수점 두번째 자리까지 허용합니다.
16203
18162
 
18163
+ - buyer\_name?: string
18164
+
18165
+ **구매자 이름**
18166
+
18167
+ - buyer\_email?: string
18168
+
18169
+ **구매자 이메일**
18170
+
16204
18171
  - buyer\_tel: string
16205
18172
 
16206
18173
  **구매자 전화번호**
16207
18174
 
16208
18175
  주의: 스마트로 일반 결제시 필수 입력
16209
18176
 
18177
+ - buyer\_addr?: string
18178
+
18179
+ **구매자 주소**
18180
+
18181
+ - buyer\_postcode?: string
18182
+
18183
+ **구매자 우편번호**
18184
+
18185
+ - tax\_free?: number
18186
+
18187
+ **면세금액**
18188
+
16210
18189
  - vbank\_due: string
16211
18190
 
16212
18191
  **가상계좌 입금기한 (YYYY-MM-DD)**
@@ -16217,6 +18196,12 @@ IMP.request_pay(
16217
18196
 
16218
18197
  **에스크로 결제 여부**
16219
18198
 
18199
+ - digital?: boolean
18200
+
18201
+ **디지털 컨텐츠 여부**
18202
+
18203
+ 휴대폰 소액결제 시 필수 입력합니다.
18204
+
16220
18205
  - period?: object
16221
18206
 
16222
18207
  **서비스 제공 기간**
@@ -16231,6 +18216,63 @@ IMP.request_pay(
16231
18216
 
16232
18217
  **YYYYMMDD**
16233
18218
 
18219
+ - m\_redirect\_url?: string
18220
+
18221
+ **모바일 결제 후 리디렉션 될 URL**
18222
+
18223
+ - app\_scheme?: string
18224
+
18225
+ **모바일 앱 URL scheme** (모바일 전용)
18226
+
18227
+ - notice\_url?: string | string\[]
18228
+
18229
+ **웹훅 수신 URL**
18230
+
18231
+ - confirm\_url?: string
18232
+
18233
+ **Confirm process URL**
18234
+
18235
+ - custom\_data?: object
18236
+
18237
+ **가맹점 커스텀 데이터**
18238
+
18239
+ - bypass?: object
18240
+
18241
+ - cashReceiptType?: string
18242
+
18243
+ **현금영수증 발급 유형** (계좌이체/가상계좌 전용)
18244
+
18245
+ - anonymous (미발행, 자진발급)
18246
+ - personal (소득공제)
18247
+ - corporate (지출증빙)
18248
+
18249
+ - customerIdentifier?: string
18250
+
18251
+ **현금영수증 발급 식별번호** (계좌이체/가상계좌 전용)
18252
+
18253
+ 휴대폰번호, 사업자등록번호, 현금영수증 카드번호를 입력할 수 있습니다.
18254
+
18255
+ - smartro\_v2?: object
18256
+
18257
+ **스마트로 전용 파라미터**
18258
+
18259
+ - GoodsCnt?: number
18260
+
18261
+ **결제 상품 품목 개수**
18262
+
18263
+ - SkinColor?: string
18264
+
18265
+ **UI 스타일**
18266
+
18267
+ - `RED` (기본값), `GREEN`, `BLUE`, `PURPLE`
18268
+
18269
+ - OpenType?: string
18270
+
18271
+ **결제창 언어**
18272
+
18273
+ - `KR`: 국내 (기본값)
18274
+ - `EN`: 영문 (해외카드 전용 결제창)
18275
+
16234
18276
  </details>
16235
18277
 
16236
18278
  <details>
@@ -16327,6 +18369,10 @@ IMP.request_pay(
16327
18369
 
16328
18370
  주의: 스마트로 일반결제시 주문 번호에 특수문자 사용 불가
16329
18371
 
18372
+ - name: string
18373
+
18374
+ **주문명**
18375
+
16330
18376
  - customer\_uid: string
16331
18377
 
16332
18378
  **빌링키 발급을 위한 결제 수단을 특정하는 고유 번호**
@@ -16339,6 +18385,18 @@ IMP.request_pay(
16339
18385
 
16340
18386
  주의: 스마트로 빌링키 발급시 필수 입력으로 입력 길이는 **20자**로 제한됩니다.
16341
18387
 
18388
+ - buyer\_name?: string
18389
+
18390
+ **구매자 이름**
18391
+
18392
+ - buyer\_email?: string
18393
+
18394
+ **구매자 이메일**
18395
+
18396
+ - buyer\_tel?: string
18397
+
18398
+ **구매자 연락처**
18399
+
16342
18400
  - m\_redirect\_url: string
16343
18401
 
16344
18402
  **리다이렉트 URL**
@@ -16347,6 +18405,33 @@ IMP.request_pay(
16347
18405
 
16348
18406
  스마트로의 경우 모바일 환경에서 **리디렉션 방식으로 빌링키 발급창이 렌더링 되기 때문에 필수입력입니다.**
16349
18407
 
18408
+ - notice\_url?: string | string\[]
18409
+
18410
+ **웹훅 수신 URL**
18411
+
18412
+ - custom\_data?: object
18413
+
18414
+ **가맹점 커스텀 데이터**
18415
+
18416
+ - bypass?: object
18417
+
18418
+ - smartro\_v2?: object
18419
+
18420
+ **스마트로 빌링키 발급 전용 파라미터**
18421
+
18422
+ - SkinColor?: string
18423
+
18424
+ **UI 스타일**
18425
+
18426
+ - `RED` (기본값), `GREEN`, `BLUE`, `PURPLE`
18427
+
18428
+ - IsPwdPass?: string
18429
+
18430
+ **결제 비밀번호 등록 Skip 여부**
18431
+
18432
+ - `Y`: 비밀번호 설정 미사용
18433
+ - `N`: 비밀번호 설정 사용 (기본값)
18434
+
16350
18435
  </details>
16351
18436
 
16352
18437
  </div>
@@ -16464,12 +18549,90 @@ IMP.request_pay(
16464
18549
 
16465
18550
  매번 고유하게 채번되어야 합니다.
16466
18551
 
18552
+ - name: string
18553
+
18554
+ **주문명**
18555
+
16467
18556
  - amount: number
16468
18557
 
16469
18558
  **결제금액**
16470
18559
 
16471
18560
  **string** 이 아닌점에 유의하세요
16472
18561
 
18562
+ - buyer\_name?: string
18563
+
18564
+ **구매자 이름**
18565
+
18566
+ - buyer\_email?: string
18567
+
18568
+ **구매자 이메일**
18569
+
18570
+ - buyer\_tel?: string
18571
+
18572
+ **구매자 연락처**
18573
+
18574
+ - buyer\_addr?: string
18575
+
18576
+ **구매자 주소**
18577
+
18578
+ - buyer\_postcode?: string
18579
+
18580
+ **구매자 우편번호**
18581
+
18582
+ - escrow?: boolean
18583
+
18584
+ **에스크로 설정여부**
18585
+
18586
+ - digital?: boolean
18587
+
18588
+ **디지털 컨텐츠 여부**
18589
+
18590
+ - `true`: 컨텐츠
18591
+ - `false`: 실물 상품
18592
+
18593
+ - language?: string
18594
+
18595
+ **결제창 언어**
18596
+
18597
+ - `ko`: 한국어 (기본값)
18598
+ - `en`: 영어
18599
+
18600
+ - vbank\_due?: string
18601
+
18602
+ **가상계좌 입금마감일시**
18603
+
18604
+ - period?: object
18605
+
18606
+ **서비스 제공기간**
18607
+
18608
+ - from?: string
18609
+
18610
+ **시작일 (YYYYMMDD)**
18611
+
18612
+ - to?: string
18613
+
18614
+ **종료일 (YYYYMMDD)**
18615
+
18616
+ - m\_redirect\_url?: string
18617
+
18618
+ **모바일 결제 후 리디렉션 될 URL**
18619
+
18620
+ - app\_scheme?: string
18621
+
18622
+ **모바일 앱 URL scheme** (모바일 전용)
18623
+
18624
+ - notice\_url?: string | string\[]
18625
+
18626
+ **웹훅 수신 URL**
18627
+
18628
+ - confirm\_url?: string
18629
+
18630
+ **Confirm process URL**
18631
+
18632
+ - custom\_data?: object
18633
+
18634
+ **가맹점 커스텀 데이터**
18635
+
16473
18636
  </div>
16474
18637
 
16475
18638
  </div>
@@ -16559,17 +18722,63 @@ IMP.request_pay(
16559
18722
 
16560
18723
  매번 고유하게 채번되어야 합니다.
16561
18724
 
18725
+ - name: string
18726
+
18727
+ **주문명**
18728
+
18729
+ - amount: number
18730
+
18731
+ **결제금액**
18732
+
18733
+ **string** 이 아닌점에 유의하세요
18734
+
18735
+ - buyer\_name?: string
18736
+
18737
+ **구매자 이름**
18738
+
18739
+ - buyer\_email?: string
18740
+
18741
+ **구매자 이메일**
18742
+
16562
18743
  - buyer\_tel: string
16563
18744
 
16564
18745
  **구매자 연락처**
16565
18746
 
16566
18747
  필수 파라미터 입니다.
16567
18748
 
16568
- - amount: number
18749
+ - buyer\_addr?: string
16569
18750
 
16570
- **결제금액**
18751
+ **구매자 주소**
16571
18752
 
16572
- **string** 아닌점에 유의하세요
18753
+ - buyer\_postcode?: string
18754
+
18755
+ **구매자 우편번호**
18756
+
18757
+ - tax\_free?: number
18758
+
18759
+ **면세금액**
18760
+
18761
+ - m\_redirect\_url?: string
18762
+
18763
+ **모바일 결제 후 리디렉션 될 URL**
18764
+
18765
+ - app\_scheme?: string
18766
+
18767
+ **모바일 앱 URL scheme** (모바일 전용)
18768
+
18769
+ 모바일 앱에서 결제 시 설정하면 결제 완료 후 해당 앱으로 돌아옵니다.
18770
+
18771
+ - notice\_url?: string | string\[]
18772
+
18773
+ **웹훅 수신 URL**
18774
+
18775
+ - confirm\_url?: string
18776
+
18777
+ **Confirm process URL**
18778
+
18779
+ - custom\_data?: object
18780
+
18781
+ **가맹점 커스텀 데이터**
16573
18782
 
16574
18783
  </div>
16575
18784
 
@@ -16708,7 +18917,7 @@ attribute가 `paypal-spb`인 elemente도 2개 이상인 경우, “동일한 dat
16708
18917
  <!-- ...중략 -->
16709
18918
  <label for="amount">결제 금액</label>
16710
18919
  <!-- 4. 구매자가 쿠폰을 적용해 결제 요청 금액이 변경(예) 1000 -> 2000)되었습니다. -->
16711
- <input id="amount" name="amount" value="1000" onchnage="onChangeAmount()" />
18920
+ <input id="amount" name="amount" value="1000" onchange="onChangeAmount()" />
16712
18921
  </form>
16713
18922
 
16714
18923
  <!--
@@ -16757,30 +18966,93 @@ attribute가 `paypal-spb`인 elemente도 2개 이상인 경우, “동일한 dat
16757
18966
 
16758
18967
  ## loadUI 요청 객체
16759
18968
 
16760
- |파라미터 |데이터타입|필수여부 |의미 |
16761
- |------------------------------------------------------------------------------------------------------|----------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
16762
- |merchant\_uid |string |required |고객사 채번 주문 고유 번호 |
16763
- |name |string |optional |제품명 |
16764
- |amount |number |required |금액 |
16765
- |\~\~pg(deprecated)\`\` |~~string~~|~~required~~|~~paypal\_v2~~ |
16766
- |channelKey |string |required |<p>paypal\_v2 채널의 채널 키 </p><p>(포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.)</p> |
16767
- |pay\_method |string |required |paypal (결제수단) |
16768
- |[country](http://chaifinance.notion.site/country-29b79aaa067846cea251a7875b0f6ed4) |string |optional |<p>국가 코드</p><p>주의: 페이팔 일반결제 테스트 모드시에만 유효</p> |
16769
- |customer\_id |string |optional |고객사가 구매자를 특정하기 위해 채번한 고유 번호 |
16770
- |buyer\_name |string |optional |구매자 전체 이름 |
16771
- |[buyer\_first\_name](http://chaifinance.notion.site/buyer_first_name-b40318cbf8e2489385a58cc59ae7ab7e)|string |optional |구매자 이름 주의: 페이팔에서만 유효하며 buyer\_name이 아닌 buyer\_first\_name과 buyer\_last\_name 입력을 권장 |
16772
- |[buyer\_last\_name](http://chaifinance.notion.site/buyer_last_name-0571c7432cf44c0ab6f3fddf34238666) |string |optional |구매자 성 주의: 페이팔에서만 유효하며 buyer\_name이 아닌 buyer\_first\_name과 buyer\_last\_name 입력을 권장 |
16773
- |buyer\_tel |string |optional |구매자 전화번호 |
16774
- |buyer\_email |string |optional |구매자 이메일 주소 |
16775
- |notice\_url |string |optional |<p>결제 창에서 결제 승인 완료 또는 가상계좌 발급 완료시 고객사에게 노티 될 웹훅 URL string 또는 string\[]로 N개 설정 가능</p><p>웹훅이 잘 발송 됐는지는 결제 승인 내역에서 아임포트 번호를 눌러봤을때 웹훅 발송 내역을 보고 확인할 수 있음</p> |
16776
- |confirm\_url |string |optional |<p>결제창이 호출되고 구매자가 최종 결제 승인을 하기까지 수량 소진 등 모종의 사유로 더이상 결제가 불가능 하게 되는 상황을 대비해, 최종 결제 승인 직전 최종 결제 승인 여부를 질의할 고객사 웹서버 endpoint</p><p>아임포트가 해당 endpoint로 최종 결제 승인 질의시, 200 외의 응답을 받으면 최종 결제 승인을 시키지 않고 결제 실패 상태로 기록함</p><p /><p>
16777
-
16778
- <strong>주의: 아임포트 CS팀으로 해당 기능 사용 신청을 해야 함</strong>
16779
-
16780
- </p>|
16781
- |[products](http://chaifinance.notion.site/products-9107dec19480457bbfeb06e9244eb31c) |array |optional |결제 상품 정보 |
16782
- |[currency](http://chaifinance.notion.site/currency-196b9c5e6a8543df9059ff20199028fc) |string |optional |결제 통화 (기본값: USD) |
16783
- |custom\_data |object |optional |결제 정보와 함께 관리하고 싶은 고객사 커스텀 JSON 데이터 |
18969
+ - channelKey: string
18970
+
18971
+ **채널키**
18972
+
18973
+ paypal\_v2 채널의 채널 키입니다. 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
18974
+
18975
+ - pg(deprecated)?: string
18976
+
18977
+ ~~`paypal_v2`로 지정합니다.~~
18978
+
18979
+ - pay\_method: string
18980
+
18981
+ **결제수단 구분코드**
18982
+
18983
+ `paypal`로 지정합니다.
18984
+
18985
+ - merchant\_uid: string
18986
+
18987
+ **고객사 채번 주문 고유 번호**
18988
+
18989
+ - name?: string
18990
+
18991
+ **제품명**
18992
+
18993
+ - amount: number
18994
+
18995
+ **금액**
18996
+
18997
+ - currency?: string
18998
+
18999
+ **결제 통화** (기본값: USD)
19000
+
19001
+ - country?: string
19002
+
19003
+ **국가 코드**
19004
+
19005
+ 주의: 페이팔 일반결제 **테스트 모드시에만** 유효합니다.
19006
+
19007
+ - customer\_id?: string
19008
+
19009
+ **구매자 고유 ID**
19010
+
19011
+ 고객사가 구매자를 특정하기 위해 채번한 고유 번호
19012
+
19013
+ - buyer\_name?: string
19014
+
19015
+ **구매자 전체 이름**
19016
+
19017
+ - buyer\_first\_name?: string
19018
+
19019
+ **구매자 이름**
19020
+
19021
+ 페이팔에서만 유효하며 `buyer_name`이 아닌 `buyer_first_name`과 `buyer_last_name` 입력을 권장합니다.
19022
+
19023
+ - buyer\_last\_name?: string
19024
+
19025
+ **구매자 성**
19026
+
19027
+ 페이팔에서만 유효하며 `buyer_name`이 아닌 `buyer_first_name`과 `buyer_last_name` 입력을 권장합니다.
19028
+
19029
+ - buyer\_tel?: string
19030
+
19031
+ **구매자 전화번호**
19032
+
19033
+ - buyer\_email?: string
19034
+
19035
+ **구매자 이메일 주소**
19036
+
19037
+ - notice\_url?: string | string\[]
19038
+
19039
+ **웹훅 수신 URL**
19040
+
19041
+ 결제 승인 완료 시 고객사에게 웹훅이 발송됩니다.
19042
+
19043
+ - confirm\_url?: string
19044
+
19045
+ **Confirm process URL**
19046
+
19047
+ 최종 결제 승인 직전 승인 여부를 질의할 고객사 서버 URL입니다. 200 외의 응답을 받으면 결제가 중단됩니다.
19048
+
19049
+ - products?: array
19050
+
19051
+ **결제 상품 정보**
19052
+
19053
+ - custom\_data?: object
19054
+
19055
+ **가맹점 커스텀 데이터**
16784
19056
 
16785
19057
  <div class="hint" data-style="warning">
16786
19058
 
@@ -18064,7 +20336,7 @@ await IMP.loadModule(
18064
20336
  브랜드페이의 모듈 로딩에 필요한 추가 파라미터입니다.
18065
20337
  `moduleType`을 `toss-brandpay`로 설정하는 경우 필요합니다.
18066
20338
 
18067
- - loadBrandpayOptions.customer\_id: string
20339
+ - customerKey: string
18068
20340
 
18069
20341
  **구매자 ID**
18070
20342
 
@@ -18359,10 +20631,42 @@ IMP.request_pay(
18359
20631
 
18360
20632
  브랜드페이는 원화 결제만 지원합니다. KRW 기준으로 금액을 입력해주세요.
18361
20633
 
20634
+ - buyer\_name?: string
20635
+
20636
+ **구매자 이름**
20637
+
18362
20638
  - buyer\_email?: string
18363
20639
 
18364
20640
  **구매자 email 주소**
18365
20641
 
20642
+ - buyer\_tel?: string
20643
+
20644
+ **구매자 연락처**
20645
+
20646
+ - buyer\_addr?: string
20647
+
20648
+ **구매자 주소**
20649
+
20650
+ - buyer\_postcode?: string
20651
+
20652
+ **구매자 우편번호**
20653
+
20654
+ - tax\_free?: number
20655
+
20656
+ **면세금액**
20657
+
20658
+ - notice\_url?: string | string\[]
20659
+
20660
+ **웹훅 수신 URL**
20661
+
20662
+ - confirm\_url?: string
20663
+
20664
+ **Confirm process URL**
20665
+
20666
+ - custom\_data?: object
20667
+
20668
+ **가맹점 커스텀 데이터**
20669
+
18366
20670
  - customer\_id: string
18367
20671
 
18368
20672
  **구매자 ID**
@@ -18372,7 +20676,7 @@ IMP.request_pay(
18372
20676
 
18373
20677
  - bypass?: object
18374
20678
 
18375
- - isCulturalExpense: string
20679
+ - isCulturalExpense?: boolean
18376
20680
 
18377
20681
  **도서 문화비 결제 여부**
18378
20682
 
@@ -18526,7 +20830,7 @@ IMP.request_pay(
18526
20830
 
18527
20831
  아래 파라미터는 브랜드페이 위젯에서는 사용할 수 없습니다.
18528
20832
 
18529
- - **`display.card_quot`**
20833
+ - **`display.card_quota`**
18530
20834
  - **`useCardPoint`**
18531
20835
  - **`bypass.cashReceiptType`**
18532
20836
  - **`bypass.customerIdentifier`**
@@ -18961,9 +21265,12 @@ IMP.request_pay(
18961
21265
  **결제수단 구분코드**
18962
21266
 
18963
21267
  - card(신용카드)
18964
- - transfer(퀵계좌이체)
21268
+ - trans(실시간 계좌이체)
18965
21269
  - vbank(가상계좌)
18966
21270
  - phone(휴대폰소액결제)
21271
+ - cultureland(컬쳐랜드 문화상품권)
21272
+ - smartculture(스마트문상)
21273
+ - booknlife(도서문화상품권)
18967
21274
  - applepay(애플페이)
18968
21275
  - tosspay(토스페이)
18969
21276
  - naverpay(네이버페이)
@@ -18978,16 +21285,126 @@ IMP.request_pay(
18978
21285
 
18979
21286
  매번 고유하게 채번되어야 합니다.
18980
21287
 
21288
+ - name: string
21289
+
21290
+ **주문명**
21291
+
18981
21292
  - amount: number
18982
21293
 
18983
21294
  **결제금액**
18984
21295
 
18985
21296
  **string** 이 아닌점에 유의하세요
18986
21297
 
21298
+ - buyer\_name?: string
21299
+
21300
+ **구매자 이름**
21301
+
21302
+ - buyer\_email?: string
21303
+
21304
+ **구매자 이메일**
21305
+
21306
+ - buyer\_tel?: string
21307
+
21308
+ **구매자 연락처**
21309
+
21310
+ - buyer\_addr?: string
21311
+
21312
+ **구매자 주소**
21313
+
21314
+ - buyer\_postcode?: string
21315
+
21316
+ **구매자 우편번호**
21317
+
18987
21318
  - escrow?: boolean
18988
21319
 
18989
21320
  **에스크로 설정여부**
18990
21321
 
21322
+ - tax\_free?: number
21323
+
21324
+ **면세금액**
21325
+
21326
+ - vbank\_due?: string
21327
+
21328
+ **가상계좌 입금마감일시**
21329
+
21330
+ `YYYYMMDD` 또는 `YYYYMMDDHHmmss` 형식으로 지정합니다.
21331
+
21332
+ - language?: string
21333
+
21334
+ **결제창 언어**
21335
+
21336
+ - `ko`: 한국어 (기본값)
21337
+ - `en`: 영어
21338
+
21339
+ - appCard?: boolean
21340
+
21341
+ **앱카드 전용 모드**
21342
+
21343
+ `true` 설정 시 신용카드 결제모듈에서 앱카드 결제만 활성화됩니다.
21344
+
21345
+ - m\_redirect\_url?: string
21346
+
21347
+ **모바일 결제 후 리디렉션 될 URL**
21348
+
21349
+ - app\_scheme?: string
21350
+
21351
+ **모바일 앱 URL scheme** (모바일 전용)
21352
+
21353
+ - notice\_url?: string | string\[]
21354
+
21355
+ **웹훅 수신 URL**
21356
+
21357
+ - confirm\_url?: string
21358
+
21359
+ **Confirm process URL**
21360
+
21361
+ - custom\_data?: object
21362
+
21363
+ **가맹점 커스텀 데이터**
21364
+
21365
+ - display?: object
21366
+
21367
+ **결제창에 렌더링될 카드 할부 개월수 리스트 설정값**
21368
+
21369
+ - card\_quota?: number\[]
21370
+
21371
+ **할부 개월수**
21372
+
21373
+ 예시
21374
+
21375
+ - `[]`: 일시불만 결제 가능
21376
+ - `[2,3,4,5,6]`: 일시불을 포함한 2, 3, 4, 5, 6개월까지 할부개월 선택 가능
21377
+
21378
+ - card?: object
21379
+
21380
+ **카드 결제 옵션**
21381
+
21382
+ - direct?: object
21383
+
21384
+ **카드사 다이렉트 호출 정보**
21385
+
21386
+ - code?: string
21387
+
21388
+ **카드사 금융결제원 표준 코드**
21389
+
21390
+ [카드사 코드](https://developers.portone.io/opi/ko/support/code-info/card-code) 참조
21391
+
21392
+ - quota?: number
21393
+
21394
+ **할부 개월 수**
21395
+
21396
+ 일시불일 시 0으로 설정합니다.
21397
+
21398
+ - bypass?: object
21399
+
21400
+ **토스페이먼츠 구모듈 전용 파라미터**
21401
+
21402
+ - uplus?: object
21403
+
21404
+ - LGD\_AUTO\_DISCOUNT?: string
21405
+
21406
+ **카드 프로모션 자동 적용 여부**
21407
+
18991
21408
 
18992
21409
  # https://developers.portone.io/opi/ko/integration/pg/v1/tosspay-v2/caution
18993
21410
 
@@ -19125,8 +21542,10 @@ IMP.request_pay(
19125
21542
  useInstallment: false,
19126
21543
  },
19127
21544
  bypass: {
19128
- expiredTime: "2023-12-02 11:00:00", //결제 만료시간
19129
- cashReceiptTradeOption: "CULTURE", //현금영수증 발급타입
21545
+ tosspay_v2: {
21546
+ expiredTime: "2023-12-02 11:00:00", //결제 만료시간
21547
+ cashReceiptTradeOption: "CULTURE", //현금영수증 발급타입
21548
+ },
19130
21549
  },
19131
21550
  },
19132
21551
  function (rsp) {
@@ -19181,35 +21600,75 @@ IMP.request_pay(
19181
21600
 
19182
21601
  매번 고유하게 채번되어야 합니다.
19183
21602
 
21603
+ - name: string
21604
+
21605
+ **주문명**
21606
+
19184
21607
  - amount: number
19185
21608
 
19186
21609
  **결제금액**
19187
21610
 
19188
21611
  string 이 아닌점에 유의하세요
19189
21612
 
21613
+ - buyer\_name?: string
21614
+
21615
+ **구매자 이름**
21616
+
21617
+ - buyer\_email?: string
21618
+
21619
+ **구매자 이메일**
21620
+
21621
+ - buyer\_tel?: string
21622
+
21623
+ **구매자 연락처**
21624
+
21625
+ - m\_redirect\_url?: string
21626
+
21627
+ **모바일 결제 후 리디렉션 될 URL**
21628
+
21629
+ - app\_scheme?: string
21630
+
21631
+ **모바일 앱 URL scheme** (모바일 전용)
21632
+
21633
+ - notice\_url?: string | string\[]
21634
+
21635
+ **웹훅 수신 URL**
21636
+
21637
+ - confirm\_url?: string
21638
+
21639
+ **Confirm process URL**
21640
+
21641
+ - custom\_data?: object
21642
+
21643
+ **가맹점 커스텀 데이터**
21644
+
19190
21645
  - card.useInstallment: boolean
19191
21646
 
19192
21647
  **할부 사용 가능 여부**
19193
21648
 
19194
21649
  - bypass?: object
19195
21650
 
19196
- - expiredTime: string
21651
+ - tosspay\_v2?: object
21652
+
21653
+ **(신) 토스페이 전용 파라미터**
19197
21654
 
19198
- **결제 만료 기한**
21655
+ - expiredTime?: string
19199
21656
 
19200
- `yyyy-MM-dd HH:mm:ss` 의 형식입니다.
21657
+ **결제 만료 기한**
19201
21658
 
19202
- 입력하지 않을 경우, 기본값인 15분으로 설정됩니다. 최대 60분까지 설정할 수 있습니다.
21659
+ `yyyy-MM-dd HH:mm:ss` 형식입니다.
19203
21660
 
19204
- - cashReceiptTradeOption: string
21661
+ 입력하지 않을 경우, 기본값인 15분으로 설정됩니다. 최대 60분까지 설정할 수 있습니다.
19205
21662
 
19206
- **현금영수증 발급 대상 타입**
21663
+ - cashReceiptTradeOption?: string
19207
21664
 
19208
- 전달하지 않을경우, 기본값은 `GENERAL` 입니다.
21665
+ **현금영수증 발급 대상 타입**
19209
21666
 
19210
- - `GENERAL`: 일반 (default)
19211
- - `CULTURE`: 문화비
19212
- - `PUBLIC_TP`: 교통비
21667
+ 전달하지 않을경우, 기본값은 `GENERAL` 입니다.
21668
+
21669
+ - `GENERAL`: 일반 (default)
21670
+ - `CULTURE`: 문화비
21671
+ - `PUBLIC_TP`: 교통비
19213
21672
 
19214
21673
  </details>
19215
21674
 
@@ -19311,6 +21770,16 @@ IMP.request_pay(
19311
21770
 
19312
21771
  빌링키 발급이 완료됐을 때 웹훅이 전달될 URL입니다. 해당 파라미터가 전달되지 않은 경우 콘솔에 등록한 웹훅 주소로 웹훅이 발송됩니다. **(신) 토스페이의 경우 SDK 콜백만으로 빌링키 발급여부를 체크하는 경우 정보 유실 가능성이 있기 때문에, 반드시 웹훅으로 빌링키 발급여부를 체크하길 권장합니다**.
19313
21772
 
21773
+ - bypass?: object
21774
+
21775
+ - tosspay\_v2?: object
21776
+
21777
+ - encryptedUserCi?: string
21778
+
21779
+ **암호화된 사용자 CI**
21780
+
21781
+ 빌링키 발급 시 사용자 CI를 암호화하여 전달할 수 있습니다.
21782
+
19314
21783
  </details>
19315
21784
 
19316
21785
  </div>
@@ -19333,10 +21802,11 @@ await fetch("https://api.iamport.kr/subscribe/payments/again", {
19333
21802
  merchant_uid: "merchant_uid", // [필수 입력] 주문 번호
19334
21803
  amount: 1000, // [필수 입력] 결제 금액
19335
21804
  name: "주문명", // 주문명
19336
- cash_recipt_type: "person", // 현금영수증 발급 타입
21805
+ cash_receipt_type: "person", // 현금영수증 발급 타입
19337
21806
  bypass: {
19338
21807
  tosspay_v2: {
19339
- cashReceiptTradeType: "GENERAL", // 현금영수증 발급 대상 타입
21808
+ cashReceipt: true, // 현금영수증 발급 여부 (default: true)
21809
+ cashReceiptTradeOption: "GENERAL", // 현금영수증 발급 대상 타입
19340
21810
  sendFailPush: false, // 결제 실패 시 토스페이앱 푸시알람 발송 여부
19341
21811
  },
19342
21812
  },
@@ -19350,6 +21820,12 @@ await fetch("https://api.iamport.kr/subscribe/payments/again", {
19350
21820
 
19351
21821
  - tosspay\_v2?: object
19352
21822
 
21823
+ - cashReceipt?: boolean
21824
+
21825
+ **현금영수증 발급 여부**
21826
+
21827
+ 기본값은 `true`입니다.
21828
+
19353
21829
  - cashReceiptTradeOption?: string
19354
21830
 
19355
21831
  **현금영수증 발급 대상 타입**
@@ -19358,7 +21834,7 @@ await fetch("https://api.iamport.kr/subscribe/payments/again", {
19358
21834
  - `CULTURE`: 문화비
19359
21835
  - `PUBLIC_TP`: 교통비
19360
21836
 
19361
- - tosspay\_v2.cashReceiptTradeOption?: boolean
21837
+ - sendFailPush?: boolean
19362
21838
 
19363
21839
  **결제실패 푸시알람 사용 여부**
19364
21840
 
@@ -19455,7 +21931,7 @@ IMP.request_pay(
19455
21931
 
19456
21932
  **결제수단 구분코드**
19457
21933
 
19458
- 신용카드 : `card` | 계좌이체 : `trans`
21934
+ 입력값은 `card` 지원합니다. 단, 결제창 호출 이후에는 토스페이 머니 결제와 카드 결제 중 선택하여 진행할 수 있습니다.
19459
21935
 
19460
21936
  - name: string
19461
21937
 
@@ -19473,6 +21949,46 @@ IMP.request_pay(
19473
21949
 
19474
21950
  **string** 이 아닌점에 유의하세요
19475
21951
 
21952
+ - buyer\_name?: string
21953
+
21954
+ **구매자 이름**
21955
+
21956
+ - buyer\_email?: string
21957
+
21958
+ **구매자 이메일**
21959
+
21960
+ - buyer\_tel?: string
21961
+
21962
+ **구매자 연락처**
21963
+
21964
+ - buyer\_addr?: string
21965
+
21966
+ **구매자 주소**
21967
+
21968
+ - buyer\_postcode?: string
21969
+
21970
+ **구매자 우편번호**
21971
+
21972
+ - tax\_free?: number
21973
+
21974
+ **면세금액**
21975
+
21976
+ - m\_redirect\_url?: string
21977
+
21978
+ **모바일 결제 후 리디렉션 될 URL**
21979
+
21980
+ - notice\_url?: string | string\[]
21981
+
21982
+ **웹훅 수신 URL**
21983
+
21984
+ - confirm\_url?: string
21985
+
21986
+ **Confirm process URL**
21987
+
21988
+ - custom\_data?: object
21989
+
21990
+ **가맹점 커스텀 데이터**
21991
+
19476
21992
  </div>
19477
21993
 
19478
21994
  </div>
@@ -20385,12 +22901,24 @@ IMP.request_pay(
20385
22901
 
20386
22902
  **구매자 이메일 주소**
20387
22903
 
22904
+ - buyer\_addr?: string
22905
+
22906
+ **구매자 주소**
22907
+
22908
+ - buyer\_postcode?: string
22909
+
22910
+ **구매자 우편번호**
22911
+
20388
22912
  - m\_redirect\_url?: string
20389
22913
 
20390
22914
  **모바일 환경에서 트랜잭션 종료 후 302 리디렉션 될 URL**
20391
22915
 
20392
22916
  주의: 웰컴페이먼츠의 경우 **모바일 환경에서 필수 입력**입니다.
20393
22917
 
22918
+ - custom\_data?: object
22919
+
22920
+ **가맹점 커스텀 데이터**
22921
+
20394
22922
  - notice\_url?: string 또는 **string\[]**
20395
22923
 
20396
22924
  **트랜잭션 종료 후 웹훅이 발송 될 고객사 서버 URL**
@@ -21699,7 +24227,7 @@ const {
21699
24227
  - 토스페이먼츠 (신모듈)
21700
24228
  - 다날
21701
24229
  - 이지페이(KICC)
21702
- - 모빌리언스 (휴대폰 소액결제 한정)
24230
+ - KG파이낸셜 (휴대폰 소액결제 한정)
21703
24231
  - 웰컴페이먼츠
21704
24232
  - 스마트로 (신모듈)
21705
24233
  - 헥토파이낸셜 (내통장 결제 한정)
@@ -22516,7 +25044,7 @@ targetVersions:
22516
25044
  | 카카오페이 | `kakaopay` |
22517
25045
  |다날휴대폰결제/본인인증| `danal` |
22518
25046
  | 다날 | `danal_tpay` |
22519
- | 모빌리언스 | `mobilians` |
25047
+ | KG파이낸셜 | `mobilians` |
22520
25048
  | 페이코 | `payco` |
22521
25049
  | (구) 페이팔 | `paypal` |
22522
25050
  | (신) 페이팔 | `paypal_v2` |
@@ -22561,11 +25089,11 @@ targetVersions:
22561
25089
 
22562
25090
  (파일: 토스페이먼츠 오류코드 다운로드)
22563
25091
 
22564
- ## KG모빌리언스
25092
+ ## KG파이낸셜
22565
25093
 
22566
- (파일: KG모빌리언스 휴대폰 결제 오류코드 다운로드)
25094
+ (파일: KG파이낸셜 휴대폰 결제 오류코드 다운로드)
22567
25095
 
22568
- (파일: KG모빌리언스 휴대폰 결제 취소 오류코드 다운로드)
25096
+ (파일: KG파이낸셜 휴대폰 결제 취소 오류코드 다운로드)
22569
25097
 
22570
25098
  ## 다날
22571
25099
 
@@ -22608,7 +25136,7 @@ API방식으로 연동하실 때는 [비인증 결제(일회성) API](https://de
22608
25136
  | 헥토파이낸셜 | settle | X | O | - |
22609
25137
  | 이지페이(KICC) | kicc | O | X | 불가능 |
22610
25138
  | 키움페이 | daou | X | O | - |
22611
- | KG모빌리언스 | moblians | O | X | 가능 |
25139
+ | KG파이낸셜 | mobilians | O | X | 가능 |
22612
25140
  | KSNET | ksnet | X | O | - |
22613
25141
  | 스마트로(신모듈) | smartro\_v2 | O | X | 불가능 |
22614
25142
  | 웰컴페이먼츠 | welcome | O | O |발급 수단에 따라 상이함. (카드 : 불가능 / 휴대폰소액결제 : 가능)|
@@ -23272,7 +25800,7 @@ versionVariants:
23272
25800
  - `kcp_billing`(NHN KCP 결제창 정기결제)
23273
25801
  - `kicc`(이지페이(한국정보통신) 결제창 일반/정기결제)
23274
25802
  - `ksnet`(KSNET 결제창 일반결제 및 API 수기/정기결제)
23275
- - `mobilians`(모빌리언스 결제창 일반/정기결제)
25803
+ - `mobilians`(KG파이낸셜 결제창 일반/정기결제)
23276
25804
  - `nice`(나이스정보통신(구모듈) 결제창 일반결제 및 API 수기/정기결제)
23277
25805
  - `nice_v2`(나이스페이(신모듈) 결제창 일반결제 및 API 수기/정기결제)
23278
25806
  - `settle`(헥토파이낸셜 결제창 일반결제 및 API 수기/정기결제)
@@ -23590,7 +26118,7 @@ versionVariants:
23590
26118
  ```json
23591
26119
  {
23592
26120
  "display": {
23593
- "card_quota": [6] // 할부개월 6개월만 활성화
26121
+ "card_quota": [6]
23594
26122
  }
23595
26123
  }
23596
26124
  ```
@@ -23613,6 +26141,14 @@ versionVariants:
23613
26141
 
23614
26142
  </div>
23615
26143
 
26144
+ <div class="hint" data-style="danger">
26145
+
26146
+ PG사 별로 지원 여부 및 이용 방법이 상이할 수 있습니다.
26147
+
26148
+ PG사 별 이용 방법은 결제대행사 선택하여 연동하기를 참고해주세요.
26149
+
26150
+ </div>
26151
+
23616
26152
  ### 카드사 결제모듈 바로(direct) 호출하기
23617
26153
 
23618
26154
  ```ts
@@ -23872,7 +26408,7 @@ PG사 또는 결제수단에 따라서 반환되는 속성들이 상이합니다
23872
26408
  - `kakaopay`(카카오페이)
23873
26409
  - `danal`(다날 휴대폰 소액결제)
23874
26410
  - `danal_tpay`(다날 일반결제)
23875
- - `mobilians`(모빌리언스)
26411
+ - `mobilians`(KG파이낸셜)
23876
26412
  - `payco`(페이코)
23877
26413
  - `paypal`((구) 페이팔)
23878
26414
  - `eximbay`(엑심베이)
@@ -28604,7 +31140,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
28604
31140
  - **다날** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
28605
31141
  - **키움페이** : 카드 / 실시간 계좌이체 / 가상계좌
28606
31142
  - **헥토파이낸셜** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
28607
- - **KG모빌리언스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
31143
+ - **KG파이낸셜** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
28608
31144
  - **KSNET** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
28609
31145
  - **이지페이(KICC)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
28610
31146
  - **웰컴페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
@@ -28945,9 +31481,9 @@ targetVersions:
28945
31481
 
28946
31482
  <details>
28947
31483
 
28948
- <summary>모빌리언스</summary>
31484
+ <summary>KG파이낸셜</summary>
28949
31485
 
28950
- 포트원 콘솔에서 채널 추가 시 계약 완료 후 모빌리언스로부터 전달받은 \[서비스ID]를 입력한 후 `저장`을 클릭합니다.
31486
+ 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG파이낸셜로부터 전달받은 \[서비스ID]를 입력한 후 `저장`을 클릭합니다.
28951
31487
 
28952
31488
  <div class="hint" data-style="info">
28953
31489
 
@@ -29276,25 +31812,13 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
29276
31812
 
29277
31813
  (이미지 첨부: KCP 파트너관리자 내 관리용 사설인증서 발급 완료 화면)
29278
31814
 
29279
- 4. \[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
29280
-
29281
- 5. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
29282
-
29283
- 6. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
29284
-
29285
- 7. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
31815
+ 4. \[결제관리]→\[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
29286
31816
 
29287
- 8. \[고지방법]에서 원하시는 고지 방법을 선택한 \[등록하기]를 클릭합니다.
31817
+ 5. 그룹명을 입력 그룹을 생성하고 생성된 그룹아이디를 확인합니다.
29288
31818
 
29289
- (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
29290
-
29291
- 9. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
29292
-
29293
- 10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
29294
-
29295
- (이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
31819
+ (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
29296
31820
 
29297
- 11. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 정기자동결제 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
31821
+ 6. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
29298
31822
 
29299
31823
  </div>
29300
31824
 
@@ -29312,25 +31836,13 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
29312
31836
 
29313
31837
  (이미지 첨부: KCP 파트너관리자 내 관리용 사설인증서 발급 완료 화면)
29314
31838
 
29315
- 4. \[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
31839
+ 4. \[결제관리]→\[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
29316
31840
 
29317
- 5. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
31841
+ 5. 그룹명을 입력 그룹을 생성하고 생성된 그룹아이디를 확인합니다.
29318
31842
 
29319
- 6. \[그룹정보]에서 \[유형3]을 선택한 원하는 그룹명을 입력합니다.
31843
+ (이미지 첨부: KCP 파트너관리자 관리용 그룹등록 화면)
29320
31844
 
29321
- 7. \[결제입력 정보]에서 \[결제유형] \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
29322
-
29323
- 8. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
29324
-
29325
- (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
29326
-
29327
- 9. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
29328
-
29329
- 10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
29330
-
29331
- (이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
29332
-
29333
- 11. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 정기자동결제 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
31845
+ 6. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 정기자동결제 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
29334
31846
 
29335
31847
  </div>
29336
31848
 
@@ -29395,21 +31907,13 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
29395
31907
  9. 정기결제를 이용하시는 경우, 아래 절차를 진행해주세요.
29396
31908
 
29397
31909
  1. [KCP 파트너관리자](http://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
29398
- 2. \[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
29399
- 3. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
29400
- 4. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
29401
- 5. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
29402
- 6. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
31910
+ 2. \[결제관리]→\[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
31911
+ 3. 그룹명을 입력 그룹을 생성하고 생성된 그룹아이디를 확인합니다.
29403
31912
 
29404
31913
  (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
29405
31914
 
29406
- 7. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
29407
- 8. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
29408
-
29409
- (이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
29410
-
29411
- 9. 포트원 콘솔에서 채널 추가 시 앞서 발급한 \[MID(사이트코드)], \[PG-API 인증서키], \[PG-API 개인키],
29412
- \[개인키 비밀번호], \[정기자동결제 그룹아이디]를 입력한 후 \[저장]을 클릭합니다.
31915
+ 4. 포트원 콘솔에서 채널 추가 시 앞서 발급한 \[MID(사이트코드)], \[PG-API 인증서키], \[PG-API 개인키],
31916
+ \[개인키 비밀번호], \[자동결제 그룹아이디]를 입력한 후 \[저장]을 클릭합니다.
29413
31917
 
29414
31918
  <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
29415
31919
 
@@ -30332,7 +32836,7 @@ targetVersions:
30332
32836
 
30333
32837
  <span>API 문서 바로가기</span>
30334
32838
 
30335
- <i class="i-ic-baseline-chevron-right inline-block text-2xl" />
32839
+ <i class="icon-[ic--baseline-chevron-right] inline-block text-2xl" />
30336
32840
 
30337
32841
  </a>
30338
32842
 
@@ -30344,7 +32848,7 @@ targetVersions:
30344
32848
 
30345
32849
  <span>API 문서 바로가기</span>
30346
32850
 
30347
- <i class="i-ic-baseline-chevron-right inline-block text-2xl" />
32851
+ <i class="icon-[ic--baseline-chevron-right] inline-block text-2xl" />
30348
32852
 
30349
32853
  </a>
30350
32854
 
@@ -34113,11 +36617,11 @@ iOS13 이후 아이패드 기기에서 결제 요청 시 PC 환경의 결제창
34113
36617
 
34114
36618
  ## 기타 수정사항
34115
36619
 
34116
- ### ✔️ KG모빌리언스를 통해 신용카드 결제를 이용할 수 있습니다
36620
+ ### ✔️ KG파이낸셜을 통해 신용카드 결제를 이용할 수 있습니다
34117
36621
 
34118
- KG모빌리언스와 계약을 통해 새로운 결제수단으로 신용카드를 이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이 안내드리겠습니다.
36622
+ KG파이낸셜과 계약을 통해 새로운 결제수단으로 신용카드를 이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이 안내드리겠습니다.
34119
36623
 
34120
- 본 기능 설정을 위한 자세한 내용은 관련 연동가이드를 확인 바랍니다. [→ KG모빌리언스](https://developers.portone.io/docs/ko/pg/payment-gateway/kg)
36624
+ 본 기능 설정을 위한 자세한 내용은 관련 연동가이드를 확인 바랍니다. [→ KG파이낸셜](https://developers.portone.io/docs/ko/pg/payment-gateway/kg)
34121
36625
 
34122
36626
 
34123
36627
  # https://developers.portone.io/release-notes/api-sdk/2023-07-10