@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
|
@@ -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
|
현금영수증 카드 번호는 사용이 불가능**하오니 참고 부탁드립니다.
|
|
@@ -23,9 +23,16 @@ targetVersions:
|
|
|
23
23
|
- 해외카드 비인증 : `PLCreditCard`
|
|
24
24
|
- 해외카드 인증(3DS) : `PLCreditCardMpi`
|
|
25
25
|
- 유니온페이 : `PLUnionPay_HC`
|
|
26
|
-
- 위챗페이 PC
|
|
26
|
+
- 위챗페이 PC결제 : `WeChatPayQRCodePayment`
|
|
27
27
|
- 위챗페이 모바일결제 : `WeChatPayH5Payment`
|
|
28
28
|
- 알리페이 : `ICBAlipay`
|
|
29
|
+
- 알리페이 HK (알리페이+) : `AlipayPlusAlipayHK`
|
|
30
|
+
- BPI (알리페이+) : `AlipayPlusBPI`
|
|
31
|
+
- Dana (알리페이+) : `AlipayPlusDana`
|
|
32
|
+
- GCash (알리페이+) : `AlipayPlusGcash`
|
|
33
|
+
- Rabbit LINE Pay (알리페이+) : `AlipayPlusRabbitLinePay`
|
|
34
|
+
- Touch 'n Go (알리페이+) : `AlipayPlusTNG`
|
|
35
|
+
- TrueMoney (알리페이+) : `AlipayPlusTrueMoney`
|
|
29
36
|
|
|
30
37
|
## SDK 결제 요청하기
|
|
31
38
|
|
|
@@ -59,4 +66,4 @@ targetVersions:
|
|
|
59
66
|
- `paymentId` 에는 영문, 숫자만으로 이루어진 문자열만 입력할 수 있습니다.
|
|
60
67
|
- 페이레터의 경우 구매자 이메일을 필수로 받고있어,`customer.email`을 필수로 입력하셔야 합니다.
|
|
61
68
|
- 해외결제시 카드는 `KRW`, `USD`, `JPY`, 알리페이⋅위챗페이는 `CNY`를 지원합니다.
|
|
62
|
-
- WeChatPay, Alipay 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
|
|
69
|
+
- WeChatPay, Alipay, Alipay+ 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
|
|
@@ -289,33 +289,34 @@ STC 기능을 사용하기 위해 다음 정보를 확인해 주세요.
|
|
|
289
289
|
// 해당 파라미터들은 예시로 산업군에 따라 추가 또는 제외 가능한 파라미터들이 있습니다.
|
|
290
290
|
_({
|
|
291
291
|
additional_data: [
|
|
292
|
+
// 상점의 구매자 계정 기준으로 정보 입력
|
|
292
293
|
{
|
|
293
|
-
key: "sender_account_id", //
|
|
294
|
+
key: "sender_account_id", // 구매자 계정 ID
|
|
294
295
|
value: "A12345N343",
|
|
295
296
|
},
|
|
296
297
|
{
|
|
297
|
-
key: "sender_first_name", //
|
|
298
|
+
key: "sender_first_name", // 구매자 이름
|
|
298
299
|
value: "John",
|
|
299
300
|
},
|
|
300
301
|
{
|
|
301
|
-
key: "sender_last_name", //
|
|
302
|
+
key: "sender_last_name", // 구매자 성
|
|
302
303
|
value: "Doe",
|
|
303
304
|
},
|
|
304
305
|
{
|
|
305
|
-
key: "sender_email", //
|
|
306
|
+
key: "sender_email", // 구매자 이메일 주소
|
|
306
307
|
value: "example@example.com",
|
|
307
308
|
},
|
|
308
309
|
{
|
|
309
|
-
key: "sender_phone", //
|
|
310
|
+
key: "sender_phone", // 구매자 휴대전화 번호
|
|
310
311
|
value: "(02)16705176",
|
|
311
312
|
},
|
|
312
313
|
{
|
|
313
|
-
key: "sender_country_code", //
|
|
314
|
-
value: "KR", // ISO
|
|
314
|
+
key: "sender_country_code", // 구매자 국가 코드
|
|
315
|
+
value: "KR", // ISO 3166-2 alpha-2 코드
|
|
315
316
|
},
|
|
316
317
|
{
|
|
317
|
-
key: "sender_create_date", //
|
|
318
|
-
value: "2023-10-10T23:59:59+09:00", //
|
|
318
|
+
key: "sender_create_date", // 구매자 계정 생성 시각
|
|
319
|
+
value: "2023-10-10T23:59:59+09:00", // RFC 3339 형식
|
|
319
320
|
},
|
|
320
321
|
],
|
|
321
322
|
});
|
|
@@ -1824,7 +1825,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
|
|
|
1824
1825
|
|
|
1825
1826
|
- 안드로이드
|
|
1826
1827
|
|
|
1827
|
-
[**Android Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/android/) 가이드 문서에 따라 아래와 같이 collectAndSubmit
|
|
1828
|
+
[**Android Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/android/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야 합니다. 이때 두 번째 파라미터(`paypalClientMetaDataId`)로는 주문번호(`paymentId`)를 전달해야 합니다.
|
|
1828
1829
|
|
|
1829
1830
|
```java title="코드 예시"
|
|
1830
1831
|
MagnesResult magnesResult = MagnesSDK.getInstance()
|
|
@@ -1837,7 +1838,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
|
|
|
1837
1838
|
|
|
1838
1839
|
- iOS Switft
|
|
1839
1840
|
|
|
1840
|
-
[**iOS Swift SDK Integration**](http://developer.paypal.com/limited-release/magnes/integrate/ios-swift/) 가이드 문서에 따라 아래와 같이 collectAndSubmit
|
|
1841
|
+
[**iOS Swift SDK Integration**](http://developer.paypal.com/limited-release/magnes/integrate/ios-swift/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야합니다. 이때 첫번째 파라미터(withPayPalClientMetadataId)로는 주문번호(paymentId)를 전달해야 합니다.
|
|
1841
1842
|
|
|
1842
1843
|
```swift title="코드 예시"
|
|
1843
1844
|
let magnesResult: MagnesResult =
|
|
@@ -1849,7 +1850,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
|
|
|
1849
1850
|
|
|
1850
1851
|
- iOS Objective-C
|
|
1851
1852
|
|
|
1852
|
-
[**iOS Objective-C SDK Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/ios-objective-c/) 가이드 문서에 따라 아래와 같이 collectAndSubmitWithPayPalClientMetadataId
|
|
1853
|
+
[**iOS Objective-C SDK Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/ios-objective-c/) 가이드 문서에 따라 아래와 같이 collectAndSubmitWithPayPalClientMetadataId 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야 합니다. 이때 첫번째 파라미터(YOUR-PAYPAL-CLIENT-METADATA-ID)로는 주문번호(paymentId)를 전달해주시면 됩니다.
|
|
1853
1854
|
|
|
1854
1855
|
```objc title="코드 예시"
|
|
1855
1856
|
//PPRMOCMagnesSDK *magnesSDK = [PPRMOCMagnesSDK shared];
|
|
@@ -207,7 +207,7 @@ function requestPayment() {
|
|
|
207
207
|
|
|
208
208
|
## SDK 빌링키 발급 요청하기
|
|
209
209
|
|
|
210
|
-
빌링키 발급 요청 시에는 `
|
|
210
|
+
빌링키 발급 요청 시에는 `requestIssueBillingKey` 함수를 호출해야 합니다.
|
|
211
211
|
`channelKey`파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 스마트로 채널 사용을 명시해주세요.
|
|
212
212
|
|
|
213
213
|
스마트로 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
@@ -221,13 +221,13 @@ function requestPayment() {
|
|
|
221
221
|
|
|
222
222
|
**PC - 카드 결제 전용 파라미터**
|
|
223
223
|
|
|
224
|
-
|형식 |설명
|
|
225
|
-
|
|
226
|
-
|SKIN(색상코드) |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d)
|
|
227
|
-
|below1000 |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음
|
|
228
|
-
|paypopup |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어
|
|
229
|
-
|onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay`|
|
|
230
|
-
|SLIMQUOTA(슬림 할부 설정) |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3)
|
|
224
|
+
|형식 |설명 |
|
|
225
|
+
|---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
226
|
+
|SKIN(색상코드) |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d) |
|
|
227
|
+
|below1000 |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음 |
|
|
228
|
+
|paypopup |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어 |
|
|
229
|
+
|onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay` <br /> - 네이버페이: `npay`|
|
|
230
|
+
|SLIMQUOTA(슬림 할부 설정) |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3) |
|
|
231
231
|
|
|
232
232
|
**PC - 휴대폰 소액 결제 전용 파라미터**
|
|
233
233
|
|
|
@@ -398,6 +398,7 @@ SDK를 통한 결제 요청 파라미터에는 부가세를 지정할 수 있는
|
|
|
398
398
|
- lpay: `LPAY`
|
|
399
399
|
- 토스페이: `TOSSPAY`
|
|
400
400
|
- 페이코: `PAYCO`
|
|
401
|
+
- 네이버페이: `NAVERPAY`
|
|
401
402
|
|
|
402
403
|
</details>
|
|
403
404
|
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: 결제대행사별 연동 정보 확인하기 - 하이픈
|
|
3
|
+
targetVersions:
|
|
4
|
+
- v2
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
1. [HYPHEN PAY & 바로계좌결제 운영 백오피스](http://payadmin.hyphen.im/) 접속 후 **바로계좌결제** 선택 후
|
|
8
|
+
로그인을 합니다.
|
|
9
|
+
|
|
10
|
+
(이미지 첨부: HYPHEN 백오피스 로그인 화면)
|
|
11
|
+
|
|
12
|
+
2. \[상점관리]→\[바로계좌결제 상점정보관리]를 클릭합니다.
|
|
13
|
+
|
|
14
|
+
3. 상점명을 클릭합니다.
|
|
15
|
+
|
|
16
|
+
(이미지 첨부: HYPHEN \[상점관리] - \[상점정보관리] 예시 화면)
|
|
17
|
+
|
|
18
|
+
4. \[상점 기본정보]에서 \[상점번호]를 확인합니다.
|
|
19
|
+
|
|
20
|
+
(이미지 첨부: HYPHEN \[상점 기본정보] 예시 화면)
|
|
21
|
+
|
|
22
|
+
5. \[암호화 키, 토큰]에서 \[암호화 키]와 \[암호화 토큰]을 확인합니다.
|
|
23
|
+
|
|
24
|
+
(이미지 첨부: HYPHEN \[암호화 키, 토큰] 예시 화면)
|
|
25
|
+
|
|
26
|
+
6. 포트원 콘솔에서 채널 추가 시 \[PG상점아이디(상점 번호)], \[암호화 키], \[암호화 토큰]을
|
|
27
|
+
입력한 후 \[저장]을 클릭합니다.
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: 결제대행사별 연동 정보 확인하기 - KG이니시스
|
|
3
|
+
targetVersions:
|
|
4
|
+
- v1
|
|
5
|
+
- v2
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
|
|
9
|
+
|
|
10
|
+
<div class="hint" data-style="info">
|
|
11
|
+
|
|
12
|
+
- **INILite Key**는 정기결제 시 필수로 입력해야 합니다.
|
|
13
|
+
- **INIAPI Key**, **INIAPI IV** 하위 상점 관련 API 사용시 필수로 입력해야 합니다. [영수증 내 하위 상점 거래 등록 API 바로가기](https://developers.portone.io/api/rest-v1/partner#post%20%2Fpartners%2Freceipts%2F%7Bimp_uid%7D)
|
|
14
|
+
|
|
15
|
+
</div>
|
|
16
|
+
|
|
17
|
+
<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
|
|
18
|
+
|
|
19
|
+
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
|
|
20
|
+
|
|
21
|
+
<div class="hint" data-style="info">
|
|
22
|
+
|
|
23
|
+
크레덴셜 중 **hashKey** 는 선택사항으로, KG이니시스에서 제공하는 모바일 금액위변조 방지 기능 사용을 원하실 경우 입력하시면 됩니다.
|
|
24
|
+
|
|
25
|
+
</div>
|
|
26
|
+
|
|
27
|
+
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
|
|
28
|
+
|
|
29
|
+
1. [KG이니시스 가맹점관리자](http://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
|
|
30
|
+
|
|
31
|
+
2. \[상점정보]→\[계약정보]→\[부가정보]를 클릭합니다.
|
|
32
|
+
|
|
33
|
+
3. 아래의 크레덴셜 값들을 확인합니다. 값이 표시되지 않는 경우 생성/갱신 버튼을 클릭해 주세요.
|
|
34
|
+
|
|
35
|
+
<ul>
|
|
36
|
+
|
|
37
|
+
<li>**웹결제 signkey 생성 조회**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
|
|
38
|
+
<li>**INIAPI key 생성 갱신**의 조회 버튼을 클릭하여 \[INIAPI KEY], \[INIAPI IV] 값을 확인할 수 있습니다.</li>
|
|
39
|
+
|
|
40
|
+
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
|
|
41
|
+
|
|
42
|
+
<li>**모바일 금액위변조 HashKey**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
|
|
43
|
+
|
|
44
|
+
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
|
|
45
|
+
|
|
46
|
+
</ul>
|
|
47
|
+
|
|
48
|
+
(이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 1)
|
|
49
|
+
|
|
50
|
+
4. INILite Key의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.
|
|
51
|
+
|
|
52
|
+
(이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 2)
|
|
53
|
+
|
|
54
|
+
5. 포트원 콘솔에서 채널 추가 시 \[상점아이디]와 위 과정에서 발급받은 크레덴셜 값들을 입력한 후 `저장`을 클릭합니다.
|
|
55
|
+
|
|
56
|
+
<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
|
|
57
|
+
|
|
58
|
+
<div class="hint" data-style="warning">
|
|
59
|
+
|
|
60
|
+
포트원 V1 결제모듈을 사용하시는 경우 KG이니시스로부터 전달받은 키파일을 별도로 등록해야 합니다. 키파일 등록과 관련하여 문의사항이 있는 경우 채널톡으로 문의해주세요.
|
|
61
|
+
|
|
62
|
+
</div>
|
|
63
|
+
|
|
64
|
+
<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: 결제대행사별 연동 정보 확인하기 - NHN KCP (V2)
|
|
3
|
+
targetVersions:
|
|
4
|
+
- v2
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<div class="hint" data-style="danger">
|
|
8
|
+
|
|
9
|
+
포트원 V2에서 제공하는 KCP의 경우 **KCP의 PG-API방식**만 지원합니다. 따라서 아래와 같이 인증서 발급 후
|
|
10
|
+
사용할 수 있습니다.
|
|
11
|
+
|
|
12
|
+
해당 인증서의 경우 유효기간은 **5년**이며, 유효기간 만료 30일전부터 갱신이 가능합니다.
|
|
13
|
+
|
|
14
|
+
**서비스 인증서의 유효기간이 만료되거나 폐기된 경우** 즉시 결제 승인/취소 등 관련
|
|
15
|
+
**서비스 이용이 불가능**하오니
|
|
16
|
+
서비스 사용을 위해서 인증서를 재발급이 필요한 후 **포트원에 저장된 채널 정보를 업데이트** 해야 합니다.
|
|
17
|
+
|
|
18
|
+
</div>
|
|
19
|
+
|
|
20
|
+
1. [KCP 파트너관리자](http://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
|
|
21
|
+
|
|
22
|
+
2. \[고객센터]→\[인증센터]→\[KCP PG-API]를 클릭합니다.
|
|
23
|
+
|
|
24
|
+
(이미지 첨부: NHN KCP 파트너관리자 내 \[고객센터] - \[PG-API 인증서] 예시 화면)
|
|
25
|
+
|
|
26
|
+
3. KCP PG-API 발급 버튼을 클릭합니다.
|
|
27
|
+
|
|
28
|
+
4. 파트너 관리자 비밀번호(로그인시 입력한 비밀번호)를 입력한 후 다음을 클릭합니다.
|
|
29
|
+
|
|
30
|
+
(이미지 첨부: \[PG-API 인증서] 발급시 \[파트너 관리자 비밀번호 입력] 화면)
|
|
31
|
+
|
|
32
|
+
5. 사용할 개인키 비밀번호를 입력한 후 다음을 클릭합니다.
|
|
33
|
+
|
|
34
|
+
- 개인키 비밀번호를 분실하신 경우 확인이 불가함으로 폐기 후 재발급해야 합니다.
|
|
35
|
+
|
|
36
|
+
- 개인키를 폐기하는 즉시 기존에 사용하던 개인키와 서비스 인증서 사용이 불가능하며,
|
|
37
|
+
결제 승인/취소/조회가 불가능하오니 잘 보관하시길 바랍니다.
|
|
38
|
+
|
|
39
|
+
(이미지 첨부: \[PG-API 인증서] 발급시 \[개인키 비밀번호 등록] 화면)
|
|
40
|
+
|
|
41
|
+
6. KCP PG-API 개인키 및 서비스 인증서 발급이 완료되면 로컬에 .zip 파일이 다운로드 됩니다.
|
|
42
|
+
|
|
43
|
+
- 서비스 인증서의 유효기간은 발급일로부터 5년으로, 유효기간 만료 30일전부터 갱신이 가능합니다.
|
|
44
|
+
- 서비스 인증서의 유효기간이 만료되었거나 폐기한 경우 원활한 서비스 사용을 위해 인증서를 재발급해주세요.
|
|
45
|
+
|
|
46
|
+
(이미지 첨부: \[PG-API 인증서] 발급 완료 화면)
|
|
47
|
+
|
|
48
|
+
7. 로컬내에서 압축 풀면 `KCP_AUTH_{$사이트코드}_CERT.pem` 파일과 `KCP_AUTH_{$사이트코드}_PRIKEY.pem` 파일을 확인할 수 있습니다.
|
|
49
|
+
|
|
50
|
+
8. 포트원 콘솔에서 채널 추가 시 \[MID(사이트코드)], \[PG-API 인증서키], \[PG-API 개인키], \[개인키 비밀번호]를
|
|
51
|
+
입력한 후 저장을 클릭합니다.
|
|
52
|
+
|
|
53
|
+
9. 정기결제를 이용하시는 경우, 아래 절차를 진행해주세요.
|
|
54
|
+
|
|
55
|
+
1. [KCP 파트너관리자](http://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
|
|
56
|
+
2. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
|
|
57
|
+
3. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
|
|
58
|
+
4. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
|
|
59
|
+
5. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
|
|
60
|
+
6. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
|
|
61
|
+
|
|
62
|
+
(이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
|
|
63
|
+
|
|
64
|
+
7. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
|
|
65
|
+
8. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
|
|
66
|
+
|
|
67
|
+
(이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
|
|
68
|
+
|
|
69
|
+
9. 포트원 콘솔에서 채널 추가 시 앞서 발급한 \[MID(사이트코드)], \[PG-API 인증서키], \[PG-API 개인키],
|
|
70
|
+
\[개인키 비밀번호], \[정기자동결제 그룹아이디]를 입력한 후 \[저장]을 클릭합니다.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: 결제대행사별 연동 정보 확인하기 - 페이팔 (V2)
|
|
3
|
+
targetVersions:
|
|
4
|
+
- v2
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
1. [페이팔](http://www.paypal.com/) 접속 후 로그인을 합니다.
|
|
8
|
+
|
|
9
|
+
2. \[Account settings]-\[Business information]을 클릭합니다.
|
|
10
|
+
|
|
11
|
+
(이미지 첨부: 페이팔 페이지 내 PayPal Merchant ID 조회 화면)
|
|
12
|
+
|
|
13
|
+
3. 포트원 콘솔에서 채널 추가 시 \[PayPal Merchant ID]를 입력한 후 `저장`을 클릭합니다.
|
|
14
|
+
|
|
15
|
+
<div class="hint" data-style="info">
|
|
16
|
+
|
|
17
|
+
- 포트원에서 제공하는 페이팔 테스트용 계정으로 채널을 추가하신 경우, 테스트 결제 시 테스트용 구매자 계정을 이용하여 결제를 진행해야합니다.
|
|
18
|
+
[→ 테스트용 계정생성 바로가기](http://developer.paypal.com/dashboard/accounts)
|
|
19
|
+
|
|
20
|
+
- 판매자와 구매자 계정 국가가 모두 한국인 경우 페이팔 정책상 결제가 불가능합니다.
|
|
21
|
+
따라서 테스트용 구매자 계정 생성 시 Sandbox Accounts의 Country가 US인 Personal(구매자) 계정으로 생성하여 테스트를 해야합니다.
|
|
22
|
+
|
|
23
|
+
- 테스트 계정으로 결제 시 테스트용 카드정보를 참고하여 결제를 진행해야 합니다. [→ 테스트용 카드정보 바로가기](http://developer.paypal.com/api/rest/sandbox/card-testing/#link-creditcardgeneratorfortesting)
|
|
24
|
+
|
|
25
|
+
</div>
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: 결제대행사별 연동 정보 확인하기 - 토스페이먼츠 (신모듈)
|
|
3
|
+
targetVersions:
|
|
4
|
+
- v1
|
|
5
|
+
- v2
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
1. [토스페이먼츠 개발자센터](http://developers.tosspayments.com/) 접속 후 로그인을 합니다.
|
|
9
|
+
2. \[내 개발정보]를 클릭합니다.
|
|
10
|
+
3. \[API키] 메뉴에서 \[상점아이디(MID)]와 \[클라이언트키], \[시크릿키]를 확인합니다.
|
|
11
|
+
4. API 버전은 `2022-07-27`로 설정해야합니다.
|
|
12
|
+
|
|
13
|
+
(이미지 첨부: 토스페이먼츠 개발자센터 내 API 키 조회 화면)
|
|
14
|
+
|
|
15
|
+
5. 포트원 콘솔에서 채널 추가 시 \[상점아이디(MID)]와 \[클라이언트키], \[시크릿키]를 입력한 후 `저장`을 클릭합니다.
|