@portone/mcp-server 0.14.0 → 0.15.0-alpha.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/README.md +4 -2
- package/assets/docs/_components/ko/docs-for-llms.md +21 -0
- package/assets/docs/_components/ko/llms-txt-support.md +15 -0
- package/assets/docs/_components/ko/using-mcp-server.md +60 -0
- package/assets/docs/api/rest-v1/_components/v1auth.md +103 -0
- package/assets/docs/help/admin-console/analytics/content32.md +4 -4
- package/assets/docs/help/admin-console/payment-service/content29.md +223 -110
- package/assets/docs/help/admin-console/pg-settlement/content30.md +103 -208
- package/assets/docs/help/admin-console/pg-settlement-history/content35.md +167 -0
- package/assets/docs/help/admin-console/platform-settlement/partner_settlement_service_guide.md +268 -0
- package/assets/docs/help/api-sdk-2025-05-14.md +71 -0
- package/assets/docs/help/applepay.md +1 -1
- package/assets/docs/help/content100002.md +1 -1
- package/assets/docs/help/content100029.md +1 -1
- package/assets/docs/help/content100060.md +2 -2
- package/assets/docs/help/content200015.md +1 -1
- package/assets/docs/help/content200019.md +1 -1
- package/assets/docs/help/content200023.md +2 -2
- package/assets/docs/help/content200050.md +1 -1
- package/assets/docs/help/core-service/channel-setting/danal.md +6 -8
- package/assets/docs/help/core-service/channel-setting/eximbay.md +9 -3
- package/assets/docs/help/core-service/channel-setting/kcp_channel.md +80 -13
- package/assets/docs/help/core-service/channel-setting/naverpay.md +6 -8
- package/assets/docs/help/core-service/channel-setting/nice.md +49 -47
- package/assets/docs/help/core-service/channel-setting/payletter.md +91 -0
- package/assets/docs/help/core-service/channel-setting/paymentwall.md +4 -1
- package/assets/docs/help/core-service/how-to-use/additional-nice.md +19 -19
- package/assets/docs/help/core-service/how-to-use/cancel-reversal.md +2 -2
- package/assets/docs/help/core-service/how-to-use/content200009.md +2 -2
- package/assets/docs/help/core-service/how-to-use/danal-contract.md +2 -2
- package/assets/docs/help/core-service/how-to-use/daou-contract.md +2 -2
- package/assets/docs/help/core-service/how-to-use/high-risk-industry.md +9 -9
- package/assets/docs/help/core-service/how-to-use/identity-verification-age-restriction.md +29 -0
- package/assets/docs/help/core-service/how-to-use/information-pg.md +4 -4
- package/assets/docs/help/core-service/how-to-use/ksnet-contract.md +1 -1
- package/assets/docs/help/core-service/how-to-use/nice-contract.md +15 -15
- package/assets/docs/help/core-service/how-to-use/open-immediately.md +1 -1
- package/assets/docs/help/core-service/how-to-use/point-service.md +7 -7
- package/assets/docs/help/core-service/how-to-use/settle-contract.md +2 -2
- package/assets/docs/help/core-service/how-to-use/shopify-available-list.md +4 -4
- package/assets/docs/help/core-service/how-to-use/test-mode-cancel.md +3 -3
- package/assets/docs/help/core-service/how-to-use/tosspayments-contract.md +4 -4
- package/assets/docs/help/core-service/payment-type/content200007.md +8 -7
- package/assets/docs/help/core-service/payment-type/content200036.md +17 -18
- package/assets/docs/help/core-service/payment-type/content200042.md +3 -3
- package/assets/docs/help/core-service/payment-type/content200052.md +2 -2
- package/assets/docs/help/core-service/payment-type/content200053.md +7 -3
- package/assets/docs/help/core-service/payment-type/hub-service-fee.md +19 -17
- package/assets/docs/help/core-service/payment-type/inicis-easypay-hub-fee.md +5 -6
- package/assets/docs/help/core-service/payment-type/inicis-international.md +10 -10
- package/assets/docs/help/core-service/payment-type/internationl-pg.md +7 -3
- package/assets/docs/help/core-service/payment-type/kcp-easypay-hub-apply.md +4 -5
- package/assets/docs/help/core-service/payment-type/kcp-international.md +2 -3
- package/assets/docs/help/core-service/payment-type/nice-easypay-hub-fee.md +8 -8
- package/assets/docs/help/core-service/payment-type/nice-international.md +14 -14
- package/assets/docs/help/core-service/payment-type/payletter-international.md +104 -0
- package/assets/docs/help/core-service/payment-type/schedule-requirement.md +2 -2
- package/assets/docs/help/core-service/payment-type/tosspayments-easypay-hub-fee.md +6 -6
- package/assets/docs/help/faq/general-inquiry/confirm-process.md +16 -16
- package/assets/docs/help/faq/general-inquiry/identity-verification-suspended-ip.md +35 -0
- package/assets/docs/help/faq/general-inquiry/kcp-business-number-error.md +29 -0
- package/assets/docs/help/faq/general-inquiry/platform-contract-method.md +4 -5
- package/assets/docs/help/faq/general-inquiry/platform-contract-pg.md +2 -2
- package/assets/docs/help/faq/general-inquiry/real-channel-info.md +1 -1
- package/assets/docs/help/faq/payment-faq/cash-receipt-guide.md +2 -2
- package/assets/docs/help/faq/payment-faq/kcp-cash-receipt.md +34 -0
- package/assets/docs/help/faq/payment-faq/payment-failure-danal-insufficient-funds.md +29 -0
- package/assets/docs/help/faq/payment-faq/payment-failure-kcp-insufficient-funds.md +35 -0
- package/assets/docs/help/faq/payment-faq/payment-failure-kiwoompay-insufficient-funds.md +25 -0
- package/assets/docs/help/faq/payment-faq/payment-failure-nice-insufficient-funds.md +28 -0
- 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 +10 -10
- package/assets/docs/help/faq/payment-faq/wordpress-woocommerce-taxation.md +67 -0
- package/assets/docs/help/faq/platform-faq/platform_additional_fee_setting.md +28 -0
- package/assets/docs/help/faq/platform-faq/platform_api_docs.md +24 -0
- package/assets/docs/help/faq/platform-faq/platform_definition_partner.md +34 -0
- package/assets/docs/help/faq/platform-faq/platform_definition_payout_agency.md +23 -0
- package/assets/docs/help/faq/platform-faq/platform_definition_platform.md +17 -0
- package/assets/docs/help/faq/platform-faq/platform_definition_settlement.md +29 -0
- package/assets/docs/help/faq/platform-faq/platform_difference_settlement_payout.md +29 -0
- package/assets/docs/help/faq/platform-faq/platform_ecommerce_discount_policy.md +19 -0
- package/assets/docs/help/faq/platform-faq/platform_introduction.md +15 -0
- package/assets/docs/help/faq/platform-faq/platform_introduction_conditions.md +16 -0
- package/assets/docs/help/faq/platform-faq/platform_nocode_guide.md +5 -5
- package/assets/docs/help/faq/platform-faq/platform_nocode_hosting.md +20 -0
- package/assets/docs/help/faq/platform-faq/platform_nocode_use.md +28 -0
- package/assets/docs/help/faq/platform-faq/platform_partner_bulk_registration.md +31 -0
- package/assets/docs/help/faq/platform-faq/platform_partner_info_guide.md +49 -0
- package/assets/docs/help/faq/platform-faq/platform_partner_management_tags.md +14 -0
- package/assets/docs/help/faq/platform-faq/platform_partner_tax_type.md +18 -0
- package/assets/docs/help/faq/platform-faq/platform_partnerships.md +16 -0
- package/assets/docs/help/faq/platform-faq/platform_payment_formula_setting.md +20 -0
- package/assets/docs/help/faq/platform-faq/platform_paymentdetails_definition.md +11 -0
- package/assets/docs/help/faq/platform-faq/platform_paymentdetails_view_features.md +18 -0
- package/assets/docs/help/faq/platform-faq/platform_payoutagency_realtime_payment.md +22 -0
- package/assets/docs/help/faq/platform-faq/platform_payoutagency_safety_legality.md +22 -0
- package/assets/docs/help/faq/platform-faq/platform_payoutagency_scheduled_payment.md +18 -0
- package/assets/docs/help/faq/platform-faq/platform_pg_fee_handling.md +18 -0
- package/assets/docs/help/faq/platform-faq/platform_policymanagement_calculator.md +1 -1
- package/assets/docs/help/faq/platform-faq/platform_privacypolicy_creation_guide.md +24 -0
- package/assets/docs/help/faq/platform-faq/platform_privacypolicy_definition.md +19 -0
- package/assets/docs/help/faq/platform-faq/platform_privacypolicy_service_compliance.md +28 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_auto_calculation_setting.md +39 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_cancellation_data.md +21 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_custom_attributes.md +18 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_custom_formula_request.md +20 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_cycle_setting.md +42 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_decimal_rounding.md +23 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_hold_date_setting.md +35 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_holidays.md +9 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_manual_registration.md +32 -0
- package/assets/docs/help/faq/platform-faq/platform_settlementdetails_view_features.md +26 -0
- package/assets/docs/help/faq/platform-faq/platform_settlmentandpayout_guide.md +4 -4
- package/assets/docs/help/faq/platform-faq/platform_supported_bank_codes.md +85 -0
- package/assets/docs/help/faq/platform-faq/platform_supported_currencies.md +33 -0
- package/assets/docs/help/faq/platform-faq/platform_tax_calculation.md +17 -0
- package/assets/docs/help/faq/platform-faq/platform_tax_setting_guide.md +1 -1
- package/assets/docs/help/faq/platform-faq/platform_tax_withholding_tax_definition.md +14 -0
- package/assets/docs/help/faq/platform-faq/platform_virtual_account_withdrawal.md +16 -0
- package/assets/docs/help/faq/platform-faq/platform_webhook_definition.md +24 -0
- package/assets/docs/help/faq/platform-faq/recommended_withdrawal.md +16 -0
- package/assets/docs/help/faq/platform-faq/system_test_environment.md +13 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_bulk_issuance.md +25 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_cancel.md +12 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_delayed.md +18 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_forward_issuance.md +23 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_guide_atoz.md +202 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_partner_peristalsis.md +60 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_buyer_process.md +52 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_definition.md +46 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_partner_signup.md +23 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_supplier_process.md +47 -0
- package/assets/docs/help/notice-payletter-2025-10-21.md +29 -0
- package/assets/docs/help/notice-payletter-2025-10-24.md +46 -0
- package/assets/docs/help/platform-2025-07-02.md +73 -0
- package/assets/docs/help/platform-2025-07-07.md +56 -0
- package/assets/docs/help/pricing/pg/domestic-and-oversea-fees.md +2 -2
- package/assets/docs/help/procedure/payment-integration/test-integration.md +2 -2
- package/assets/docs/help/procedure/pg-application/content59.md +1 -1
- package/assets/docs/help/procedure/pg-application/start.md +1 -1
- package/assets/docs/help/procedure/recommendation/package.md +5 -5
- package/assets/docs/help/service/identity-verification/identity-verification.md +6 -6
- package/assets/docs/help/service/paymethod/paymethod.md +2 -2
- package/assets/docs/help/service/pg/pg-service-list.md +25 -13
- package/assets/docs/help/service/version/portone-version.md +1 -1
- package/assets/docs/opi/ko/console/guide/billing-payments.md +1 -1
- package/assets/docs/opi/ko/console/guide/reg.md +1 -1
- package/assets/docs/opi/ko/console/guide/smartrouting.md +0 -2
- package/assets/docs/opi/ko/console/pg.md +7 -7
- package/assets/docs/opi/ko/etc/recon.md +1 -1
- package/assets/docs/opi/ko/extra/confirm-process/readme-v1.md +2 -2
- package/assets/docs/opi/ko/extra/confirm-process/readme-v2.md +11 -4
- package/assets/docs/opi/ko/extra/identity-verification/readme-v2.md +2 -2
- package/assets/docs/opi/ko/extra/identity-verification/v1/all/3.md +3 -3
- package/assets/docs/opi/ko/extra/identity-verification/v1/all/readme.md +1 -1
- package/assets/docs/opi/ko/extra/identity-verification/v1/credit-auth/4.md +3 -3
- package/assets/docs/opi/ko/extra/identity-verification/v1/phone/4.md +3 -3
- package/assets/docs/opi/ko/extra/manual-confirm/readme-v2.md +74 -0
- package/assets/docs/opi/ko/extra/plugins/wordpress/button.md +1 -1
- package/assets/docs/opi/ko/extra/plugins/wordpress/edd.md +1 -1
- package/assets/docs/opi/ko/extra/plugins/wordpress/woocommerce/subscription.md +1 -1
- package/assets/docs/opi/ko/extra/promotion/intro.md +1 -1
- package/assets/docs/opi/ko/extra/smart-routing/console-guide.md +1 -1
- package/assets/docs/opi/ko/extra/smart-routing/integration.md +2 -2
- package/assets/docs/opi/ko/extra/smart-routing/intro.md +9 -9
- package/assets/docs/opi/ko/integration/pg/v1/danal.md +5 -0
- package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +9 -0
- package/assets/docs/opi/ko/integration/pg/v1/daou/undefined.md +8 -0
- package/assets/docs/opi/ko/integration/pg/v1/eximbay.md +0 -14
- package/assets/docs/opi/ko/integration/pg/v1/inicis.md +58 -0
- package/assets/docs/opi/ko/integration/pg/v1/kakaopay.md +12 -1
- package/assets/docs/opi/ko/integration/pg/v1/kicc.md +3 -1
- package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/kcp-quickpay.md +710 -0
- package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/readme.md +661 -0
- package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp.md +10 -71
- package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md +11 -11
- package/assets/docs/opi/ko/integration/pg/v1/nice-v2/payment-caution.md +16 -16
- package/assets/docs/opi/ko/integration/pg/v1/nice-v2/readme.md +10 -8
- package/assets/docs/opi/ko/integration/pg/v1/nice.md +6 -6
- package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md +86 -0
- package/assets/docs/opi/ko/integration/pg/v1/paypal.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/readme.md +5 -3
- package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md +80 -0
- package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md +10 -9
- package/assets/docs/opi/ko/integration/pg/v1/welcome/readme.md +10 -7
- package/assets/docs/opi/ko/integration/pg/v2/eximbay-v2.md +138 -22
- package/assets/docs/opi/ko/integration/pg/v2/inicis-unified-identity-verification.md +0 -1
- package/assets/docs/opi/ko/integration/pg/v2/inicis-v2.md +13 -1
- package/assets/docs/opi/ko/integration/pg/v2/kcp-v2.md +4 -2
- package/assets/docs/opi/ko/integration/pg/v2/naverpay.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v2/nice-v2.md +40 -40
- package/assets/docs/opi/ko/integration/pg/v2/payletter-global.md +9 -2
- package/assets/docs/opi/ko/integration/pg/v2/paypal-v2.md +13 -12
- package/assets/docs/opi/ko/integration/pg/v2/readme.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v2/smartro-v2.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v2/welcome.md +8 -7
- package/assets/docs/opi/ko/integration/ready/_components/integration-guide/hyphen.md +27 -0
- package/assets/docs/opi/ko/integration/ready/_components/integration-guide/inicis.md +64 -0
- package/assets/docs/opi/ko/integration/ready/_components/integration-guide/kcp-v2.md +70 -0
- package/assets/docs/opi/ko/integration/ready/_components/integration-guide/paypal-v2.md +25 -0
- package/assets/docs/opi/ko/integration/ready/_components/integration-guide/tosspayments.md +15 -0
- package/assets/docs/opi/ko/integration/ready/readme.md +26 -10
- package/assets/docs/opi/ko/integration/start/_components/sdk-installation.md +71 -0
- package/assets/docs/opi/ko/integration/start/v1/non-auth.md +2 -4
- package/assets/docs/opi/ko/integration/start/v2/billing/issue.md +1 -1
- package/assets/docs/opi/ko/integration/start/v2/checkout.md +4 -2
- package/assets/docs/opi/ko/integration/start/v2/readme.md +2 -2
- package/assets/docs/opi/ko/integration/using-ai-tools.md +33 -57
- package/assets/docs/opi/ko/integration/virtual-account/readme.md +9 -9
- package/assets/docs/opi/ko/integration/webhook/readme-v1.md +2 -4
- package/assets/docs/opi/ko/integration/webhook/readme-v2.md +1 -3
- package/assets/docs/opi/ko/quick-guide/payment.md +16 -16
- package/assets/docs/opi/ko/support/code-info/pg-1.md +1 -1
- package/assets/docs/opi/ko/support/code-info/pg-2.md +2 -2
- package/assets/docs/opi/ko/support/code-info/pg.md +2 -2
- package/assets/docs/opi/ko/support/contact.md +1 -13
- package/assets/docs/opi/ko/support/pg-terms.md +233 -0
- package/assets/docs/platform/ko/guides/dictionary.md +136 -16
- package/assets/docs/platform/ko/guides/process.md +1 -1
- package/assets/docs/platform/ko/guides/webhook.md +1 -1
- package/assets/docs/platform/ko/using-ai-tools.md +33 -57
- package/assets/docs/release-notes/api-sdk/2023-07-10.md +7 -7
- package/assets/docs/release-notes/api-sdk/2023-07-31.md +1 -1
- package/assets/docs/release-notes/api-sdk/2023-08-31.md +2 -2
- package/assets/docs/release-notes/api-sdk/2024-01-08.md +4 -4
- package/assets/docs/release-notes/api-sdk/2024-06-03.md +1 -1
- package/assets/docs/release-notes/api-sdk/2024-09-05.md +0 -1
- package/assets/docs/release-notes/api-sdk/2024-09-27.md +1 -1
- package/assets/docs/release-notes/console/2025-10-17.md +47 -0
- package/assets/docs/release-notes/platform/2025-03-17.md +1 -1
- package/assets/docs/release-notes/platform/2025-07-07.md +1 -1
- package/assets/docs/release-notes/platform/2025-07-23.md +85 -0
- package/assets/docs/release-notes/platform/2025-08-13.md +95 -0
- package/assets/docs/release-notes/platform/2025-08-21.md +53 -0
- package/assets/docs/release-notes/platform/2025-08-28.md +53 -0
- package/assets/docs/release-notes/platform/2025-10-02.md +152 -0
- package/assets/docs/schema/browser-sdk.yml +196 -69
- package/assets/docs/schema/v1.openapi.json +164 -217
- package/assets/docs/schema/v1.openapi.yml +148 -213
- package/assets/docs/schema/v2.openapi.json +18056 -11790
- package/assets/docs/schema/v2.openapi.yml +4801 -191
- package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrq.md +3 -3
- package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrt.md +3 -3
- package/assets/docs/sdk/ko/v2-sdk/_components/sdk-installation.md +71 -0
- package/assets/docs/sdk/ko/v2-server-sdk/jvm.md +12 -5
- package/assets/docs/sdk/ko/v2-server-sdk/python.md +12 -3
- package/assets/docs/v1-docs-full.md +2298 -1026
- package/assets/docs/v2-docs-full.md +1412 -362
- package/assets/docs/website-links.md +23 -13
- package/assets/instructions.md +4 -2
- package/manifest.json +1 -1
- package/package.json +17 -20
- package/server/index.js +135 -97
- package/assets/docs/help/admin-console/platform-settlement/content33-1.md +0 -201
- package/assets/docs/help/core-service/payment-type/schedule-logic-guide.md +0 -49
- package/assets/docs/help/faq/platform-faq/taxinvoice_guide.md +0 -107
- package/assets/docs/help/faq/platform-faq/taxinvoice_signupemail.md +0 -67
|
@@ -132,7 +132,7 @@ targetVersions:
|
|
|
132
132
|
|
|
133
133
|
<details>
|
|
134
134
|
|
|
135
|
-
<summary
|
|
135
|
+
<summary>나이스정보통신</summary>
|
|
136
136
|
|
|
137
137
|
<div class="hint" data-style="info">
|
|
138
138
|
|
|
@@ -140,16 +140,16 @@ targetVersions:
|
|
|
140
140
|
|
|
141
141
|
</div>
|
|
142
142
|
|
|
143
|
-
1. [
|
|
143
|
+
1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
|
|
144
144
|
2. \[가맹점정보]→\[KEY관리]를 클릭합니다.
|
|
145
145
|
3. MID 및 Key 값을 확인할 수 있습니다.
|
|
146
146
|
|
|
147
|
-
(이미지 첨부:
|
|
147
|
+
(이미지 첨부: 나이스정보통신 가맹점 관리자 내 KEY 조회 화면)
|
|
148
148
|
|
|
149
149
|
4. \[가맹점정보]→\[비밀번호관리]→\[거래취소비밀번호]를 클릭합니다.
|
|
150
150
|
5. 비밀번호를 설정합니다. 비밀번호는 최대 10자리까지 가능합니다.
|
|
151
151
|
|
|
152
|
-
(이미지 첨부:
|
|
152
|
+
(이미지 첨부: 나이스정보통신 가맹점 관리자 내 거래취소비밀번호 설정 화면)
|
|
153
153
|
|
|
154
154
|
6. 포트원 콘솔에서 채널 추가 시 \[MID], \[Key], \[결제취소 비밀번호]를 입력한 후 `저장`을 클릭합니다.
|
|
155
155
|
|
|
@@ -468,7 +468,17 @@ targetVersions:
|
|
|
468
468
|
|
|
469
469
|
<div class="tabs-content" data-title="통합 본인인증">
|
|
470
470
|
|
|
471
|
-
|
|
471
|
+
1. [KG이니시스 가맹점관리자](https://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
|
|
472
|
+
2. \[상점정보]→\[계약정보]→\[KEY 정보]를 클릭합니다.
|
|
473
|
+
3. \[부가서비스 연동 Key 정보]→\[통합인증 서비스] 항목에서 \[도메인 등록] 버튼을 클릭 후 아래 3개의 도메인을 등록합니다.
|
|
474
|
+
|
|
475
|
+
- 본인인증 서비스를 이용하는 고객사 서비스 도메인
|
|
476
|
+
- iamport.co
|
|
477
|
+
- iamport.kr
|
|
478
|
+
|
|
479
|
+
(이미지 첨부: KG이니시스 가맹점관리자 내 도메인 등록화면)
|
|
480
|
+
|
|
481
|
+
4. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
|
|
472
482
|
|
|
473
483
|
</div>
|
|
474
484
|
|
|
@@ -564,7 +574,17 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
|
|
|
564
574
|
|
|
565
575
|
<div class="tabs-content" data-title="통합 본인인증">
|
|
566
576
|
|
|
567
|
-
|
|
577
|
+
1. [KG이니시스 가맹점관리자](https://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
|
|
578
|
+
2. \[상점정보]→\[계약정보]→\[KEY 정보]를 클릭합니다.
|
|
579
|
+
3. \[부가서비스 연동 Key 정보]→\[통합인증 서비스] 항목에서 \[도메인 등록] 버튼을 클릭 후 아래 3개의 도메인을 등록합니다.
|
|
580
|
+
|
|
581
|
+
- 본인인증 서비스를 이용하는 고객사 서비스 도메인
|
|
582
|
+
- iamport.co
|
|
583
|
+
- iamport.kr
|
|
584
|
+
|
|
585
|
+
(이미지 첨부: KG이니시스 가맹점관리자 내 도메인 등록화면)
|
|
586
|
+
|
|
587
|
+
4. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
|
|
568
588
|
|
|
569
589
|
</div>
|
|
570
590
|
|
|
@@ -994,8 +1014,6 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
|
|
|
994
1014
|
|
|
995
1015
|
</details>
|
|
996
1016
|
|
|
997
|
-
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
|
|
998
|
-
|
|
999
1017
|
<details>
|
|
1000
1018
|
|
|
1001
1019
|
<summary>페이레터 해외결제</summary>
|
|
@@ -1005,8 +1023,6 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
|
|
|
1005
1023
|
|
|
1006
1024
|
</details>
|
|
1007
1025
|
|
|
1008
|
-
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
|
|
1009
|
-
|
|
1010
1026
|
## <span id="integration-identifiers">4. 포트원 연동정보 확인하기</span>
|
|
1011
1027
|
|
|
1012
1028
|
포트원을 이용한 결제 연동 시 필요한 연동정보를 확인합니다.
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: V2 JavaScript SDK 설치하기
|
|
3
|
+
description: 웹 브라우저에서 결제창 연동 시 사용되는 SDK 설치 방법을 안내합니다.
|
|
4
|
+
targetVersions:
|
|
5
|
+
- v2
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
포트원 V2 SDK는 npm 레지스트리와 CDN을 통해 배포되고 있습니다.
|
|
9
|
+
|
|
10
|
+
- npm, yarn 등 패키지 매니저를 사용한다면 의존
|
|
11
|
+
대상으로 [@portone/browser-sdk](http://www.npmjs.com/package/@portone/browser-sdk)를 추가하세요.
|
|
12
|
+
|
|
13
|
+
- 패키지 매니저를 사용하지 않는다면 `<script>` 요소를 이용하여 CDN에서 SDK를 직접 불러오세요.
|
|
14
|
+
|
|
15
|
+
- CDN에서 ESM 모듈 형태로도 SDK를 제공하고 있습니다.
|
|
16
|
+
|
|
17
|
+
<div class="tabs-container">
|
|
18
|
+
|
|
19
|
+
<div class="tabs-content" data-title="패키지 의존 대상으로 추가">
|
|
20
|
+
|
|
21
|
+
사용하는 패키지 매니저에 알맞은 명령어를 실행하세요.
|
|
22
|
+
|
|
23
|
+
```shell
|
|
24
|
+
npm i @portone/browser-sdk
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
```shell
|
|
28
|
+
yarn add @portone/browser-sdk
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
```shell
|
|
32
|
+
pnpm add @portone/browser-sdk
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
패키지 매니저로 SDK를 불러온 경우 `PortOne` 객체를 import해서 사용합니다.
|
|
36
|
+
|
|
37
|
+
```javascript
|
|
38
|
+
import * as PortOne from "@portone/browser-sdk/v2";
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
</div>
|
|
42
|
+
|
|
43
|
+
<div class="tabs-content" data-title="<script> 요소로 추가">
|
|
44
|
+
|
|
45
|
+
```html
|
|
46
|
+
<script src="https://cdn.portone.io/v2/browser-sdk.js"></script>
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
`<script>` 요소로 SDK를 불러온 경우 전역 객체 `window`에 `PortOne` 객체가 추가됩니다.
|
|
50
|
+
|
|
51
|
+
</div>
|
|
52
|
+
|
|
53
|
+
<div class="tabs-content" data-title="ESM 모듈로 추가">
|
|
54
|
+
|
|
55
|
+
ESM 모듈을 사용하는 경우 URL에서 `PortOne` 객체를 직접 import할 수 있습니다.
|
|
56
|
+
|
|
57
|
+
```javascript
|
|
58
|
+
import * as PortOne from "https://cdn.portone.io/v2/browser-sdk.esm.js";
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
</div>
|
|
62
|
+
|
|
63
|
+
</div>
|
|
64
|
+
|
|
65
|
+
<div class="hint" data-style="info">
|
|
66
|
+
|
|
67
|
+
**타입스크립트 지원**
|
|
68
|
+
|
|
69
|
+
포트원 V2 SDK는 타입스크립트 선언 파일(`.d.ts`)의 형식으로 타입 정보를 제공하고 있습니다. npm 레지스트리를 이용하는 경우 각종 개발 환경에서 별도 설정 없이 사용 가능합니다.
|
|
70
|
+
|
|
71
|
+
</div>
|
|
@@ -38,7 +38,7 @@ targetVersions:
|
|
|
38
38
|
- **지원 결제대행사**
|
|
39
39
|
- KG이니시스
|
|
40
40
|
- NHN KCP
|
|
41
|
-
-
|
|
41
|
+
- 나이스정보통신 (구모듈, 신모듈)
|
|
42
42
|
- 토스페이먼츠 (신모듈)
|
|
43
43
|
- 키움페이
|
|
44
44
|
- KSNET
|
|
@@ -106,7 +106,7 @@ const onetimeResponse = await fetch(
|
|
|
106
106
|
- **지원 결제대행사**
|
|
107
107
|
- KG이니시스
|
|
108
108
|
- NHN KCP
|
|
109
|
-
-
|
|
109
|
+
- 나이스정보통신 (구모듈, 신모듈)
|
|
110
110
|
- 토스페이먼츠 (신모듈)
|
|
111
111
|
- 키움페이
|
|
112
112
|
- KSNET
|
|
@@ -369,8 +369,6 @@ app.post("/iamport-callback/schedule", async (req, res) => {
|
|
|
369
369
|
포트원 서버에 결제 예약 요청을 하고 예약한 시간에 결제가 시도되면 지정된 웹훅 URL을 통해서
|
|
370
370
|
서버에 알리는 과정을 반복적으로 수행하여 반복 결제를 구현할 수 있습니다.
|
|
371
371
|
|
|
372
|
-
(관련 이미지 첨부)
|
|
373
|
-
|
|
374
372
|
예약된 결제가 시도되었을 때 발생하는 webhook 이벤트를 처리하는 로직에서 예약된 결제가 정상적으로 완료되고 결제 내역이 저장되면 다음 결제를 예약하는 예제입니다.
|
|
375
373
|
|
|
376
374
|
```ts title="server-side"
|
|
@@ -39,7 +39,7 @@ versionVariants:
|
|
|
39
39
|
브라우저에서 포트원 SDK를 호출하여 빌링키를 발급하고, 서버로 빌링키를 전달합니다.
|
|
40
40
|
|
|
41
41
|
```ts
|
|
42
|
-
const issueResponse = PortOne.requestIssueBillingKey({
|
|
42
|
+
const issueResponse = await PortOne.requestIssueBillingKey({
|
|
43
43
|
storeId: "store-9bf6076d-beef-4729-9521-ae66c14e0569",
|
|
44
44
|
channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d",
|
|
45
45
|
billingKeyMethod: "CARD",
|
|
@@ -158,7 +158,8 @@ async function requestPayment() {
|
|
|
158
158
|
}
|
|
159
159
|
```
|
|
160
160
|
|
|
161
|
-
결과값에 들어 있는 필드는 다음과 같습니다.
|
|
161
|
+
결과값에 들어 있는 주요 필드는 다음과 같습니다.
|
|
162
|
+
전체 필드 목록은 [requestPayment 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/payment-response)을 참조해 주시기 바랍니다.
|
|
162
163
|
|
|
163
164
|
|필드명 |설명 |비고 |
|
|
164
165
|
|---------|-------------------|----------------------------|
|
|
@@ -181,7 +182,8 @@ PortOne.requestPayment({
|
|
|
181
182
|
});
|
|
182
183
|
```
|
|
183
184
|
|
|
184
|
-
쿼리 문자열로 전달되는
|
|
185
|
+
쿼리 문자열로 전달되는 주요 필드는 다음과 같습니다.
|
|
186
|
+
전체 필드 목록은 [requestPayment 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/payment-response)을 참조해 주시기 바랍니다.
|
|
185
187
|
|
|
186
188
|
|키 |설명 |비고 |
|
|
187
189
|
|---------|-------------------|----------------------------|
|
|
@@ -78,7 +78,7 @@ V2는 모든 데이터를 수집하고 기록합니다. [Event Sourcing](https:/
|
|
|
78
78
|
|
|
79
79
|
### 기능 확장: 신속한 업데이트와 혁신
|
|
80
80
|
|
|
81
|
-
V2는 최신 결제 기능을 가장 빠르게 제공합니다.
|
|
81
|
+
V2는 최신 결제 기능을 가장 빠르게 제공합니다.
|
|
82
82
|
최신 기능을 통해 결제 프로세스를 혁신하고, 고객의 결제 경험을 향상시킬 수 있습니다.
|
|
83
83
|
|
|
84
84
|
## 사용 가능한 PG사
|
|
@@ -92,7 +92,7 @@ V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될
|
|
|
92
92
|
- **카카오페이**
|
|
93
93
|
- **네이버페이**
|
|
94
94
|
- **스마트로**
|
|
95
|
-
-
|
|
95
|
+
- **나이스정보통신**
|
|
96
96
|
- **페이팔**
|
|
97
97
|
- **KG이니시스**
|
|
98
98
|
- **한국결제네트웍스(KPN)**
|
|
@@ -13,78 +13,54 @@ targetVersions:
|
|
|
13
13
|
포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
|
|
14
14
|
AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
이외에도 포트원 콘솔에서 제공하는 기능 중 일부를 수행할 수 있습니다.
|
|
17
|
+
아래 기능을 AI에게 요청하면 MCP 서버가 브라우저를 열어 포트원 콘솔 로그인을 요청하며, 로그인 후 기능이 수행됩니다.
|
|
17
18
|
|
|
18
|
-
|
|
19
|
+
- 채널 목록 조회
|
|
20
|
+
- 테스트 채널 추가
|
|
21
|
+
- 하위 상점 조회
|
|
22
|
+
- 결제 내역 조회
|
|
19
23
|
|
|
20
|
-
|
|
24
|
+
### DXT를 이용한 설치
|
|
21
25
|
|
|
22
|
-
|
|
23
|
-
{
|
|
24
|
-
// ...
|
|
26
|
+
[DXT (Desktop Extensions)](https://github.com/anthropics/dxt)를 이용해 MCP 서버를 원클릭으로 설치할 수 있습니다.
|
|
25
27
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
+
1. [GitHub Releases](https://github.com/portone-io/mcp-server/releases)에서 최신 `portone-mcp-server.dxt` 파일을 다운로드합니다.
|
|
29
|
+
2. 지원하는 AI 도구(Claude Desktop 등)에서 다운로드한 `.dxt` 파일을 드래그 앤 드롭하거나 열기를 통해 설치합니다.
|
|
30
|
+
3. 설치 후 도구를 재시작하여 MCP 서버가 정상적으로 등록되었는지 확인합니다.
|
|
28
31
|
|
|
29
|
-
|
|
30
|
-
"command": "uvx",
|
|
31
|
-
"args": ["portone-mcp-server@latest"]
|
|
32
|
-
}
|
|
33
|
-
}
|
|
34
|
-
}
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
<div class="hint" data-style="info">
|
|
38
|
-
|
|
39
|
-
사용 환경에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야 합니다.
|
|
40
|
-
|
|
41
|
-
</div>
|
|
42
|
-
|
|
43
|
-
설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
|
|
44
|
-
|
|
45
|
-
#### 포트원 기능 사용하기
|
|
46
|
-
|
|
47
|
-
MCP 서버에 포트원 기능을 연동하면, AI가 아래와 같은 작업을 수행할 수 있습니다.
|
|
48
|
-
|
|
49
|
-
- 결제 내역 단건/다건 조회
|
|
50
|
-
- 본인인증 내역 단건/다건 조회
|
|
32
|
+
<div class="hint" data-style="warning">
|
|
51
33
|
|
|
52
|
-
|
|
34
|
+
**Claude Desktop에서 DXT 파일 사용 시 주의사항**
|
|
53
35
|
|
|
54
|
-
|
|
55
|
-
{
|
|
56
|
-
// ...
|
|
36
|
+
현재 [알려진 이슈](https://github.com/anthropics/dxt/issues/45)로 인해 Claude Desktop에서 DXT 설치 후 MCP 서버가 정상적으로 작동하지 않을 수 있습니다.
|
|
57
37
|
|
|
58
|
-
|
|
59
|
-
// ...
|
|
38
|
+
이 경우 Node.js 22.6.0 이상을 설치하고 Claude Desktop 설정에서 **"MCP용 내장 Node.js 사용"** 옵션을 비활성화한 후 재시작하면 정상적으로 작동합니다.
|
|
60
39
|
|
|
61
|
-
|
|
62
|
-
"command": "uvx",
|
|
63
|
-
"args": ["portone-mcp-server@latest"],
|
|
64
|
-
// 아래 env 블록을 추가하여 API 시크릿을 설정합니다.
|
|
65
|
-
"env": {
|
|
66
|
-
"API_SECRET": "<YOUR_PORTONE_API_SECRET>"
|
|
67
|
-
}
|
|
68
|
-
}
|
|
69
|
-
}
|
|
70
|
-
}
|
|
71
|
-
```
|
|
40
|
+
</div>
|
|
72
41
|
|
|
73
|
-
|
|
42
|
+
### MCP 서버 등록하기
|
|
74
43
|
|
|
75
|
-
|
|
44
|
+
1. Node.js 22.6.0 이상이 설치되어 있어야 합니다.
|
|
76
45
|
|
|
77
|
-
|
|
46
|
+
2. 사용하는 AI 도구의 MCP 설정에서 아래 내용을 추가합니다. (Cursor, Windsurf, Claude Desktop, etc...)
|
|
78
47
|
|
|
79
|
-
|
|
48
|
+
```jsonc
|
|
49
|
+
"mcpServers": {
|
|
80
50
|
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
**MCP 서버는 포트원의 공개된 API 기능만을 사용하며, 인증을 위해 사용자가 제공한 API 시크릿을 활용합니다.**
|
|
51
|
+
// 기존 설정
|
|
84
52
|
|
|
85
|
-
|
|
53
|
+
"portone-mcp-server": {
|
|
54
|
+
"command": "npx",
|
|
55
|
+
"args": [
|
|
56
|
+
"-y",
|
|
57
|
+
"@portone/mcp-server@latest"
|
|
58
|
+
]
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
```
|
|
86
62
|
|
|
87
|
-
|
|
63
|
+
3. 도구를 재시작해 portone-mcp-server 및 해당 서버가 제공하는 도구들이 잘 등록되었는지 확인합니다.
|
|
88
64
|
|
|
89
65
|
<div class="hint" data-style="warning">
|
|
90
66
|
|
|
@@ -95,7 +71,7 @@ MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않
|
|
|
95
71
|
|
|
96
72
|
</div>
|
|
97
73
|
|
|
98
|
-
###
|
|
74
|
+
### MCP 서버 활용하기
|
|
99
75
|
|
|
100
76
|
사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
|
|
101
77
|
|
|
@@ -21,8 +21,8 @@ targetVersions:
|
|
|
21
21
|
|키움페이 |daou |<ul><li>발행 통지 URL: [https://service.iamport.kr/daou\_payments/result](http://service.iamport.kr/daou_payments/result)</li> <li>결과 통지 URL: [https://service.iamport.kr/daou\_payments/notice\_vbank](http://service.iamport.kr/daou_payments/notice_vbank)</li></ul>|
|
|
22
22
|
|토스페이먼츠(신모듈) |tosspayments |[https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments](http://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments) |
|
|
23
23
|
|스마트로(신모듈) |smartro\_v2 |입금 통보, 환불이체 URL 동일: [https://tx-gateway-service.prod.iamport.co/smartro-v2](http://tx-gateway-service.prod.iamport.co/smartro-v2) |
|
|
24
|
-
|
|
25
|
-
|
|
24
|
+
|나이스정보통신(구모듈)|nice |[https://service.iamport.kr/nice\_payments/notice\_vbank](http://service.iamport.kr/nice_payments/notice_vbank) |
|
|
25
|
+
|나이스정보통신(신모듈)|nice\_v2 |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2) |
|
|
26
26
|
|웰컴페이먼츠 |welcome |[https://tx-gateway-service.prod.iamport.co/welcome](http://tx-gateway-service.prod.iamport.co/welcome) |
|
|
27
27
|
|
|
28
28
|
<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
|
|
@@ -33,7 +33,7 @@ targetVersions:
|
|
|
33
33
|
|----------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-|
|
|
34
34
|
|토스페이먼츠 |tosspayments |[https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments](http://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments)| |
|
|
35
35
|
|스마트로 |smartro\_v2 |입금 통보, 환불이체 URL 동일: [https://tx-gateway-service.prod.iamport.co/smartro-v2](http://tx-gateway-service.prod.iamport.co/smartro-v2) | |
|
|
36
|
-
|
|
36
|
+
|나이스정보통신 |nice\_v2 |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2) | |
|
|
37
37
|
|KG이니시스 |inicis\_v2 |[https://tx-gateway-service.prod.iamport.co/inicis-v2](http://tx-gateway-service.prod.iamport.co/inicis-v2) | |
|
|
38
38
|
|한국결제네트웍스|kpn |[https://tx-gateway-service.prod.iamport.co/kpn/virtual-account](http://tx-gateway-service.prod.iamport.co/kpn/virtual-account) | |
|
|
39
39
|
|NHN KCP |kcp\_v2 |[https://tx-gateway-service.prod.iamport.co/kcp-v2](http://tx-gateway-service.prod.iamport.co/kcp-v2) | |
|
|
@@ -74,9 +74,9 @@ targetVersions:
|
|
|
74
74
|
|
|
75
75
|
<details>
|
|
76
76
|
|
|
77
|
-
<summary
|
|
77
|
+
<summary>나이스정보통신(구모듈) 설정 방법</summary>
|
|
78
78
|
|
|
79
|
-
1. [
|
|
79
|
+
1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
|
|
80
80
|
2. \[가맹점정보]→\[기본정보]를 클릭합니다.
|
|
81
81
|
3. \[결제데이터통보] 항목에서 **가상계좌**의 \[URL/IP]를 `https://service.iamport.kr/nice_payments/notice_vbank` 로 설정해주세요.
|
|
82
82
|
4. \[재전송 간격]은 1분, \[재전송 횟수]는 3회로 설정해주세요.
|
|
@@ -86,7 +86,7 @@ targetVersions:
|
|
|
86
86
|
- 재전송 간격: 최소 1분 \~ 최대 10분까지만 입력 가능합니다.
|
|
87
87
|
- 재전송 횟수: 최소 1회 \~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
|
|
88
88
|
|
|
89
|
-
(이미지 첨부:
|
|
89
|
+
(이미지 첨부: 나이스정보통신 가맹점 관리자 내 입금통보 URL 설정 화면)
|
|
90
90
|
|
|
91
91
|
</details>
|
|
92
92
|
|
|
@@ -179,9 +179,9 @@ KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 U
|
|
|
179
179
|
|
|
180
180
|
<details>
|
|
181
181
|
|
|
182
|
-
<summary
|
|
182
|
+
<summary>나이스정보통신(신모듈) 설정 방법</summary>
|
|
183
183
|
|
|
184
|
-
1. [
|
|
184
|
+
1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
|
|
185
185
|
2. \[가맹점정보]→\[기본정보]를 클릭합니다.
|
|
186
186
|
3. \[결제데이터통보] 항목에서 **가상계좌**의 \[URL/IP]를 `https://tx-gateway-service.prod.iamport.co/nicepay-v2` 로 설정해주세요.
|
|
187
187
|
4. \[재전송 간격]은 1분, \[재전송 횟수]는 3회로 설정해주세요.
|
|
@@ -191,7 +191,7 @@ KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 U
|
|
|
191
191
|
- 재전송 간격: 최소 1분 \~ 최대 10분까지만 입력 가능합니다.
|
|
192
192
|
- 재전송 횟수: 최소 1회 \~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
|
|
193
193
|
|
|
194
|
-
(이미지 첨부:
|
|
194
|
+
(이미지 첨부: 나이스정보통신 가맹점 관리자 내 입금통보 URL 설정 화면 )
|
|
195
195
|
|
|
196
196
|
</details>
|
|
197
197
|
|
|
@@ -10,8 +10,6 @@ versionVariants:
|
|
|
10
10
|
v2: /opi/ko/integration/webhook/readme-v2
|
|
11
11
|
---
|
|
12
12
|
|
|
13
|
-
(관련 이미지 첨부)
|
|
14
|
-
|
|
15
13
|
## 웹훅(Webhook)이란?
|
|
16
14
|
|
|
17
15
|
특정 이벤트가 발생하였을 때 타 서비스나 응용프로그램으로 알림을 보내는 기능입니다.
|
|
@@ -216,7 +214,7 @@ app.post("/portone-webhook", async (req, res) => {
|
|
|
216
214
|
|
|
217
215
|
**웹훅 처리 전에 브라우저 결제 완료 처리가 진행되는 경우**
|
|
218
216
|
|
|
219
|
-
기본적으로 포트원 서버는 웹훅을 호출한 뒤 고객사 응답을 기다리지 않고 브라우저에 302 redirect 응답을 보내기 때문에 결과 도달에 대한 순서를 보장하지 않습니다. 다만 고객사 요청이 있을 경우 webhook 호출 이후에 브라우저에 302 redirect 또는 callback 응답을 보내어 순서를 보장해 드리고 있습니다. 웹훅 우선순위 설정 요청은 <support@portone.io> 로 고객사 식별코드를 기재하여 요청해 주시면 됩니다.
|
|
217
|
+
기본적으로 포트원 서버는 웹훅을 호출한 뒤 고객사 응답을 기다리지 않고 브라우저에 302 redirect 응답을 보내기 때문에 결과 도달에 대한 순서를 보장하지 않습니다. 다만 고객사 요청이 있을 경우 webhook 호출 이후에 브라우저에 302 redirect 또는 callback 응답을 보내어 순서를 보장해 드리고 있습니다. 웹훅 우선순위 설정 요청은 <tech.support@portone.io> 로 고객사 식별코드를 기재하여 요청해 주시면 됩니다.
|
|
220
218
|
|
|
221
219
|
</div>
|
|
222
220
|
|
|
@@ -224,7 +222,7 @@ app.post("/portone-webhook", async (req, res) => {
|
|
|
224
222
|
|
|
225
223
|
**웹훅 재 전송이 가능한가요?**
|
|
226
224
|
|
|
227
|
-
웹훅은 기본적으로 1회 전송되도록 설정되어 있습니다. 네트워크 에러가 발생하거나 고객사 응답(HTTP 상태 코드)이 500번대인 경우, 재발송 설정을 원하신다면 웹훅이 최대 5회까지 1분 간격으로 재시도될 수 있습니다. 웹훅 재발송 설정 요청은 <support@portone.io> 로 고객사 식별코드를 기재하여 요청해 주시면 됩니다.
|
|
225
|
+
웹훅은 기본적으로 1회 전송되도록 설정되어 있습니다. 네트워크 에러가 발생하거나 고객사 응답(HTTP 상태 코드)이 500번대인 경우, 재발송 설정을 원하신다면 웹훅이 최대 5회까지 1분 간격으로 재시도될 수 있습니다. 웹훅 재발송 설정 요청은 <tech.support@portone.io> 로 고객사 식별코드를 기재하여 요청해 주시면 됩니다.
|
|
228
226
|
|
|
229
227
|
</div>
|
|
230
228
|
|
|
@@ -7,8 +7,6 @@ versionVariants:
|
|
|
7
7
|
v1: /opi/ko/integration/webhook/readme-v1
|
|
8
8
|
---
|
|
9
9
|
|
|
10
|
-
(관련 이미지 첨부)
|
|
11
|
-
|
|
12
10
|
## 웹훅(Webhook) 이란?
|
|
13
11
|
|
|
14
12
|
특정 이벤트가 발생하였을 때 타 서비스나 응용프로그램으로 알림을 보내는 기능입니다.
|
|
@@ -584,7 +582,7 @@ Connection Timeout 및 Read Timeout 모두 30초 입니다.
|
|
|
584
582
|
|
|
585
583
|
**웹훅 처리 전에 브라우저 결제 완료 처리가 진행되는 경우**
|
|
586
584
|
|
|
587
|
-
기본적으로 포트원 서버는 웹훅을 호출한 뒤 고객사 응답을 기다리지 않고 브라우저에 302 redirect 응답을 보내기 때문에 결과 도달에 대한 순서를 보장하지 않습니다. 다만 고객사 요청이 있을 경우 webhook 호출 이후에 브라우저에 302 redirect 또는 callback 응답을 보내어 순서를 보장해 드리고 있습니다. 웹훅 우선순위 요청은 <support@portone.io> 로
|
|
585
|
+
기본적으로 포트원 서버는 웹훅을 호출한 뒤 고객사 응답을 기다리지 않고 브라우저에 302 redirect 응답을 보내기 때문에 결과 도달에 대한 순서를 보장하지 않습니다. 다만 고객사 요청이 있을 경우 webhook 호출 이후에 브라우저에 302 redirect 또는 callback 응답을 보내어 순서를 보장해 드리고 있습니다. 웹훅 우선순위 요청은 <tech.support@portone.io> 로 상점 아이디(storeId)를 기재하여 요청해 주시면 됩니다.
|
|
588
586
|
|
|
589
587
|
</div>
|
|
590
588
|
|
|
@@ -184,7 +184,7 @@ ni @portone/browser-sdk
|
|
|
184
184
|
|
|
185
185
|
<div class="hint" data-style="warning">
|
|
186
186
|
|
|
187
|
-
|
|
187
|
+
나이스정보통신의 경우 최대 40바이트까지 입력할 수 있으며, 사용 가능한 특수문자는 아래와 같습니다.
|
|
188
188
|
|
|
189
189
|
- 사용 가능: `_`
|
|
190
190
|
- 사용 불가: `% & | $ - + = [ ]`
|
|
@@ -288,7 +288,7 @@ ni @portone/browser-sdk
|
|
|
288
288
|
|
|
289
289
|
<div class="hint" data-style="warning">
|
|
290
290
|
|
|
291
|
-
|
|
291
|
+
나이스정보통신은 `KRW`만을 지원합니다.
|
|
292
292
|
|
|
293
293
|
</div>
|
|
294
294
|
|
|
@@ -526,7 +526,7 @@ ni @portone/browser-sdk
|
|
|
526
526
|
|
|
527
527
|
<div class="hint" data-style="warning">
|
|
528
528
|
|
|
529
|
-
|
|
529
|
+
나이스정보통신의 경우 카드사 단독 노출 시 `card.installment.monthOption.fixedMonth`를 필수로 지정해야 합니다.
|
|
530
530
|
결제 금액이 할부 지원 금액 미만인 경우 할부 개월 수를 `0`으로 전달해야 합니다.
|
|
531
531
|
|
|
532
532
|
</div>
|
|
@@ -824,7 +824,7 @@ ni @portone/browser-sdk
|
|
|
824
824
|
|
|
825
825
|
<div class="hint" data-style="warning">
|
|
826
826
|
|
|
827
|
-
|
|
827
|
+
나이스정보통신의 경우 카드사 포인트 사용 시 별도 계약이 필요합니다.
|
|
828
828
|
|
|
829
829
|
</div>
|
|
830
830
|
|
|
@@ -1047,7 +1047,7 @@ ni @portone/browser-sdk
|
|
|
1047
1047
|
|
|
1048
1048
|
<div class="hint" data-style="warning">
|
|
1049
1049
|
|
|
1050
|
-
|
|
1050
|
+
나이스정보통신의 경우 입금 만료기한을 필수로 입력해야 합니다.
|
|
1051
1051
|
|
|
1052
1052
|
</div>
|
|
1053
1053
|
|
|
@@ -1214,7 +1214,7 @@ ni @portone/browser-sdk
|
|
|
1214
1214
|
|
|
1215
1215
|
<div class="hint" data-style="warning">
|
|
1216
1216
|
|
|
1217
|
-
|
|
1217
|
+
나이스정보통신의 경우 상품권 유형을 필수로 지정해야 합니다.s
|
|
1218
1218
|
|
|
1219
1219
|
</div>
|
|
1220
1220
|
|
|
@@ -1410,7 +1410,7 @@ ni @portone/browser-sdk
|
|
|
1410
1410
|
|
|
1411
1411
|
<div class="hint" data-style="warning">
|
|
1412
1412
|
|
|
1413
|
-
|
|
1413
|
+
나이스정보통신의 경우 카카오페이, 네이버페이, 애플페이, LPAY 사용 시 상점분담 무이자를 사용하실 수 없습니다.
|
|
1414
1414
|
|
|
1415
1415
|
</div>
|
|
1416
1416
|
|
|
@@ -1547,7 +1547,7 @@ ni @portone/browser-sdk
|
|
|
1547
1547
|
|
|
1548
1548
|
<div class="hint" data-style="warning">
|
|
1549
1549
|
|
|
1550
|
-
|
|
1550
|
+
나이스정보통신의 경우 할부 사용 시 별도 계약이 필요합니다.
|
|
1551
1551
|
|
|
1552
1552
|
</div>
|
|
1553
1553
|
|
|
@@ -1670,7 +1670,7 @@ ni @portone/browser-sdk
|
|
|
1670
1670
|
|
|
1671
1671
|
<div class="hint" data-style="warning">
|
|
1672
1672
|
|
|
1673
|
-
|
|
1673
|
+
나이스정보통신의 경우 일부 간편결제 수단에 대해 `availablePayMethods`가 필수입니다.
|
|
1674
1674
|
|
|
1675
1675
|
- 네이버페이: 카드 결제인 경우 `CARD`, 포인트 혹은 머니 결제인 경우 `CHARGE`를 입력합니다.
|
|
1676
1676
|
- SSG페이: 계좌 결제를 노출하는 `TRANSFER`만 유효하며, 카드 혹은 머니 결제인 경우 `availablePayMethods`를 생략해야 합니다.
|
|
@@ -1706,7 +1706,7 @@ ni @portone/browser-sdk
|
|
|
1706
1706
|
|
|
1707
1707
|
<div class="hint" data-style="warning">
|
|
1708
1708
|
|
|
1709
|
-
|
|
1709
|
+
나이스정보통신와 계약 시 지정된 면세금액을 반드시 입력해야 합니다.
|
|
1710
1710
|
|
|
1711
1711
|
</div>
|
|
1712
1712
|
|
|
@@ -1990,7 +1990,7 @@ ni @portone/browser-sdk
|
|
|
1990
1990
|
|
|
1991
1991
|
<div class="hint" data-style="warning">
|
|
1992
1992
|
|
|
1993
|
-
|
|
1993
|
+
나이스정보통신와 별도 계약이 필요합니다.
|
|
1994
1994
|
|
|
1995
1995
|
</div>
|
|
1996
1996
|
|
|
@@ -2015,7 +2015,7 @@ ni @portone/browser-sdk
|
|
|
2015
2015
|
|
|
2016
2016
|
<div class="hint" data-style="warning">
|
|
2017
2017
|
|
|
2018
|
-
|
|
2018
|
+
나이스정보통신와 별도 계약이 필요합니다.
|
|
2019
2019
|
|
|
2020
2020
|
</div>
|
|
2021
2021
|
|
|
@@ -2056,7 +2056,7 @@ ni @portone/browser-sdk
|
|
|
2056
2056
|
|
|
2057
2057
|
<div class="hint" data-style="warning">
|
|
2058
2058
|
|
|
2059
|
-
|
|
2059
|
+
나이스정보통신와 별도 계약이 필요합니다.
|
|
2060
2060
|
|
|
2061
2061
|
</div>
|
|
2062
2062
|
|
|
@@ -2068,7 +2068,7 @@ ni @portone/browser-sdk
|
|
|
2068
2068
|
|
|
2069
2069
|
<div class="hint" data-style="warning">
|
|
2070
2070
|
|
|
2071
|
-
|
|
2071
|
+
나이스정보통신와 별도 계약이 필요합니다.
|
|
2072
2072
|
|
|
2073
2073
|
</div>
|
|
2074
2074
|
|
|
@@ -2083,7 +2083,7 @@ ni @portone/browser-sdk
|
|
|
2083
2083
|
|
|
2084
2084
|
<div class="hint" data-style="warning">
|
|
2085
2085
|
|
|
2086
|
-
|
|
2086
|
+
나이스정보통신와 별도 계약이 필요합니다.
|
|
2087
2087
|
|
|
2088
2088
|
</div>
|
|
2089
2089
|
|
|
@@ -2774,7 +2774,7 @@ ni @portone/browser-sdk
|
|
|
2774
2774
|
|
|
2775
2775
|
<div class="hint" data-style="warning">
|
|
2776
2776
|
|
|
2777
|
-
|
|
2777
|
+
나이스정보통신의 경우 에스크로 사용 시 별도 계약이 필요합니다.
|
|
2778
2778
|
|
|
2779
2779
|
</div>
|
|
2780
2780
|
|
|
@@ -15,8 +15,8 @@ targetVersions:
|
|
|
15
15
|
| NHN KCP 퀵페이 | `kcp_quick` |
|
|
16
16
|
| (구) 토스페이먼츠 | `uplus` |
|
|
17
17
|
| (신) 토스페이먼츠 | `tosspayments` |
|
|
18
|
-
| (구)
|
|
19
|
-
| (신)
|
|
18
|
+
| (구) 나이스정보통신 | `nice` |
|
|
19
|
+
| (신) 나이스정보통신 | `nice_v2` |
|
|
20
20
|
| 이지페이(KICC) | `kicc` |
|
|
21
21
|
| 카카오페이 | `kakaopay` |
|
|
22
22
|
|다날휴대폰결제/본인인증| `danal` |
|
|
@@ -16,8 +16,8 @@ API방식으로 연동하실 때는 [비인증 결제(일회성) API](https://de
|
|
|
16
16
|
|
|
17
17
|
| 결제대행사 |코드값(pg provider)|결제창 방식|API 방식| 발급과 동시에 결제 기능 (결제창기준) |
|
|
18
18
|
|:---------------------:|:-----------------:|:---------:|:------:|:--------------------------------------------------------------:|
|
|
19
|
-
|
|
|
20
|
-
|
|
|
19
|
+
| 나이스정보통신(구모듈)| nice | X | O | - |
|
|
20
|
+
| 나이스정보통신(신모듈)| nice\_v2 | X | O | - |
|
|
21
21
|
| 토스페이먼츠(신모듈) | tosspayments | O | O | 불가능 |
|
|
22
22
|
| KCP | kcp\_billing | O | X | 불가능 |
|
|
23
23
|
| KCP | kcp | X | O | - |
|