@portone/mcp-server 0.14.0 → 0.15.0-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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/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/content61.md +0 -2
- package/assets/docs/help/core-service/channel-setting/danal.md +6 -8
- package/assets/docs/help/core-service/channel-setting/eximbay.md +224 -17
- 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/eximbay-contract.md +1 -1
- 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 -10
- package/assets/docs/help/core-service/how-to-use/kakao-contract.md +2 -2
- 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/shopify-guide.md +1 -1
- 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 +105 -0
- package/assets/docs/help/core-service/payment-type/paypal-payment-status.md +3 -3
- package/assets/docs/help/core-service/payment-type/schedule-requirement.md +2 -2
- package/assets/docs/help/faq/console-faq/change-console-url.md +2 -0
- 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/notice-v1-api-2025-11-24.md +78 -0
- package/assets/docs/help/notice-v1-api-2025-11-25.md +59 -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/pricing/portone/portone-pricing.md +1 -1
- 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 +14 -8
- 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 +2 -2
- 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 -10
- package/assets/docs/opi/ko/integration/pg/v1/danal.md +6 -1
- package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +10 -1
- 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 +60 -2
- 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/ksnet/readme.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/newtoss/readme.md +1 -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 +0 -34
- 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 +7 -7
- package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md +91 -0
- package/assets/docs/opi/ko/integration/pg/v1/paypal.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/readme.md +5 -5
- package/assets/docs/opi/ko/integration/pg/v1/rt/readme.md +3 -3
- package/assets/docs/opi/ko/integration/pg/v1/rt/warning.md +2 -2
- package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md +81 -1
- package/assets/docs/opi/ko/integration/pg/v1/smartro-v2/caution.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md +10 -9
- package/assets/docs/opi/ko/integration/pg/v1/tosspay-v2/readme.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/welcome/readme.md +10 -7
- package/assets/docs/opi/ko/integration/pg/v2/eximbay-v2.md +140 -22
- package/assets/docs/opi/ko/integration/pg/v2/hyphen.md +1 -1
- 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 +17 -3
- package/assets/docs/opi/ko/integration/pg/v2/paypal-v2.md +14 -13
- package/assets/docs/opi/ko/integration/pg/v2/readme.md +1 -9
- package/assets/docs/opi/ko/integration/pg/v2/smartro-v2.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v2/tosspayments.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v2/welcome.md +8 -7
- package/assets/docs/opi/ko/integration/ready/readme.md +44 -42
- 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 -3
- 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 +3 -5
- package/assets/docs/opi/ko/quick-guide/payment.md +25 -77
- 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 +4 -4
- 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.schema.json +510 -0
- package/assets/docs/schema/browser-sdk.yml +196 -69
- package/assets/docs/schema/v1.openapi.json +845 -887
- package/assets/docs/schema/v1.openapi.yml +1062 -1737
- package/assets/docs/schema/v2.openapi.json +9177 -2044
- package/assets/docs/schema/v2.openapi.yml +7499 -1479
- 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-mobile-sdk/android.md +1 -1
- 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 +2395 -1336
- package/assets/docs/v2-docs-full.md +1422 -649
- package/assets/docs/website-links.md +23 -15
- 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/core-service/payment-type/tosspayments-easypay-hub-fee.md +0 -42
- package/assets/docs/help/faq/platform-faq/taxinvoice_guide.md +0 -107
- package/assets/docs/help/faq/platform-faq/taxinvoice_signupemail.md +0 -67
|
@@ -101,6 +101,7 @@ IMP.request_pay(
|
|
|
101
101
|
- kakaopay (카카오페이)
|
|
102
102
|
- payco (페이코)
|
|
103
103
|
- tosspay (토스페이)
|
|
104
|
+
- naverpay (네이버페이)
|
|
104
105
|
|
|
105
106
|
- merchant\_uid: string
|
|
106
107
|
|
|
@@ -296,18 +297,19 @@ IMP.request_pay(
|
|
|
296
297
|
- 엘페이: LPAY
|
|
297
298
|
- 페이코: PAYCO
|
|
298
299
|
- 토스페이: TOSSPAY
|
|
300
|
+
- 네이버페이: NPAY
|
|
299
301
|
|
|
300
302
|
- acceptmethod?: string\[]
|
|
301
303
|
|
|
302
304
|
**PC - 카드 결제 전용 파라미터**
|
|
303
305
|
|
|
304
|
-
|형식 |설명
|
|
305
|
-
|
|
306
|
-
|SKIN(색상코드) |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d)
|
|
307
|
-
|below1000 |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음
|
|
308
|
-
|paypopup |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어
|
|
309
|
-
|onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay`|
|
|
310
|
-
|SLIMQUOTA(슬림 할부 설정) |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3)
|
|
306
|
+
|형식 |설명 |
|
|
307
|
+
|---------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
308
|
+
|SKIN(색상코드) |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d) |
|
|
309
|
+
|below1000 |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음 |
|
|
310
|
+
|paypopup |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어 |
|
|
311
|
+
|onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay` <br /> - 네이버페이: `naverpay`|
|
|
312
|
+
|SLIMQUOTA(슬림 할부 설정) |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3) |
|
|
311
313
|
|
|
312
314
|
**PC - 휴대폰 소액 결제 전용 파라미터**
|
|
313
315
|
|
|
@@ -383,6 +385,7 @@ IMP.request_pay(
|
|
|
383
385
|
- kakaopay
|
|
384
386
|
- payco
|
|
385
387
|
- tosspay
|
|
388
|
+
- naverpay
|
|
386
389
|
|
|
387
390
|
</details>
|
|
388
391
|
|
|
@@ -17,19 +17,13 @@ targetVersions:
|
|
|
17
17
|
|
|
18
18
|
## 가능한 결제수단
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
엑심베이의 경우 포트원의 결제수단 구분과 상관없이 MID에 설정된 여러 결제수단을 표시할 수 있습니다.
|
|
21
|
+
`payMethod`를 생략하고, 특정 결제수단만을 노출할 경우 `bypass.eximbay_v2`를 사용해야 합니다.
|
|
21
22
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
- 특정 결제수단을 단독으로 표시하려면 `bypass.eximbay_v2.payment.payment_method`를 설정합니다.
|
|
27
|
-
- 일부 결제수단만을 표시하려면 `bypass.eximbay_v2.payment.multi_payment_method`에 결제수단 목록을 전달합니다.
|
|
28
|
-
- 엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
|
|
29
|
-
|
|
30
|
-
- **결제창 빌링키 발급 및 결제**
|
|
31
|
-
|
|
32
|
-
현재 신용카드 결제만 지원하며, `billingKeyAndPayMethod` 파라미터를 `CARD`로 설정해야 합니다.
|
|
23
|
+
- MID에 설정된 기본 결제수단을 전부 표시하려면 `bypass.eximbay_v2.payment`를 생략해야 합니다.
|
|
24
|
+
- 특정 결제수단을 단독으로 표시하려면 `bypass.eximbay_v2.payment.payment_method`를 설정합니다.
|
|
25
|
+
- 일부 결제수단만을 표시하려면 `bypass.eximbay_v2.payment.multi_payment_method`에 결제수단 목록을 전달합니다.
|
|
26
|
+
- 엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
|
|
33
27
|
|
|
34
28
|
## SDK 결제 요청하기
|
|
35
29
|
|
|
@@ -154,6 +148,35 @@ function requestPayment() {
|
|
|
154
148
|
|
|
155
149
|
결제 완료 메일이 발송됩니다.
|
|
156
150
|
|
|
151
|
+
- products?: object\[]
|
|
152
|
+
|
|
153
|
+
**구매 상품 정보**
|
|
154
|
+
|
|
155
|
+
- 해외카드 결제를 제외하고 필수 입력입니다.
|
|
156
|
+
- 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
|
|
157
|
+
|
|
158
|
+
* id: string
|
|
159
|
+
|
|
160
|
+
**상품 ID**
|
|
161
|
+
|
|
162
|
+
* name: string
|
|
163
|
+
|
|
164
|
+
**상품명**
|
|
165
|
+
|
|
166
|
+
* amount: number
|
|
167
|
+
|
|
168
|
+
**상품 단위 가격**
|
|
169
|
+
|
|
170
|
+
결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
|
|
171
|
+
|
|
172
|
+
* quantity: number
|
|
173
|
+
|
|
174
|
+
**상품 수량**
|
|
175
|
+
|
|
176
|
+
* link: string
|
|
177
|
+
|
|
178
|
+
**상품 판매 URL**
|
|
179
|
+
|
|
157
180
|
- bypass?: oneof object
|
|
158
181
|
|
|
159
182
|
- eximbay\_v2?: object
|
|
@@ -317,7 +340,6 @@ function issueBillingKeyAndPay() {
|
|
|
317
340
|
orderName: "PortOne Recurring Payment",
|
|
318
341
|
totalAmount: 100, // 1 USD
|
|
319
342
|
currency: "USD",
|
|
320
|
-
billingKeyAndPayMethod: "CARD",
|
|
321
343
|
customer: {
|
|
322
344
|
fullName: "PortOne",
|
|
323
345
|
email: "test@example.com",
|
|
@@ -370,12 +392,6 @@ function issueBillingKeyAndPay() {
|
|
|
370
392
|
- ISO 4217 통화 코드
|
|
371
393
|
- [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)
|
|
372
394
|
|
|
373
|
-
- billingKeyAndPayMethod: string
|
|
374
|
-
|
|
375
|
-
**빌링키 발급 및 결제 방법**
|
|
376
|
-
|
|
377
|
-
- `CARD`: 신용카드 결제
|
|
378
|
-
|
|
379
395
|
- locale?: Locale
|
|
380
396
|
|
|
381
397
|
**결제창 언어**
|
|
@@ -427,12 +443,55 @@ function issueBillingKeyAndPay() {
|
|
|
427
443
|
|
|
428
444
|
결제 완료 메일이 발송됩니다.
|
|
429
445
|
|
|
446
|
+
- products?: object\[]
|
|
447
|
+
|
|
448
|
+
**구매 상품 정보**
|
|
449
|
+
|
|
450
|
+
- 해외카드 결제를 제외하고 필수 입력입니다.
|
|
451
|
+
- 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
|
|
452
|
+
|
|
453
|
+
* id: string
|
|
454
|
+
|
|
455
|
+
**상품 ID**
|
|
456
|
+
|
|
457
|
+
* name: string
|
|
458
|
+
|
|
459
|
+
**상품명**
|
|
460
|
+
|
|
461
|
+
* amount: number
|
|
462
|
+
|
|
463
|
+
**상품 단위 가격**
|
|
464
|
+
|
|
465
|
+
결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
|
|
466
|
+
|
|
467
|
+
* quantity: number
|
|
468
|
+
|
|
469
|
+
**상품 수량**
|
|
470
|
+
|
|
471
|
+
* link: string
|
|
472
|
+
|
|
473
|
+
**상품 판매 URL**
|
|
474
|
+
|
|
430
475
|
- bypass?: oneof object
|
|
431
476
|
|
|
432
477
|
- eximbay\_v2?: object
|
|
433
478
|
|
|
434
479
|
**엑심베이 특수 파라미터**
|
|
435
480
|
|
|
481
|
+
- payment?: object
|
|
482
|
+
|
|
483
|
+
- payment\_method?: string
|
|
484
|
+
|
|
485
|
+
**결제수단 단독 노출**
|
|
486
|
+
|
|
487
|
+
엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
|
|
488
|
+
|
|
489
|
+
- multi\_payment\_method?: string\[]
|
|
490
|
+
|
|
491
|
+
**결제수단 노출 목록**
|
|
492
|
+
|
|
493
|
+
여러 결제수단을 노출합니다.
|
|
494
|
+
|
|
436
495
|
- merchant?: object
|
|
437
496
|
|
|
438
497
|
- shop?: string
|
|
@@ -630,6 +689,35 @@ const response = await axios({
|
|
|
630
689
|
|
|
631
690
|
**구매자 이메일**
|
|
632
691
|
|
|
692
|
+
- products?: object\[]
|
|
693
|
+
|
|
694
|
+
**구매 상품 정보**
|
|
695
|
+
|
|
696
|
+
- 해외카드 결제를 제외하고 필수 입력입니다.
|
|
697
|
+
- 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
|
|
698
|
+
|
|
699
|
+
* id: string
|
|
700
|
+
|
|
701
|
+
**상품 ID**
|
|
702
|
+
|
|
703
|
+
* name: string
|
|
704
|
+
|
|
705
|
+
**상품명**
|
|
706
|
+
|
|
707
|
+
* amount: number
|
|
708
|
+
|
|
709
|
+
**상품 단위 가격**
|
|
710
|
+
|
|
711
|
+
결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
|
|
712
|
+
|
|
713
|
+
* quantity: number
|
|
714
|
+
|
|
715
|
+
**상품 수량**
|
|
716
|
+
|
|
717
|
+
* link: string
|
|
718
|
+
|
|
719
|
+
**상품 판매 URL**
|
|
720
|
+
|
|
633
721
|
- bypass?: oneof object
|
|
634
722
|
|
|
635
723
|
- eximbayV2?: object
|
|
@@ -840,6 +928,35 @@ const response = await axios({
|
|
|
840
928
|
|
|
841
929
|
**구매자 이메일**
|
|
842
930
|
|
|
931
|
+
- products?: object\[]
|
|
932
|
+
|
|
933
|
+
**구매 상품 정보**
|
|
934
|
+
|
|
935
|
+
- 해외카드 결제를 제외하고 필수 입력입니다.
|
|
936
|
+
- 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
|
|
937
|
+
|
|
938
|
+
* id: string
|
|
939
|
+
|
|
940
|
+
**상품 ID**
|
|
941
|
+
|
|
942
|
+
* name: string
|
|
943
|
+
|
|
944
|
+
**상품명**
|
|
945
|
+
|
|
946
|
+
* amount: number
|
|
947
|
+
|
|
948
|
+
**상품 단위 가격**
|
|
949
|
+
|
|
950
|
+
결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
|
|
951
|
+
|
|
952
|
+
* quantity: number
|
|
953
|
+
|
|
954
|
+
**상품 수량**
|
|
955
|
+
|
|
956
|
+
* link: string
|
|
957
|
+
|
|
958
|
+
**상품 판매 URL**
|
|
959
|
+
|
|
843
960
|
- bypass?: oneof object
|
|
844
961
|
|
|
845
962
|
- eximbayV2?: object
|
|
@@ -945,9 +1062,10 @@ const response = await axios({
|
|
|
945
1062
|
### 공통
|
|
946
1063
|
|
|
947
1064
|
- `customer.name` 및 `customer.email`은 필수 입력 항목입니다.
|
|
1065
|
+
- 해외카드 결제를 제외하고 `products`를 필수로 입력해야 합니다. 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
|
|
948
1066
|
- `products` 입력 시 `link`를 필수로 입력해야 합니다.
|
|
949
1067
|
|
|
950
|
-
### SDK 결제 요청
|
|
1068
|
+
### SDK 결제 / 빌링키 발급 및 결제 요청
|
|
951
1069
|
|
|
952
1070
|
- 네이버페이 포인트로 결제할 경우에는 `bypass.eximbay_v2.tax` 내용을 모두 입력해야 합니다.
|
|
953
1071
|
|
|
@@ -955,10 +1073,10 @@ const response = await axios({
|
|
|
955
1073
|
|
|
956
1074
|
- `bypass.eximbay_v2.payment_method`에 일본 편의점 결제를 지정할 경우 `customer.phoneNumber`을 필수로 입력해야 합니다.
|
|
957
1075
|
|
|
958
|
-
- 간편결제 사용 시 `products`를 필수로 입력해야 합니다.
|
|
959
|
-
|
|
960
1076
|
- 아래 결제수단의 경우 사용이 제한되므로 결제 연동 시 유의해 주시기 바랍니다.
|
|
961
1077
|
- 가상계좌(`P305`) : 호환성 이슈로 추후 지원 예정
|
|
962
1078
|
- Klarna(`P197`) : 엑심베이 정책에 따라 신규 결제 사용 불가
|
|
963
1079
|
|
|
964
1080
|
- 모바일 앱 내에서 결제를 연동할 경우 `appScheme` 파라미터를 설정하고 `bypass.eximbay_v2.settings.call_from_app` 파라미터를 "Y"로 설정해야 합니다.
|
|
1081
|
+
|
|
1082
|
+
- 엑심베이의 경우 결제창을 닫은 이후에 결제가 성공 처리될 수 있습니다. 웹훅을 연동하여 결제 실패 상태에서 결제 성공 상태로 바뀌는 경우를 처리해야 합니다.
|
|
@@ -209,7 +209,7 @@ function requestPayment() {
|
|
|
209
209
|
"Ini_SSGPAY_MDN": "01012341234",
|
|
210
210
|
"acceptmethod": ["SKIN(#C1272C)", "below1000", "ocb"],
|
|
211
211
|
"P_CARD_OPTION": "selcode=14",
|
|
212
|
-
"
|
|
212
|
+
"P_MNAME": "포트원",
|
|
213
213
|
"P_RESERVED": ["below1000=Y", "noeasypay=Y"]
|
|
214
214
|
}
|
|
215
215
|
}
|
|
@@ -338,6 +338,18 @@ function requestPayment() {
|
|
|
338
338
|
|
|
339
339
|
<details>
|
|
340
340
|
|
|
341
|
+
<summary>계약 사항에 따라 결제 정보에서 카드 정보가 누락될 수 있습니다.</summary>
|
|
342
|
+
|
|
343
|
+
KG이니시스와의 계약에서 결제 결과에 카드번호를 전송하지 않도록 설정된 경우, 결제 조회 시 다음 카드 관련 필드들이 누락될 수 있습니다.
|
|
344
|
+
|
|
345
|
+
- `card.issuer`: 카드 발급사
|
|
346
|
+
- `card.publisher`: 카드 발행사
|
|
347
|
+
- `card.name`: 카드명
|
|
348
|
+
|
|
349
|
+
</details>
|
|
350
|
+
|
|
351
|
+
<details>
|
|
352
|
+
|
|
341
353
|
<summary>PC와 모바일에서 파라미터 필수 여부가 상이합니다.</summary>
|
|
342
354
|
|
|
343
355
|
위의 주요 파라미터 설명에도 안내되어 있듯이, PC 결제와 모바일 결제에서 필수 여부가 상이한 파라미터가 존재합니다. 아래 필드들은 PC 결제에서는 필수이지만, 모바일 결제에서는 선택입니다.
|
|
@@ -4,7 +4,7 @@ description: NHN KCP 연동 방법을 안내합니다.
|
|
|
4
4
|
targetVersions:
|
|
5
5
|
- v2
|
|
6
6
|
versionVariants:
|
|
7
|
-
v1: /opi/ko/integration/pg/v1/nhn-kcp
|
|
7
|
+
v1: /opi/ko/integration/pg/v1/nhn-kcp/readme
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
## 채널 설정하기
|
|
@@ -203,8 +203,10 @@ function requestPayment() {
|
|
|
203
203
|
|
|
204
204
|
- shop\_user\_id?: string
|
|
205
205
|
|
|
206
|
-
|
|
206
|
+
**리스크 관리 조치를 위한 고객사 회원 ID**
|
|
207
207
|
|
|
208
|
+
- KCP에서 부정거래를 신속하게 탐지하기 위한 파라미터입니다.
|
|
209
|
+
- 고객사에서 관리하는 구매자의 회원 ID를 입력합니다.
|
|
208
210
|
- 상품권, 휴대폰 결제 시 필수로 입력해야 합니다.
|
|
209
211
|
|
|
210
212
|
- site\_name?: string
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
|
-
title:
|
|
3
|
-
description:
|
|
2
|
+
title: 나이스정보통신
|
|
3
|
+
description: 나이스정보통신 결제 연동 방법을 안내합니다.
|
|
4
4
|
targetVersions:
|
|
5
5
|
- v2
|
|
6
6
|
versionVariants:
|
|
@@ -10,7 +10,7 @@ versionVariants:
|
|
|
10
10
|
## 채널 설정하기
|
|
11
11
|
|
|
12
12
|
- [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
|
|
13
|
-
V2 결제 모듈을 사용하시려면
|
|
13
|
+
V2 결제 모듈을 사용하시려면 나이스정보통신(신모듈)로 연동하셔야 합니다.
|
|
14
14
|
|
|
15
15
|
## 가능한 결제수단
|
|
16
16
|
|
|
@@ -24,7 +24,7 @@ versionVariants:
|
|
|
24
24
|
- 간편 결제 : `EASY_PAY`
|
|
25
25
|
|
|
26
26
|
- **결제창 빌링키 발급**
|
|
27
|
-
- `billingKeyMethod` 파라미터를 `EASY_PAY`로 설정해야 합니다.
|
|
27
|
+
- 결제창 빌링키 발급은 간편결제(네이버페이 / 카카오페이)만 지원하므로 `billingKeyMethod` 파라미터를 `EASY_PAY`로 설정해야 합니다.
|
|
28
28
|
|
|
29
29
|
- **API 수기(키인) 결제**
|
|
30
30
|
- `method`파라미터를 `card`로 설정해야 합니다.
|
|
@@ -35,9 +35,9 @@ versionVariants:
|
|
|
35
35
|
## SDK 결제 요청하기
|
|
36
36
|
|
|
37
37
|
결제 요청 시에는 `requestPayment` 함수를 호출해야 합니다.
|
|
38
|
-
`channelKey`파라미터에 결제 채널 연동 시 생성된 채널 키값을 지정하여
|
|
38
|
+
`channelKey`파라미터에 결제 채널 연동 시 생성된 채널 키값을 지정하여 나이스정보통신 채널 사용을 명시해주세요.
|
|
39
39
|
|
|
40
|
-
|
|
40
|
+
나이스정보통신 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
41
41
|
|
|
42
42
|
<div class="tabs-container">
|
|
43
43
|
|
|
@@ -92,7 +92,7 @@ function requestPayment() {
|
|
|
92
92
|
|
|
93
93
|
- currency: string
|
|
94
94
|
|
|
95
|
-
결제통화로 원화 결제 시 `KRW`로 입력해야 합니다.
|
|
95
|
+
결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. 나이스정보통신의 경우 `KRW`와 `USD`를 지원합니다.
|
|
96
96
|
|
|
97
97
|
- payMethod: string
|
|
98
98
|
|
|
@@ -100,7 +100,7 @@ function requestPayment() {
|
|
|
100
100
|
|
|
101
101
|
- taxFreeAmount?: number
|
|
102
102
|
|
|
103
|
-
면세금액으로
|
|
103
|
+
면세금액으로 나이스정보통신와 상점아이디 계약시 지정금액 혹은 복합과세 방식으로 계약한 경우 면세 처리를 위해 면세금액을 반드시 입력해야 합니다.
|
|
104
104
|
|
|
105
105
|
면세금액 미 입력 시 면세금액은 0원으로 자동 처리되며, 결제 요청 금액은 모두 과세 처리 되오니 이 점 유의하시기 바랍니다.
|
|
106
106
|
|
|
@@ -112,7 +112,7 @@ function requestPayment() {
|
|
|
112
112
|
|
|
113
113
|
- `card.installment.monthOption.fixedMonth`
|
|
114
114
|
|
|
115
|
-
|
|
115
|
+
나이스정보통신은 **카드사 다이렉트 호출시 고정 할부 개월수를 필수로 입력**해야 합니다. 결제
|
|
116
116
|
금액이 할부 지원 금액 미만(대부분 50,000원이상 할부지원이나 카드사에 따라 상이함)인 경우 **할부
|
|
117
117
|
개월수를 0(일시불)으로 전달**해야 합니다.
|
|
118
118
|
|
|
@@ -126,15 +126,15 @@ function requestPayment() {
|
|
|
126
126
|
|
|
127
127
|
- `giftCertificate.certificateType`
|
|
128
128
|
|
|
129
|
-
|
|
129
|
+
나이스정보통신은 컬쳐랜드만 지원하므로 상품권 결제시 항상 `CULTURELAND`로 지정해주어야 합니다.
|
|
130
130
|
|
|
131
131
|
- `bypass.nice_v2.MallUserID`
|
|
132
132
|
|
|
133
|
-
|
|
133
|
+
나이스정보통신 상품권 결제시 고객사 구매자 ID를 의미하는 MalluserID는 필수로 입력해주어야 합니다.
|
|
134
134
|
|
|
135
135
|
- `easyPay.availablePayMethods`
|
|
136
136
|
|
|
137
|
-
|
|
137
|
+
나이스정보통신를 통한 간편결제 결제 요청 시 다른 간편결제 수단과 다르게 네이버페이, SSG페이, 토스페이의
|
|
138
138
|
경우 어떤 방식으로 결제하느냐에 따라 availablePayMethods을 입력해야 합니다.
|
|
139
139
|
|
|
140
140
|
- 네이버페이의 경우 카드 결제인 경우 `CARD`, 포인트 혹은 머니 결제인 경우 `CHARGE` 로 입력해야
|
|
@@ -149,9 +149,9 @@ function requestPayment() {
|
|
|
149
149
|
## 결제창 빌링키 발급
|
|
150
150
|
|
|
151
151
|
빌링키 발급 요청 시에는 `requestIssueBillingKey` 함수를 호출해야 합니다.
|
|
152
|
-
`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여
|
|
152
|
+
`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 나이스정보통신 채널 사용을 명시해주세요.
|
|
153
153
|
|
|
154
|
-
|
|
154
|
+
나이스정보통신 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
155
155
|
|
|
156
156
|
<div class="tabs-container">
|
|
157
157
|
|
|
@@ -163,7 +163,7 @@ function requestIssueBillingKey() {
|
|
|
163
163
|
PortOne.requestIssueBillingKey({
|
|
164
164
|
storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요.
|
|
165
165
|
channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요.
|
|
166
|
-
billingKeyMethod: "EASY_PAY",
|
|
166
|
+
billingKeyMethod: "EASY_PAY", // 간편결제만 지원합니다.
|
|
167
167
|
issueId: "testIssueId",
|
|
168
168
|
issueName: "testIssueName",
|
|
169
169
|
customer: {
|
|
@@ -200,21 +200,21 @@ function requestIssueBillingKey() {
|
|
|
200
200
|
|
|
201
201
|
**빌링키 발급수단**
|
|
202
202
|
|
|
203
|
-
|
|
203
|
+
나이스정보통신은 결제창 방식으로 빌링키 발급 시 간편결제(네이버페이 / 카카오페이)만을 지원하므로 `EASY_PAY`로 설정해야 합니다.
|
|
204
204
|
|
|
205
205
|
- issueId: string
|
|
206
206
|
|
|
207
207
|
**빌링키 발급 건 고유 ID**
|
|
208
208
|
|
|
209
209
|
- 고객사에서 채번하여 사용해야 합니다.
|
|
210
|
-
-
|
|
210
|
+
- 나이스정보통신의 경우 필수 입력해야 합니다.
|
|
211
211
|
- 영문 대소문자와 숫자만 사용하여 40자 이내로 입력합니다.
|
|
212
212
|
|
|
213
213
|
- issueName: string
|
|
214
214
|
|
|
215
215
|
**빌링키 발급 시 결제창에 표시되는 제목**
|
|
216
216
|
|
|
217
|
-
-
|
|
217
|
+
- 나이스정보통신의 경우 필수 입력해야 합니다.
|
|
218
218
|
|
|
219
219
|
- customer?: object
|
|
220
220
|
|
|
@@ -333,7 +333,7 @@ const issueResponse = await axios({
|
|
|
333
333
|
|
|
334
334
|
- taxFree?: number
|
|
335
335
|
|
|
336
|
-
면세 금액으로
|
|
336
|
+
면세 금액으로 나이스정보통신과 상점아이디 계약시 지정금액 혹은 복합과세 방식으로 계약한 경우 면세 처리를 위해 면세금액을 반드시 입력해야 합니다.
|
|
337
337
|
면세금액 미 입력 시 면세금액은 0원으로 자동 처리되며, 결제 요청 금액은 모두 과세 처리 되오니 이 점 유의하시기 바랍니다.
|
|
338
338
|
|
|
339
339
|
- currency: string
|
|
@@ -531,7 +531,7 @@ const response = await axios({
|
|
|
531
531
|
|
|
532
532
|
결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
|
|
533
533
|
|
|
534
|
-
|
|
534
|
+
나이스정보통신와 지정금액 혹은 복합과세 방식으로 계약한 경우 면세금액을 반드시 입력해야 합니다.
|
|
535
535
|
카드 빌링키의 경우 면세금액 미입력 시 면세금액은 0원으로 자동 처리되며, 결제 요청 금액은 모두 과세 처리 되오니 이 점 유의하시기 바랍니다.
|
|
536
536
|
간편결제 빌링키의 경우 면세금액 미입력 시 오류가 발생합니다.
|
|
537
537
|
|
|
@@ -541,13 +541,13 @@ const response = await axios({
|
|
|
541
541
|
|
|
542
542
|
결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
|
|
543
543
|
|
|
544
|
-
|
|
544
|
+
나이스정보통신와 지정금액 혹은 복합과세 방식으로 계약한 경우 간편결제 빌링키 이용 시 부가세를 반드시 입력해야 합니다.
|
|
545
545
|
|
|
546
546
|
- currency: string
|
|
547
547
|
|
|
548
548
|
**결제 통화**
|
|
549
549
|
|
|
550
|
-
결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. (신)
|
|
550
|
+
결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. (신)나이스정보통신의 경우 빌링키로 결제시 `KRW`만 지원합니다.
|
|
551
551
|
|
|
552
552
|
- customer: object
|
|
553
553
|
|
|
@@ -620,9 +620,9 @@ const response = await axios({
|
|
|
620
620
|
|
|
621
621
|
## 연동 유의사항
|
|
622
622
|
|
|
623
|
-
###
|
|
623
|
+
### 나이스정보통신와 사전 계약이 필요한 경우
|
|
624
624
|
|
|
625
|
-
아래 기능을 사용하시려면
|
|
625
|
+
아래 기능을 사용하시려면 나이스정보통신에 사전 신청 후 계약이 완료되어야 합니다.
|
|
626
626
|
그렇지 않은 상태에서 해당 기능 이용시 PG창 호출에 실패하거나, 승인에 실패하거나,
|
|
627
627
|
승인에 성공하더라도 의도한 바와는 다른 응답을 얻게 될 수 있으니 이 점 유의하시길 바랍니다.
|
|
628
628
|
|
|
@@ -671,9 +671,9 @@ const response = await axios({
|
|
|
671
671
|
|비 다이렉트 호출 + 리스트 할부 개월수|`PC만 가능` |
|
|
672
672
|
|
|
673
673
|
- 토스뱅크 카드의 경우 카드사 다이렉트 호출 불가능합니다.
|
|
674
|
-
-
|
|
674
|
+
- 나이스정보통신의 경우 토스뱅크 카드 다이렉트 호출이 지원되지 않습니다.
|
|
675
675
|
|
|
676
|
-
- 모바일 환경에서는 다이렉트 호출시에만 할부 옵션 설정이 가능합니다.
|
|
676
|
+
- 모바일 환경에서는 다이렉트 호출시에만 할부 옵션 설정이 가능합니다. -나이스정보통신의 경우 일반
|
|
677
677
|
카드 결제 시(간편결제 제외) 할부 옵션(고정 할부 개월수)사용이 가능하나 **모바일 환경**에서는
|
|
678
678
|
**카드사 다이렉트 호출할 때만 할부 옵션 사용이 가능합니다.** 만약 모바일 환경에서 다이렉트 호출
|
|
679
679
|
코드 없이 할부 옵션을 전달하는 경우 무시됩니다.
|
|
@@ -681,18 +681,18 @@ const response = await axios({
|
|
|
681
681
|
### 계좌이체 일반결제 유의사항
|
|
682
682
|
|
|
683
683
|
- 계좌이체 다이렉트 호출 시 은행 코드 지정이 불가능합니다.
|
|
684
|
-
-
|
|
684
|
+
- 나이스정보통신의 경우 계좌이체 다이렉트 호출을 하더라도 뱅크페이가 호출되오니 이 점 유의하시기 바랍니다.
|
|
685
685
|
- 다이렉트 호출을 원하시는 경우 은행코드 대신 bypass 파라미터인 `DirectShowOpt`를 설정하여 사용하시길 바랍니다.
|
|
686
686
|
|
|
687
687
|
- 계좌이체 에스크로 결제시에는 다이렉트 호출이 불가능합니다.
|
|
688
|
-
-
|
|
688
|
+
- 나이스정보통신 정책상 에스크로를 사용한 계좌이체 결제시에는 다이렉트 호출이 불가능합니다. 아래와
|
|
689
689
|
같이 계좌이체 + 에스크로 + 다이렉트 호출을 위한 파라미터를 설정할 경우 "나이스페이 V2 계좌이체
|
|
690
690
|
에스크로 결제시 다이렉트 호출은 불가능합니다."라는 에러 메시지가 리턴되며, 결제창이 호출되지
|
|
691
691
|
않으니 유의하시기 바랍니다.
|
|
692
692
|
|
|
693
693
|
- 계좌이체 에스크로 결제시 결제창에 올바른 이메일을 입력해야 합니다.
|
|
694
694
|
- 존재하지 않는 이메일을 입력할 경우 **이메일 주소 오류**라는 에러 메시지와 함께 승인 실패됩니다.
|
|
695
|
-
또한 실제로 존재하는 이메일 도메인이더라도
|
|
695
|
+
또한 실제로 존재하는 이메일 도메인이더라도 나이스정보통신 정책상 유효하지 않다고 취급하는 이메일
|
|
696
696
|
주소((예) <ex@portone.finance>)를 입력한 경우 정상 승인되지만 **이후 에스크로 API를 이용하여 배송
|
|
697
697
|
정보 등록 시 에스크로 구매 확정 이메일이 전송되지 않습니다.**
|
|
698
698
|
|
|
@@ -700,8 +700,8 @@ const response = await axios({
|
|
|
700
700
|
|
|
701
701
|
### 상품권 일반결제 유의사항
|
|
702
702
|
|
|
703
|
-
- 승인 완료시
|
|
704
|
-
-
|
|
703
|
+
- 승인 완료시 나이스정보통신로부터 승인번호(`approvalNumber`)가 전달되지 않으니 이 점 유의하시기 바랍니다.
|
|
704
|
+
- 나이스정보통신은 상품권 결제시 별도의 승인 번호를 전달하지 않습니다. 따라서 결제 내역 조회시 승인 번호가 null로 리턴됩니다.
|
|
705
705
|
|
|
706
706
|
### 카카오페이 일반결제 유의사항
|
|
707
707
|
|
|
@@ -781,9 +781,9 @@ const response = await axios({
|
|
|
781
781
|
|
|
782
782
|
- SSGPAY 계좌 결제 시 현금영수증 발급 정보를 확인할 수 없습니다.
|
|
783
783
|
- SSGPAY 은행 계좌 결제 시 현금영수증 발급 정보를 입력하여 정상적으로 발급되더라도 승인
|
|
784
|
-
완료(status: paid)시
|
|
784
|
+
완료(status: paid)시 나이스정보통신에서 현금영수증 발급 정보를 전달하지 않아 포트원 API로
|
|
785
785
|
결제/현금영수증 발급 내역 조회 또는 포트원 콘솔에서 현금영수증 내역을 확인할 수 없습니다. 단,
|
|
786
|
-
|
|
786
|
+
나이스정보통신 어드민에서는 확인이 가능하오니 확인이 필요한 경우 나이스정보통신 어드민에서
|
|
787
787
|
확인하시길 바랍니다.
|
|
788
788
|
|
|
789
789
|
<details>
|
|
@@ -822,7 +822,7 @@ PortOne.requestPayment({
|
|
|
822
822
|
|
|
823
823
|
### API 지원 기능
|
|
824
824
|
|
|
825
|
-
|
|
825
|
+
나이스정보통신은 API를 통해 아래 기능들을 지원합니다.
|
|
826
826
|
|
|
827
827
|
- 카드 빌링키 발급
|
|
828
828
|
- 카드 및 간편결제 빌링키 결제
|
|
@@ -836,9 +836,9 @@ PortOne.requestPayment({
|
|
|
836
836
|
### 가상계좌 발급 API 유의사항
|
|
837
837
|
|
|
838
838
|
- 고정식 가상계좌 지원합니다.
|
|
839
|
-
-
|
|
839
|
+
- 나이스정보통신의 경우 API를 통한 고정식 가상계좌 사용을 지원합니다. 고정식 가상계좌를 사용하기
|
|
840
840
|
위해서는 `virtualAccount.option.type`를 `FIXED`로 전달해야 합니다. 단, 고정식 가상계좌 및
|
|
841
|
-
과오납체크를 사용하도록
|
|
841
|
+
과오납체크를 사용하도록 나이스정보통신와 사전 협의가 필요합니다.
|
|
842
842
|
|
|
843
843
|
### 에스크로 API 유의사항
|
|
844
844
|
|
|
@@ -848,21 +848,21 @@ PortOne.requestPayment({
|
|
|
848
848
|
- 배송지 주소인 `receiver.address` 파라미터가 필수입니다.
|
|
849
849
|
|
|
850
850
|
- 이메일 전송 여부인 `sendEmail` 파라미터가 필수입니다.
|
|
851
|
-
-
|
|
851
|
+
- 나이스정보통신의 경우 다른 PG에서는 지원하지 않는 `sendEmail` 파라미터를 지원합니다.
|
|
852
852
|
- 에스크로 구매 확정시 결제 창에 입력했던 이메일로 해당 사실을 전송할지 여부. (기본값: true | boolean type)
|
|
853
853
|
|
|
854
854
|
- 배송 정보 수정 불가합니다.
|
|
855
|
-
-
|
|
855
|
+
- 나이스정보통신은 API로 에스크로 배송 정보 등록은 가능하지만 **수정은 불가능**합니다.
|
|
856
856
|
|
|
857
857
|
### 현금영수증 API 유의사항
|
|
858
858
|
|
|
859
859
|
- 결제창에서 발급 받지 못한 현금영수증은 API로 발급 불가능합니다.
|
|
860
|
-
-
|
|
860
|
+
- 나이스정보통신의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서
|
|
861
861
|
현금영수증을 발급 요청할 수 있습니다. 이때 결제 승인 단계에서 현금영수증을 발급 요청하지 못한
|
|
862
862
|
경우, 현금영수증 발급 API(`POST /cash-receipts`)를 사용한다고 하더라도 발급이 되지 않으니 참고
|
|
863
863
|
부탁드립니다.
|
|
864
864
|
|
|
865
865
|
- API로 현금영수증 발급 시, 현금영수증 카드 사용이 불가능합니다.
|
|
866
866
|
- API로 현금영수증 발급(`POST /cash-receipts`)시 발급 받을 현금영수증 정보(현금영수증 발급 유형,
|
|
867
|
-
현금영수증 발행 식별 정보)를 전달해야 합니다. 단,
|
|
867
|
+
현금영수증 발행 식별 정보)를 전달해야 합니다. 단, 나이스정보통신의 경우 **발행 식별 정보 중
|
|
868
868
|
현금영수증 카드 번호는 사용이 불가능**하오니 참고 부탁드립니다.
|