@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
|
@@ -346,40 +346,6 @@ IMP.request_pay({
|
|
|
346
346
|
|
|
347
347
|
<details>
|
|
348
348
|
|
|
349
|
-
<summary>휴대폰 소액결제시 `buyer_name`과 `bypass.shop_user_id` 파라미터를 필수 입력해야합니다.</summary>
|
|
350
|
-
|
|
351
|
-
결제수단 중 휴대폰 소액결제를 요청하는 경우 구매자 이름(`buyer_name`)과 고객사에서 관리하는 회원ID(`bypass.shop_user_id`)를 필수로 입력해야 합니다.
|
|
352
|
-
|
|
353
|
-
<div class="tabs-container">
|
|
354
|
-
|
|
355
|
-
<div class="tabs-content" data-title="휴대폰 소액결제 호출 예제">
|
|
356
|
-
|
|
357
|
-
```ts
|
|
358
|
-
IMP.request_pay({
|
|
359
|
-
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
360
|
-
pay_method: "phone", //휴대폰 소액결제
|
|
361
|
-
merchant_uid: "A00021-TEST",
|
|
362
|
-
name: "당근 10kg",
|
|
363
|
-
amount: 1004,
|
|
364
|
-
buyer_email: "test@portone.io",
|
|
365
|
-
buyer_name: "포트원 기술지원팀", // 휴대폰 결제시 필수
|
|
366
|
-
buyer_tel: "010-1234-5678",
|
|
367
|
-
buyer_addr: "서울특별시 강남구 삼성동",
|
|
368
|
-
buyer_postcode: "123-456",
|
|
369
|
-
bypass: {
|
|
370
|
-
shop_user_id: "abaddd", // 고객사 회원 id 입력 (휴대폰 결제시 필수)
|
|
371
|
-
},
|
|
372
|
-
});
|
|
373
|
-
```
|
|
374
|
-
|
|
375
|
-
</div>
|
|
376
|
-
|
|
377
|
-
</div>
|
|
378
|
-
|
|
379
|
-
</details>
|
|
380
|
-
|
|
381
|
-
<details>
|
|
382
|
-
|
|
383
349
|
<summary>휴대폰 소액결제 시 전화번호를 고정할 수 있습니다.</summary>
|
|
384
350
|
|
|
385
351
|
`prefill.phoneNumber` 파라미터에 고정할 휴대폰 번호를 입력한 후 결제를 요청합니다.
|
|
@@ -701,7 +667,7 @@ IMP.request_pay(
|
|
|
701
667
|
kcpQuick: {
|
|
702
668
|
//KCP퀵페이 설정 정보
|
|
703
669
|
actionType: "Register", //결제수단 등록
|
|
704
|
-
|
|
670
|
+
memberCI: "djkDFJ45dFndkl", //본인인증 후 전달된 CI 값
|
|
705
671
|
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
706
672
|
},
|
|
707
673
|
},
|
|
@@ -736,7 +702,7 @@ IMP.request_pay(
|
|
|
736
702
|
kcpQuick: {
|
|
737
703
|
//KCP퀵페이 설정 정보
|
|
738
704
|
actionType: "Deregister", //결제수단 삭제
|
|
739
|
-
|
|
705
|
+
memberCI: "djkDFJ45dFndkl", //결제수단 등록시 입력한 CI 값
|
|
740
706
|
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
741
707
|
},
|
|
742
708
|
},
|
|
@@ -775,7 +741,7 @@ IMP.request_pay(
|
|
|
775
741
|
kcpQuick: {
|
|
776
742
|
//KCP퀵페이 설정 정보
|
|
777
743
|
actionType: "Pay", //결제 요청
|
|
778
|
-
|
|
744
|
+
memberCI: "djkDFJ45dFndkl", //결제수단 등록시 입력한 CI 값
|
|
779
745
|
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
780
746
|
},
|
|
781
747
|
},
|
|
@@ -814,7 +780,7 @@ IMP.request_pay(
|
|
|
814
780
|
kcpQuick: {
|
|
815
781
|
//KCP퀵페이 설정 정보
|
|
816
782
|
actionType: "PinChange", //PIN번호 변경
|
|
817
|
-
|
|
783
|
+
memberCI: "djkDFJ45dFndkl", //결제수단 등록시 입력한 CI 값
|
|
818
784
|
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
819
785
|
},
|
|
820
786
|
},
|
|
@@ -849,7 +815,7 @@ IMP.request_pay(
|
|
|
849
815
|
kcpQuick: {
|
|
850
816
|
//KCP퀵페이 설정 정보
|
|
851
817
|
actionType: "PinReset", //PIN번호 초기화
|
|
852
|
-
|
|
818
|
+
memberCI: "djkDFJ45dFndkl", //결제수단 등록시 입력한 CI 값
|
|
853
819
|
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
854
820
|
},
|
|
855
821
|
},
|
|
@@ -888,7 +854,7 @@ IMP.request_pay(
|
|
|
888
854
|
kcpQuick: {
|
|
889
855
|
//KCP퀵페이 설정 정보
|
|
890
856
|
actionType: "PhoneChange", //등록된 휴대폰 번호 변경
|
|
891
|
-
|
|
857
|
+
memberCI: "djkDFJ45dFndkl", //본인인증 후 전달된 CI 값
|
|
892
858
|
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
893
859
|
},
|
|
894
860
|
},
|
|
@@ -927,7 +893,7 @@ IMP.request_pay(
|
|
|
927
893
|
kcpQuick: {
|
|
928
894
|
//KCP퀵페이 설정 정보
|
|
929
895
|
actionType: "Terminate", //유저 및 결제수단 삭제
|
|
930
|
-
|
|
896
|
+
memberCI: "djkDFJ45dFndkl", //본인인증 후 전달된 CI 값
|
|
931
897
|
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
932
898
|
},
|
|
933
899
|
},
|
|
@@ -1031,9 +997,9 @@ IMP.request_pay(
|
|
|
1031
997
|
- PhoneChange : 전화번호 변경
|
|
1032
998
|
- Terminate : 결제 수단 해지
|
|
1033
999
|
|
|
1034
|
-
-
|
|
1000
|
+
- memberCI: string
|
|
1035
1001
|
|
|
1036
|
-
|
|
1002
|
+
**본인인증 CI값**
|
|
1037
1003
|
|
|
1038
1004
|
- memberID: string
|
|
1039
1005
|
|
|
@@ -1085,33 +1051,6 @@ IMP.request_pay(
|
|
|
1085
1051
|
|
|
1086
1052
|
<details>
|
|
1087
1053
|
|
|
1088
|
-
<summary>`encryptedCI` 파라미터 안내</summary>
|
|
1089
|
-
|
|
1090
|
-
본인인증 후 전달받은 CI 값을 아래 방법으로 암호화하여 입력해야합니다.
|
|
1091
|
-
|
|
1092
|
-
포트원 계정의 [REST API Secret](https://developers.portone.io/api/rest-v1/auth?v=v1) 을 SHA-256 해시 알고리즘으로 처리하여 암호화 키를 생성한 후, 해당 키를 사용해 CI 데이터를 AES-256-ECB 방식으로 암호화해야 합니다.
|
|
1093
|
-
암호화된 결과는 Base64로 인코딩하여 encryptedCI 파라미터 값으로 전달합니다.
|
|
1094
|
-
|
|
1095
|
-
```pseudo
|
|
1096
|
-
FUNCTION encryptCi(ci, apiSecret):
|
|
1097
|
-
# Step 1: SHA-256으로 API Secret을 해시하여 암호화 키 생성
|
|
1098
|
-
key = SHA256(apiSecret)
|
|
1099
|
-
|
|
1100
|
-
# Step 2: AES-256-ECB 알고리즘으로 CI 데이터를 암호화
|
|
1101
|
-
encryptedData = AES256Encrypt(data = ci, key = key, mode = ECB)
|
|
1102
|
-
|
|
1103
|
-
# Step 3: 암호화된 데이터를 Base64로 인코딩
|
|
1104
|
-
base64EncodedData = Base64Encode(encryptedData)
|
|
1105
|
-
|
|
1106
|
-
# Step 4: Base64 인코딩된 결과 반환
|
|
1107
|
-
RETURN base64EncodedData
|
|
1108
|
-
END FUNCTION
|
|
1109
|
-
```
|
|
1110
|
-
|
|
1111
|
-
</details>
|
|
1112
|
-
|
|
1113
|
-
<details>
|
|
1114
|
-
|
|
1115
1054
|
<summary>결제수단을 여러개 등록할 수 있습니다.</summary>
|
|
1116
1055
|
|
|
1117
1056
|
한 고객에게 여러개의 결제수단을 등록할 수 있습니다.
|
|
@@ -1124,7 +1063,7 @@ END FUNCTION
|
|
|
1124
1063
|
|
|
1125
1064
|
<summary>결제수단 삭제 요청시 등록할 때 입력한 정보를 동일하게 입력해야 합니다.</summary>
|
|
1126
1065
|
|
|
1127
|
-
결제수단 삭제(actionType:Deregister) 요청시 결제수단 등록할 때 사용된 `customer_uid` + `
|
|
1066
|
+
결제수단 삭제(actionType:Deregister) 요청시 결제수단 등록할 때 사용된 `customer_uid` + `memberCI` + `memberID` + `deviceID` + `noAuth` 조합을
|
|
1128
1067
|
동일하게 전송해야 합니다.
|
|
1129
1068
|
|
|
1130
1069
|
</details>
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: 빌링키 발급 / API 연동 유의사항
|
|
3
|
-
description: (신)
|
|
3
|
+
description: (신)나이스정보통신 비인증 결제 연동 유의사항을 소개합니다.
|
|
4
4
|
targetVersions:
|
|
5
5
|
- v1
|
|
6
6
|
---
|
|
@@ -22,7 +22,7 @@ targetVersions:
|
|
|
22
22
|
|
|
23
23
|
## 비인증 결제
|
|
24
24
|
|
|
25
|
-
(신)
|
|
25
|
+
(신) 나이스정보통신은 발급 된 빌링키로 재결제(`POST /subscribe/payemnts/again`),
|
|
26
26
|
키인 결제(`POST /subscribe/payments/onetime`) 그리고 스케줄 결제(`POST /subscribe/payments/schedule`)를
|
|
27
27
|
모두 지원하며 기본 파라미터 외에 아래 3개의 파라미터를 추가로 지원합니다.
|
|
28
28
|
|
|
@@ -30,9 +30,9 @@ targetVersions:
|
|
|
30
30
|
|
|
31
31
|
|파라미터 |데이터 타입 |의미 |
|
|
32
32
|
|-----------------------------|----------------------|---------------------------------------------------------------------------------------------------|
|
|
33
|
-
|vat\_amount |double |총 결제 금액 중 부가세 금액. 부가세 직접 입력 방식을 위해 사용. 단,
|
|
34
|
-
|intereset\_free\_by\_merchant|boolean(기본값: false)|상점 부담 무이자 할부 적용 여부. 단,
|
|
35
|
-
|use\_card\_point |boolean(기본값: false)|카드사 포인트 사용 여부. 단,
|
|
33
|
+
|vat\_amount |double |총 결제 금액 중 부가세 금액. 부가세 직접 입력 방식을 위해 사용. 단, 나이스정보통신와 사전 협의 필요|
|
|
34
|
+
|intereset\_free\_by\_merchant|boolean(기본값: false)|상점 부담 무이자 할부 적용 여부. 단, 나이스정보통신와 사전 협의 필요 |
|
|
35
|
+
|use\_card\_point |boolean(기본값: false)|카드사 포인트 사용 여부. 단, 나이스정보통신와 사전 협의 필요 |
|
|
36
36
|
|
|
37
37
|
## 가상계좌
|
|
38
38
|
|
|
@@ -42,12 +42,12 @@ targetVersions:
|
|
|
42
42
|
|------------------------------|-----------|-----------------------|
|
|
43
43
|
|business\_registration\_number|string |구매자 사업자 등록 번호|
|
|
44
44
|
|
|
45
|
-
(신)
|
|
45
|
+
(신) 나이스정보통신의 경우 API를 통한 가상 계좌 발급 시, 향후 해당 거래 건을 에스크로 배송 정보로 등록할 때
|
|
46
46
|
사용될 구매자의 사업자 번호를 `business_registration_number` 파라미터로 입력받고 있습니다.
|
|
47
47
|
|
|
48
48
|
### API로 가상계좌 채번은 가능하나 발급된 가상계좌 정보는 수정 불가능
|
|
49
49
|
|
|
50
|
-
(신)
|
|
50
|
+
(신) 나이스정보통신은 `POST /vbanks` API로 가상 계좌를 채번 할 수 있지만 `PUT /vbanks` API로
|
|
51
51
|
**이미 채번 된 가상계좌 정보(입금 기한, 입금 금액)를 수정할 수 없습니다.**
|
|
52
52
|
|
|
53
53
|
## 에스크로 결제
|
|
@@ -58,20 +58,20 @@ targetVersions:
|
|
|
58
58
|
|-----------|-----------|-----------------------------------------------------------------------------------------|
|
|
59
59
|
|send\_email|boolean |에스크로 구매 확정시 결제 창에 입력했던 이메일로 해당 사실을 전송할지 여부 (기본값: true)|
|
|
60
60
|
|
|
61
|
-
(신)
|
|
61
|
+
(신) 나이스정보통신의 경우 에스크로 결제건에 대해 배송 정보 등록 API 호출 시 `send_email` 파라미터를
|
|
62
62
|
이용하여 구매 확정됐을 때 결제창에 입력한 이메일로 구매 확정 내용을 전송할지 여부를 제어할 수 있습니다.
|
|
63
63
|
기본 값은 true(구매 확정 여부 이메일 전송)이며 false로 입력 시 구매가 확정되어도 이메일로 안내되지 않습니다.
|
|
64
64
|
|
|
65
65
|
### 배송 정보 수정 불가
|
|
66
66
|
|
|
67
|
-
(신)
|
|
67
|
+
(신) 나이스정보통신은 `POST /escrow/logis/{imp_uid}` API로 에스크로 배송 정보 등록은 가능하지만
|
|
68
68
|
`PUT /escrow/logis/{imp_uid}` API로 **수정은 불가능**합니다.
|
|
69
69
|
|
|
70
70
|
## 현금영수증
|
|
71
71
|
|
|
72
72
|
### 결제창에서 발급 받지 못한 현금영수증은 API로 발급 불가능
|
|
73
73
|
|
|
74
|
-
(신)
|
|
74
|
+
(신) 나이스정보통신의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서
|
|
75
75
|
현금영수증을 발급 요청할 수 있습니다. 이때 결제 승인 단계에서 현금영수증을 발급 요청하지 못한 경우,
|
|
76
76
|
현금영수증 발급 API(`POST /receipts/{imp_uid}`)를 사용한다고 하더라도 발급이 되지 않으니 참고 부탁드립니다.
|
|
77
77
|
|
|
@@ -79,7 +79,7 @@ targetVersions:
|
|
|
79
79
|
|
|
80
80
|
API로 현금영수증 발급(`POST /receipts/{imp_uid}`)시 발급 받을 현금영수증 정보(현금영수증 발급 유형,
|
|
81
81
|
현금영수증 발행 식별 정보, 현금영수증 발행 식별 정보 유형)를 전달해야 합니다.
|
|
82
|
-
단, (신)
|
|
82
|
+
단, (신) 나이스정보통신의 경우 **현금영수증 카드 번호로 현금영수증 발급이 불가능**하오니 참고 부탁드립니다.
|
|
83
83
|
|
|
84
84
|
<details>
|
|
85
85
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: 일반결제 연동 유의사항
|
|
3
|
-
description:
|
|
3
|
+
description: 나이스정보통신(신모듈) 일반결제 연동 유의사항을 소개합니다.
|
|
4
4
|
targetVersions:
|
|
5
5
|
- v1
|
|
6
6
|
---
|
|
@@ -25,11 +25,11 @@ PG사로부터 정확한 사유를 전달받지 못하기 때문에 다음과
|
|
|
25
25
|
|
|
26
26
|
### 토스뱅크 카드사 다이렉트 호출 미지원
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
나이스정보통신(신모듈)의 경우 토스뱅크 카드(card.direct.code = "092") 다이렉트 호출이 불가능합니다.
|
|
29
29
|
|
|
30
30
|
### 카드사 다이렉트 호출시 고정 할부 개월수 필수 입력
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
나이스정보통신(신모듈)는 **카드사 다이렉트 호출시
|
|
33
33
|
고정 할부 개월수를 <span style="color:red"> 필수 </span>로 입력**해야 합니다.
|
|
34
34
|
결제 금액이 할부 지원 금액 미만(일반적으로 50,000원 이상 결제 시 할부 기능을 지원하나
|
|
35
35
|
카드사에 따라 다를 수 있습니다.)인 경우 **할부 개월수를 0(일시불)으로 전달**해야 합니다.
|
|
@@ -84,7 +84,7 @@ IMP.request_pay(
|
|
|
84
84
|
|
|
85
85
|
### 모바일 환경에서는 다이렉트 호출시에만 할부 옵션 설정 가능
|
|
86
86
|
|
|
87
|
-
|
|
87
|
+
나이스정보통신(신모듈)의 경우 일반 카드 결제 시(간편결제 제외) 할부 옵션(고정 할부 개월수)사용이 가능하나
|
|
88
88
|
**모바일 환경**에서는 **카드사 다이렉트 호출할 때만 할부 옵션 사용이 가능합니다.** 만약 모바일 환경에서 다이렉트 호출 코드 없이
|
|
89
89
|
할부 옵션을 전달하는 경우 무시됩니다.
|
|
90
90
|
|
|
@@ -132,7 +132,7 @@ IMP.request_pay(
|
|
|
132
132
|
|
|
133
133
|
### 가상계좌 입금 기한(`vbank_due`) 필수 입력
|
|
134
134
|
|
|
135
|
-
|
|
135
|
+
나이스정보통신(신모듈) 가상 계좌 발급 시, 입금 기한은 필수 입력해야 하며 아래 4가지 형식만 유효합니다.
|
|
136
136
|
입금 기한을 입력하지 않거나, 유효하지 않은 형식을 입력할 경우 가상계좌 발급 결제창이 호출되지 않고 "결제 창 호출에 실패하였습니다.
|
|
137
137
|
나이스페이 V2 가상계좌 발급시 유효한 입금 기한을 필수로 입력해야 합니다." 라는 에러 메세지가 리턴되오니 유의하시기 바랍니다.
|
|
138
138
|
|
|
@@ -145,17 +145,17 @@ IMP.request_pay(
|
|
|
145
145
|
|
|
146
146
|
### 계좌이체 다이렉트 호출시 은행 코드 지정 불가능
|
|
147
147
|
|
|
148
|
-
|
|
148
|
+
나이스정보통신(신모듈) 계좌이체 다이렉트 호출은 은행 코드를 지정하지 않고 바로 뱅크페이 결제창이 띄워지는 구조입니다.
|
|
149
149
|
|
|
150
150
|
### 계좌이체 다이렉트 호출시 현금영수증 정보는 필수 입력
|
|
151
151
|
|
|
152
152
|
계좌이체 거래는 계좌에서 현금성 결제로 현금영수증 발급이 가능하므로 현금영수증 정보를 필수로 입력해야 합니다.
|
|
153
|
-
만약 입력하지 않을 경우
|
|
153
|
+
만약 입력하지 않을 경우 나이스정보통신(신모듈) 계좌이체 다이렉트 호출 시 **현금영수증 발급 유형은 필수 입력**입니다.
|
|
154
154
|
라는 에러 메시지가 뜨면서 결제창이 호출되지 않으니 유의하시기 바랍니다.
|
|
155
155
|
|
|
156
156
|
### 계좌이체 에스크로 결제시에는 다이렉트 호출 불가능
|
|
157
157
|
|
|
158
|
-
|
|
158
|
+
나이스정보통신 정책상 계좌이체 + 에스크로 결제시에는 다이렉트 호출이 불가능합니다.
|
|
159
159
|
아래와 같이 계좌이체 + 에스크로 + 다이렉트 호출을 위한 파라미터를 설정할 경우
|
|
160
160
|
"나이스페이 V2 계좌이체 에스크로 결제시 다이렉트 호출은 불가능합니다."라는 에러 메시지가 뜨면서
|
|
161
161
|
결제창이 호출되지 않으니 유의하시기 바랍니다.
|
|
@@ -163,7 +163,7 @@ IMP.request_pay(
|
|
|
163
163
|
### 계좌이체 에스크로 결제시 결제창에 올바른 이메일을 입력해야 함
|
|
164
164
|
|
|
165
165
|
존재하지 않는 이메일을 입력할 경우 **이메일 주소 오류**라는 에러 메시지와 함께 승인에 실패합니다.
|
|
166
|
-
또한 실제로 존재하는 이메일 도메인이더라도
|
|
166
|
+
또한 실제로 존재하는 이메일 도메인이더라도 나이스정보통신 정책상 유효하지 않다고 취급하는
|
|
167
167
|
이메일 주소(예: .finance로 끝나는 이메일 주소)를 입력한 경우 승인은 정상적으로 되지만
|
|
168
168
|
**이후 API로 에스크로 등록시 에스크로 구매 확정 이메일이 전송되지 않습니다.**
|
|
169
169
|
|
|
@@ -207,15 +207,15 @@ IMP.request_pay(
|
|
|
207
207
|
|
|
208
208
|
### 컬쳐랜드(`cultureland`)만 지원
|
|
209
209
|
|
|
210
|
-
|
|
210
|
+
나이스정보통신(신모듈)은 상품권 결제시 컬쳐랜드만 지원하며 북앤라이프, 스마트문상 등은 지원하지 않습니다.
|
|
211
211
|
|
|
212
212
|
### MallUserID(`bypass.nice_v2.MallUserID`)는 필수 입력
|
|
213
213
|
|
|
214
|
-
|
|
214
|
+
나이스정보통신(신모듈) 상품권 결제시 고객사 구매자 ID를 의미하는 MalluserID는 필수 입력이며, bypass 파라미터로 전달할 수 있습니다.
|
|
215
215
|
|
|
216
|
-
### 승인 완료시
|
|
216
|
+
### 승인 완료시 나이스정보통신로부터 승인번호(`apply_num`)가 전달되지 않음
|
|
217
217
|
|
|
218
|
-
|
|
218
|
+
나이스정보통신(신모듈)은 상품권 결제시에는 승인 번호를 전달하지 않아 승인번호 확인이 어렵습니다.
|
|
219
219
|
따라서 결제 내역 조회시 승인 번호는 null로 리턴됩니다.
|
|
220
220
|
|
|
221
221
|
<details>
|
|
@@ -260,7 +260,7 @@ GET /payments/{imp_uid}
|
|
|
260
260
|
|
|
261
261
|
### 결제 수단 지정 시 카드 또는 포인트 지정 필요
|
|
262
262
|
|
|
263
|
-
|
|
263
|
+
나이스정보통신(신모듈)를 통한 네이버페이 결제 시 카드 또는 포인트 결제를 지정하여 호출해야합니다.
|
|
264
264
|
결제 수단(`pay_method`) 파라미터에 `naverpay` 입력은 불가능하며 `naverpay_card`(카드)
|
|
265
265
|
또는 `naverpay_point`(포인트/머니) 둘 중 하나로 입력해야 정상적으로 결제창이 호출되오니 유의하시기 바랍니다.
|
|
266
266
|
|
|
@@ -345,9 +345,9 @@ IMP.request_pay({
|
|
|
345
345
|
### SSGPAY 은행 계좌 결제시 현금영수증 발급 정보를 확인할 수 없음
|
|
346
346
|
|
|
347
347
|
SSGPAY 은행 계좌 결제 시 현금영수증 발급 정보를 입력하여 정상적으로 발급되더라도
|
|
348
|
-
승인 완료(status: paid)시
|
|
348
|
+
승인 완료(status: paid)시 나이스정보통신에서 현금영수증 발급 정보를 전달하지 않아
|
|
349
349
|
포트원 API로 결제/현금영수증 발급 내역 조회 또는 포트원 콘솔에서 현금영수증 내역을 확인할 수 없습니다.
|
|
350
|
-
단,
|
|
350
|
+
단, 나이스정보통신 어드민에서는 확인이 가능합니다.
|
|
351
351
|
|
|
352
352
|
<details>
|
|
353
353
|
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
---
|
|
2
|
-
title:
|
|
3
|
-
description:
|
|
2
|
+
title: 나이스정보통신 (신모듈)
|
|
3
|
+
description: 나이스정보통신 연동 방법을 안내합니다.
|
|
4
4
|
targetVersions:
|
|
5
5
|
- v1
|
|
6
6
|
versionVariants:
|
|
7
7
|
v2: /opi/ko/integration/pg/v2/nice-v2
|
|
8
8
|
---
|
|
9
9
|
|
|
10
|
-
## 1.
|
|
10
|
+
## 1. 나이스정보통신(신모듈) 채널 설정하기
|
|
11
11
|
|
|
12
12
|
[결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
|
|
13
13
|
|
|
14
|
-
아래 기능을 사용하시려면
|
|
14
|
+
아래 기능을 사용하시려면 나이스정보통신에 사전 신청 후 계약이 완료되어야 합니다.
|
|
15
15
|
그렇지 않은 상태에서 해당 기능 이용시 PG창 호출에 실패하거나, 승인에 실패하거나,
|
|
16
16
|
승인에 성공하더라도 의도한 바와는 다른 응답을 얻게 될 수 있으니 주의 해주시기 바랍니다.
|
|
17
17
|
|
|
@@ -42,7 +42,7 @@ versionVariants:
|
|
|
42
42
|
|
|
43
43
|
## 2. 최신 JavaScript SDK로 업데이트하기 <a href="#2." id="2." />
|
|
44
44
|
|
|
45
|
-
|
|
45
|
+
나이스정보통신(신모듈) 결제는 최신 SDK에서만 지원되는 기능입니다.
|
|
46
46
|
|
|
47
47
|
```html title="JS SDK"
|
|
48
48
|
<script src="https://cdn.iamport.kr/v1/iamport.js"></script>
|
|
@@ -50,7 +50,7 @@ versionVariants:
|
|
|
50
50
|
|
|
51
51
|
<div class="hint" data-style="info">
|
|
52
52
|
|
|
53
|
-
**(신)
|
|
53
|
+
**(신) 나이스정보통신를 연동하기 위해서는 위에 안내된 JS SDK를 이용하셔야 합니다**
|
|
54
54
|
|
|
55
55
|
</div>
|
|
56
56
|
|
|
@@ -76,7 +76,7 @@ versionVariants:
|
|
|
76
76
|
## 3.결제 요청하기
|
|
77
77
|
|
|
78
78
|
[JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
|
|
79
|
-
(신)
|
|
79
|
+
(신) 나이스정보통신 결제창을 호출할 수 있습니다. **결제 결과**는 PC의 경우 `IMP.request_pay(param,
|
|
80
80
|
callback)` 호출 후 **callback**으로 수신되고 모바일의 경우
|
|
81
81
|
**m\_redirect\_url** 로 리디렉션됩니다.
|
|
82
82
|
|
|
@@ -189,7 +189,7 @@ IMP.request_pay(
|
|
|
189
189
|
|
|
190
190
|
**가상계좌 입금기한 (YYYY-MM-DD)**
|
|
191
191
|
|
|
192
|
-
(신)
|
|
192
|
+
(신) 나이스정보통신의 경우 필수 입력이며 날짜는 무조건 23:59:59로 설정 됨
|
|
193
193
|
|
|
194
194
|
- escrow: boolean
|
|
195
195
|
|
|
@@ -241,6 +241,8 @@ IMP.request_pay(
|
|
|
241
241
|
|
|
242
242
|
<div class="tabs-content" data-title="비인증 결제창 요청">
|
|
243
243
|
|
|
244
|
+
(신) 나이스정보통신의 경우 비인증 결제창 방식은 간편결제(네이버페이 / 카카오페이)만 지원합니다.
|
|
245
|
+
|
|
244
246
|
```ts title="Javascript SDK"
|
|
245
247
|
IMP.request_pay(
|
|
246
248
|
{
|
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
---
|
|
2
|
-
title: (구)
|
|
3
|
-
description: (구)
|
|
2
|
+
title: (구) 나이스정보통신
|
|
3
|
+
description: (구) 나이스정보통신 결제창 연동 가이드를 안내합니다.
|
|
4
4
|
targetVersions:
|
|
5
5
|
- v1
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
<div class="hint" data-style="warning">
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
**나이스정보통신(구모듈) 연동 방법에 관한 매뉴얼**입니다.
|
|
11
11
|
|
|
12
|
-
신규 연동 고객사이시거나
|
|
12
|
+
신규 연동 고객사이시거나 나이스정보통신 신모듈로 업그레이드를 원하신다면 [나이스정보통신(신모듈) 연동 가이드](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme)를 참고하여 진행해주세요.
|
|
13
13
|
구모듈에 비해 신모듈에서 다양한 기능 및 결제수단을 지원하고 있습니다. 신규 고객사의 경우 가급적 신모듈로 연동하는 것을 권장드립니다.
|
|
14
14
|
|
|
15
15
|
</div>
|
|
16
16
|
|
|
17
|
-
## 1.
|
|
17
|
+
## 1. 나이스정보통신 채널 설정하기
|
|
18
18
|
|
|
19
19
|
[결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
|
|
20
20
|
|
|
@@ -179,7 +179,7 @@ curl -H "Content-Type: application/json" \
|
|
|
179
179
|
|
|
180
180
|
<div class="hint" data-style="info">
|
|
181
181
|
|
|
182
|
-
|
|
182
|
+
**나이스정보통신은 비인증 결제는 API 방식으로만 지원됩니다.**
|
|
183
183
|
|
|
184
184
|
비인증 결제를 연동하기 위해서는 카드정보를 획득할수 있는 UI를 구성해 주셔야 하며
|
|
185
185
|
해당 가이드는 [**비인증결제 연동하기**](https://developers.portone.io/opi/ko/integration/start/v1/non-auth)에서 확인해주시면 됩니다.
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: 페이레터 해외결제
|
|
3
|
+
description: 페이레터 해외결제 연동 방법을 안내합니다.
|
|
4
|
+
targetVersions:
|
|
5
|
+
- v1
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## 채널 설정하기
|
|
9
|
+
|
|
10
|
+
- [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기)의 페이레터 해외결제 채널 설정 내용을 참고하여 채널 설정을 진행합니다.
|
|
11
|
+
|
|
12
|
+
## 가능한 결제 수단
|
|
13
|
+
|
|
14
|
+
- **결제창 일반 결제**
|
|
15
|
+
|
|
16
|
+
페이레터의 경우, `pay_method` 파라미터를 지원하고 있지 않아,
|
|
17
|
+
계약된 모든 결제 수단이 페이레터 결제창에 노출됩니다.
|
|
18
|
+
|
|
19
|
+
특정 결제 수단만 노출하고 싶으신 경우, 아래에 후술될 `bypass.payletter_global.pginfo` 파라미터를 사용하시면 됩니다.
|
|
20
|
+
|
|
21
|
+
- **일반 결제**
|
|
22
|
+
- 특정 결제 수단만 결제창에 표기하고 싶으신 경우, `bypass.payletter_global.pginfo` 파라미터를 결제수단에 따라 아래와 같이 설정하시면 됩니다.
|
|
23
|
+
- 해외카드 비인증 : `PLCreditCard`
|
|
24
|
+
- 해외카드 인증(3DS) : `PLCreditCardMpi`
|
|
25
|
+
- 유니온페이 : `PLUnionPay_HC`
|
|
26
|
+
- 위챗페이 PC결제: `WeChatPayQRCodePayment`
|
|
27
|
+
- 위챗페이 모바일결제 : `WeChatPayH5Payment`
|
|
28
|
+
- 알리페이 : `ICBAlipay`
|
|
29
|
+
|
|
30
|
+
## SDK 결제 요청하기
|
|
31
|
+
|
|
32
|
+
결제 요청 시에는 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출해야 합니다.
|
|
33
|
+
|
|
34
|
+
## 가능한 빌링키 발급 및 결제 수단
|
|
35
|
+
|
|
36
|
+
- **빌링키 발급 및 결제**
|
|
37
|
+
|
|
38
|
+
페이레터의 경우, `pay_method` 파라미터를 지원하고 있지 않아,
|
|
39
|
+
계약된 모든 빌링키 발급 및 결제 수단이 페이레터 결제창에 노출됩니다.
|
|
40
|
+
특정 결제 수단만 노출하고 싶으신 경우, 아래에 후술될 `bypass.payletter_global.pginfo` 파라미터를 사용하시면 됩니다.
|
|
41
|
+
|
|
42
|
+
- **가능한 빌링키 발급 및 결제 수단**
|
|
43
|
+
- 특정 빌링키 발급 및 결제 수단만 결제창에 표기하고 싶으신 경우, `bypass.payletter_global.pginfo` 파라미터를 결제 수단에 따라 아래와 같이 설정하시면 됩니다.
|
|
44
|
+
|
|
45
|
+
- 빌링키 발급 및 결제의 경우, 위챗, 알리페이 등의 간편결제 수단으로 발급하는 것을 지원하지 않고 있어 아래의 결제 수단으로만 발급이 가능합니다.
|
|
46
|
+
- 해외카드 비인증 : `PLCreditCard`
|
|
47
|
+
- 해외카드 인증(3DS) : `PLCreditCardMpi`
|
|
48
|
+
- 유니온페이 : `PLUnionPay_HC`
|
|
49
|
+
|
|
50
|
+
## SDK 빌링키 발급 및 결제 요청하기
|
|
51
|
+
|
|
52
|
+
빌링키 발급 및 결제 요청 시에는 `customer_uid` 파라미터를 포함하여 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출해야 합니다.
|
|
53
|
+
|
|
54
|
+
<div class="hint" data-style="warning">
|
|
55
|
+
|
|
56
|
+
페이레터 해외결제는 **SDK 1.3.0 부터 사용 가능**합니다.
|
|
57
|
+
|
|
58
|
+
SDK 스크립트의 주소가 `https://cdn.iamport.kr/v1/iamport.js` 인지 확인해주세요.
|
|
59
|
+
|
|
60
|
+
위 JS SDK 를 이용하여 페이팔 정기결제 연동시 callback Data는 아래와 같이 두가지 형태로만 내려갑니다.
|
|
61
|
+
|
|
62
|
+
- `imp_uid`
|
|
63
|
+
- `merchant_uid`
|
|
64
|
+
|
|
65
|
+
해당 SDK를 사용하실때는 IMP.request\_pay로부터 응답된 객체(또는 쿼리 파라미터)에서 imp\_uid를 가지고
|
|
66
|
+
**포트원 REST API(GET /payments/imp\_uid)로 결제 상세 내역(승인 상태, 승인 결과 등등)을 조회**하여
|
|
67
|
+
응답 파라미터 중 status(결제 상태) 파라미터에 따라 추가 로직을 구현해야 합니다.
|
|
68
|
+
|
|
69
|
+
</div>
|
|
70
|
+
|
|
71
|
+
### 비동기 결제
|
|
72
|
+
|
|
73
|
+
<div class="hint" data-style="warning">
|
|
74
|
+
|
|
75
|
+
페이레터 일반결제, 빌링키 발급 및 결제는 승인 요청 시 바로 승인되지 않고 일정 시간 후 처리되는 **승인 대기(pending) 상태**가 존재합니다. 따라서 고객사는 트랜잭션 종료시 콜백 함수로 전달되는 포트원 번호(imp\_uid)로 결제 내역을 조회(GET /payments/{imp\_uid})한 후 응답되는 status를 보고 각 상황에 맞는 후 처리 로직을 작성해야 합니다.
|
|
76
|
+
|
|
77
|
+
승인 대기 상태에서는 고객사는 반드시 (가상계좌나 정기결제와 같이 결제가 비동기로 승인되는 경우 포트원 → 고객사로 결제 결과를 통보해주는) 웹훅 기능을 연동해야 합니다.
|
|
78
|
+
|
|
79
|
+
</div>
|
|
80
|
+
|
|
81
|
+
## 유의사항
|
|
82
|
+
|
|
83
|
+
- `merchant_uid` 에는 영문, 숫자만으로 이루어진 문자열만 입력할 수 있습니다.
|
|
84
|
+
- 페이레터의 경우 구매자 이메일을 필수로 받고있어,`buyer_email`을 필수로 입력하셔야 합니다.
|
|
85
|
+
- 해외결제시 카드는 `KRW`, `USD`, `JPY`, 알리페이⋅위챗페이는 `CNY`를 지원합니다.
|
|
86
|
+
- WeChatPay, Alipay 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
|
|
@@ -141,7 +141,7 @@ IMP.request_pay({
|
|
|
141
141
|
<div class="hint" data-style="info">
|
|
142
142
|
|
|
143
143
|
STC API를 사용하기 위해서는 **Paypal과의 STC 데이터 협의**가 필요하며,
|
|
144
|
-
**포트원 지원팀(<support@portone.io>)을 통해 요청**해주시면 협의 프로세스를 안내해드리고 있습니다.
|
|
144
|
+
**포트원 지원팀(<tech.support@portone.io>)을 통해 요청**해주시면 협의 프로세스를 안내해드리고 있습니다.
|
|
145
145
|
|
|
146
146
|
연동을 원하시는 경우 원활한 연동절차를 위해 요청 전 **아래 pdf의 Create REST API Application 섹션을 완료**해주세요.
|
|
147
147
|
|
|
@@ -12,11 +12,11 @@ versionVariants:
|
|
|
12
12
|
|
|
13
13
|
## 국내결제
|
|
14
14
|
|
|
15
|
-
[
|
|
15
|
+
[나이스정보통신 (신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme)
|
|
16
16
|
|
|
17
|
-
[(구)
|
|
17
|
+
[(구) 나이스정보통신](https://developers.portone.io/opi/ko/integration/pg/v1/nice)
|
|
18
18
|
|
|
19
|
-
[NHN KCP](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp)
|
|
19
|
+
[NHN KCP](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme)
|
|
20
20
|
|
|
21
21
|
[KG이니시스](https://developers.portone.io/opi/ko/integration/pg/v1/inicis)
|
|
22
22
|
|
|
@@ -71,3 +71,5 @@ versionVariants:
|
|
|
71
71
|
[페이팔(Reference Transaction) 정기결제](https://developers.portone.io/opi/ko/integration/pg/v1/rt/readme)
|
|
72
72
|
|
|
73
73
|
[페이팔(Express Checkout)](https://developers.portone.io/opi/ko/integration/pg/v1/paypal)
|
|
74
|
+
|
|
75
|
+
[페이레터 해외결제](https://developers.portone.io/opi/ko/integration/pg/v1/payletter-global)
|
|
@@ -183,3 +183,83 @@ curl -H "Content-Type: application/json" \
|
|
|
183
183
|
</div>
|
|
184
184
|
|
|
185
185
|
</div>
|
|
186
|
+
|
|
187
|
+
## 3. 고정식 가상계좌 연동하기
|
|
188
|
+
|
|
189
|
+
헥토파이낸셜의 고정식 가상계좌 연동 방법을 안내합니다.
|
|
190
|
+
|
|
191
|
+
### 입금통보 설정
|
|
192
|
+
|
|
193
|
+
헥토파이낸셜 MID 발급 후 `settle_pgdev@settlebank.co.kr`에 아래 입금통보 주소로 설정 요청해야합니다.
|
|
194
|
+
|
|
195
|
+
요청 입금통보 주소: <https://service.iamport.kr/settle_payments/notice_vbank>
|
|
196
|
+
|
|
197
|
+
<div class="hint" data-style="info">
|
|
198
|
+
|
|
199
|
+
자세한 내용은 [가상계좌 입금통보 설정](https://developers.portone.io/opi/ko/integration/virtual-account/readme?v=v1)을 참고하세요.
|
|
200
|
+
|
|
201
|
+
</div>
|
|
202
|
+
|
|
203
|
+
### 가상계좌 발급 API
|
|
204
|
+
|
|
205
|
+
**주요 파라미터**
|
|
206
|
+
|
|
207
|
+
- `merchant_uid`: 고객사 거래 고유번호 (필수)
|
|
208
|
+
- `amount`: 결제 금액 (고정식 가상계좌 시 필수)
|
|
209
|
+
- `vbank_num`: PG사로부터 받은 가상계좌 번호 (필수)
|
|
210
|
+
- `vbank_holder`: 가상계좌 예금주명 (필수)
|
|
211
|
+
- `fixed_unlimited_vbank`: 고정식 무제한 가상계좌 여부
|
|
212
|
+
- `pg`: PG사 구분자 `{PG사}.{PG상점 아이디}` (필수)
|
|
213
|
+
|
|
214
|
+
**에스크로 결제시 추가 파라미터**
|
|
215
|
+
|
|
216
|
+
- `escrow_password`: 에스크로 비밀번호 (필수)
|
|
217
|
+
- `buyer_email`: 구매자 이메일 (필수)
|
|
218
|
+
|
|
219
|
+
<div class="hint" data-style="warning">
|
|
220
|
+
|
|
221
|
+
고정식 무제한 가상계좌 발급 유의사항
|
|
222
|
+
|
|
223
|
+
- `amount`는 생략 가능하며, 지정 시 0원으로 발급됩니다.
|
|
224
|
+
- `tax_free`, `vat_amount` 파라미터를 사용할 수 없습니다.
|
|
225
|
+
- 에스크로 결제를 지원하지 않습니다.
|
|
226
|
+
|
|
227
|
+
</div>
|
|
228
|
+
|
|
229
|
+
### 발급 정보 변경 API
|
|
230
|
+
|
|
231
|
+
입금 전 가상계좌의 입금기한이나 금액을 수정할 수 있습니다.
|
|
232
|
+
|
|
233
|
+
- `imp_uid`: 포트원 거래고유번호 (필수)
|
|
234
|
+
- `amount`: 수정할 결제금액 (선택)
|
|
235
|
+
- `vbank_due`: 수정할 입금기한 UNIX TIMESTAMP (필수)
|
|
236
|
+
|
|
237
|
+
<div class="hint" data-style="warning">
|
|
238
|
+
|
|
239
|
+
- 면세, 복합과세로 발급된 가상계좌의 경우 발급 정보 변경 기능이 제공되지 않습니다.
|
|
240
|
+
- 고정식 무제한 가상계좌의 경우 amount 파라미터를 전달하여도 적용되지 않습니다.
|
|
241
|
+
|
|
242
|
+
</div>
|
|
243
|
+
|
|
244
|
+
### 입금 내역 확인
|
|
245
|
+
|
|
246
|
+
#### 결제건 조회 API
|
|
247
|
+
|
|
248
|
+
고정식 무제한 가상계좌의 경우 `deposit_history` 필드로 입금 내역을 확인할 수 있습니다.
|
|
249
|
+
|
|
250
|
+
**응답 필드 (주요)**
|
|
251
|
+
|
|
252
|
+
- `deposit_history`: 입금 내역 배열
|
|
253
|
+
- `pg_tid`: PG사 승인번호
|
|
254
|
+
- `amount`: 입금 금액
|
|
255
|
+
- `depositor_name`: 입금자명
|
|
256
|
+
- `deposited_at`: 입금 시각
|
|
257
|
+
|
|
258
|
+
<div class="hint" data-style="warning">
|
|
259
|
+
|
|
260
|
+
**유의 사항**
|
|
261
|
+
|
|
262
|
+
- **무제한 가상계좌**: 웹훅 수신 후 반드시 결제건 조회 API로 `deposit_history`를 확인하여 정확한 입금 내역을 검증하세요.
|
|
263
|
+
- **취소 후 입금**: 취소된 무제한 가상계좌로 입금이 발생하면 status가 `cancelled`로 유지되므로, `deposit_history`와 `cancel_history`를 모두 확인해야 합니다.
|
|
264
|
+
|
|
265
|
+
</div>
|