@portone/mcp-server 0.15.0 → 0.16.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/docs/help/admin-console/pg-settlement/content30.md +2 -2
- package/assets/docs/help/admin-console/pg-settlement-history/content35.md +2 -2
- package/assets/docs/help/core-service/channel-setting/danal.md +4 -4
- package/assets/docs/help/core-service/channel-setting/daou.md +5 -0
- package/assets/docs/help/core-service/channel-setting/galaxia.md +2 -2
- package/assets/docs/help/core-service/channel-setting/inicis.md +30 -46
- package/assets/docs/help/core-service/channel-setting/kcp_channel.md +25 -13
- package/assets/docs/help/core-service/channel-setting/kpn.md +3 -2
- package/assets/docs/help/core-service/channel-setting/mobilians.md +22 -27
- package/assets/docs/help/core-service/channel-setting/nice.md +4 -4
- package/assets/docs/help/core-service/channel-setting/payco.md +5 -3
- package/assets/docs/help/core-service/channel-setting/payletter.md +3 -3
- package/assets/docs/help/core-service/how-to-use/additional-mobilians.md +15 -21
- package/assets/docs/help/core-service/how-to-use/content200009.md +10 -9
- package/assets/docs/help/core-service/how-to-use/high-risk-industry.md +2 -0
- package/assets/docs/help/core-service/how-to-use/information-pg.md +1 -1
- package/assets/docs/help/core-service/how-to-use/mobilians-contract.md +26 -21
- package/assets/docs/help/core-service/how-to-use/requirements.md +2 -0
- package/assets/docs/help/core-service/how-to-use/test-mode-cancel.md +1 -1
- package/assets/docs/help/core-service/how-to-use/wordpress-setting.md +2 -1
- package/assets/docs/help/core-service/payment-type/content200047.md +3 -1
- package/assets/docs/help/core-service/payment-type/content200052.md +8 -1
- package/assets/docs/help/core-service/payment-type/hub-service-fee.md +1 -1
- package/assets/docs/help/core-service/payment-type/internationl-high-risk-industry.md +1 -26
- package/assets/docs/help/faq/general-inquiry/confirm-process.md +5 -11
- package/assets/docs/help/faq/general-inquiry/real-channel-info.md +1 -1
- package/assets/docs/help/faq/payment-faq/pg-max-min-amount.md +3 -3
- package/assets/docs/help/faq/payment-faq/vbank-service-detail.md +1 -1
- package/assets/docs/help/pricing/pg/domestic-and-oversea-fees.md +1 -1
- package/assets/docs/help/pricing/portone/portone-pricing.md +2 -0
- package/assets/docs/help/procedure/pg-application/content54.md +2 -0
- package/assets/docs/help/procedure/pg-application/start.md +2 -0
- package/assets/docs/help/procedure/recommendation/package.md +4 -2
- package/assets/docs/help/service/pg/pg-service-list.md +8 -6
- package/assets/docs/opi/ko/extra/link-pay/readme-v1.md +36 -4
- package/assets/docs/opi/ko/extra/mobile-payment/readme-v2.md +610 -0
- package/assets/docs/opi/ko/extra/smart-routing/intro.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/blue.md +36 -0
- package/assets/docs/opi/ko/integration/pg/v1/danal.md +134 -4
- package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +103 -53
- package/assets/docs/opi/ko/integration/pg/v1/eximbay.md +121 -19
- package/assets/docs/opi/ko/integration/pg/v1/galaxia.md +12 -0
- package/assets/docs/opi/ko/integration/pg/v1/inicis-jp.md +57 -30
- package/assets/docs/opi/ko/integration/pg/v1/inicis.md +177 -0
- package/assets/docs/opi/ko/integration/pg/v1/kakaopay.md +128 -2
- package/assets/docs/opi/ko/integration/pg/v1/kg-mobilians-v2.md +19 -19
- package/assets/docs/opi/ko/integration/pg/v1/kg.md +65 -12
- package/assets/docs/opi/ko/integration/pg/v1/kicc.md +115 -2
- package/assets/docs/opi/ko/integration/pg/v1/ksnet/readme.md +14 -2
- package/assets/docs/opi/ko/integration/pg/v1/naver.md +60 -0
- package/assets/docs/opi/ko/integration/pg/v1/newtoss/readme.md +117 -7
- package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/kcp-quickpay.md +21 -32
- package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/readme.md +164 -3
- package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md +6 -6
- package/assets/docs/opi/ko/integration/pg/v1/nice-v2/readme.md +177 -2
- package/assets/docs/opi/ko/integration/pg/v1/nice.md +122 -3
- package/assets/docs/opi/ko/integration/pg/v1/payco.md +87 -3
- package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md +142 -1
- package/assets/docs/opi/ko/integration/pg/v1/paymentwall.md +45 -1
- package/assets/docs/opi/ko/integration/pg/v1/paypal.md +37 -1
- package/assets/docs/opi/ko/integration/pg/v1/readme.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/rt/readme.md +52 -14
- package/assets/docs/opi/ko/integration/pg/v1/settle/mybank.md +138 -56
- package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md +50 -0
- package/assets/docs/opi/ko/integration/pg/v1/smartro-v2/readme.md +126 -0
- package/assets/docs/opi/ko/integration/pg/v1/smartro.md +78 -0
- package/assets/docs/opi/ko/integration/pg/v1/smilepay.md +49 -3
- package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md +88 -25
- package/assets/docs/opi/ko/integration/pg/v1/toss-brandpay/module.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/toss-brandpay/readme.md +34 -2
- package/assets/docs/opi/ko/integration/pg/v1/toss.md +114 -1
- package/assets/docs/opi/ko/integration/pg/v1/tosspay-v2/readme.md +74 -15
- package/assets/docs/opi/ko/integration/pg/v1/tosspay.md +41 -1
- package/assets/docs/opi/ko/integration/pg/v1/welcome/readme.md +12 -0
- package/assets/docs/opi/ko/integration/pg/v2/inicis-jp.md +3 -15
- package/assets/docs/opi/ko/integration/pg/v2/triple-a.md +1 -0
- package/assets/docs/opi/ko/integration/ready/readme.md +14 -46
- package/assets/docs/opi/ko/integration/start/v1/non-auth.md +1 -1
- package/assets/docs/opi/ko/readme.md +2 -2
- package/assets/docs/opi/ko/support/code-info/pg-2.md +1 -1
- package/assets/docs/opi/ko/support/code-info/pg-3.md +3 -3
- package/assets/docs/opi/ko/support/code-info/pg.md +1 -1
- package/assets/docs/release-notes/api-sdk/2023-07-03.md +3 -3
- package/assets/docs/schema/v1.openapi.json +239 -3
- package/assets/docs/schema/v1.openapi.yml +174 -12
- package/assets/docs/schema/v2.openapi.json +225 -11
- package/assets/docs/schema/v2.openapi.yml +185 -3
- package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrq.md +10 -2
- package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrt.md +1 -1
- package/assets/docs/v1-docs-full.md +2892 -388
- package/assets/docs/v2-docs-full.md +639 -67
- package/assets/docs/website-links.md +4 -3
- package/manifest.json +1 -1
- package/package.json +1 -1
- package/server/index.js +1 -1
|
@@ -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
|
|
105
|
-
- [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
|
-
-
|
|
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
|
-
-
|
|
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\":[{\"
|
|
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\":{\"
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
4201
|
+
- tax\_free?: number
|
|
3974
4202
|
|
|
3975
|
-
|
|
4203
|
+
**면세금액**
|
|
3976
4204
|
|
|
3977
|
-
|
|
4205
|
+
- vbank\_due?: string
|
|
3978
4206
|
|
|
3979
|
-
|
|
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
|
-
-
|
|
4217
|
+
- custom\_data?: object
|
|
3994
4218
|
|
|
3995
|
-
|
|
4219
|
+
**가맹점 커스텀 데이터**
|
|
3996
4220
|
|
|
3997
|
-
|
|
4221
|
+
- bypass?: object
|
|
3998
4222
|
|
|
3999
|
-
|
|
4223
|
+
**키움페이 전용 파라미터**
|
|
4000
4224
|
|
|
4001
|
-
|
|
4225
|
+
- daou?: object
|
|
4002
4226
|
|
|
4003
|
-
|
|
4227
|
+
- PRODUCTCODE?: string
|
|
4004
4228
|
|
|
4005
|
-
|
|
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
|
-
|
|
4235
|
+
**현금영수증 발급 구분코드**
|
|
4037
4236
|
|
|
4038
|
-
|
|
4237
|
+
실시간 계좌이체, 가상계좌, 카카오페이 거래 시 키움페이에서 현금영수증 자동발급 여부 구분코드
|
|
4039
4238
|
|
|
4040
|
-
|
|
4239
|
+
- 실시간 계좌이체, 가상계좌인 경우
|
|
4240
|
+
- `1`: 허용
|
|
4241
|
+
- `0`: 차단
|
|
4041
4242
|
|
|
4042
|
-
-
|
|
4243
|
+
- 카카오페이인 경우
|
|
4244
|
+
- `Y`: 허용
|
|
4245
|
+
- `N`: 차단
|
|
4043
4246
|
|
|
4044
|
-
|
|
4247
|
+
- DIRECT\_YN?: string
|
|
4045
4248
|
|
|
4046
|
-
|
|
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
|
-
-
|
|
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
|
-
|
|
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
|
-
|
|
4659
|
-
|
|
4660
|
-
-
|
|
4661
|
-
-
|
|
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
|
-
"
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
5448
|
-
|
|
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
|
-
-
|
|
5614
|
-
|
|
5615
|
-
**카드 결제 시 파라미터**
|
|
5616
|
-
|
|
5617
|
-
- display?: object
|
|
5975
|
+
- display?: object
|
|
5618
5976
|
|
|
5619
|
-
|
|
5977
|
+
- card\_quota?: number\[]
|
|
5620
5978
|
|
|
5621
|
-
|
|
5979
|
+
**카드 할부 개월수 리스트**
|
|
5622
5980
|
|
|
5623
|
-
|
|
5981
|
+
이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
|
|
5624
5982
|
|
|
5625
|
-
|
|
5626
|
-
|
|
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
|
-
|
|
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
|
-
|
|
5704
|
-
|
|
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
|
-
-
|
|
6157
|
+
- customer\_id: string
|
|
6158
|
+
|
|
6159
|
+
**구매자 ID**
|
|
6160
|
+
|
|
6161
|
+
CBT 유형이 SBPS인 경우 필수 입력이며 최대 30자로 설정해야합니다.
|
|
6162
|
+
|
|
6163
|
+
- display?: object
|
|
6164
|
+
|
|
6165
|
+
- card\_quota?: number\[]
|
|
5786
6166
|
|
|
5787
|
-
|
|
6167
|
+
**카드 할부 개월수 리스트**
|
|
6168
|
+
|
|
6169
|
+
이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
|
|
5788
6170
|
|
|
5789
|
-
-
|
|
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
|
-
|
|
6177
|
+
**모바일 결제 후 리디렉션 될 URL**
|
|
6178
|
+
|
|
6179
|
+
- notice\_url?: string | string\[]
|
|
5794
6180
|
|
|
5795
|
-
|
|
5796
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
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
|
|
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
|
|
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
|
|
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
|
-
-
|
|
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:
|
|
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는 `
|
|
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:
|
|
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
|
-
- 삼성페이(
|
|
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
|
-
|
|
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: "
|
|
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
|
|
11295
|
-
|
|
11296
|
-
결제 수단 등록, PIN 체크시 `noAuth:true` 파라미터를 추가하여 요청한 경우 무인증 등록이 가능합니다.
|
|
11297
|
-
등록 이후 결제 요청하는 경우 무인증 결제를 이용할 수 있습니다. 무인증 결제시 PIN 입력 과정이 생략되며,
|
|
11298
|
-
바로 결제가 진행됩니다.
|
|
11299
|
-
|
|
11300
|
-
만약 무인증 등록과정 없이 무인증 결제가 요청되는 경우 PIN 입력 화면이 표시되고, 올바른 PIN 입력시 무인증 등록 및 결제가 진행됩니다.
|
|
12321
|
+
<summary>선불머니 기능 이용 시 선불머니 거래사전 등록 API 선행 필요</summary>
|
|
11301
12322
|
|
|
11302
|
-
|
|
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
|
-
|
|
12326
|
+
**대상 기능 목록:**
|
|
11305
12327
|
|
|
11306
|
-
|
|
12328
|
+
- `SignUp`: 간편결제+선불머니 서비스 유저 등록
|
|
12329
|
+
- `Leave`: 간편결제+선불머니 서비스 해지
|
|
12330
|
+
- `PrepaidRefundAccount`: 선불머니 환급계좌 등록 및 변경
|
|
12331
|
+
- `PrepaidRefund`: 선불머니 환급 요청
|
|
12332
|
+
- `PrepaidLimitRaise`: 선불머니 보유한도 상향 요청
|
|
12333
|
+
- `PrepaidKYC`: 선불머니 고객 확인 재이행
|
|
11307
12334
|
|
|
11308
|
-
선불머니
|
|
12335
|
+
거래사전 등록 API를 호출하지 않은 상태에서 선불머니 기능을 요청하는 경우 에러가 발생할 수 있으니 유의하시기 바랍니다.
|
|
11309
12336
|
|
|
11310
|
-
|
|
12337
|
+
</details>
|
|
11311
12338
|
|
|
11312
|
-
|
|
12339
|
+
<details>
|
|
11313
12340
|
|
|
11314
|
-
<
|
|
12341
|
+
<summary>무인증 결제 안내</summary>
|
|
11315
12342
|
|
|
11316
|
-
|
|
12343
|
+
결제 수단 등록, PIN 체크시 `noAuth:true` 파라미터를 추가하여 요청한 경우 무인증 등록이 가능합니다.
|
|
12344
|
+
등록 이후 결제 요청하는 경우 무인증 결제를 이용할 수 있습니다. 무인증 결제시 PIN 입력 과정이 생략되며,
|
|
12345
|
+
바로 결제가 진행됩니다.
|
|
11317
12346
|
|
|
11318
|
-
|
|
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
|
|
12023
|
-
|
|
|
12024
|
-
|use\_card\_point
|
|
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
|
-
"
|
|
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
|
-
**가상계좌
|
|
13983
|
+
**가상계좌 입금기한**
|
|
12767
13984
|
|
|
12768
|
-
(신) 나이스정보통신의 경우 필수
|
|
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(미국 달러)
|
|
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`:
|
|
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
|
-
-
|
|
14868
|
+
- buyer\_addr?: string
|
|
13367
14869
|
|
|
13368
|
-
|
|
14870
|
+
**구매자 주소**
|
|
13369
14871
|
|
|
13370
|
-
|
|
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 를 이용하여
|
|
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
|
|
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
|
|
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
|
-
|
|
14271
|
-
|
|
14272
|
-
|
|
14273
|
-
|
|
14274
|
-
|
|
14275
|
-
|
|
14276
|
-
|
|
14277
|
-
|
|
14278
|
-
|
|
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", //
|
|
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", //
|
|
14546
|
-
value: "2023-10-10T23:59:59+09:00", //
|
|
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
|
-
-
|
|
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
|
-
-
|
|
16878
|
+
- settle?: object
|
|
15012
16879
|
|
|
15013
|
-
|
|
16880
|
+
- custCi?: string
|
|
15014
16881
|
|
|
15015
|
-
|
|
16882
|
+
**주문자 CI**
|
|
15016
16883
|
|
|
15017
|
-
|
|
15018
|
-
암호화 키(key)는 포트원 관리자콘솔 채널 등록 시 "암호화 키" 항목에 입력한 값을 사용합니다.
|
|
16884
|
+
고객사가 보유한 회원 CI를 설정하면 내통장 결제에 등록한 CI와 비교하여 동일인인지 자동검증되며 일치하지 않은 경우 결제가 중단됩니다.
|
|
15019
16885
|
|
|
15020
|
-
|
|
15021
|
-
INPUT: ci (string), key (string)
|
|
15022
|
-
OUTPUT: custCI (string)
|
|
16886
|
+
<div class="hint" data-style="warning">
|
|
15023
16887
|
|
|
15024
|
-
|
|
15025
|
-
|
|
15026
|
-
binaryData ← AES256ECB(key, ci)
|
|
16888
|
+
본인인증 후 전달받은 CI 값을 AES-256-ECB 방식을 사용해 암호화하여 16진수로 인코딩한 결과를 입력해야합니다.
|
|
16889
|
+
암호화 키(key)는 포트원 관리자콘솔 채널 등록 시 "암호화 키" 항목에 입력한 값을 사용합니다.
|
|
15027
16890
|
|
|
15028
|
-
|
|
15029
|
-
|
|
16891
|
+
```pseudo
|
|
16892
|
+
INPUT: ci (string), key (string)
|
|
16893
|
+
OUTPUT: custCI (string)
|
|
15030
16894
|
|
|
15031
|
-
|
|
15032
|
-
|
|
15033
|
-
|
|
15034
|
-
```
|
|
16895
|
+
BEGIN
|
|
16896
|
+
# Step 1: CI 데이터를 AES-256-ECB 방식으로 암호화
|
|
16897
|
+
binaryData ← AES256ECB(key, ci)
|
|
15035
16898
|
|
|
15036
|
-
|
|
16899
|
+
# Step 2: 암호화된 데이터를 16진수 문자열로 변환
|
|
16900
|
+
custCI ← ConvertToHex(binaryData)
|
|
15037
16901
|
|
|
15038
|
-
|
|
15039
|
-
|
|
16902
|
+
# Step 3: 결과 반환
|
|
16903
|
+
RETURN custCI
|
|
16904
|
+
END
|
|
16905
|
+
```
|
|
15040
16906
|
|
|
15041
|
-
|
|
16907
|
+
</div>
|
|
16908
|
+
|
|
16909
|
+
- addDeductionYn?: string
|
|
16910
|
+
|
|
16911
|
+
**추가공제구분**
|
|
15042
16912
|
|
|
15043
|
-
|
|
16913
|
+
대중교통: Y, 도서 및 공연비: C, 추가공제없음: N
|
|
15044
16914
|
|
|
15045
|
-
|
|
16915
|
+
계약 후 사용 가능합니다.
|
|
15046
16916
|
|
|
15047
|
-
|
|
16917
|
+
- criPsblYn?: string
|
|
15048
16918
|
|
|
15049
|
-
|
|
16919
|
+
**현금영수증 발행가능 여부**
|
|
15050
16920
|
|
|
15051
|
-
|
|
16921
|
+
Y or N or "", 빈문자열은 Y로 인식
|
|
15052
16922
|
|
|
15053
|
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
17055
|
+
- settle?: object
|
|
15152
17056
|
|
|
15153
|
-
|
|
17057
|
+
- custCi?: string
|
|
15154
17058
|
|
|
15155
|
-
|
|
17059
|
+
**주문자 CI**
|
|
15156
17060
|
|
|
15157
|
-
|
|
15158
|
-
암호화 키(key)는 포트원 관리자콘솔 채널 등록 시 "암호화 키" 항목에 입력한 값을 사용합니다.
|
|
17061
|
+
고객사가 보유한 회원 CI를 설정하면 내통장 결제에 등록한 CI와 비교하여 동일인인지 자동검증되며 일치하지 않은 경우 결제가 중단됩니다.
|
|
15159
17062
|
|
|
15160
|
-
|
|
15161
|
-
INPUT: ci (string), key (string)
|
|
15162
|
-
OUTPUT: custCI (string)
|
|
17063
|
+
<div class="hint" data-style="warning">
|
|
15163
17064
|
|
|
15164
|
-
|
|
15165
|
-
|
|
15166
|
-
binaryData ← AES256ECB(key, ci)
|
|
17065
|
+
본인인증 후 전달받은 CI 값을 AES-256-ECB 방식을 사용해 암호화하여 16진수로 인코딩한 결과를 입력해야합니다.
|
|
17066
|
+
암호화 키(key)는 포트원 관리자콘솔 채널 등록 시 "암호화 키" 항목에 입력한 값을 사용합니다.
|
|
15167
17067
|
|
|
15168
|
-
|
|
15169
|
-
|
|
17068
|
+
```pseudo
|
|
17069
|
+
INPUT: ci (string), key (string)
|
|
17070
|
+
OUTPUT: custCI (string)
|
|
15170
17071
|
|
|
15171
|
-
|
|
15172
|
-
|
|
15173
|
-
|
|
15174
|
-
```
|
|
17072
|
+
BEGIN
|
|
17073
|
+
# Step 1: CI 데이터를 AES-256-ECB 방식으로 암호화
|
|
17074
|
+
binaryData ← AES256ECB(key, ci)
|
|
15175
17075
|
|
|
15176
|
-
|
|
17076
|
+
# Step 2: 암호화된 데이터를 16진수 문자열로 변환
|
|
17077
|
+
custCI ← ConvertToHex(binaryData)
|
|
15177
17078
|
|
|
15178
|
-
|
|
15179
|
-
|
|
17079
|
+
# Step 3: 결과 반환
|
|
17080
|
+
RETURN custCI
|
|
17081
|
+
END
|
|
17082
|
+
```
|
|
17083
|
+
|
|
17084
|
+
</div>
|
|
15180
17085
|
|
|
15181
|
-
|
|
17086
|
+
- addDeductionYn?: string
|
|
15182
17087
|
|
|
15183
|
-
|
|
17088
|
+
**추가공제구분**
|
|
15184
17089
|
|
|
15185
|
-
|
|
17090
|
+
대중교통: Y, 도서 및 공연비: C, 추가공제없음: N
|
|
15186
17091
|
|
|
15187
|
-
|
|
17092
|
+
계약 후 사용 가능합니다.
|
|
15188
17093
|
|
|
15189
|
-
|
|
17094
|
+
- criPsblYn?: string
|
|
15190
17095
|
|
|
15191
|
-
|
|
17096
|
+
**현금영수증 발행가능 여부**
|
|
15192
17097
|
|
|
15193
|
-
|
|
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
|
-
-
|
|
18749
|
+
- buyer\_addr?: string
|
|
16569
18750
|
|
|
16570
|
-
|
|
18751
|
+
**구매자 주소**
|
|
16571
18752
|
|
|
16572
|
-
|
|
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"
|
|
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
|
-
|
|
16763
|
-
|
|
16764
|
-
|
|
16765
|
-
|
|
16766
|
-
|
|
16767
|
-
|
|
16768
|
-
|
|
16769
|
-
|
|
16770
|
-
|
|
16771
|
-
|
|
16772
|
-
|
|
16773
|
-
|
|
16774
|
-
|
|
16775
|
-
|
|
16776
|
-
|
|
16777
|
-
|
|
16778
|
-
|
|
16779
|
-
|
|
16780
|
-
|
|
16781
|
-
|
|
16782
|
-
|
|
16783
|
-
|
|
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
|
-
-
|
|
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
|
|
20679
|
+
- isCulturalExpense?: boolean
|
|
18376
20680
|
|
|
18377
20681
|
**도서 문화비 결제 여부**
|
|
18378
20682
|
|
|
@@ -18526,7 +20830,7 @@ IMP.request_pay(
|
|
|
18526
20830
|
|
|
18527
20831
|
아래 파라미터는 브랜드페이 위젯에서는 사용할 수 없습니다.
|
|
18528
20832
|
|
|
18529
|
-
- **`display.
|
|
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
|
-
-
|
|
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
|
-
|
|
19129
|
-
|
|
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
|
-
-
|
|
21651
|
+
- tosspay\_v2?: object
|
|
21652
|
+
|
|
21653
|
+
**(신) 토스페이 전용 파라미터**
|
|
19197
21654
|
|
|
19198
|
-
|
|
21655
|
+
- expiredTime?: string
|
|
19199
21656
|
|
|
19200
|
-
|
|
21657
|
+
**결제 만료 기한**
|
|
19201
21658
|
|
|
19202
|
-
|
|
21659
|
+
`yyyy-MM-dd HH:mm:ss` 의 형식입니다.
|
|
19203
21660
|
|
|
19204
|
-
|
|
21661
|
+
입력하지 않을 경우, 기본값인 15분으로 설정됩니다. 최대 60분까지 설정할 수 있습니다.
|
|
19205
21662
|
|
|
19206
|
-
|
|
21663
|
+
- cashReceiptTradeOption?: string
|
|
19207
21664
|
|
|
19208
|
-
|
|
21665
|
+
**현금영수증 발급 대상 타입**
|
|
19209
21666
|
|
|
19210
|
-
|
|
19211
|
-
|
|
19212
|
-
|
|
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
|
-
|
|
21805
|
+
cash_receipt_type: "person", // 현금영수증 발급 타입
|
|
19337
21806
|
bypass: {
|
|
19338
21807
|
tosspay_v2: {
|
|
19339
|
-
|
|
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
|
-
-
|
|
21837
|
+
- sendFailPush?: boolean
|
|
19362
21838
|
|
|
19363
21839
|
**결제실패 푸시알람 사용 여부**
|
|
19364
21840
|
|
|
@@ -19455,7 +21931,7 @@ IMP.request_pay(
|
|
|
19455
21931
|
|
|
19456
21932
|
**결제수단 구분코드**
|
|
19457
21933
|
|
|
19458
|
-
|
|
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
|
-
|
|
|
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
|
-
|
|
|
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]
|
|
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
|
|
31484
|
+
<summary>KG파이낸셜</summary>
|
|
28949
31485
|
|
|
28950
|
-
포트원 콘솔에서 채널 추가 시 계약 완료 후
|
|
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
|
-
|
|
31817
|
+
5. 그룹명을 입력 후 그룹을 생성하고 생성된 그룹아이디를 확인합니다.
|
|
29288
31818
|
|
|
29289
|
-
|
|
29290
|
-
|
|
29291
|
-
9. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
|
|
29292
|
-
|
|
29293
|
-
10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
|
|
29294
|
-
|
|
29295
|
-
(이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
|
|
31819
|
+
(이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
|
|
29296
31820
|
|
|
29297
|
-
|
|
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
|
-
|
|
31843
|
+
(이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
|
|
29320
31844
|
|
|
29321
|
-
|
|
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
|
-
|
|
29407
|
-
|
|
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="
|
|
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="
|
|
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
|
|
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
|