@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
|
@@ -56,7 +56,7 @@
|
|
|
56
56
|
- [결제 연동 하기](https://developers.portone.io/opi/ko/console/guide/connect)
|
|
57
57
|
- [결제 내역](https://developers.portone.io/opi/ko/console/guide/list): 결제가 이루어진 거래내역을 조회할 수 있는 메뉴입니다.
|
|
58
58
|
- [복수 PG설정 및 사용하기](https://developers.portone.io/opi/ko/console/pg): 복수 PG를 사용하는 경우 설정방법을 확인할 수 있습니다.
|
|
59
|
-
- [컨펌 프로세스](https://developers.portone.io/opi/ko/extra/confirm-process/readme-v1): 결제요청의 주체를 고객사 서버로 가져갈수 있는
|
|
59
|
+
- [컨펌 프로세스](https://developers.portone.io/opi/ko/extra/confirm-process/readme-v1): 결제요청의 주체를 고객사 서버로 가져갈수 있는 서비스입니다.
|
|
60
60
|
- [통합인증 준비하기](https://developers.portone.io/opi/ko/extra/identity-verification/v1/all/0): 통합인증 연동을 시작하기 위한 준비작업을 소개합니다.
|
|
61
61
|
- [통합인증 요청하기](https://developers.portone.io/opi/ko/extra/identity-verification/v1/all/1): 통합인증 페이지를 호출하는 방법을 확인합니다.
|
|
62
62
|
- [인증 완료정보 전달하기](https://developers.portone.io/opi/ko/extra/identity-verification/v1/all/2): 통합인증 이후 획득된 정보를 처리하는 방법을 안내합니다.
|
|
@@ -107,12 +107,14 @@
|
|
|
107
107
|
- [네이버페이(결제형)](https://developers.portone.io/opi/ko/integration/pg/v1/naver): 네이버페이 결제형 연동 방법을 안내합니다.
|
|
108
108
|
- [토스페이먼츠(신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/newtoss/readme): 토스페이먼츠 (신모듈 / 2022-07-27 버전) 연동 방법을 확인합니다.
|
|
109
109
|
- [연동 유의사항](https://developers.portone.io/opi/ko/integration/pg/v1/newtoss/warning): 토스페이먼츠 (신 모듈) 연동 유의사항을 소개합니다.
|
|
110
|
-
- [
|
|
111
|
-
- [
|
|
112
|
-
- [
|
|
113
|
-
- [
|
|
114
|
-
- [(
|
|
110
|
+
- [KCP 퀵페이 (자체 간편결제)](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/kcp-quickpay): NHN KCP 퀵페이 결제 연동 방법을 안내합니다.
|
|
111
|
+
- [NHN KCP](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme): NHN KCP 결제 연동 방법을 안내합니다.
|
|
112
|
+
- [빌링키 발급 / API 연동 유의사항](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/billing-api-caution): (신)나이스정보통신 비인증 결제 연동 유의사항을 소개합니다.
|
|
113
|
+
- [일반결제 연동 유의사항](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/payment-caution): 나이스정보통신(신모듈) 일반결제 연동 유의사항을 소개합니다.
|
|
114
|
+
- [나이스정보통신 (신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme): 나이스정보통신 연동 방법을 안내합니다.
|
|
115
|
+
- [(구) 나이스정보통신](https://developers.portone.io/opi/ko/integration/pg/v1/nice): (구) 나이스정보통신 결제창 연동 가이드를 안내합니다.
|
|
115
116
|
- [페이코](https://developers.portone.io/opi/ko/integration/pg/v1/payco): 페이코 결제 연동방법을 안내합니다.
|
|
117
|
+
- [페이레터 해외결제](https://developers.portone.io/opi/ko/integration/pg/v1/payletter-global): 페이레터 해외결제 연동 방법을 안내합니다.
|
|
116
118
|
- [페이먼트월](https://developers.portone.io/opi/ko/integration/pg/v1/paymentwall): 페이먼트월 결제창 연동가이드를 확인 합니다.
|
|
117
119
|
- [페이팔(Express Checkout)](https://developers.portone.io/opi/ko/integration/pg/v1/paypal): 페이팔(Express Checkout) 결제연동 방법을 안내합니다.
|
|
118
120
|
- [결제대행사 선택하여 연동하기](https://developers.portone.io/opi/ko/integration/pg/v1/readme): 각 결제대행사(PG)사별 결제 연동 방법 및 유의사항을 확인할 수 있습니다.
|
|
@@ -171,19 +173,20 @@
|
|
|
171
173
|
- [프로모션 결제 연동하기](https://developers.portone.io/opi/ko/extra/promotion/integration): 프로모션 할인금액을 적용하는 방법을 안내합니다.
|
|
172
174
|
- [프로모션](https://developers.portone.io/opi/ko/extra/promotion/intro): 카드 즉시 할인을 쉽게 운영 및 관리할 수 있는 서비스입니다.
|
|
173
175
|
- [프로모션 결제 취소하기](https://developers.portone.io/opi/ko/extra/promotion/refund): 프로모션을 적용하여 승인된 결제건들에 대하여 취소/환불하는 방법을 안내합니다.
|
|
174
|
-
- [스마트 라우팅 - 콘솔 가이드](https://developers.portone.io/opi/ko/extra/smart-routing/console-guide): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화
|
|
175
|
-
- [스마트 라우팅 - 연동하기](https://developers.portone.io/opi/ko/extra/smart-routing/integration): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화
|
|
176
|
-
- [스마트 라우팅](https://developers.portone.io/opi/ko/extra/smart-routing/intro): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화
|
|
176
|
+
- [스마트 라우팅 - 콘솔 가이드](https://developers.portone.io/opi/ko/extra/smart-routing/console-guide): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
|
|
177
|
+
- [스마트 라우팅 - 연동하기](https://developers.portone.io/opi/ko/extra/smart-routing/integration): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
|
|
178
|
+
- [스마트 라우팅](https://developers.portone.io/opi/ko/extra/smart-routing/intro): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
|
|
177
179
|
- [결제 연동 준비하기](https://developers.portone.io/opi/ko/integration/ready/readme): 포트원을 이용한 연동 개발이 처음이시라면 아래 안내 사항에 따라 진행하세요.
|
|
178
180
|
- [AI 도구 활용하기](https://developers.portone.io/opi/ko/integration/using-ai-tools): AI 도구를 활용하여 쉽고 빠르게 포트원을 연동하세요. 연동 코드 작성은 물론, 24시간 언제나 관련 질의에 대한 답변을 받을 수 있습니다.
|
|
179
181
|
- [가상계좌 입금통보 설정](https://developers.portone.io/opi/ko/integration/virtual-account/readme): 결제대행사별 입금통보 URL을 안내합니다.
|
|
180
182
|
- [포트원 결제 연동 Doc](https://developers.portone.io/opi/ko/readme): 포트원 결제 연동 가이드입니다. 빠른 시간 안에 결제를 연동할 수 있게 도와드립니다.
|
|
181
183
|
- [직접 문의하기](https://developers.portone.io/opi/ko/support/contact): 기술지원 문의를 위한 연락처 정보입니다.
|
|
184
|
+
- [용어 사전](https://developers.portone.io/opi/ko/support/pg-terms): 온라인 결제 시스템에서 자주 사용되는 용어들을 설명합니다.
|
|
182
185
|
- [TLS 지원 범위](https://developers.portone.io/opi/ko/support/tls-support): 포트원 v1 API의 TLS 지원 범위 및 설정 가이드를 확인할 수 있습니다.
|
|
183
186
|
|
|
184
187
|
### 파트너정산
|
|
185
188
|
|
|
186
|
-
- [용어 사전](https://developers.portone.io/platform/ko/guides/dictionary)
|
|
189
|
+
- [용어 사전](https://developers.portone.io/platform/ko/guides/dictionary): 파트너 정산 자동화 솔루션에서 자주 사용되는 용어를 설명합니다.
|
|
187
190
|
- [서비스 프로세스](https://developers.portone.io/platform/ko/guides/process)
|
|
188
191
|
- [세금계산서 웹훅 가이드](https://developers.portone.io/platform/ko/guides/webhook): 세금계산서 상태 변화 웹훅의 사용 방법과 설정 가이드입니다.
|
|
189
192
|
- [파트너 정산 자동화 서비스 가이드](https://developers.portone.io/platform/ko/readme)
|
|
@@ -243,6 +246,7 @@
|
|
|
243
246
|
- [관리자콘솔 2023-09-12](https://developers.portone.io/release-notes/console/2023-09-12)
|
|
244
247
|
- [관리자콘솔 2023-12-27](https://developers.portone.io/release-notes/console/2023-12-27)
|
|
245
248
|
- [관리자콘솔 2024-09-05](https://developers.portone.io/release-notes/console/2024-09-05)
|
|
249
|
+
- [관리자콘솔 2025-10-17](https://developers.portone.io/release-notes/console/2025-10-17)
|
|
246
250
|
- [파트너 정산 자동화 2023-08-31](https://developers.portone.io/release-notes/platform/2023-08-31)
|
|
247
251
|
- [파트너 정산 자동화 2023-11-08](https://developers.portone.io/release-notes/platform/2023-11-08)
|
|
248
252
|
- [파트너 정산 자동화 2023-11-14](https://developers.portone.io/release-notes/platform/2023-11-14)
|
|
@@ -269,6 +273,11 @@
|
|
|
269
273
|
- [파트너 정산 자동화 2025-05-14](https://developers.portone.io/release-notes/platform/2025-05-14)
|
|
270
274
|
- [파트너 정산 자동화 2025-07-02](https://developers.portone.io/release-notes/platform/2025-07-02)
|
|
271
275
|
- [파트너 정산 자동화 2025-07-07](https://developers.portone.io/release-notes/platform/2025-07-07)
|
|
276
|
+
- [파트너 정산 자동화 2025-07-23](https://developers.portone.io/release-notes/platform/2025-07-23)
|
|
277
|
+
- [파트너 정산 자동화 2025-08-13](https://developers.portone.io/release-notes/platform/2025-08-13)
|
|
278
|
+
- [파트너 정산 자동화 2025-08-21](https://developers.portone.io/release-notes/platform/2025-08-21)
|
|
279
|
+
- [파트너 정산 자동화 2025-08-28](https://developers.portone.io/release-notes/platform/2025-08-28)
|
|
280
|
+
- [파트너 정산 자동화 2025-10-02](https://developers.portone.io/release-notes/platform/2025-10-02)
|
|
272
281
|
|
|
273
282
|
### 블로그
|
|
274
283
|
|
|
@@ -623,8 +632,8 @@ targetVersions:
|
|
|
623
632
|
|
|
624
633
|
| PG사 |상점아이디 (예시)| 용도 | 채널키 |
|
|
625
634
|
|:---------------------:|:---------------:|:---------------:|:----------------------------------------------:|
|
|
626
|
-
|**(신)
|
|
627
|
-
|**(신)
|
|
635
|
+
|**(신) 나이스정보통신**| MID-a | **인증 결제용** |channel-key-12345678-1234-5678-9012-123456789012|
|
|
636
|
+
|**(신) 나이스정보통신**| MID-b |**비인증 결제용**|channel-key-abcdefgh-abcd-efgh-ijkl-abcdefghijkl|
|
|
628
637
|
| 카카오페이 | MID-c | 인증 결제용 |channel-key-98765432-9876-5432-1098-987654321098|
|
|
629
638
|
|
|
630
639
|
다음과 같이 `channelKey` 속성에 `channel-key-98765432-9876-5432-1098-987654321098`를 지정하면 등록한 카카오페이 설정으로 결제창이 호출됩니다
|
|
@@ -647,15 +656,15 @@ IMP.request_pay({
|
|
|
647
656
|
|
|
648
657
|
</div>
|
|
649
658
|
|
|
650
|
-
위에서 등록한 PG 설정 중 **(신)
|
|
659
|
+
위에서 등록한 PG 설정 중 **(신) 나이스정보통신 (인증 결제용)** 와 **(신) 나이스정보통신 (비인증 결제용)** 의 경우 **PG사 코드값이 동일**하지만, `channelKey` 파라미터를 통해 구분이 가능합니다.
|
|
651
660
|
|
|
652
661
|
<div class="tabs-container">
|
|
653
662
|
|
|
654
|
-
<div class="tabs-content" data-title="(신)
|
|
663
|
+
<div class="tabs-content" data-title="(신) 나이스정보통신 인증 결제용 호출">
|
|
655
664
|
|
|
656
665
|
```ts
|
|
657
666
|
IMP.request_pay({
|
|
658
|
-
channelKey: "channel-key-12345678-1234-5678-9012-123456789012", // (신)
|
|
667
|
+
channelKey: "channel-key-12345678-1234-5678-9012-123456789012", // (신) 나이스정보통신 인증 결제용 채널키
|
|
659
668
|
amount: 1000,
|
|
660
669
|
name: "테스트 주문",
|
|
661
670
|
buyer_name: "구매자",
|
|
@@ -665,11 +674,11 @@ IMP.request_pay({
|
|
|
665
674
|
|
|
666
675
|
</div>
|
|
667
676
|
|
|
668
|
-
<div class="tabs-content" data-title="(신)
|
|
677
|
+
<div class="tabs-content" data-title="(신) 나이스정보통신 비인증 결제용 호출">
|
|
669
678
|
|
|
670
679
|
```ts
|
|
671
680
|
IMP.request_pay({
|
|
672
|
-
channelKey: "channel-key-abcdefgh-abcd-efgh-ijkl-abcdefghijkl", // (신)
|
|
681
|
+
channelKey: "channel-key-abcdefgh-abcd-efgh-ijkl-abcdefghijkl", // (신) 나이스정보통신 비인증 결제용 채널키
|
|
673
682
|
amount: 1000,
|
|
674
683
|
name: "테스트 주문",
|
|
675
684
|
buyer_name: "구매자",
|
|
@@ -694,7 +703,7 @@ JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미
|
|
|
694
703
|
|
|
695
704
|
---
|
|
696
705
|
title: 컨펌 프로세스
|
|
697
|
-
description: 결제요청의 주체를 고객사 서버로 가져갈수 있는
|
|
706
|
+
description: 결제요청의 주체를 고객사 서버로 가져갈수 있는 서비스입니다.
|
|
698
707
|
targetVersions:
|
|
699
708
|
- v1
|
|
700
709
|
versionVariants:
|
|
@@ -747,7 +756,7 @@ versionVariants:
|
|
|
747
756
|
|
|
748
757
|
**컨펌 프로세스 신청 방법**
|
|
749
758
|
|
|
750
|
-
기술지원 메일(<support@portone.io>)로 **고객사 식별코드**를 기재하여 메일 발송
|
|
759
|
+
기술지원 메일(<tech.support@portone.io>)로 **고객사 식별코드**를 기재하여 메일 발송
|
|
751
760
|
|
|
752
761
|
(이미지 첨부: 포트원 콘솔 내 고객사 식별코드 확인 예시)
|
|
753
762
|
|
|
@@ -1059,7 +1068,7 @@ app.post("/certifications", async (request, response) => {
|
|
|
1059
1068
|
|
|
1060
1069
|
- `name`: 이름
|
|
1061
1070
|
- `gender`: 성별
|
|
1062
|
-
- `
|
|
1071
|
+
- `birthday`: 생년월일(YYYY-MM-DD)
|
|
1063
1072
|
- `unique_key`: CI 값과 동일. 온라인 주민번호와 같은 개인고유식별키
|
|
1064
1073
|
- `phone :`휴대폰 번호
|
|
1065
1074
|
|
|
@@ -1073,9 +1082,9 @@ app.post("/certifications", async (request, response) => {
|
|
|
1073
1082
|
// imp_uid로 인증 정보 조회
|
|
1074
1083
|
/* ...중략... */
|
|
1075
1084
|
const certificationsInfo = getCertifications.data; // 조회한 인증 정보
|
|
1076
|
-
const { name,
|
|
1085
|
+
const { name, birthday } = certificationsInfo;
|
|
1077
1086
|
// 연령 제한 로직
|
|
1078
|
-
if (new Date(
|
|
1087
|
+
if (new Date(birthday).getFullYear() <= 1999) {
|
|
1079
1088
|
// 연령 만족
|
|
1080
1089
|
} else {
|
|
1081
1090
|
// 연령 미달
|
|
@@ -1112,7 +1121,7 @@ targetVersions:
|
|
|
1112
1121
|
이용하거나 사용자 본인이 가입된 간편인증을 통해 인증요청을 보내고 간편인증 페이지에서 인증처리를
|
|
1113
1122
|
하는 방식으로 이루어 집니다.
|
|
1114
1123
|
|
|
1115
|
-
> **이용가능 수단 : 네이버 / PASS /
|
|
1124
|
+
> **이용가능 수단 : 네이버 / PASS / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스**
|
|
1116
1125
|
|
|
1117
1126
|
[이미지 링크](<https://developers.portone.io/gitbook-assets/ko/image (24) (2).png>)
|
|
1118
1127
|
|
|
@@ -1408,7 +1417,7 @@ app.post("/certifications", async (request, response) => {
|
|
|
1408
1417
|
|
|
1409
1418
|
- `name`: 이름
|
|
1410
1419
|
- `gender`: 성별
|
|
1411
|
-
- `
|
|
1420
|
+
- `birthday`: 생년월일(YYYY-MM-DD)
|
|
1412
1421
|
- `unique_key`: CI 값과 동일. 온라인 주민번호와 같은 개인고유식별키
|
|
1413
1422
|
- `unique_in_site`: DI 값과 동일. 상점아이디(사이트)별로 할당되는 식별키
|
|
1414
1423
|
|
|
@@ -1431,10 +1440,10 @@ app.post("/certifications", async (request, response) => {
|
|
|
1431
1440
|
/* ...중략... */
|
|
1432
1441
|
const certificationsInfo = getCertifications.data; // 조회한 인증 정보
|
|
1433
1442
|
// unique_key: 개인식별 고유 키, unique_in_site: 사이트 별 개인식별 고유 키
|
|
1434
|
-
const { unique_key, unique_in_site, name, gender,
|
|
1443
|
+
const { unique_key, unique_in_site, name, gender, birthday } =
|
|
1435
1444
|
certificationsInfo;
|
|
1436
1445
|
// 연령 제한 로직
|
|
1437
|
-
if (new Date(
|
|
1446
|
+
if (new Date(birthday).getFullYear() <= 1999) {
|
|
1438
1447
|
// 연령 만족
|
|
1439
1448
|
} else {
|
|
1440
1449
|
// 연령 미달
|
|
@@ -1781,7 +1790,7 @@ app.post("/certifications", async (request, response) => {
|
|
|
1781
1790
|
|
|
1782
1791
|
- `name`: 이름
|
|
1783
1792
|
- `gender`: 성별
|
|
1784
|
-
- `
|
|
1793
|
+
- `birthday`: 생년월일(YYYY-MM-DD)
|
|
1785
1794
|
- `unique_key`: CI 값과 동일. 온라인 주민번호와 같은 개인고유식별키
|
|
1786
1795
|
- `unique_in_site`: DI 값과 동일. 상점아이디(사이트)별로 할당되는 식별키
|
|
1787
1796
|
|
|
@@ -1817,10 +1826,10 @@ app.post("/certifications", async (request, response) => {
|
|
|
1817
1826
|
/* ...중략... */
|
|
1818
1827
|
const certificationsInfo = getCertifications.data; // 조회한 인증 정보
|
|
1819
1828
|
// unique_key: 개인식별 고유 키, unique_in_site: 사이트 별 개인식별 고유 키
|
|
1820
|
-
const { unique_key, unique_in_site, name, gender,
|
|
1829
|
+
const { unique_key, unique_in_site, name, gender, birthday } =
|
|
1821
1830
|
certificationsInfo;
|
|
1822
1831
|
// 연령 제한 로직
|
|
1823
|
-
if (new Date(
|
|
1832
|
+
if (new Date(birthday).getFullYear() <= 1999) {
|
|
1824
1833
|
// 연령 만족
|
|
1825
1834
|
} else {
|
|
1826
1835
|
// 연령 미달
|
|
@@ -2343,7 +2352,7 @@ targetVersions:
|
|
|
2343
2352
|
<div class="hint" data-style="warning">
|
|
2344
2353
|
|
|
2345
2354
|
해당 플러그인은 현재 유지보수 되지 않으며, 신규 워드프레스 버전에서는 정상작동을 보장하지 않습니다.\
|
|
2346
|
-
연동과 관련하여 기술지원이 필요하신 경우 <support@portone.io>로 문의바랍니다.
|
|
2355
|
+
연동과 관련하여 기술지원이 필요하신 경우 <tech.support@portone.io>로 문의바랍니다.
|
|
2347
2356
|
|
|
2348
2357
|
</div>
|
|
2349
2358
|
|
|
@@ -2513,7 +2522,7 @@ targetVersions:
|
|
|
2513
2522
|
<div class="hint" data-style="warning">
|
|
2514
2523
|
|
|
2515
2524
|
해당 플러그인은 현재 유지보수 되지 않으며, 신규 워드프레스 버전에서는 정상작동을 보장하지 않습니다.\
|
|
2516
|
-
연동과 관련하여 기술지원이 필요하신 경우 <support@portone.io>로 문의바랍니다.
|
|
2525
|
+
연동과 관련하여 기술지원이 필요하신 경우 <tech.support@portone.io>로 문의바랍니다.
|
|
2517
2526
|
|
|
2518
2527
|
</div>
|
|
2519
2528
|
|
|
@@ -2712,7 +2721,7 @@ Woocommerce Subscriptions 플러그인
|
|
|
2712
2721
|
|
|
2713
2722
|
다음 PG사의 경우, 정기결제 수단을 다음과 같이 선택합니다.
|
|
2714
2723
|
|
|
2715
|
-
-
|
|
2724
|
+
- **나이스정보통신**: 포트원(KEY-IN결제/정기결제)
|
|
2716
2725
|
- **KG이니시스 / 다날(신용카드, 휴대폰소액결제)**: 포트원(정기결제-결제창방식)
|
|
2717
2726
|
|
|
2718
2727
|
결제 수단을 포트원(정기결제-결제창방식)으로 선택한 화면입니다.
|
|
@@ -3465,6 +3474,7 @@ IMP.request_pay(
|
|
|
3465
3474
|
buyer_tel: "010-1234-5678",
|
|
3466
3475
|
buyer_addr: "서울특별시 강남구 삼성동",
|
|
3467
3476
|
buyer_postcode: "123-456",
|
|
3477
|
+
company: "고객사",
|
|
3468
3478
|
},
|
|
3469
3479
|
function (rsp) {
|
|
3470
3480
|
// callback 로직
|
|
@@ -3534,6 +3544,10 @@ IMP.request_pay(
|
|
|
3534
3544
|
|
|
3535
3545
|
가상계좌 결제창 호출 시 `사업자등록번호 10자리` 필수 입력 (미설정 시 다날 결제창에서 오류 발생 가능)
|
|
3536
3546
|
|
|
3547
|
+
- company?: string
|
|
3548
|
+
|
|
3549
|
+
휴대폰 결제시 결제창에 표시될 표시될 상호명. 입력하지 않으면 포트원 대표상점명으로 표시됩니다.
|
|
3550
|
+
|
|
3537
3551
|
</div>
|
|
3538
3552
|
|
|
3539
3553
|
<div class="tabs-content" data-title="비인증 결제(결제창 방식)">
|
|
@@ -3938,6 +3952,9 @@ IMP.request_pay(
|
|
|
3938
3952
|
- payco (페이코)
|
|
3939
3953
|
- samsung (삼성페이)
|
|
3940
3954
|
- applepay (애플페이)
|
|
3955
|
+
- cultureland (문화상품권)
|
|
3956
|
+
- smartculture (스마트문화상품권)
|
|
3957
|
+
- booknlife (도서문화상품권)
|
|
3941
3958
|
|
|
3942
3959
|
- merchant\_uid: string
|
|
3943
3960
|
|
|
@@ -3971,6 +3988,12 @@ IMP.request_pay(
|
|
|
3971
3988
|
- `Y`: 허용
|
|
3972
3989
|
- `N`: 차단
|
|
3973
3990
|
|
|
3991
|
+
- bypass.daou.DIRECT\_YN?: string
|
|
3992
|
+
|
|
3993
|
+
**카드, 간편결제 다이렉트 호출 시 키움페이 페이지 노출여부**
|
|
3994
|
+
|
|
3995
|
+
'Y'로 입력하는 경우 키움페이 화면이 노출되지 않고 바로 카드사, 간편결제 결제창이 호출됩니다.
|
|
3996
|
+
|
|
3974
3997
|
- app\_scheme?: string
|
|
3975
3998
|
|
|
3976
3999
|
**모바일 앱 URL Scheme**
|
|
@@ -4367,6 +4390,14 @@ GET http://api.iamport.kr/payments/{포트원 번호}?**extension=true**
|
|
|
4367
4390
|
|
|
4368
4391
|
</details>
|
|
4369
4392
|
|
|
4393
|
+
<details>
|
|
4394
|
+
|
|
4395
|
+
<summary>도서문화상품권, 스마트문화상품권 거래는 부분취소 불가능</summary>
|
|
4396
|
+
|
|
4397
|
+
도서문화상품권, 스마트문화상품권 거래는 부분취소가 불가능하며 전체취소만 가능합니다.
|
|
4398
|
+
|
|
4399
|
+
</details>
|
|
4400
|
+
|
|
4370
4401
|
|
|
4371
4402
|
# https://developers.portone.io/opi/ko/integration/pg/v1/eximbay
|
|
4372
4403
|
|
|
@@ -4489,20 +4520,6 @@ IMP.request_pay(
|
|
|
4489
4520
|
- HKD
|
|
4490
4521
|
- CAD
|
|
4491
4522
|
- AUD
|
|
4492
|
-
- CNY
|
|
4493
|
-
- TWD
|
|
4494
|
-
- MYR
|
|
4495
|
-
- VND
|
|
4496
|
-
- PHP
|
|
4497
|
-
- MNT
|
|
4498
|
-
- NZD
|
|
4499
|
-
- AED
|
|
4500
|
-
- MOP
|
|
4501
|
-
- BRL
|
|
4502
|
-
- KZT
|
|
4503
|
-
- NOK
|
|
4504
|
-
- SAR
|
|
4505
|
-
- TRY
|
|
4506
4523
|
|
|
4507
4524
|
- language?: string
|
|
4508
4525
|
|
|
@@ -5259,6 +5276,64 @@ KG이니시스 설정이 완료되었으면 아래와 같이 파라미터 설정
|
|
|
5259
5276
|
|
|
5260
5277
|
</div>
|
|
5261
5278
|
|
|
5279
|
+
<div class="tabs-content" data-title="이니시스 에스크로 상태변경 웹훅">
|
|
5280
|
+
|
|
5281
|
+
에스크로 상태 변경이 이뤄지면 고객사의 웹훅을 호출하여 통해 아래와 같은 데이터가 전송됩니다.
|
|
5282
|
+
|
|
5283
|
+
```json
|
|
5284
|
+
{
|
|
5285
|
+
"event": "Inicis.Escrow.Changed",
|
|
5286
|
+
"imp_uid": "imp_123412341234",
|
|
5287
|
+
"merchant_uid": "asdfasdfasdf",
|
|
5288
|
+
"status": "paid",
|
|
5289
|
+
"extra": {
|
|
5290
|
+
"escrow_status": "4",
|
|
5291
|
+
"changed_at": 112312323,
|
|
5292
|
+
"denied_reason": "구매 거절 사유"
|
|
5293
|
+
}
|
|
5294
|
+
}
|
|
5295
|
+
```
|
|
5296
|
+
|
|
5297
|
+
웹훅 데이터 필드 설명
|
|
5298
|
+
|
|
5299
|
+
|필드명 |타입 |설명 |
|
|
5300
|
+
|---------------------|------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
5301
|
+
|`event` |string|이벤트 타입 (항상 `Inicis.Escrow.Changed`) |
|
|
5302
|
+
|`imp_uid` |string|포트원 거래 고유번호 |
|
|
5303
|
+
|`merchant_uid` |string|고객사 주문번호 |
|
|
5304
|
+
|`status` |string|결제 상태 |
|
|
5305
|
+
|`extra.escrow_status`|string|에스크로 상태구분 <br />- `2`: 배송등록<br />- `3`: 구매확인<br />- `31`: 자동구매확인<br />- `32`: 강제구매확인<br />- `4`: 구매거절<br />- `8`: 거래취소<br />- `10`: 거절확인|
|
|
5306
|
+
|`extra.changed_at` |number|상태 변경 시각 (Unix Timestamp) |
|
|
5307
|
+
|`extra.denied_reason`|string|구매 거절 사유 (구매거절시 전달) |
|
|
5308
|
+
|
|
5309
|
+
<div class="hint" data-style="warning">
|
|
5310
|
+
|
|
5311
|
+
이니시스 에스크로 웹훅 기능을 사용하려면 별도 설정이 필요합니다.
|
|
5312
|
+
<cs@portone.io>로 아래와 같이 설정 요청 메일을 보내주세요.
|
|
5313
|
+
|
|
5314
|
+
```text
|
|
5315
|
+
제목: [에스크로 상태 변화에 따른 통보 수신 URL 설정 요청]
|
|
5316
|
+
|
|
5317
|
+
안녕하세요, 포트원 담당자님
|
|
5318
|
+
|
|
5319
|
+
에스크로 상태 변화에 따른 통보 수신 URL 설정 요청드립니다.
|
|
5320
|
+
|
|
5321
|
+
■ 고객사 정보
|
|
5322
|
+
- 상호명: [상호명 입력]
|
|
5323
|
+
- 사업자번호: [사업자번호 입력]
|
|
5324
|
+
- 이니시스 MID: [MID 입력]
|
|
5325
|
+
|
|
5326
|
+
■ 이니시스 에스크로 상태변화 수신 URL
|
|
5327
|
+
-URL : https://service.iamport.kr/inicis_payments/escrow/changed
|
|
5328
|
+
-한글 인코딩 : UTF-8
|
|
5329
|
+
|
|
5330
|
+
감사합니다.
|
|
5331
|
+
```
|
|
5332
|
+
|
|
5333
|
+
</div>
|
|
5334
|
+
|
|
5335
|
+
</div>
|
|
5336
|
+
|
|
5262
5337
|
</div>
|
|
5263
5338
|
|
|
5264
5339
|
|
|
@@ -5451,10 +5526,21 @@ curl -H "Content-Type: application/json" \
|
|
|
5451
5526
|
|
|
5452
5527
|
</div>
|
|
5453
5528
|
|
|
5454
|
-
|
|
5529
|
+
## 유의사항
|
|
5530
|
+
|
|
5531
|
+
<details>
|
|
5532
|
+
|
|
5533
|
+
<summary> 부가세 지정 미지원</summary>
|
|
5534
|
+
|
|
5535
|
+
- 카카오페이 결제 시 부가세 지정은 지원하지 않습니다.
|
|
5536
|
+
- 카카오페이 결제 취소 시 부가세 지정은 지원하지 않습니다.
|
|
5537
|
+
|
|
5538
|
+
</details>
|
|
5455
5539
|
|
|
5456
5540
|
## 참고사항
|
|
5457
5541
|
|
|
5542
|
+
<div class="hint" data-style="info">
|
|
5543
|
+
|
|
5458
5544
|
- 카카오페이 결제버튼이 노출되는 것을 권장 합니다.
|
|
5459
5545
|
- 카카오페이 고객사 사이니지 이미지를 [다운받아](http://biz.kakaopay.com/online/guide) 활용할 수 있습니다.
|
|
5460
5546
|
|
|
@@ -6105,7 +6191,8 @@ KICC는 **현금성 결제수단** (실시간 계좌이체, 가상계좌)에 한
|
|
|
6105
6191
|
"code": "367",
|
|
6106
6192
|
"quota": 3
|
|
6107
6193
|
}
|
|
6108
|
-
}
|
|
6194
|
+
},
|
|
6195
|
+
"company": "고객사" //해당 파라미터를 설정하지 않으면 카드사 모듈 창에 iamport 로 표기
|
|
6109
6196
|
}
|
|
6110
6197
|
```
|
|
6111
6198
|
|
|
@@ -6113,6 +6200,7 @@ KICC는 **현금성 결제수단** (실시간 계좌이체, 가상계좌)에 한
|
|
|
6113
6200
|
|
|
6114
6201
|
- **`code`** : 카드사 금융결제원 표준 코드. [**링크**](https://developers.portone.io/opi/ko/support/code-info/card-code) 참조 (**string**)
|
|
6115
6202
|
- **`quota`** : 할부 개월 수. 일시불일 시 0 으로 지정. (**number**)
|
|
6203
|
+
- **`company`** : 카드사 모듈 바로 호출 시 결제창에 표시될 상호명. 입력하지 않으면 iamport로 표시됩니다.
|
|
6116
6204
|
|
|
6117
6205
|
<div class="hint" data-style="danger">
|
|
6118
6206
|
|
|
@@ -8311,7 +8399,721 @@ IE 브라우저에서 결제 중단(결제 승인/실패 이전에 결제창을
|
|
|
8311
8399
|
</details>
|
|
8312
8400
|
|
|
8313
8401
|
|
|
8314
|
-
# https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp
|
|
8402
|
+
# https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/kcp-quickpay
|
|
8403
|
+
|
|
8404
|
+
---
|
|
8405
|
+
title: KCP 퀵페이 (자체 간편결제)
|
|
8406
|
+
description: NHN KCP 퀵페이 결제 연동 방법을 안내합니다.
|
|
8407
|
+
targetVersions:
|
|
8408
|
+
- v1
|
|
8409
|
+
---
|
|
8410
|
+
|
|
8411
|
+
## 퀵페이 (자체 간편 결제)
|
|
8412
|
+
|
|
8413
|
+
### 퀵페이 호출하기
|
|
8414
|
+
|
|
8415
|
+
퀵페이의 경우 결제 기능을 포함하여 결제수단 등록 및 삭제, PIN 변경 및 초기화, 탈퇴 기능을 지원합니다.
|
|
8416
|
+
|
|
8417
|
+
KCP 퀵페이 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
8418
|
+
|
|
8419
|
+
<div class="tabs-container">
|
|
8420
|
+
|
|
8421
|
+
<div class="tabs-content" data-title="결제수단 등록">
|
|
8422
|
+
|
|
8423
|
+
간편결제 서비스 결제수단을 등록합니다. 최초 결제수단 등록 시 간편결제 서비스 등록이 진행됩니다.
|
|
8424
|
+
|
|
8425
|
+
```ts
|
|
8426
|
+
IMP.request_pay(
|
|
8427
|
+
{
|
|
8428
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8429
|
+
pay_method: "card",
|
|
8430
|
+
merchant_uid: "order_no_0001",
|
|
8431
|
+
name: "결제수단 등록",
|
|
8432
|
+
customer_uid: "use_your_unique_id_with_pay_method_0",
|
|
8433
|
+
bypass: {
|
|
8434
|
+
kcpQuick: {
|
|
8435
|
+
actionType: "Register",
|
|
8436
|
+
encryptedCI: "encrypted_ci",
|
|
8437
|
+
memberID: "use_your_unique_id",
|
|
8438
|
+
},
|
|
8439
|
+
},
|
|
8440
|
+
m_redirect_url: "https://redirection.url",
|
|
8441
|
+
},
|
|
8442
|
+
function (rsp) {
|
|
8443
|
+
// callback 로직
|
|
8444
|
+
},
|
|
8445
|
+
);
|
|
8446
|
+
```
|
|
8447
|
+
|
|
8448
|
+
</div>
|
|
8449
|
+
|
|
8450
|
+
<div class="tabs-content" data-title="결제수단 삭제">
|
|
8451
|
+
|
|
8452
|
+
등록된 간편결제 서비스 결제수단을 삭제합니다.
|
|
8453
|
+
|
|
8454
|
+
```ts
|
|
8455
|
+
IMP.request_pay(
|
|
8456
|
+
{
|
|
8457
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8458
|
+
merchant_uid: "order_no_0001",
|
|
8459
|
+
name: "결제수단 삭제",
|
|
8460
|
+
customer_uid: "use_your_unique_id_with_pay_method_0",
|
|
8461
|
+
bypass: {
|
|
8462
|
+
kcpQuick: {
|
|
8463
|
+
actionType: "Deregister",
|
|
8464
|
+
encryptedCI: "encrypted_ci",
|
|
8465
|
+
memberID: "use_your_unique_id",
|
|
8466
|
+
},
|
|
8467
|
+
},
|
|
8468
|
+
m_redirect_url: "https://redirection.url",
|
|
8469
|
+
},
|
|
8470
|
+
function (rsp) {
|
|
8471
|
+
// callback 로직
|
|
8472
|
+
},
|
|
8473
|
+
);
|
|
8474
|
+
```
|
|
8475
|
+
|
|
8476
|
+
</div>
|
|
8477
|
+
|
|
8478
|
+
</div>
|
|
8479
|
+
|
|
8480
|
+
<div class="tabs-container">
|
|
8481
|
+
|
|
8482
|
+
<div class="tabs-content" data-title="결제 요청">
|
|
8483
|
+
|
|
8484
|
+
등록된 간편결제 결제수단을 사용하여 결제를 진행합니다.
|
|
8485
|
+
|
|
8486
|
+
```ts
|
|
8487
|
+
IMP.request_pay(
|
|
8488
|
+
{
|
|
8489
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8490
|
+
pay_method: "card", //즉시 출금 이용 시 'trans' 입력
|
|
8491
|
+
merchant_uid: "order_no_0001",
|
|
8492
|
+
name: "결제",
|
|
8493
|
+
amount: 1000,
|
|
8494
|
+
buyer_email: "test@portone.io",
|
|
8495
|
+
buyer_name: "구매자이름",
|
|
8496
|
+
buyer_tel: "010-1234-5678",
|
|
8497
|
+
buyer_addr: "서울특별시 강남구 삼성동",
|
|
8498
|
+
buyer_postcode: "123-456",
|
|
8499
|
+
customer_uid: "use_your_unique_id_with_pay_method_0",
|
|
8500
|
+
bypass: {
|
|
8501
|
+
kcpQuick: {
|
|
8502
|
+
actionType: "Pay",
|
|
8503
|
+
encryptedCI: "encrypted_ci",
|
|
8504
|
+
memberID: "use_your_unique_id",
|
|
8505
|
+
},
|
|
8506
|
+
},
|
|
8507
|
+
m_redirect_url: "https://redirection.url",
|
|
8508
|
+
},
|
|
8509
|
+
function (rsp) {
|
|
8510
|
+
// callback 로직
|
|
8511
|
+
},
|
|
8512
|
+
);
|
|
8513
|
+
```
|
|
8514
|
+
|
|
8515
|
+
</div>
|
|
8516
|
+
|
|
8517
|
+
</div>
|
|
8518
|
+
|
|
8519
|
+
<div class="tabs-container">
|
|
8520
|
+
|
|
8521
|
+
<div class="tabs-content" data-title="PIN 변경">
|
|
8522
|
+
|
|
8523
|
+
간편결제 서비스의 PIN을 변경합니다.
|
|
8524
|
+
|
|
8525
|
+
```ts
|
|
8526
|
+
IMP.request_pay(
|
|
8527
|
+
{
|
|
8528
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8529
|
+
merchant_uid: "order_no_0001",
|
|
8530
|
+
name: "PIN 변경",
|
|
8531
|
+
customer_uid: "use_your_unique_id", //`bypass.kcpQuick.memberId`와 동일하게 입력
|
|
8532
|
+
bypass: {
|
|
8533
|
+
kcpQuick: {
|
|
8534
|
+
actionType: "PinChange",
|
|
8535
|
+
encryptedCI: "encrypted_ci",
|
|
8536
|
+
memberID: "use_your_unique_id",
|
|
8537
|
+
},
|
|
8538
|
+
},
|
|
8539
|
+
m_redirect_url: "https://redirection.url",
|
|
8540
|
+
},
|
|
8541
|
+
function (rsp) {
|
|
8542
|
+
// callback 로직
|
|
8543
|
+
},
|
|
8544
|
+
);
|
|
8545
|
+
```
|
|
8546
|
+
|
|
8547
|
+
</div>
|
|
8548
|
+
|
|
8549
|
+
<div class="tabs-content" data-title="PIN 초기화">
|
|
8550
|
+
|
|
8551
|
+
간편결제 서비스의 PIN을 초기화합니다. 기존 등록된 모든 결제수단이 삭제됩니다.
|
|
8552
|
+
|
|
8553
|
+
```ts
|
|
8554
|
+
IMP.request_pay(
|
|
8555
|
+
{
|
|
8556
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8557
|
+
pay_method: "card",
|
|
8558
|
+
merchant_uid: "order_no_0001",
|
|
8559
|
+
name: "PIN 초기화",
|
|
8560
|
+
customer_uid: "use_your_unique_id", // `bypass.kcpQuick.memberId`와 동일하게 입력
|
|
8561
|
+
bypass: {
|
|
8562
|
+
kcpQuick: {
|
|
8563
|
+
actionType: "PinReset",
|
|
8564
|
+
encryptedCI: "encrypted_ci",
|
|
8565
|
+
memberID: "use_your_unique_id",
|
|
8566
|
+
},
|
|
8567
|
+
},
|
|
8568
|
+
m_redirect_url: "https://redirection.url",
|
|
8569
|
+
},
|
|
8570
|
+
function (rsp) {
|
|
8571
|
+
// callback 로직
|
|
8572
|
+
},
|
|
8573
|
+
);
|
|
8574
|
+
```
|
|
8575
|
+
|
|
8576
|
+
</div>
|
|
8577
|
+
|
|
8578
|
+
<div class="tabs-content" data-title="PIN 확인">
|
|
8579
|
+
|
|
8580
|
+
간편결제 서비스의 PIN을 확인합니다.
|
|
8581
|
+
|
|
8582
|
+
```ts
|
|
8583
|
+
IMP.request_pay(
|
|
8584
|
+
{
|
|
8585
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8586
|
+
pay_method: "card",
|
|
8587
|
+
merchant_uid: "order_no_0001",
|
|
8588
|
+
name: "PIN 확인",
|
|
8589
|
+
customer_uid: "use_your_unique_id", // `bypass.kcpQuick.memberId`와 동일하게 입력
|
|
8590
|
+
bypass: {
|
|
8591
|
+
kcpQuick: {
|
|
8592
|
+
actionType: "PinCheck",
|
|
8593
|
+
encryptedCI: "encrypted_ci",
|
|
8594
|
+
memberID: "use_your_unique_id",
|
|
8595
|
+
},
|
|
8596
|
+
},
|
|
8597
|
+
m_redirect_url: "https://redirection.url",
|
|
8598
|
+
},
|
|
8599
|
+
function (rsp) {
|
|
8600
|
+
// callback 로직
|
|
8601
|
+
},
|
|
8602
|
+
);
|
|
8603
|
+
```
|
|
8604
|
+
|
|
8605
|
+
</div>
|
|
8606
|
+
|
|
8607
|
+
</div>
|
|
8608
|
+
|
|
8609
|
+
<div class="tabs-container">
|
|
8610
|
+
|
|
8611
|
+
<div class="tabs-content" data-title="등록된 전화번호 변경">
|
|
8612
|
+
|
|
8613
|
+
간편결제 서비스에 등록된 전화번호를 변경합니다.
|
|
8614
|
+
|
|
8615
|
+
```ts
|
|
8616
|
+
IMP.request_pay(
|
|
8617
|
+
{
|
|
8618
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8619
|
+
merchant_uid: "order_no_0001",
|
|
8620
|
+
name: "전화번호 변경",
|
|
8621
|
+
customer_uid: "use_your_unique_id", // `bypass.kcpQuick.memberId`와 동일하게 입력
|
|
8622
|
+
bypass: {
|
|
8623
|
+
kcpQuick: {
|
|
8624
|
+
actionType: "PhoneChange",
|
|
8625
|
+
encryptedCI: "encrypted_ci",
|
|
8626
|
+
memberID: "use_your_unique_id",
|
|
8627
|
+
},
|
|
8628
|
+
},
|
|
8629
|
+
m_redirect_url: "https://redirection.url",
|
|
8630
|
+
},
|
|
8631
|
+
function (rsp) {
|
|
8632
|
+
// callback 로직
|
|
8633
|
+
},
|
|
8634
|
+
);
|
|
8635
|
+
```
|
|
8636
|
+
|
|
8637
|
+
</div>
|
|
8638
|
+
|
|
8639
|
+
</div>
|
|
8640
|
+
|
|
8641
|
+
<div class="tabs-container">
|
|
8642
|
+
|
|
8643
|
+
<div class="tabs-content" data-title="선불머니+간편결제 서비스 유저 등록">
|
|
8644
|
+
|
|
8645
|
+
선불머니와 간편결제 서비스를 함께 이용할 수 있도록 유저를 등록합니다. 기 간편결제 서비스 유저에서 호출 시 선불머니 서비스 가입으로 진행합니다.
|
|
8646
|
+
|
|
8647
|
+
<div class="hint" data-style="warning">
|
|
8648
|
+
|
|
8649
|
+
이 기능은 KCP와 사전 협의된 특정 고객만 사용 가능합니다.
|
|
8650
|
+
|
|
8651
|
+
</div>
|
|
8652
|
+
|
|
8653
|
+
```ts
|
|
8654
|
+
IMP.request_pay(
|
|
8655
|
+
{
|
|
8656
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8657
|
+
pay_method: "card",
|
|
8658
|
+
merchant_uid: "order_no_0001",
|
|
8659
|
+
name: "선불머니+간편결제 서비스 유저 등록",
|
|
8660
|
+
bypass: {
|
|
8661
|
+
kcpQuick: {
|
|
8662
|
+
actionType: "SignUp",
|
|
8663
|
+
encryptedCI: "encrypted_ci",
|
|
8664
|
+
memberID: "use_your_unique_id",
|
|
8665
|
+
},
|
|
8666
|
+
},
|
|
8667
|
+
m_redirect_url: "https://redirection.url",
|
|
8668
|
+
},
|
|
8669
|
+
function (rsp) {
|
|
8670
|
+
// callback 로직
|
|
8671
|
+
},
|
|
8672
|
+
);
|
|
8673
|
+
```
|
|
8674
|
+
|
|
8675
|
+
</div>
|
|
8676
|
+
|
|
8677
|
+
</div>
|
|
8678
|
+
|
|
8679
|
+
<div class="tabs-container">
|
|
8680
|
+
|
|
8681
|
+
<div class="tabs-content" data-title="간편결제 서비스 해지">
|
|
8682
|
+
|
|
8683
|
+
간편결제 서비스를 해지합니다. 등록된 모든 결제수단이 삭제됩니다.
|
|
8684
|
+
|
|
8685
|
+
```ts
|
|
8686
|
+
IMP.request_pay(
|
|
8687
|
+
{
|
|
8688
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8689
|
+
merchant_uid: "order_no_0001",
|
|
8690
|
+
name: "간편결제 서비스 해지",
|
|
8691
|
+
customer_uid: "use_your_unique_id", //`bypass.kcpQuick.memberId`와 동일하게 입력
|
|
8692
|
+
bypass: {
|
|
8693
|
+
kcpQuick: {
|
|
8694
|
+
actionType: "Terminate",
|
|
8695
|
+
encryptedCI: "encrypted_ci",
|
|
8696
|
+
memberID: "use_your_unique_id",
|
|
8697
|
+
},
|
|
8698
|
+
},
|
|
8699
|
+
m_redirect_url: "https://redirection.url",
|
|
8700
|
+
},
|
|
8701
|
+
function (rsp) {
|
|
8702
|
+
// callback 로직
|
|
8703
|
+
},
|
|
8704
|
+
);
|
|
8705
|
+
```
|
|
8706
|
+
|
|
8707
|
+
</div>
|
|
8708
|
+
|
|
8709
|
+
<div class="tabs-content" data-title="선불머니+간편결제 서비스 해지">
|
|
8710
|
+
|
|
8711
|
+
선불머니와 간편결제 서비스를 모두 해지합니다. 선불머니 잔액이 남아있는 경우 사전에 환급 요청을 완료해야 합니다.
|
|
8712
|
+
|
|
8713
|
+
<div class="hint" data-style="warning">
|
|
8714
|
+
|
|
8715
|
+
이 기능은 KCP와 사전 협의된 특정 고객만 사용 가능합니다.
|
|
8716
|
+
|
|
8717
|
+
</div>
|
|
8718
|
+
|
|
8719
|
+
```ts
|
|
8720
|
+
IMP.request_pay(
|
|
8721
|
+
{
|
|
8722
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8723
|
+
merchant_uid: "order_no_0001",
|
|
8724
|
+
name: "선불머니+간편결제 서비스 해지",
|
|
8725
|
+
bypass: {
|
|
8726
|
+
kcpQuick: {
|
|
8727
|
+
actionType: "Leave",
|
|
8728
|
+
encryptedCI: "encrypted_ci",
|
|
8729
|
+
memberID: "use_your_unique_id",
|
|
8730
|
+
},
|
|
8731
|
+
},
|
|
8732
|
+
m_redirect_url: "https://redirection.url",
|
|
8733
|
+
},
|
|
8734
|
+
function (rsp) {
|
|
8735
|
+
// callback 로직
|
|
8736
|
+
},
|
|
8737
|
+
);
|
|
8738
|
+
```
|
|
8739
|
+
|
|
8740
|
+
</div>
|
|
8741
|
+
|
|
8742
|
+
</div>
|
|
8743
|
+
|
|
8744
|
+
<div class="tabs-container">
|
|
8745
|
+
|
|
8746
|
+
<div class="tabs-content" data-title="선불머니 환급계좌 등록 및 변경">
|
|
8747
|
+
|
|
8748
|
+
선불머니 환급을 위한 계좌 정보를 등록하거나 변경합니다.
|
|
8749
|
+
|
|
8750
|
+
<div class="hint" data-style="warning">
|
|
8751
|
+
|
|
8752
|
+
이 기능은 KCP와 사전 협의된 특정 고객만 사용 가능합니다.
|
|
8753
|
+
|
|
8754
|
+
</div>
|
|
8755
|
+
|
|
8756
|
+
```ts
|
|
8757
|
+
IMP.request_pay(
|
|
8758
|
+
{
|
|
8759
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8760
|
+
merchant_uid: "order_no_0001",
|
|
8761
|
+
name: "선불머니 환급계좌 등록 및 변경",
|
|
8762
|
+
bypass: {
|
|
8763
|
+
kcpQuick: {
|
|
8764
|
+
actionType: "RefundAccount",
|
|
8765
|
+
encryptedCI: "encrypted_ci",
|
|
8766
|
+
memberID: "use_your_unique_id",
|
|
8767
|
+
},
|
|
8768
|
+
},
|
|
8769
|
+
m_redirect_url: "https://redirection.url",
|
|
8770
|
+
},
|
|
8771
|
+
function (rsp) {
|
|
8772
|
+
// callback 로직
|
|
8773
|
+
},
|
|
8774
|
+
);
|
|
8775
|
+
```
|
|
8776
|
+
|
|
8777
|
+
</div>
|
|
8778
|
+
|
|
8779
|
+
</div>
|
|
8780
|
+
|
|
8781
|
+
<div class="tabs-container">
|
|
8782
|
+
|
|
8783
|
+
<div class="tabs-content" data-title="선불머니 환급 요청">
|
|
8784
|
+
|
|
8785
|
+
선불머니 잔액을 등록된 계좌로 환급 요청합니다.
|
|
8786
|
+
|
|
8787
|
+
<div class="hint" data-style="warning">
|
|
8788
|
+
|
|
8789
|
+
이 기능은 KCP와 사전 협의된 특정 고객만 사용 가능합니다.
|
|
8790
|
+
|
|
8791
|
+
</div>
|
|
8792
|
+
|
|
8793
|
+
```ts
|
|
8794
|
+
IMP.request_pay(
|
|
8795
|
+
{
|
|
8796
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8797
|
+
merchant_uid: "order_no_0001",
|
|
8798
|
+
name: "선불머니 환급 요청",
|
|
8799
|
+
bypass: {
|
|
8800
|
+
kcpQuick: {
|
|
8801
|
+
actionType: "PrepaidRefund",
|
|
8802
|
+
encryptedCI: "encrypted_ci",
|
|
8803
|
+
memberID: "use_your_unique_id",
|
|
8804
|
+
},
|
|
8805
|
+
},
|
|
8806
|
+
m_redirect_url: "https://redirection.url",
|
|
8807
|
+
},
|
|
8808
|
+
function (rsp) {
|
|
8809
|
+
// callback 로직
|
|
8810
|
+
},
|
|
8811
|
+
);
|
|
8812
|
+
```
|
|
8813
|
+
|
|
8814
|
+
</div>
|
|
8815
|
+
|
|
8816
|
+
</div>
|
|
8817
|
+
|
|
8818
|
+
<div class="hint" data-style="info">
|
|
8819
|
+
|
|
8820
|
+
퀵페이의 경우 m\_redirect\_url시 다음과 같이 4개의 파라미터가 Query String으로 전달됩니다.
|
|
8821
|
+
|
|
8822
|
+
- `imp_uid`
|
|
8823
|
+
- `merchant_uid`
|
|
8824
|
+
- `imp_status` : true 또는 false
|
|
8825
|
+
- `kcp_action` : 인증창 유형 (요청 시 입력한 bypass.kcpQuick.actionType 값)
|
|
8826
|
+
|
|
8827
|
+
`kcp_action`이 Register 이고 `imp_status`가 true인 경우 결제수단 등록에 성공하였다는 것을 의미합니다.
|
|
8828
|
+
|
|
8829
|
+
</div>
|
|
8830
|
+
|
|
8831
|
+
#### 주요 파라미터
|
|
8832
|
+
|
|
8833
|
+
- channelKey: string
|
|
8834
|
+
|
|
8835
|
+
**채널키**
|
|
8836
|
+
|
|
8837
|
+
결제를 진행할 채널을 지정합니다.
|
|
8838
|
+
|
|
8839
|
+
포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
|
|
8840
|
+
|
|
8841
|
+
(최신 JavaScript SDK 버전부터 사용 가능합니다.)
|
|
8842
|
+
|
|
8843
|
+
- pg(deprecated)?: string
|
|
8844
|
+
|
|
8845
|
+
**PG사 구분코드**
|
|
8846
|
+
|
|
8847
|
+
포트원 콘솔 내 \[연동 관리] > \[연동 정보] > \[채널 관리] 화면에서 채널 추가 후
|
|
8848
|
+
`kcp_quick.{mid(사이트코드)}` 형식으로 채널을 지정할 때 사용됩니다.
|
|
8849
|
+
|
|
8850
|
+
<div class="hint" data-style="warning">
|
|
8851
|
+
|
|
8852
|
+
`pg` 파라미터는 지원 중단 예정입니다.
|
|
8853
|
+
|
|
8854
|
+
JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
|
|
8855
|
+
|
|
8856
|
+
</div>
|
|
8857
|
+
|
|
8858
|
+
- pay\_method?: string
|
|
8859
|
+
|
|
8860
|
+
**결제수단 구분코드**
|
|
8861
|
+
|
|
8862
|
+
결제 요청 시 혹은 결제수단 등록 시 결제수단을 지정할 때 사용됩니다.
|
|
8863
|
+
결제(actionType:Pay), 결제수단등록(actionType:Register) 시 필수로 입력해야합니다.
|
|
8864
|
+
|
|
8865
|
+
- card (카드)
|
|
8866
|
+
- trans (즉시출금)
|
|
8867
|
+
|
|
8868
|
+
- merchant\_uid: string
|
|
8869
|
+
|
|
8870
|
+
**고객사 주문 고유 번호**
|
|
8871
|
+
|
|
8872
|
+
고객사에서 채번하는 주문 고유 번호로 매번 고유하게 채번되어야 합니다.
|
|
8873
|
+
|
|
8874
|
+
- amount?: integer
|
|
8875
|
+
|
|
8876
|
+
**결제금액**
|
|
8877
|
+
|
|
8878
|
+
결제 요청 시 필수 입력입니다.
|
|
8879
|
+
|
|
8880
|
+
- customer\_uid?: string
|
|
8881
|
+
|
|
8882
|
+
**결제 수단에 대한 고유 식별값**
|
|
8883
|
+
|
|
8884
|
+
퀵페이에 등록된 결제수단과 1:1 맵핑됩니다.
|
|
8885
|
+
결제수단 등록, 결제, 결제수단 해지 시 필수로 입력해야 합니다.
|
|
8886
|
+
|
|
8887
|
+
- bypass?: oneof object
|
|
8888
|
+
|
|
8889
|
+
**PG사 결제창 호출 시 PG사로 그대로 bypass할 파라미터들의 모음**
|
|
8890
|
+
|
|
8891
|
+
- kcpQuick?: object
|
|
8892
|
+
|
|
8893
|
+
**KCP 퀵페이 설정정보**
|
|
8894
|
+
|
|
8895
|
+
퀵페이 결제시 필수로 입력해야 합니다.
|
|
8896
|
+
|
|
8897
|
+
- actionType: string
|
|
8898
|
+
|
|
8899
|
+
**호출 유형**
|
|
8900
|
+
|
|
8901
|
+
- Register : 결제 수단 등록
|
|
8902
|
+
- UserRegister : 결제 수단 등록 없이 간편결제 서비스 유저 등록
|
|
8903
|
+
- Deregister : 결제 수단 삭제
|
|
8904
|
+
- Pay : 결제
|
|
8905
|
+
- PinChange : PIN 변경
|
|
8906
|
+
- PinReset : PIN 초기화
|
|
8907
|
+
- PinCheck : PIN 확인
|
|
8908
|
+
- PhoneChange : 전화번호 변경
|
|
8909
|
+
- Terminate : 간편결제 서비스 해지
|
|
8910
|
+
- SignUp : 간편결제+선불머니 서비스 유저 등록 (사전 협의 필요)
|
|
8911
|
+
- Leave : 간편결제+선불머니 서비스 해지 (사전 협의 필요)
|
|
8912
|
+
- PrepaidRefundAccount: 선불머니 환급계좌 등록 및 변경 (사전 협의 필요)
|
|
8913
|
+
- PrepaidRefund: 선불머니 환급 요청 (사전 협의 필요)
|
|
8914
|
+
|
|
8915
|
+
- encryptedCI: string
|
|
8916
|
+
|
|
8917
|
+
**암호화된 본인인증 CI**
|
|
8918
|
+
|
|
8919
|
+
암호화 방법은 [`encryptedCI` 파라미터 안내](#encryptedci-parameter-guide)를 참고하세요.
|
|
8920
|
+
|
|
8921
|
+
- memberCI: string
|
|
8922
|
+
|
|
8923
|
+
**본인인증 CI**
|
|
8924
|
+
|
|
8925
|
+
<div class="hint" data-style="warning">
|
|
8926
|
+
|
|
8927
|
+
보안상의 이유로 `memberCI` 파라미터는 지원 중단 되었습니다. `encryptedCI` 파라미터를 사용해야합니다.
|
|
8928
|
+
|
|
8929
|
+
</div>
|
|
8930
|
+
|
|
8931
|
+
- memberID: string
|
|
8932
|
+
|
|
8933
|
+
**사용자 식별값**
|
|
8934
|
+
|
|
8935
|
+
고객사에서 결제유저를 식별하기 위한 값
|
|
8936
|
+
최대 16글자까지 입력가능하며, 하나의 유저가 여러 개의 결제수단을 등록하는 경우 동일한 `memberID`를 입력해야 합니다.
|
|
8937
|
+
|
|
8938
|
+
- deviceID?: string
|
|
8939
|
+
|
|
8940
|
+
**디바이스 식별값**
|
|
8941
|
+
|
|
8942
|
+
미 입력시 고객이 사용한 브라우저 정보(User-Agent)가 입력됩니다.
|
|
8943
|
+
|
|
8944
|
+
- noAuth?: boolean
|
|
8945
|
+
|
|
8946
|
+
**무인증 등록/결제 여부**
|
|
8947
|
+
|
|
8948
|
+
`true`로 입력한 경우 무인증 키가 발급되며, 이후 결제시 PIN 인증 과정이 생략됩니다.
|
|
8949
|
+
|
|
8950
|
+
- true : 무인증 결제
|
|
8951
|
+
- false : 인증 결제
|
|
8952
|
+
|
|
8953
|
+
- installment?: number
|
|
8954
|
+
|
|
8955
|
+
**할부 개월수**
|
|
8956
|
+
|
|
8957
|
+
입력하지 않는 경우 일시불로 진행됩니다.
|
|
8958
|
+
|
|
8959
|
+
- useCardPoint?: boolean
|
|
8960
|
+
|
|
8961
|
+
**카드사 포인트 결제 여부**
|
|
8962
|
+
|
|
8963
|
+
입력하지 않는 경우 미사용으로 진행됩니다.
|
|
8964
|
+
|
|
8965
|
+
- true : 카드사 포인트 사용
|
|
8966
|
+
- false : 카드사 포인트 미사용
|
|
8967
|
+
|
|
8968
|
+
#### 유의사항
|
|
8969
|
+
|
|
8970
|
+
<details>
|
|
8971
|
+
|
|
8972
|
+
<summary>`customer_uid` 파라미터 안내</summary>
|
|
8973
|
+
|
|
8974
|
+
결제수단 등록/삭제, 결제 요청시에는 결제수단을 식별하는 `customer_uid`를 입력한 후 사용해야 합니다.
|
|
8975
|
+
이 외의 PIN 변경/확인/초기화, 사용자 등록, 해지 요청시에는 `customer_uid`에 결제수단 등록시 입력한 `memberID`를 입력해야 합니다.
|
|
8976
|
+
위의 경우에 `customer_uid` 파라미터에 발급시 입력했던 `customer_uid`를 입력하는 경우 에러가 리턴됩니다.
|
|
8977
|
+
|
|
8978
|
+
</details>
|
|
8979
|
+
|
|
8980
|
+
<details>
|
|
8981
|
+
|
|
8982
|
+
<summary>`encryptedCI` 파라미터 안내</summary>
|
|
8983
|
+
|
|
8984
|
+
본인인증 후 전달받은 CI 값을 아래 방법으로 암호화하여 입력해야합니다.
|
|
8985
|
+
|
|
8986
|
+
포트원 계정의 [REST API Secret](https://developers.portone.io/api/rest-v1/auth?v=v1) 을 SHA-256 해시 알고리즘으로 처리하여 암호화 키를 생성한 후, 해당 키를 사용해 CI 데이터를 AES-256-ECB 방식으로 암호화해야 합니다.
|
|
8987
|
+
암호화된 결과는 Base64로 인코딩하여 encryptedCI 파라미터 값으로 전달합니다.
|
|
8988
|
+
|
|
8989
|
+
```pseudo
|
|
8990
|
+
FUNCTION encryptCi(ci, apiSecret):
|
|
8991
|
+
# Step 1: SHA-256으로 API Secret을 해시하여 암호화 키 생성
|
|
8992
|
+
key = SHA256(apiSecret)
|
|
8993
|
+
|
|
8994
|
+
# Step 2: AES-256-ECB 알고리즘으로 CI 데이터를 암호화
|
|
8995
|
+
encryptedData = AES256Encrypt(data = ci, key = key, mode = ECB)
|
|
8996
|
+
|
|
8997
|
+
# Step 3: 암호화된 데이터를 Base64로 인코딩
|
|
8998
|
+
base64EncodedData = Base64Encode(encryptedData)
|
|
8999
|
+
|
|
9000
|
+
# Step 4: Base64 인코딩된 결과 반환
|
|
9001
|
+
RETURN base64EncodedData
|
|
9002
|
+
END FUNCTION
|
|
9003
|
+
```
|
|
9004
|
+
|
|
9005
|
+
</details>
|
|
9006
|
+
|
|
9007
|
+
<details>
|
|
9008
|
+
|
|
9009
|
+
<summary>결제수단을 여러개 등록할 수 있습니다.</summary>
|
|
9010
|
+
|
|
9011
|
+
한 고객에게 여러개의 결제수단을 등록할 수 있습니다.
|
|
9012
|
+
고객 식별 정보(`memberID`)와 결제 수단 식별 정보(`customer_uid`)의 경우 1:N으로 맵핑되며,
|
|
9013
|
+
이미 등록한 고객의 `memberID`를 동일하게 입력한 후 사용하지 않은 `customer_uid`를 지정하는 경우 여러개의 결제 수단을 등록할 수 있습니다.
|
|
9014
|
+
|
|
9015
|
+
</details>
|
|
9016
|
+
|
|
9017
|
+
<details>
|
|
9018
|
+
|
|
9019
|
+
<summary>결제수단 삭제 요청시 등록할 때 입력한 정보를 동일하게 입력해야 합니다.</summary>
|
|
9020
|
+
|
|
9021
|
+
결제수단 삭제(actionType:Deregister) 요청시 결제수단 등록할 때 사용된 `customer_uid` + `encryptedCI` + `memberID` + `deviceID` + `noAuth` 조합을
|
|
9022
|
+
동일하게 전송해야 합니다.
|
|
9023
|
+
|
|
9024
|
+
</details>
|
|
9025
|
+
|
|
9026
|
+
<details>
|
|
9027
|
+
|
|
9028
|
+
<summary>PIN 초기화 시 기존에 등록된 모든 결제수단이 삭제됩니다.</summary>
|
|
9029
|
+
|
|
9030
|
+
PIN 초기화 시 기존에 등록된 모든 결제수단이 삭제됩니다. 이에 따라 고객사에서는 `customer_uid`로 저장된 데이터를 일괄 삭제해야 합니다.
|
|
9031
|
+
PIN 초기화 이후 [빌링키 삭제 API](https://developers.portone.io/api/rest-v1/billingkey?v=v1#delete%20%2Fsubscribe%2Fcustomers%2F%7Bcustomer_uid%7D)를 이용하여 일괄 삭제할 수 있습니다.
|
|
9032
|
+
만약 PIN 초기화 전에 삭제를 시도하는 경우 에러 메시지와 함께 삭제가 불가능합니다.
|
|
9033
|
+
|
|
9034
|
+
</details>
|
|
9035
|
+
|
|
9036
|
+
<details>
|
|
9037
|
+
|
|
9038
|
+
<summary>등록된 전화번호 변경 기능은 사전 협의 후 사용 가능합니다.</summary>
|
|
9039
|
+
|
|
9040
|
+
전화 번호 변경(actionType:PhoneChange)은 퀵페이에 등록된 전화번호를 변경할 수 있는 기능입니다.
|
|
9041
|
+
해당 기능 사용을 원하시는 경우 KCP와 사전에 협의가 필요합니다.
|
|
9042
|
+
|
|
9043
|
+
</details>
|
|
9044
|
+
|
|
9045
|
+
<details>
|
|
9046
|
+
|
|
9047
|
+
<summary>결제 시 등록된 결제수단 화면을 표시할 수 있습니다.</summary>
|
|
9048
|
+
|
|
9049
|
+
결제(actionType:Pay)시 `customer_uid`를 빈 값 또는 생략한 경우 등록된 결제수단을 선택하는 화면이 표시됩니다.
|
|
9050
|
+
|
|
9051
|
+
</details>
|
|
9052
|
+
|
|
9053
|
+
<details>
|
|
9054
|
+
|
|
9055
|
+
<summary>결제 금액이 30만원 이상인 경우 ARS 인증이 진행됩니다.</summary>
|
|
9056
|
+
|
|
9057
|
+
결제 금액이 30만원 이상인 경우 ARS 인증이 진행되며, 퀵페이 등록시 입력된 전화 번호로 전화가 갑니다.
|
|
9058
|
+
|
|
9059
|
+
</details>
|
|
9060
|
+
|
|
9061
|
+
<details>
|
|
9062
|
+
|
|
9063
|
+
<summary>퀵페이 해지 안내 </summary>
|
|
9064
|
+
|
|
9065
|
+
해지(actionType:Terminate|Leave)시
|
|
9066
|
+
[빌링키 삭제 API](https://developers.portone.io/api/rest-v1/billingkey?v=v1#delete%20%2Fsubscribe%2Fcustomers%2F%7Bcustomer_uid%7D)를 이용하여 등록되어 있던 결제수단을 일괄 삭제해야 합니다.
|
|
9067
|
+
|
|
9068
|
+
</details>
|
|
9069
|
+
|
|
9070
|
+
<details>
|
|
9071
|
+
|
|
9072
|
+
<summary>선불머니 서비스 이용 제한 안내</summary>
|
|
9073
|
+
|
|
9074
|
+
선불머니 관련 기능은 KCP와 사전에 협의된 특정 고객만 사용할 수 있는 제한된 서비스입니다.
|
|
9075
|
+
|
|
9076
|
+
**제한 기능 목록:**
|
|
9077
|
+
|
|
9078
|
+
- `SignUp`: 간편결제+선불머니 서비스 유저 등록
|
|
9079
|
+
- `Leave`: 간편결제+선불머니 서비스 해지 (선불머니 환급 완료 후 진행 가능)
|
|
9080
|
+
- `PrepaidRefundAccount`: 선불머니 환급계좌 등록 및 변경
|
|
9081
|
+
- `PrepaidRefund`: 선불머니 환급 요청
|
|
9082
|
+
|
|
9083
|
+
</details>
|
|
9084
|
+
|
|
9085
|
+
<details>
|
|
9086
|
+
|
|
9087
|
+
<summary>무인증 결제 안내</summary>
|
|
9088
|
+
|
|
9089
|
+
결제 수단 등록, PIN 체크시 `noAuth:true` 파라미터를 추가하여 요청한 경우 무인증 등록이 가능합니다.
|
|
9090
|
+
등록 이후 결제 요청하는 경우 무인증 결제를 이용할 수 있습니다. 무인증 결제시 PIN 입력 과정이 생략되며,
|
|
9091
|
+
바로 결제가 진행됩니다.
|
|
9092
|
+
|
|
9093
|
+
만약 무인증 등록과정 없이 무인증 결제가 요청되는 경우 PIN 입력 화면이 표시되고, 올바른 PIN 입력시 무인증 등록 및 결제가 진행됩니다.
|
|
9094
|
+
|
|
9095
|
+
</details>
|
|
9096
|
+
|
|
9097
|
+
<details>
|
|
9098
|
+
|
|
9099
|
+
<summary>선불머니 결제의 경우 부분취소 불가</summary>
|
|
9100
|
+
|
|
9101
|
+
선불머니 결제는 KCP 정책상 부분취소를 지원하지 않으며 전체취소만 가능합니다.
|
|
9102
|
+
|
|
9103
|
+
**대안 방법:**
|
|
9104
|
+
|
|
9105
|
+
- 부분 환불이 필요한 경우: 전체 취소 후 차액만큼 재결제 진행
|
|
9106
|
+
|
|
9107
|
+
<div class="hint" data-style="info">
|
|
9108
|
+
|
|
9109
|
+
KCP에서 선불머니 부분취소 기능 지원 예정이나, 현재로서는 위의 대안 방법을 활용하시기 바랍니다.
|
|
9110
|
+
|
|
9111
|
+
</div>
|
|
9112
|
+
|
|
9113
|
+
</details>
|
|
9114
|
+
|
|
9115
|
+
|
|
9116
|
+
# https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme
|
|
8315
9117
|
|
|
8316
9118
|
---
|
|
8317
9119
|
title: NHN KCP
|
|
@@ -8324,7 +9126,7 @@ targetVersions:
|
|
|
8324
9126
|
|
|
8325
9127
|
## 채널 설정하기
|
|
8326
9128
|
|
|
8327
|
-
[결제대행사 채널 설정하기](
|
|
9129
|
+
[결제대행사 채널 설정하기](../../../../ready/readme#3-결제대행사-채널-설정하기)의 내용을 참고하여 PG 설정을 진행합니다.
|
|
8328
9130
|
|
|
8329
9131
|
## 일반결제
|
|
8330
9132
|
|
|
@@ -8663,594 +9465,138 @@ IMP.request_pay({
|
|
|
8663
9465
|
|
|
8664
9466
|
<summary>휴대폰 소액결제시 `buyer_name`과 `bypass.shop_user_id` 파라미터를 필수 입력해야합니다.</summary>
|
|
8665
9467
|
|
|
8666
|
-
결제수단 중 휴대폰 소액결제를 요청하는 경우 구매자 이름(`buyer_name`)과 고객사에서 관리하는 회원ID(`bypass.shop_user_id`)를 필수로 입력해야 합니다.
|
|
8667
|
-
|
|
8668
|
-
<div class="tabs-container">
|
|
8669
|
-
|
|
8670
|
-
<div class="tabs-content" data-title="휴대폰 소액결제 호출 예제">
|
|
8671
|
-
|
|
8672
|
-
```ts
|
|
8673
|
-
IMP.request_pay({
|
|
8674
|
-
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8675
|
-
pay_method: "phone", //휴대폰 소액결제
|
|
8676
|
-
merchant_uid: "A00021-TEST",
|
|
8677
|
-
name: "당근 10kg",
|
|
8678
|
-
amount: 1004,
|
|
8679
|
-
buyer_email: "test@portone.io",
|
|
8680
|
-
buyer_name: "포트원 기술지원팀", // 휴대폰 결제시 필수
|
|
8681
|
-
buyer_tel: "010-1234-5678",
|
|
8682
|
-
buyer_addr: "서울특별시 강남구 삼성동",
|
|
8683
|
-
buyer_postcode: "123-456",
|
|
8684
|
-
bypass: {
|
|
8685
|
-
shop_user_id: "abaddd", // 고객사 회원 id 입력 (휴대폰 결제시 필수)
|
|
8686
|
-
},
|
|
8687
|
-
});
|
|
8688
|
-
```
|
|
8689
|
-
|
|
8690
|
-
</div>
|
|
8691
|
-
|
|
8692
|
-
</div>
|
|
8693
|
-
|
|
8694
|
-
</details>
|
|
8695
|
-
|
|
8696
|
-
<details>
|
|
8697
|
-
|
|
8698
|
-
<summary>휴대폰 소액결제 시 전화번호를 고정할 수 있습니다.</summary>
|
|
8699
|
-
|
|
8700
|
-
`prefill.phoneNumber` 파라미터에 고정할 휴대폰 번호를 입력한 후 결제를 요청합니다.
|
|
8701
|
-
|
|
8702
|
-
</details>
|
|
8703
|
-
|
|
8704
|
-
<details>
|
|
8705
|
-
|
|
8706
|
-
<summary>에스크로 결제관련 안내</summary>
|
|
8707
|
-
|
|
8708
|
-
에스크로 결제를 위해서는 **`escrow`** 파라미터를 추가하고 **true** 값으로 설정되어야 합니다.
|
|
8709
|
-
에스크로 결제 요청시 **장바구니 상품을 묶어서 결제하는 경우**
|
|
8710
|
-
해당 품목에 대한 정보를 전달하기 위해 해당 상품 관련 정보를 추가 파라미터(**`kcpProducts`**)로 전달해야 합니다.
|
|
8711
|
-
**`kcpProducts`** 는 다음 4개의 필수 속성으로 구성된 객체배열입니다.
|
|
8712
|
-
|
|
8713
|
-
- orderNumber : 상품주문번호
|
|
8714
|
-
- name : 상품명
|
|
8715
|
-
- quantity : 수량
|
|
8716
|
-
- amount : 상품 가격
|
|
8717
|
-
|
|
8718
|
-
**`amount`** 값은 결제 금액(`param.amount`) 값과 관계가 없으며 비교 검증하지 않습니다.
|
|
8719
|
-
|
|
8720
|
-
<div class="tabs-container">
|
|
8721
|
-
|
|
8722
|
-
<div class="tabs-content" data-title="탭">
|
|
8723
|
-
|
|
8724
|
-
```ts title="JavaScript SDK"
|
|
8725
|
-
IMP.request_pay({
|
|
8726
|
-
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8727
|
-
escrow: true, // 에스크로 결제인 경우 필요
|
|
8728
|
-
kcpProducts: [
|
|
8729
|
-
{
|
|
8730
|
-
orderNumber: "xxxx",
|
|
8731
|
-
name: "상품A",
|
|
8732
|
-
quantity: 3,
|
|
8733
|
-
amount: 1000,
|
|
8734
|
-
},
|
|
8735
|
-
{
|
|
8736
|
-
orderNumber: "yyyy",
|
|
8737
|
-
name: "상품B",
|
|
8738
|
-
quantity: 2,
|
|
8739
|
-
amount: 3000,
|
|
8740
|
-
},
|
|
8741
|
-
],
|
|
8742
|
-
});
|
|
8743
|
-
```
|
|
8744
|
-
|
|
8745
|
-
</div>
|
|
8746
|
-
|
|
8747
|
-
</div>
|
|
8748
|
-
|
|
8749
|
-
</details>
|
|
8750
|
-
|
|
8751
|
-
<details>
|
|
8752
|
-
|
|
8753
|
-
<summary>결제창 내 할인쿠폰 영역 활성/비활성화 안내</summary>
|
|
8754
|
-
|
|
8755
|
-
`bypass.coupon_apply_yn`파라미터를 이용하여 결제창 내 할인쿠폰 영역을 활성/비활성화 할 수 있습니다.
|
|
8756
|
-
해당 기능은 KCP와 협의 후 사용 가능합니다.
|
|
8757
|
-
|
|
8758
|
-
- `Y`: 활성
|
|
8759
|
-
- `N`: 비활성
|
|
8760
|
-
|
|
8761
|
-
</details>
|
|
8762
|
-
|
|
8763
|
-
### SDK 빌링키 발급 요청하기
|
|
8764
|
-
|
|
8765
|
-
[JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여 NHN
|
|
8766
|
-
KCP 결제창을 호출할 수 있습니다. **결제결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
|
|
8767
|
-
**callback** 으로 수신되고
|
|
8768
|
-
모바일의 경우 **m\_redirect\_url** 로 리디렉션됩니다.
|
|
8769
|
-
|
|
8770
|
-
빌링키 발급 요청 시에는 `customer_uid` 파라미터를 입력한 후 호출해야 합니다.
|
|
8771
|
-
|
|
8772
|
-
KCP 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
8773
|
-
|
|
8774
|
-
<div class="tabs-container">
|
|
8775
|
-
|
|
8776
|
-
<div class="tabs-content" data-title="SDK 빌링키 발급 요청">
|
|
8777
|
-
|
|
8778
|
-
```ts title="Javascript SDK" showLineNumbers
|
|
8779
|
-
IMP.request_pay(
|
|
8780
|
-
{
|
|
8781
|
-
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
8782
|
-
pay_method: "card", //'card'만 지원됩니다.
|
|
8783
|
-
merchant_uid: "order_monthly_0001", //상점에서 생성한 고유 주문번호
|
|
8784
|
-
name: "정기결제",
|
|
8785
|
-
amount: 0, //결제창에 표시될 금액. 발급 요청시에는 결제가 승인되지 않습니다.
|
|
8786
|
-
customer_uid: "your-customer-unique-id", //포트원 빌링키로 필수 입력해야 합니다.
|
|
8787
|
-
buyer_email: "test@portone.io",
|
|
8788
|
-
buyer_name: "포트원",
|
|
8789
|
-
buyer_tel: "02-1234-1234",
|
|
8790
|
-
m_redirect_url: "https://testtest.test", //모바일에서 결제 완료 후 리디렉션 될 URL
|
|
8791
|
-
},
|
|
8792
|
-
function (rsp) {
|
|
8793
|
-
if (rsp.success) {
|
|
8794
|
-
alert("빌링키 발급 성공");
|
|
8795
|
-
} else {
|
|
8796
|
-
alert("빌링키 발급 실패");
|
|
8797
|
-
}
|
|
8798
|
-
},
|
|
8799
|
-
);
|
|
8800
|
-
```
|
|
8801
|
-
|
|
8802
|
-
</div>
|
|
8803
|
-
|
|
8804
|
-
</div>
|
|
8805
|
-
|
|
8806
|
-
#### 주요 파라미터 설명
|
|
8807
|
-
|
|
8808
|
-
- channelKey: string
|
|
8809
|
-
|
|
8810
|
-
**채널키**
|
|
8811
|
-
|
|
8812
|
-
결제를 진행할 채널을 지정합니다.
|
|
8813
|
-
|
|
8814
|
-
포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
|
|
8815
|
-
|
|
8816
|
-
(최신 JavaScript SDK 버전부터 사용 가능합니다.)
|
|
8817
|
-
|
|
8818
|
-
- pg(deprecated)?: string
|
|
8819
|
-
|
|
8820
|
-
**PG사 구분코드**
|
|
8821
|
-
|
|
8822
|
-
포트원 콘솔 내 \[연동 관리] > \[연동 정보] > \[채널 관리] 화면에서 채널 추가 후
|
|
8823
|
-
`kcp_billing.{mid(사이트코드)}` 형식으로 채널을 지정할 때 사용됩니다.
|
|
8824
|
-
|
|
8825
|
-
<div class="hint" data-style="warning">
|
|
8826
|
-
|
|
8827
|
-
`pg` 파라미터는 지원 중단 예정입니다.
|
|
8828
|
-
|
|
8829
|
-
JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
|
|
8830
|
-
|
|
8831
|
-
</div>
|
|
8832
|
-
|
|
8833
|
-
- customer\_uid: string
|
|
8834
|
-
|
|
8835
|
-
**포트원 빌링키**
|
|
8836
|
-
|
|
8837
|
-
빌링 결제시 사용되는 값으로 고객사에서 입력한 후 요청해야 합니다. 해당 값은 고객이 입력한 카드정보와 1:1로 매칭됩니다.
|
|
8838
|
-
|
|
8839
|
-
- amount: integer
|
|
8840
|
-
|
|
8841
|
-
**결제금액**
|
|
8842
|
-
|
|
8843
|
-
결제창에 표시되는 금액입니다.
|
|
8844
|
-
|
|
8845
|
-
#### 유의사항
|
|
8846
|
-
|
|
8847
|
-
<details>
|
|
8848
|
-
|
|
8849
|
-
<summary>빌링키 발급시 사용한 `customer_uid`는 고객사에서 저장해야 합니다.</summary>
|
|
8850
|
-
|
|
8851
|
-
발급된 빌링키를 이용하여 단건 결제 또는 예약/반복 결제 요청시 `customer_uid`를 입력한 후 요청해야합니다.
|
|
8852
|
-
고객사에서는 빌링키 발급 후 사용한 `customer_uid`를 고객 정보에 맵핑하여 관리하시길 권장드립니다.
|
|
8853
|
-
|
|
8854
|
-
</details>
|
|
8855
|
-
|
|
8856
|
-
<details>
|
|
8857
|
-
|
|
8858
|
-
<summary>빌링키 발급시 생년월일 입력 박스를 항상 표시되도록 설정할 수 있습니다.</summary>
|
|
8859
|
-
|
|
8860
|
-
NHN KCP 결제창을 이용한 빌링키 발급 시 PC환경에서 공인인증서 인증 절차를 생략할 수 있습니다.
|
|
8861
|
-
인증서 인증 절차를 생략하는 경우에도 기본적으로 결제창 내에 주민등록번호 입력 박스가 표시되며,
|
|
8862
|
-
카드 번호 8자리 입력시 주민등록번호 입력 박스가 생년월일 입력 박스로 변환됩니다.
|
|
8863
|
-
만약 초기 화면에서 생년월일 입력 박스가 항상 표시되길 원하시면 `bypass.batch_birth_day_yn` 파라미터를 포함하여 빌링키 발급을 요청해야 합니다.
|
|
8864
|
-
|
|
8865
|
-
- `Y`: 생년월일 입력박스 항상 표시
|
|
8866
|
-
|
|
8867
|
-
</details>
|
|
8868
|
-
|
|
8869
|
-
### API 수기(키인)결제 요청하기
|
|
8870
|
-
|
|
8871
|
-
수기(키인) 결제 요청시 [`POST /subscribe/payments/onetime`](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fonetime) API를 호출해야 합니다.
|
|
8872
|
-
|
|
8873
|
-
KCP 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
8874
|
-
|
|
8875
|
-
<div class="tabs-container">
|
|
8876
|
-
|
|
8877
|
-
<div class="tabs-content" data-title="API 수기(키인) 카드 결제 요청">
|
|
8878
|
-
|
|
8879
|
-
```sh
|
|
8880
|
-
curl -H "Content-Type: application/json" \
|
|
8881
|
-
-X POST -d '{"merchant_uid":"order_id_8237352", "card_number":"1234-1234-1234-1234", "expiry":"2019-01", "birth":"123456", "amount":3000}' \
|
|
8882
|
-
https://api.iamport.kr/subscribe/payments/onetime
|
|
8883
|
-
```
|
|
8884
|
-
|
|
8885
|
-
</div>
|
|
8886
|
-
|
|
8887
|
-
</div>
|
|
8888
|
-
|
|
8889
|
-
### API 빌링키 발급 요청하기
|
|
8890
|
-
|
|
8891
|
-
빌링키 발급 요청시 [`POST /subscribe/payments/onetime`](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fonetime) 또는
|
|
8892
|
-
[`POST /subscribe/customers/{customer_uid}`](https://developers.portone.io/api/rest-v1/billingkey?v=v1#post%20%2Fsubscribe%2Fcustomers%2F%7Bcustomer_uid%7D) API를 호출해야 합니다.
|
|
8893
|
-
|
|
8894
|
-
`POST /subscribe/payments/onetime`를 호출하시는 경우 빌링키 발급과 동시에 결제가 요청됩니다.
|
|
8895
|
-
빌링키 발급 및 결제를 원하시는 경우 `customer_uid` 파라미터를 필수로 입력해야 합니다.
|
|
8896
|
-
|
|
8897
|
-
`POST /subscribe/customers/{customer_uid}`를 호출하시는 경우 빌링키만 발급됩니다.
|
|
8898
|
-
|
|
8899
|
-
KCP 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
8900
|
-
|
|
8901
|
-
<div class="tabs-container">
|
|
8902
|
-
|
|
8903
|
-
<div class="tabs-content" data-title="빌링키 발급과 동시에 결제 요청하기">
|
|
8904
|
-
|
|
8905
|
-
```sh
|
|
8906
|
-
curl -H "Content-Type: application/json" \
|
|
8907
|
-
-X POST -d '{"customer_uid":"your-customer-unique-id", "merchant_uid":"order_id_8237352", "card_number":"1234-1234-1234-1234", "expiry":"2019-01", "birth":"123456", "amount":3000}' \
|
|
8908
|
-
https://api.iamport.kr/subscribe/payments/onetime
|
|
8909
|
-
```
|
|
8910
|
-
|
|
8911
|
-
</div>
|
|
8912
|
-
|
|
8913
|
-
<div class="tabs-content" data-title="빌링키 발급 요청하기">
|
|
8914
|
-
|
|
8915
|
-
```sh
|
|
8916
|
-
curl -H "Content-Type: application/json" \
|
|
8917
|
-
-X POST -d '{"card_number":"1234-1234-1234-1234", "expiry":"2025-12", "birth":"820213", "pwd_2digit":"00"}' \
|
|
8918
|
-
https://api.iamport.kr/subscribe/customers/your-customer-unique-id
|
|
8919
|
-
```
|
|
8920
|
-
|
|
8921
|
-
</div>
|
|
8922
|
-
|
|
8923
|
-
</div>
|
|
8924
|
-
|
|
8925
|
-
#### 유의사항
|
|
8926
|
-
|
|
8927
|
-
<details>
|
|
8928
|
-
|
|
8929
|
-
<summary>빌링키 발급시 사용한 `customer_uid`는 고객사에서 저장해야 합니다.</summary>
|
|
8930
|
-
|
|
8931
|
-
발급된 빌링키를 이용하여 단건 결제 또는 예약/반복 결제 요청시 `customer_uid`를 입력한 후 요청해야합니다.
|
|
8932
|
-
고객사에서는 빌링키 발급 후 사용한 `customer_uid`를 고객 정보에 맵핑하여 관리하시길 권장드립니다.
|
|
8933
|
-
|
|
8934
|
-
</details>
|
|
8935
|
-
|
|
8936
|
-
### API 빌링키 단건 결제 요청하기
|
|
8937
|
-
|
|
8938
|
-
발급된 빌링키로 단건 결제를 하기 위해서는 [`POST /subscribe/payments/again`](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)
|
|
8939
|
-
를 이용하여 결제를 요청해야 합니다.
|
|
8940
|
-
|
|
8941
|
-
KCP 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
8942
|
-
|
|
8943
|
-
<div class="tabs-container">
|
|
8944
|
-
|
|
8945
|
-
<div class="tabs-content" data-title="API 단건 결제">
|
|
8946
|
-
|
|
8947
|
-
```sh
|
|
8948
|
-
curl -H "Content-Type: application/json" \
|
|
8949
|
-
-X POST -d '{"customer_uid":"your-customer-unique-id", "merchant_uid":"order_id_8237352", "amount":3000}' \
|
|
8950
|
-
https://api.iamport.kr/subscribe/payments/again
|
|
8951
|
-
```
|
|
8952
|
-
|
|
8953
|
-
</div>
|
|
8954
|
-
|
|
8955
|
-
</div>
|
|
8956
|
-
|
|
8957
|
-
### API 빌링키 예약/반복 결제 요청하기
|
|
8958
|
-
|
|
8959
|
-
발급된 빌링키로 예약 결제를 하기 위해서는 [`POST /subscribe/payments/schedule`](https://developers.portone.io/api/rest-v1/nonAuthPayment.subscribe?v=v1#post%20%2Fsubscribe%2Fpayments%2Fschedule)
|
|
8960
|
-
를 이용하여 결제를 예약합니다.
|
|
8961
|
-
|
|
8962
|
-
KCP 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
8963
|
-
|
|
8964
|
-
<div class="tabs-container">
|
|
8965
|
-
|
|
8966
|
-
<div class="tabs-content" data-title="API 예약/반복 결제">
|
|
8967
|
-
|
|
8968
|
-
```sh title="server-side"
|
|
8969
|
-
curl -H "Content-Type: application/json" \
|
|
8970
|
-
-X POST -d '{"customer_uid":"your-customer-unique-id", "merchant_uid":"order_id_8237352", "amount":3000}' \
|
|
8971
|
-
https://api.iamport.kr/subscribe/payments/again
|
|
8972
|
-
```
|
|
8973
|
-
|
|
8974
|
-
</div>
|
|
8975
|
-
|
|
8976
|
-
</div>
|
|
8977
|
-
|
|
8978
|
-
## 퀵페이 (자체 간편 결제)
|
|
8979
|
-
|
|
8980
|
-
<div class="hint" data-style="info">
|
|
8981
|
-
|
|
8982
|
-
KCP 퀵페이를 연동하시는 경우 포트원 JavaScript SDK 1.2.0 이상의 버전을 사용해야 합니다.
|
|
8983
|
-
|
|
8984
|
-
</div>
|
|
8985
|
-
|
|
8986
|
-
### 가능한 결제 수단
|
|
8987
|
-
|
|
8988
|
-
- 카드 : `card`
|
|
8989
|
-
- 즉시출금 : `trans`
|
|
8990
|
-
|
|
8991
|
-
### 퀵페이 호출하기
|
|
8992
|
-
|
|
8993
|
-
퀵페이의 경우 결제 기능을 포함하여 결제수단 등록 및 삭제, PIN 번호 변경 및 초기화, 탈퇴 기능을 지원합니다.
|
|
8994
|
-
|
|
8995
|
-
KCP 퀵페이 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
8996
|
-
|
|
8997
|
-
<div class="tabs-container">
|
|
8998
|
-
|
|
8999
|
-
<div class="tabs-content" data-title="결제수단 등록">
|
|
9000
|
-
|
|
9001
|
-
```ts
|
|
9002
|
-
IMP.request_pay(
|
|
9003
|
-
{
|
|
9004
|
-
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
9005
|
-
pay_method: "card", //즉시 출금 이용 시 'trans' 입력
|
|
9006
|
-
merchant_uid: "order_no_0001", //상점에서 생성한 고유 주문번호
|
|
9007
|
-
name: "결제수단 등록테스트", //주문명
|
|
9008
|
-
amount: 0, //등록시 0으로 전달
|
|
9009
|
-
buyer_email: "test@portone.io",
|
|
9010
|
-
buyer_name: "구매자이름",
|
|
9011
|
-
buyer_tel: "010-1234-5678",
|
|
9012
|
-
buyer_addr: "서울특별시 강남구 삼성동",
|
|
9013
|
-
buyer_postcode: "123-456",
|
|
9014
|
-
customer_uid: "use_your_unique_id_with_pay_method_0", //결제 수단에 대한 고유 식별값
|
|
9015
|
-
bypass: {
|
|
9016
|
-
kcpQuick: {
|
|
9017
|
-
//KCP퀵페이 설정 정보
|
|
9018
|
-
actionType: "Register", //결제수단 등록
|
|
9019
|
-
encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
|
|
9020
|
-
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
9021
|
-
},
|
|
9022
|
-
},
|
|
9023
|
-
m_redirect_url: "https://testtest.test", //결제수단 등록 후 리디렉션될 URL
|
|
9024
|
-
},
|
|
9025
|
-
function (rsp) {
|
|
9026
|
-
// callback 로직
|
|
9027
|
-
//* ...중략... *//
|
|
9028
|
-
},
|
|
9029
|
-
);
|
|
9030
|
-
```
|
|
9031
|
-
|
|
9032
|
-
</div>
|
|
9033
|
-
|
|
9034
|
-
<div class="tabs-content" data-title="결제수단 삭제">
|
|
9035
|
-
|
|
9036
|
-
```ts
|
|
9037
|
-
IMP.request_pay(
|
|
9038
|
-
{
|
|
9039
|
-
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
9040
|
-
pay_method: "card", //즉시 출금 이용 시 'trans' 입력
|
|
9041
|
-
merchant_uid: "order_no_0001", //상점에서 생성한 고유 주문번호
|
|
9042
|
-
name: "결제수단 삭제테스트", //주문명
|
|
9043
|
-
amount: 0, //삭제시 0으로 전달
|
|
9044
|
-
buyer_email: "test@portone.io",
|
|
9045
|
-
buyer_name: "구매자이름",
|
|
9046
|
-
buyer_tel: "010-1234-5678",
|
|
9047
|
-
buyer_addr: "서울특별시 강남구 삼성동",
|
|
9048
|
-
buyer_postcode: "123-456",
|
|
9049
|
-
customer_uid: "use_your_unique_id_with_pay_method_0", //결제 수단에 대한 고유 식별값
|
|
9050
|
-
bypass: {
|
|
9051
|
-
kcpQuick: {
|
|
9052
|
-
//KCP퀵페이 설정 정보
|
|
9053
|
-
actionType: "Deregister", //결제수단 삭제
|
|
9054
|
-
encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
|
|
9055
|
-
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
9056
|
-
},
|
|
9057
|
-
},
|
|
9058
|
-
m_redirect_url: "https://testtest.test", //결제수단 등록 후 리디렉션될 URL
|
|
9059
|
-
},
|
|
9060
|
-
function (rsp) {
|
|
9061
|
-
// callback 로직
|
|
9062
|
-
//* ...중략... *//
|
|
9063
|
-
},
|
|
9064
|
-
);
|
|
9065
|
-
```
|
|
9066
|
-
|
|
9067
|
-
</div>
|
|
9068
|
-
|
|
9069
|
-
</div>
|
|
9468
|
+
결제수단 중 휴대폰 소액결제를 요청하는 경우 구매자 이름(`buyer_name`)과 고객사에서 관리하는 회원ID(`bypass.shop_user_id`)를 필수로 입력해야 합니다.
|
|
9070
9469
|
|
|
9071
9470
|
<div class="tabs-container">
|
|
9072
9471
|
|
|
9073
|
-
<div class="tabs-content" data-title="
|
|
9472
|
+
<div class="tabs-content" data-title="휴대폰 소액결제 호출 예제">
|
|
9074
9473
|
|
|
9075
9474
|
```ts
|
|
9076
|
-
IMP.request_pay(
|
|
9077
|
-
{
|
|
9078
|
-
|
|
9079
|
-
|
|
9080
|
-
|
|
9081
|
-
|
|
9082
|
-
|
|
9083
|
-
|
|
9084
|
-
|
|
9085
|
-
|
|
9086
|
-
|
|
9087
|
-
|
|
9088
|
-
|
|
9089
|
-
bypass: {
|
|
9090
|
-
kcpQuick: {
|
|
9091
|
-
//KCP퀵페이 설정 정보
|
|
9092
|
-
actionType: "Pay", //결제 요청
|
|
9093
|
-
encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
|
|
9094
|
-
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
9095
|
-
},
|
|
9096
|
-
},
|
|
9097
|
-
m_redirect_url: "https://testtest.test", //결제수단 등록 후 리디렉션될 URL
|
|
9098
|
-
},
|
|
9099
|
-
function (rsp) {
|
|
9100
|
-
// callback 로직
|
|
9101
|
-
//* ...중략... *//
|
|
9475
|
+
IMP.request_pay({
|
|
9476
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
9477
|
+
pay_method: "phone", //휴대폰 소액결제
|
|
9478
|
+
merchant_uid: "A00021-TEST",
|
|
9479
|
+
name: "당근 10kg",
|
|
9480
|
+
amount: 1004,
|
|
9481
|
+
buyer_email: "test@portone.io",
|
|
9482
|
+
buyer_name: "포트원 기술지원팀", // 휴대폰 결제시 필수
|
|
9483
|
+
buyer_tel: "010-1234-5678",
|
|
9484
|
+
buyer_addr: "서울특별시 강남구 삼성동",
|
|
9485
|
+
buyer_postcode: "123-456",
|
|
9486
|
+
bypass: {
|
|
9487
|
+
shop_user_id: "abaddd", // 고객사 회원 id 입력 (휴대폰 결제시 필수)
|
|
9102
9488
|
},
|
|
9103
|
-
);
|
|
9489
|
+
});
|
|
9104
9490
|
```
|
|
9105
9491
|
|
|
9106
9492
|
</div>
|
|
9107
9493
|
|
|
9108
9494
|
</div>
|
|
9109
9495
|
|
|
9110
|
-
|
|
9496
|
+
</details>
|
|
9111
9497
|
|
|
9112
|
-
<
|
|
9498
|
+
<details>
|
|
9113
9499
|
|
|
9114
|
-
|
|
9115
|
-
IMP.request_pay(
|
|
9116
|
-
{
|
|
9117
|
-
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
9118
|
-
pay_method: "card", //즉시 출금 이용 시 'trans' 입력
|
|
9119
|
-
merchant_uid: "order_no_0001", //상점에서 생성한 고유 주문번호
|
|
9120
|
-
name: "PIN번호 변경 테스트", //주문명
|
|
9121
|
-
amount: 0, //pin번호 변경시 0으로 전달
|
|
9122
|
-
buyer_email: "test@portone.io",
|
|
9123
|
-
buyer_name: "구매자이름",
|
|
9124
|
-
buyer_tel: "010-1234-5678",
|
|
9125
|
-
buyer_addr: "서울특별시 강남구 삼성동",
|
|
9126
|
-
buyer_postcode: "123-456",
|
|
9127
|
-
customer_uid: "use_your_unique_id", //memberId와 동일하게 입력
|
|
9128
|
-
bypass: {
|
|
9129
|
-
kcpQuick: {
|
|
9130
|
-
//KCP퀵페이 설정 정보
|
|
9131
|
-
actionType: "PinChange", //PIN번호 변경
|
|
9132
|
-
encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
|
|
9133
|
-
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
9134
|
-
},
|
|
9135
|
-
},
|
|
9136
|
-
m_redirect_url: "https://testtest.test", //결제수단 등록 후 리디렉션될 URL
|
|
9137
|
-
},
|
|
9138
|
-
function (rsp) {
|
|
9139
|
-
// callback 로직
|
|
9140
|
-
//* ...중략... *//
|
|
9141
|
-
},
|
|
9142
|
-
);
|
|
9143
|
-
```
|
|
9500
|
+
<summary>휴대폰 소액결제 시 전화번호를 고정할 수 있습니다.</summary>
|
|
9144
9501
|
|
|
9145
|
-
|
|
9502
|
+
`prefill.phoneNumber` 파라미터에 고정할 휴대폰 번호를 입력한 후 결제를 요청합니다.
|
|
9146
9503
|
|
|
9147
|
-
|
|
9504
|
+
</details>
|
|
9148
9505
|
|
|
9149
|
-
|
|
9150
|
-
IMP.request_pay(
|
|
9151
|
-
{
|
|
9152
|
-
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
9153
|
-
pay_method: "card", //즉시 출금 이용 시 'trans' 입력
|
|
9154
|
-
merchant_uid: "order_no_0001", //상점에서 생성한 고유 주문번호
|
|
9155
|
-
name: "PIN번호 초기화 테스트", //주문명
|
|
9156
|
-
amount: 0, //pin번호 초기화시 0으로 전달
|
|
9157
|
-
buyer_email: "test@portone.io",
|
|
9158
|
-
buyer_name: "구매자이름",
|
|
9159
|
-
buyer_tel: "010-1234-5678",
|
|
9160
|
-
buyer_addr: "서울특별시 강남구 삼성동",
|
|
9161
|
-
buyer_postcode: "123-456",
|
|
9162
|
-
customer_uid: "use_your_unique_id", //memberId와 동일하게 입력
|
|
9163
|
-
bypass: {
|
|
9164
|
-
kcpQuick: {
|
|
9165
|
-
//KCP퀵페이 설정 정보
|
|
9166
|
-
actionType: "PinReset", //PIN번호 초기화
|
|
9167
|
-
encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
|
|
9168
|
-
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
9169
|
-
},
|
|
9170
|
-
},
|
|
9171
|
-
m_redirect_url: "https://testtest.test", //결제수단 등록 후 리디렉션될 URL
|
|
9172
|
-
},
|
|
9173
|
-
function (rsp) {
|
|
9174
|
-
// callback 로직
|
|
9175
|
-
//* ...중략... *//
|
|
9176
|
-
},
|
|
9177
|
-
);
|
|
9178
|
-
```
|
|
9506
|
+
<details>
|
|
9179
9507
|
|
|
9180
|
-
|
|
9508
|
+
<summary>에스크로 결제관련 안내</summary>
|
|
9181
9509
|
|
|
9182
|
-
|
|
9510
|
+
에스크로 결제를 위해서는 **`escrow`** 파라미터를 추가하고 **true** 값으로 설정되어야 합니다.
|
|
9511
|
+
에스크로 결제 요청시 **장바구니 상품을 묶어서 결제하는 경우**
|
|
9512
|
+
해당 품목에 대한 정보를 전달하기 위해 해당 상품 관련 정보를 추가 파라미터(**`kcpProducts`**)로 전달해야 합니다.
|
|
9513
|
+
**`kcpProducts`** 는 다음 4개의 필수 속성으로 구성된 객체배열입니다.
|
|
9514
|
+
|
|
9515
|
+
- orderNumber : 상품주문번호
|
|
9516
|
+
- name : 상품명
|
|
9517
|
+
- quantity : 수량
|
|
9518
|
+
- amount : 상품 가격
|
|
9519
|
+
|
|
9520
|
+
**`amount`** 값은 결제 금액(`param.amount`) 값과 관계가 없으며 비교 검증하지 않습니다.
|
|
9183
9521
|
|
|
9184
9522
|
<div class="tabs-container">
|
|
9185
9523
|
|
|
9186
|
-
<div class="tabs-content" data-title="
|
|
9524
|
+
<div class="tabs-content" data-title="탭">
|
|
9187
9525
|
|
|
9188
|
-
```ts
|
|
9189
|
-
IMP.request_pay(
|
|
9190
|
-
{
|
|
9191
|
-
|
|
9192
|
-
|
|
9193
|
-
|
|
9194
|
-
|
|
9195
|
-
|
|
9196
|
-
|
|
9197
|
-
|
|
9198
|
-
buyer_tel: "010-1234-5678",
|
|
9199
|
-
buyer_addr: "서울특별시 강남구 삼성동",
|
|
9200
|
-
buyer_postcode: "123-456",
|
|
9201
|
-
customer_uid: "use_your_unique_id", //memberId와 동일하게 입력
|
|
9202
|
-
bypass: {
|
|
9203
|
-
kcpQuick: {
|
|
9204
|
-
//KCP퀵페이 설정 정보
|
|
9205
|
-
actionType: "PhoneChange", //등록된 휴대폰 번호 변경
|
|
9206
|
-
encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
|
|
9207
|
-
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
9208
|
-
},
|
|
9526
|
+
```ts title="JavaScript SDK"
|
|
9527
|
+
IMP.request_pay({
|
|
9528
|
+
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
9529
|
+
escrow: true, // 에스크로 결제인 경우 필요
|
|
9530
|
+
kcpProducts: [
|
|
9531
|
+
{
|
|
9532
|
+
orderNumber: "xxxx",
|
|
9533
|
+
name: "상품A",
|
|
9534
|
+
quantity: 3,
|
|
9535
|
+
amount: 1000,
|
|
9209
9536
|
},
|
|
9210
|
-
|
|
9211
|
-
|
|
9212
|
-
|
|
9213
|
-
|
|
9214
|
-
|
|
9215
|
-
|
|
9216
|
-
|
|
9537
|
+
{
|
|
9538
|
+
orderNumber: "yyyy",
|
|
9539
|
+
name: "상품B",
|
|
9540
|
+
quantity: 2,
|
|
9541
|
+
amount: 3000,
|
|
9542
|
+
},
|
|
9543
|
+
],
|
|
9544
|
+
});
|
|
9217
9545
|
```
|
|
9218
9546
|
|
|
9219
9547
|
</div>
|
|
9220
9548
|
|
|
9221
9549
|
</div>
|
|
9222
9550
|
|
|
9551
|
+
</details>
|
|
9552
|
+
|
|
9553
|
+
<details>
|
|
9554
|
+
|
|
9555
|
+
<summary>결제창 내 할인쿠폰 영역 활성/비활성화 안내</summary>
|
|
9556
|
+
|
|
9557
|
+
`bypass.coupon_apply_yn`파라미터를 이용하여 결제창 내 할인쿠폰 영역을 활성/비활성화 할 수 있습니다.
|
|
9558
|
+
해당 기능은 KCP와 협의 후 사용 가능합니다.
|
|
9559
|
+
|
|
9560
|
+
- `Y`: 활성
|
|
9561
|
+
- `N`: 비활성
|
|
9562
|
+
|
|
9563
|
+
</details>
|
|
9564
|
+
|
|
9565
|
+
### SDK 빌링키 발급 요청하기
|
|
9566
|
+
|
|
9567
|
+
[JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여 NHN
|
|
9568
|
+
KCP 결제창을 호출할 수 있습니다. **결제결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
|
|
9569
|
+
**callback** 으로 수신되고
|
|
9570
|
+
모바일의 경우 **m\_redirect\_url** 로 리디렉션됩니다.
|
|
9571
|
+
|
|
9572
|
+
빌링키 발급 요청 시에는 `customer_uid` 파라미터를 입력한 후 호출해야 합니다.
|
|
9573
|
+
|
|
9574
|
+
KCP 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
9575
|
+
|
|
9223
9576
|
<div class="tabs-container">
|
|
9224
9577
|
|
|
9225
|
-
<div class="tabs-content" data-title="
|
|
9578
|
+
<div class="tabs-content" data-title="SDK 빌링키 발급 요청">
|
|
9226
9579
|
|
|
9227
|
-
```ts
|
|
9580
|
+
```ts title="Javascript SDK" showLineNumbers
|
|
9228
9581
|
IMP.request_pay(
|
|
9229
9582
|
{
|
|
9230
9583
|
channelKey: "{콘솔 내 연동 정보의 채널키}",
|
|
9231
|
-
pay_method: "card",
|
|
9232
|
-
merchant_uid: "
|
|
9233
|
-
name: "
|
|
9234
|
-
amount: 0,
|
|
9584
|
+
pay_method: "card", //'card'만 지원됩니다.
|
|
9585
|
+
merchant_uid: "order_monthly_0001", //상점에서 생성한 고유 주문번호
|
|
9586
|
+
name: "정기결제",
|
|
9587
|
+
amount: 0, //결제창에 표시될 금액. 발급 요청시에는 결제가 승인되지 않습니다.
|
|
9588
|
+
customer_uid: "your-customer-unique-id", //포트원 빌링키로 필수 입력해야 합니다.
|
|
9235
9589
|
buyer_email: "test@portone.io",
|
|
9236
|
-
buyer_name: "
|
|
9237
|
-
buyer_tel: "
|
|
9238
|
-
|
|
9239
|
-
buyer_postcode: "123-456",
|
|
9240
|
-
customer_uid: "use_your_unique_id", //memberId와 동일하게 입력
|
|
9241
|
-
bypass: {
|
|
9242
|
-
kcpQuick: {
|
|
9243
|
-
//KCP퀵페이 설정 정보
|
|
9244
|
-
actionType: "Terminate", //유저 및 결제수단 삭제
|
|
9245
|
-
encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
|
|
9246
|
-
memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
|
|
9247
|
-
},
|
|
9248
|
-
},
|
|
9249
|
-
m_redirect_url: "https://testtest.test", //결제수단 등록 후 리디렉션될 URL
|
|
9590
|
+
buyer_name: "포트원",
|
|
9591
|
+
buyer_tel: "02-1234-1234",
|
|
9592
|
+
m_redirect_url: "https://testtest.test", //모바일에서 결제 완료 후 리디렉션 될 URL
|
|
9250
9593
|
},
|
|
9251
9594
|
function (rsp) {
|
|
9252
|
-
|
|
9253
|
-
|
|
9595
|
+
if (rsp.success) {
|
|
9596
|
+
alert("빌링키 발급 성공");
|
|
9597
|
+
} else {
|
|
9598
|
+
alert("빌링키 발급 실패");
|
|
9599
|
+
}
|
|
9254
9600
|
},
|
|
9255
9601
|
);
|
|
9256
9602
|
```
|
|
@@ -9259,20 +9605,7 @@ IMP.request_pay(
|
|
|
9259
9605
|
|
|
9260
9606
|
</div>
|
|
9261
9607
|
|
|
9262
|
-
|
|
9263
|
-
|
|
9264
|
-
퀵페이의 경우 m\_redirect\_url시 다음과 같이 4개의 파라미터가 Query String으로 전달됩니다.
|
|
9265
|
-
|
|
9266
|
-
- `imp_uid`
|
|
9267
|
-
- `merchant_uid`
|
|
9268
|
-
- `imp_status` : true 또는 false
|
|
9269
|
-
- `kcp_action` : Register 또는 Dregister 또는 Pay
|
|
9270
|
-
|
|
9271
|
-
`kcp_action`이 Register 이고 `imp_status`가 true인 경우 결제수단 등록에 성공하였다는 것을 의미합니다.
|
|
9272
|
-
|
|
9273
|
-
</div>
|
|
9274
|
-
|
|
9275
|
-
#### 주요 파라미터
|
|
9608
|
+
#### 주요 파라미터 설명
|
|
9276
9609
|
|
|
9277
9610
|
- channelKey: string
|
|
9278
9611
|
|
|
@@ -9289,7 +9622,7 @@ IMP.request_pay(
|
|
|
9289
9622
|
**PG사 구분코드**
|
|
9290
9623
|
|
|
9291
9624
|
포트원 콘솔 내 \[연동 관리] > \[연동 정보] > \[채널 관리] 화면에서 채널 추가 후
|
|
9292
|
-
`
|
|
9625
|
+
`kcp_billing.{mid(사이트코드)}` 형식으로 채널을 지정할 때 사용됩니다.
|
|
9293
9626
|
|
|
9294
9627
|
<div class="hint" data-style="warning">
|
|
9295
9628
|
|
|
@@ -9299,213 +9632,157 @@ IMP.request_pay(
|
|
|
9299
9632
|
|
|
9300
9633
|
</div>
|
|
9301
9634
|
|
|
9302
|
-
-
|
|
9303
|
-
|
|
9304
|
-
**결제수단 구분코드**
|
|
9305
|
-
|
|
9306
|
-
결제 호출 시 결제수단을 지정할 때 사용됩니다.
|
|
9307
|
-
|
|
9308
|
-
- card (카드)
|
|
9309
|
-
- trans (즉시출금)
|
|
9310
|
-
|
|
9311
|
-
- merchant\_uid: string
|
|
9635
|
+
- customer\_uid: string
|
|
9312
9636
|
|
|
9313
|
-
|
|
9637
|
+
**포트원 빌링키**
|
|
9314
9638
|
|
|
9315
|
-
고객사에서
|
|
9639
|
+
빌링 결제시 사용되는 값으로 고객사에서 입력한 후 요청해야 합니다. 해당 값은 고객이 입력한 카드정보와 1:1로 매칭됩니다.
|
|
9316
9640
|
|
|
9317
9641
|
- amount: integer
|
|
9318
9642
|
|
|
9319
9643
|
**결제금액**
|
|
9320
9644
|
|
|
9321
|
-
|
|
9322
|
-
|
|
9323
|
-
**결제 수단에 대한 고유 식별값**
|
|
9324
|
-
|
|
9325
|
-
퀵페이에 등록된 결제수단과 1:1 맵핑됩니다.
|
|
9326
|
-
|
|
9327
|
-
- bypass?: oneof object
|
|
9328
|
-
|
|
9329
|
-
**PG사 결제창 호출 시 PG사로 그대로 bypass할 파라미터들의 모음**
|
|
9330
|
-
|
|
9331
|
-
- kcpQuick?: object
|
|
9332
|
-
|
|
9333
|
-
**KCP 퀵페이 설정정보**
|
|
9334
|
-
|
|
9335
|
-
퀵페이 결제시 필수로 입력해야 합니다.
|
|
9336
|
-
|
|
9337
|
-
- actionType: string
|
|
9338
|
-
|
|
9339
|
-
**호출 유형**
|
|
9340
|
-
|
|
9341
|
-
- Register : 결제 수단 등록
|
|
9342
|
-
- Deregister : 결제 수단 삭제
|
|
9343
|
-
- Pay : 결제
|
|
9344
|
-
- PinChange : PIN번호 변경
|
|
9345
|
-
- PinReset : PIN번호 초기화
|
|
9346
|
-
- PhoneChange : 전화번호 변경
|
|
9347
|
-
- Terminate : 결제 수단 해지
|
|
9348
|
-
|
|
9349
|
-
- encryptedCI: string
|
|
9350
|
-
|
|
9351
|
-
**암호화된 본인인증 CI**
|
|
9352
|
-
|
|
9353
|
-
- memberID: string
|
|
9354
|
-
|
|
9355
|
-
**사용자 식별값**
|
|
9356
|
-
|
|
9357
|
-
최대 16byte까지 입력가능하며, 고객이 여러개의 결제수단을 등록하는 경우 동일한 `memberID`를 입력해야 합니다.
|
|
9358
|
-
|
|
9359
|
-
- deviceID?: string
|
|
9645
|
+
결제창에 표시되는 금액입니다.
|
|
9360
9646
|
|
|
9361
|
-
|
|
9647
|
+
#### 유의사항
|
|
9362
9648
|
|
|
9363
|
-
|
|
9649
|
+
<details>
|
|
9364
9650
|
|
|
9365
|
-
|
|
9651
|
+
<summary>빌링키 발급시 사용한 `customer_uid`는 고객사에서 저장해야 합니다.</summary>
|
|
9366
9652
|
|
|
9367
|
-
|
|
9653
|
+
발급된 빌링키를 이용하여 단건 결제 또는 예약/반복 결제 요청시 `customer_uid`를 입력한 후 요청해야합니다.
|
|
9654
|
+
고객사에서는 빌링키 발급 후 사용한 `customer_uid`를 고객 정보에 맵핑하여 관리하시길 권장드립니다.
|
|
9368
9655
|
|
|
9369
|
-
|
|
9656
|
+
</details>
|
|
9370
9657
|
|
|
9371
|
-
|
|
9372
|
-
- false : 인증 결제
|
|
9658
|
+
<details>
|
|
9373
9659
|
|
|
9374
|
-
|
|
9660
|
+
<summary>빌링키 발급시 생년월일 입력 박스를 항상 표시되도록 설정할 수 있습니다.</summary>
|
|
9375
9661
|
|
|
9376
|
-
|
|
9662
|
+
NHN KCP 결제창을 이용한 빌링키 발급 시 PC환경에서 공인인증서 인증 절차를 생략할 수 있습니다.
|
|
9663
|
+
인증서 인증 절차를 생략하는 경우에도 기본적으로 결제창 내에 주민등록번호 입력 박스가 표시되며,
|
|
9664
|
+
카드 번호 8자리 입력시 주민등록번호 입력 박스가 생년월일 입력 박스로 변환됩니다.
|
|
9665
|
+
만약 초기 화면에서 생년월일 입력 박스가 항상 표시되길 원하시면 `bypass.batch_birth_day_yn` 파라미터를 포함하여 빌링키 발급을 요청해야 합니다.
|
|
9377
9666
|
|
|
9378
|
-
|
|
9667
|
+
- `Y`: 생년월일 입력박스 항상 표시
|
|
9379
9668
|
|
|
9380
|
-
|
|
9669
|
+
</details>
|
|
9381
9670
|
|
|
9382
|
-
|
|
9671
|
+
### API 수기(키인)결제 요청하기
|
|
9383
9672
|
|
|
9384
|
-
|
|
9673
|
+
수기(키인) 결제 요청시 [`POST /subscribe/payments/onetime`](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fonetime) API를 호출해야 합니다.
|
|
9385
9674
|
|
|
9386
|
-
|
|
9387
|
-
- false : 카드사 포인트 미사용
|
|
9675
|
+
KCP 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
9388
9676
|
|
|
9389
|
-
|
|
9677
|
+
<div class="tabs-container">
|
|
9390
9678
|
|
|
9391
|
-
<
|
|
9679
|
+
<div class="tabs-content" data-title="API 수기(키인) 카드 결제 요청">
|
|
9392
9680
|
|
|
9393
|
-
|
|
9681
|
+
```sh
|
|
9682
|
+
curl -H "Content-Type: application/json" \
|
|
9683
|
+
-X POST -d '{"merchant_uid":"order_id_8237352", "card_number":"1234-1234-1234-1234", "expiry":"2019-01", "birth":"123456", "amount":3000}' \
|
|
9684
|
+
https://api.iamport.kr/subscribe/payments/onetime
|
|
9685
|
+
```
|
|
9394
9686
|
|
|
9395
|
-
|
|
9396
|
-
이 외의 PIN번호 변경/확인/초기화, 사용자 등록, 해지 요청시에는 `customer_uid`에 결제수단 등록시 입력한 `memberID`를 입력해야 합니다.
|
|
9397
|
-
위의 경우에 `customer_uid` 파라미터에 발급시 입력했던 `customer_uid`를 입력하는 경우 에러가 리턴됩니다.
|
|
9687
|
+
</div>
|
|
9398
9688
|
|
|
9399
|
-
</
|
|
9689
|
+
</div>
|
|
9400
9690
|
|
|
9401
|
-
|
|
9691
|
+
### API 빌링키 발급 요청하기
|
|
9402
9692
|
|
|
9403
|
-
|
|
9693
|
+
빌링키 발급 요청시 [`POST /subscribe/payments/onetime`](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fonetime) 또는
|
|
9694
|
+
[`POST /subscribe/customers/{customer_uid}`](https://developers.portone.io/api/rest-v1/billingkey?v=v1#post%20%2Fsubscribe%2Fcustomers%2F%7Bcustomer_uid%7D) API를 호출해야 합니다.
|
|
9404
9695
|
|
|
9405
|
-
|
|
9696
|
+
`POST /subscribe/payments/onetime`를 호출하시는 경우 빌링키 발급과 동시에 결제가 요청됩니다.
|
|
9697
|
+
빌링키 발급 및 결제를 원하시는 경우 `customer_uid` 파라미터를 필수로 입력해야 합니다.
|
|
9406
9698
|
|
|
9407
|
-
|
|
9408
|
-
암호화된 결과는 Base64로 인코딩하여 encryptedCI 파라미터 값으로 전달합니다.
|
|
9699
|
+
`POST /subscribe/customers/{customer_uid}`를 호출하시는 경우 빌링키만 발급됩니다.
|
|
9409
9700
|
|
|
9410
|
-
|
|
9411
|
-
FUNCTION encryptCi(ci, apiSecret):
|
|
9412
|
-
# Step 1: SHA-256으로 API Secret을 해시하여 암호화 키 생성
|
|
9413
|
-
key = SHA256(apiSecret)
|
|
9701
|
+
KCP 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
9414
9702
|
|
|
9415
|
-
|
|
9416
|
-
encryptedData = AES256Encrypt(data = ci, key = key, mode = ECB)
|
|
9703
|
+
<div class="tabs-container">
|
|
9417
9704
|
|
|
9418
|
-
|
|
9419
|
-
base64EncodedData = Base64Encode(encryptedData)
|
|
9705
|
+
<div class="tabs-content" data-title="빌링키 발급과 동시에 결제 요청하기">
|
|
9420
9706
|
|
|
9421
|
-
|
|
9422
|
-
|
|
9423
|
-
|
|
9707
|
+
```sh
|
|
9708
|
+
curl -H "Content-Type: application/json" \
|
|
9709
|
+
-X POST -d '{"customer_uid":"your-customer-unique-id", "merchant_uid":"order_id_8237352", "card_number":"1234-1234-1234-1234", "expiry":"2019-01", "birth":"123456", "amount":3000}' \
|
|
9710
|
+
https://api.iamport.kr/subscribe/payments/onetime
|
|
9424
9711
|
```
|
|
9425
9712
|
|
|
9426
|
-
</
|
|
9427
|
-
|
|
9428
|
-
<details>
|
|
9429
|
-
|
|
9430
|
-
<summary>결제수단을 여러개 등록할 수 있습니다.</summary>
|
|
9431
|
-
|
|
9432
|
-
한 고객에게 여러개의 결제수단을 등록할 수 있습니다.
|
|
9433
|
-
고객 식별 정보(`memberID`)와 결제 수단 식별 정보(`customer_uid`)의 경우 1:N으로 맵핑되며,
|
|
9434
|
-
이미 등록한 고객의 `memeberID`를 동일하게 입력한 후 사용하지 않은 `customer_uid`를 지정하는 경우 여러개의 결제 수단을 등록할 수 있습니다.
|
|
9435
|
-
|
|
9436
|
-
</details>
|
|
9437
|
-
|
|
9438
|
-
<details>
|
|
9439
|
-
|
|
9440
|
-
<summary>결제수단 삭제 요청시 등록할 때 입력한 정보를 동일하게 입력해야 합니다.</summary>
|
|
9441
|
-
|
|
9442
|
-
결제수단 삭제(actionType:Deregister) 요청시 결제수단 등록할 때 사용된 `customer_uid` + `encryptedCI` + `memberID` + `deviceID` + `noAuth` 조합을
|
|
9443
|
-
동일하게 전송해야 합니다.
|
|
9713
|
+
</div>
|
|
9444
9714
|
|
|
9445
|
-
|
|
9715
|
+
<div class="tabs-content" data-title="빌링키 발급 요청하기">
|
|
9446
9716
|
|
|
9447
|
-
|
|
9717
|
+
```sh
|
|
9718
|
+
curl -H "Content-Type: application/json" \
|
|
9719
|
+
-X POST -d '{"card_number":"1234-1234-1234-1234", "expiry":"2025-12", "birth":"820213", "pwd_2digit":"00"}' \
|
|
9720
|
+
https://api.iamport.kr/subscribe/customers/your-customer-unique-id
|
|
9721
|
+
```
|
|
9448
9722
|
|
|
9449
|
-
|
|
9723
|
+
</div>
|
|
9450
9724
|
|
|
9451
|
-
|
|
9452
|
-
핀번호 초기화 이후 [빌링키 삭제 API](https://developers.portone.io/api/rest-v1/billingkey?v=v1#delete%20%2Fsubscribe%2Fcustomers%2F%7Bcustomer_uid%7D)를 이용하여 일괄 삭제할 수 있습니다.
|
|
9453
|
-
만약 핀번호 초기화 전에 삭제를 시도하는 경우 에러 메시지와 함께 삭제가 불가능합니다.
|
|
9725
|
+
</div>
|
|
9454
9726
|
|
|
9455
|
-
|
|
9727
|
+
#### 유의사항
|
|
9456
9728
|
|
|
9457
9729
|
<details>
|
|
9458
9730
|
|
|
9459
|
-
<summary
|
|
9731
|
+
<summary>빌링키 발급시 사용한 `customer_uid`는 고객사에서 저장해야 합니다.</summary>
|
|
9460
9732
|
|
|
9461
|
-
|
|
9462
|
-
|
|
9733
|
+
발급된 빌링키를 이용하여 단건 결제 또는 예약/반복 결제 요청시 `customer_uid`를 입력한 후 요청해야합니다.
|
|
9734
|
+
고객사에서는 빌링키 발급 후 사용한 `customer_uid`를 고객 정보에 맵핑하여 관리하시길 권장드립니다.
|
|
9463
9735
|
|
|
9464
9736
|
</details>
|
|
9465
9737
|
|
|
9466
|
-
|
|
9467
|
-
|
|
9468
|
-
<summary>결제 시 등록된 결제수단 화면을 표시할 수 있습니다.</summary>
|
|
9738
|
+
### API 빌링키 단건 결제 요청하기
|
|
9469
9739
|
|
|
9470
|
-
|
|
9740
|
+
발급된 빌링키로 단건 결제를 하기 위해서는 [`POST /subscribe/payments/again`](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)
|
|
9741
|
+
를 이용하여 결제를 요청해야 합니다.
|
|
9471
9742
|
|
|
9472
|
-
|
|
9743
|
+
KCP 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
9473
9744
|
|
|
9474
|
-
<
|
|
9745
|
+
<div class="tabs-container">
|
|
9475
9746
|
|
|
9476
|
-
<
|
|
9747
|
+
<div class="tabs-content" data-title="API 단건 결제">
|
|
9477
9748
|
|
|
9478
|
-
|
|
9749
|
+
```sh
|
|
9750
|
+
curl -H "Content-Type: application/json" \
|
|
9751
|
+
-X POST -d '{"customer_uid":"your-customer-unique-id", "merchant_uid":"order_id_8237352", "amount":3000}' \
|
|
9752
|
+
https://api.iamport.kr/subscribe/payments/again
|
|
9753
|
+
```
|
|
9479
9754
|
|
|
9480
|
-
</
|
|
9755
|
+
</div>
|
|
9481
9756
|
|
|
9482
|
-
|
|
9757
|
+
</div>
|
|
9483
9758
|
|
|
9484
|
-
|
|
9759
|
+
### API 빌링키 예약/반복 결제 요청하기
|
|
9485
9760
|
|
|
9486
|
-
|
|
9487
|
-
|
|
9761
|
+
발급된 빌링키로 예약 결제를 하기 위해서는 [`POST /subscribe/payments/schedule`](https://developers.portone.io/api/rest-v1/nonAuthPayment.subscribe?v=v1#post%20%2Fsubscribe%2Fpayments%2Fschedule)
|
|
9762
|
+
를 이용하여 결제를 예약합니다.
|
|
9488
9763
|
|
|
9489
|
-
|
|
9764
|
+
KCP 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
9490
9765
|
|
|
9491
|
-
<
|
|
9766
|
+
<div class="tabs-container">
|
|
9492
9767
|
|
|
9493
|
-
<
|
|
9768
|
+
<div class="tabs-content" data-title="API 예약/반복 결제">
|
|
9494
9769
|
|
|
9495
|
-
|
|
9496
|
-
|
|
9497
|
-
|
|
9770
|
+
```sh title="server-side"
|
|
9771
|
+
curl -H "Content-Type: application/json" \
|
|
9772
|
+
-X POST -d '{"customer_uid":"your-customer-unique-id", "merchant_uid":"order_id_8237352", "amount":3000}' \
|
|
9773
|
+
https://api.iamport.kr/subscribe/payments/again
|
|
9774
|
+
```
|
|
9498
9775
|
|
|
9499
|
-
|
|
9776
|
+
</div>
|
|
9500
9777
|
|
|
9501
|
-
</
|
|
9778
|
+
</div>
|
|
9502
9779
|
|
|
9503
9780
|
|
|
9504
9781
|
# https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/billing-api-caution
|
|
9505
9782
|
|
|
9506
9783
|
---
|
|
9507
9784
|
title: 빌링키 발급 / API 연동 유의사항
|
|
9508
|
-
description: (신)
|
|
9785
|
+
description: (신)나이스정보통신 비인증 결제 연동 유의사항을 소개합니다.
|
|
9509
9786
|
targetVersions:
|
|
9510
9787
|
- v1
|
|
9511
9788
|
---
|
|
@@ -9527,7 +9804,7 @@ targetVersions:
|
|
|
9527
9804
|
|
|
9528
9805
|
## 비인증 결제
|
|
9529
9806
|
|
|
9530
|
-
(신)
|
|
9807
|
+
(신) 나이스정보통신은 발급 된 빌링키로 재결제(`POST /subscribe/payemnts/again`),
|
|
9531
9808
|
키인 결제(`POST /subscribe/payments/onetime`) 그리고 스케줄 결제(`POST /subscribe/payments/schedule`)를
|
|
9532
9809
|
모두 지원하며 기본 파라미터 외에 아래 3개의 파라미터를 추가로 지원합니다.
|
|
9533
9810
|
|
|
@@ -9535,9 +9812,9 @@ targetVersions:
|
|
|
9535
9812
|
|
|
9536
9813
|
|파라미터 |데이터 타입 |의미 |
|
|
9537
9814
|
|-----------------------------|----------------------|---------------------------------------------------------------------------------------------------|
|
|
9538
|
-
|vat\_amount |double |총 결제 금액 중 부가세 금액. 부가세 직접 입력 방식을 위해 사용. 단,
|
|
9539
|
-
|intereset\_free\_by\_merchant|boolean(기본값: false)|상점 부담 무이자 할부 적용 여부. 단,
|
|
9540
|
-
|use\_card\_point |boolean(기본값: false)|카드사 포인트 사용 여부. 단,
|
|
9815
|
+
|vat\_amount |double |총 결제 금액 중 부가세 금액. 부가세 직접 입력 방식을 위해 사용. 단, 나이스정보통신와 사전 협의 필요|
|
|
9816
|
+
|intereset\_free\_by\_merchant|boolean(기본값: false)|상점 부담 무이자 할부 적용 여부. 단, 나이스정보통신와 사전 협의 필요 |
|
|
9817
|
+
|use\_card\_point |boolean(기본값: false)|카드사 포인트 사용 여부. 단, 나이스정보통신와 사전 협의 필요 |
|
|
9541
9818
|
|
|
9542
9819
|
## 가상계좌
|
|
9543
9820
|
|
|
@@ -9547,12 +9824,12 @@ targetVersions:
|
|
|
9547
9824
|
|------------------------------|-----------|-----------------------|
|
|
9548
9825
|
|business\_registration\_number|string |구매자 사업자 등록 번호|
|
|
9549
9826
|
|
|
9550
|
-
(신)
|
|
9827
|
+
(신) 나이스정보통신의 경우 API를 통한 가상 계좌 발급 시, 향후 해당 거래 건을 에스크로 배송 정보로 등록할 때
|
|
9551
9828
|
사용될 구매자의 사업자 번호를 `business_registration_number` 파라미터로 입력받고 있습니다.
|
|
9552
9829
|
|
|
9553
9830
|
### API로 가상계좌 채번은 가능하나 발급된 가상계좌 정보는 수정 불가능
|
|
9554
9831
|
|
|
9555
|
-
(신)
|
|
9832
|
+
(신) 나이스정보통신은 `POST /vbanks` API로 가상 계좌를 채번 할 수 있지만 `PUT /vbanks` API로
|
|
9556
9833
|
**이미 채번 된 가상계좌 정보(입금 기한, 입금 금액)를 수정할 수 없습니다.**
|
|
9557
9834
|
|
|
9558
9835
|
## 에스크로 결제
|
|
@@ -9563,20 +9840,20 @@ targetVersions:
|
|
|
9563
9840
|
|-----------|-----------|-----------------------------------------------------------------------------------------|
|
|
9564
9841
|
|send\_email|boolean |에스크로 구매 확정시 결제 창에 입력했던 이메일로 해당 사실을 전송할지 여부 (기본값: true)|
|
|
9565
9842
|
|
|
9566
|
-
(신)
|
|
9843
|
+
(신) 나이스정보통신의 경우 에스크로 결제건에 대해 배송 정보 등록 API 호출 시 `send_email` 파라미터를
|
|
9567
9844
|
이용하여 구매 확정됐을 때 결제창에 입력한 이메일로 구매 확정 내용을 전송할지 여부를 제어할 수 있습니다.
|
|
9568
9845
|
기본 값은 true(구매 확정 여부 이메일 전송)이며 false로 입력 시 구매가 확정되어도 이메일로 안내되지 않습니다.
|
|
9569
9846
|
|
|
9570
9847
|
### 배송 정보 수정 불가
|
|
9571
9848
|
|
|
9572
|
-
(신)
|
|
9849
|
+
(신) 나이스정보통신은 `POST /escrow/logis/{imp_uid}` API로 에스크로 배송 정보 등록은 가능하지만
|
|
9573
9850
|
`PUT /escrow/logis/{imp_uid}` API로 **수정은 불가능**합니다.
|
|
9574
9851
|
|
|
9575
9852
|
## 현금영수증
|
|
9576
9853
|
|
|
9577
9854
|
### 결제창에서 발급 받지 못한 현금영수증은 API로 발급 불가능
|
|
9578
9855
|
|
|
9579
|
-
(신)
|
|
9856
|
+
(신) 나이스정보통신의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서
|
|
9580
9857
|
현금영수증을 발급 요청할 수 있습니다. 이때 결제 승인 단계에서 현금영수증을 발급 요청하지 못한 경우,
|
|
9581
9858
|
현금영수증 발급 API(`POST /receipts/{imp_uid}`)를 사용한다고 하더라도 발급이 되지 않으니 참고 부탁드립니다.
|
|
9582
9859
|
|
|
@@ -9584,7 +9861,7 @@ targetVersions:
|
|
|
9584
9861
|
|
|
9585
9862
|
API로 현금영수증 발급(`POST /receipts/{imp_uid}`)시 발급 받을 현금영수증 정보(현금영수증 발급 유형,
|
|
9586
9863
|
현금영수증 발행 식별 정보, 현금영수증 발행 식별 정보 유형)를 전달해야 합니다.
|
|
9587
|
-
단, (신)
|
|
9864
|
+
단, (신) 나이스정보통신의 경우 **현금영수증 카드 번호로 현금영수증 발급이 불가능**하오니 참고 부탁드립니다.
|
|
9588
9865
|
|
|
9589
9866
|
<details>
|
|
9590
9867
|
|
|
@@ -9659,7 +9936,7 @@ POST /receipts/{imp_uid}
|
|
|
9659
9936
|
|
|
9660
9937
|
---
|
|
9661
9938
|
title: 일반결제 연동 유의사항
|
|
9662
|
-
description:
|
|
9939
|
+
description: 나이스정보통신(신모듈) 일반결제 연동 유의사항을 소개합니다.
|
|
9663
9940
|
targetVersions:
|
|
9664
9941
|
- v1
|
|
9665
9942
|
---
|
|
@@ -9684,11 +9961,11 @@ PG사로부터 정확한 사유를 전달받지 못하기 때문에 다음과
|
|
|
9684
9961
|
|
|
9685
9962
|
### 토스뱅크 카드사 다이렉트 호출 미지원
|
|
9686
9963
|
|
|
9687
|
-
|
|
9964
|
+
나이스정보통신(신모듈)의 경우 토스뱅크 카드(card.direct.code = "092") 다이렉트 호출이 불가능합니다.
|
|
9688
9965
|
|
|
9689
9966
|
### 카드사 다이렉트 호출시 고정 할부 개월수 필수 입력
|
|
9690
9967
|
|
|
9691
|
-
|
|
9968
|
+
나이스정보통신(신모듈)는 **카드사 다이렉트 호출시
|
|
9692
9969
|
고정 할부 개월수를 <span style="color:red"> 필수 </span>로 입력**해야 합니다.
|
|
9693
9970
|
결제 금액이 할부 지원 금액 미만(일반적으로 50,000원 이상 결제 시 할부 기능을 지원하나
|
|
9694
9971
|
카드사에 따라 다를 수 있습니다.)인 경우 **할부 개월수를 0(일시불)으로 전달**해야 합니다.
|
|
@@ -9743,7 +10020,7 @@ IMP.request_pay(
|
|
|
9743
10020
|
|
|
9744
10021
|
### 모바일 환경에서는 다이렉트 호출시에만 할부 옵션 설정 가능
|
|
9745
10022
|
|
|
9746
|
-
|
|
10023
|
+
나이스정보통신(신모듈)의 경우 일반 카드 결제 시(간편결제 제외) 할부 옵션(고정 할부 개월수)사용이 가능하나
|
|
9747
10024
|
**모바일 환경**에서는 **카드사 다이렉트 호출할 때만 할부 옵션 사용이 가능합니다.** 만약 모바일 환경에서 다이렉트 호출 코드 없이
|
|
9748
10025
|
할부 옵션을 전달하는 경우 무시됩니다.
|
|
9749
10026
|
|
|
@@ -9791,7 +10068,7 @@ IMP.request_pay(
|
|
|
9791
10068
|
|
|
9792
10069
|
### 가상계좌 입금 기한(`vbank_due`) 필수 입력
|
|
9793
10070
|
|
|
9794
|
-
|
|
10071
|
+
나이스정보통신(신모듈) 가상 계좌 발급 시, 입금 기한은 필수 입력해야 하며 아래 4가지 형식만 유효합니다.
|
|
9795
10072
|
입금 기한을 입력하지 않거나, 유효하지 않은 형식을 입력할 경우 가상계좌 발급 결제창이 호출되지 않고 "결제 창 호출에 실패하였습니다.
|
|
9796
10073
|
나이스페이 V2 가상계좌 발급시 유효한 입금 기한을 필수로 입력해야 합니다." 라는 에러 메세지가 리턴되오니 유의하시기 바랍니다.
|
|
9797
10074
|
|
|
@@ -9804,17 +10081,17 @@ IMP.request_pay(
|
|
|
9804
10081
|
|
|
9805
10082
|
### 계좌이체 다이렉트 호출시 은행 코드 지정 불가능
|
|
9806
10083
|
|
|
9807
|
-
|
|
10084
|
+
나이스정보통신(신모듈) 계좌이체 다이렉트 호출은 은행 코드를 지정하지 않고 바로 뱅크페이 결제창이 띄워지는 구조입니다.
|
|
9808
10085
|
|
|
9809
10086
|
### 계좌이체 다이렉트 호출시 현금영수증 정보는 필수 입력
|
|
9810
10087
|
|
|
9811
10088
|
계좌이체 거래는 계좌에서 현금성 결제로 현금영수증 발급이 가능하므로 현금영수증 정보를 필수로 입력해야 합니다.
|
|
9812
|
-
만약 입력하지 않을 경우
|
|
10089
|
+
만약 입력하지 않을 경우 나이스정보통신(신모듈) 계좌이체 다이렉트 호출 시 **현금영수증 발급 유형은 필수 입력**입니다.
|
|
9813
10090
|
라는 에러 메시지가 뜨면서 결제창이 호출되지 않으니 유의하시기 바랍니다.
|
|
9814
10091
|
|
|
9815
10092
|
### 계좌이체 에스크로 결제시에는 다이렉트 호출 불가능
|
|
9816
10093
|
|
|
9817
|
-
|
|
10094
|
+
나이스정보통신 정책상 계좌이체 + 에스크로 결제시에는 다이렉트 호출이 불가능합니다.
|
|
9818
10095
|
아래와 같이 계좌이체 + 에스크로 + 다이렉트 호출을 위한 파라미터를 설정할 경우
|
|
9819
10096
|
"나이스페이 V2 계좌이체 에스크로 결제시 다이렉트 호출은 불가능합니다."라는 에러 메시지가 뜨면서
|
|
9820
10097
|
결제창이 호출되지 않으니 유의하시기 바랍니다.
|
|
@@ -9822,7 +10099,7 @@ IMP.request_pay(
|
|
|
9822
10099
|
### 계좌이체 에스크로 결제시 결제창에 올바른 이메일을 입력해야 함
|
|
9823
10100
|
|
|
9824
10101
|
존재하지 않는 이메일을 입력할 경우 **이메일 주소 오류**라는 에러 메시지와 함께 승인에 실패합니다.
|
|
9825
|
-
또한 실제로 존재하는 이메일 도메인이더라도
|
|
10102
|
+
또한 실제로 존재하는 이메일 도메인이더라도 나이스정보통신 정책상 유효하지 않다고 취급하는
|
|
9826
10103
|
이메일 주소(예: .finance로 끝나는 이메일 주소)를 입력한 경우 승인은 정상적으로 되지만
|
|
9827
10104
|
**이후 API로 에스크로 등록시 에스크로 구매 확정 이메일이 전송되지 않습니다.**
|
|
9828
10105
|
|
|
@@ -9866,15 +10143,15 @@ IMP.request_pay(
|
|
|
9866
10143
|
|
|
9867
10144
|
### 컬쳐랜드(`cultureland`)만 지원
|
|
9868
10145
|
|
|
9869
|
-
|
|
10146
|
+
나이스정보통신(신모듈)은 상품권 결제시 컬쳐랜드만 지원하며 북앤라이프, 스마트문상 등은 지원하지 않습니다.
|
|
9870
10147
|
|
|
9871
10148
|
### MallUserID(`bypass.nice_v2.MallUserID`)는 필수 입력
|
|
9872
10149
|
|
|
9873
|
-
|
|
10150
|
+
나이스정보통신(신모듈) 상품권 결제시 고객사 구매자 ID를 의미하는 MalluserID는 필수 입력이며, bypass 파라미터로 전달할 수 있습니다.
|
|
9874
10151
|
|
|
9875
|
-
### 승인 완료시
|
|
10152
|
+
### 승인 완료시 나이스정보통신로부터 승인번호(`apply_num`)가 전달되지 않음
|
|
9876
10153
|
|
|
9877
|
-
|
|
10154
|
+
나이스정보통신(신모듈)은 상품권 결제시에는 승인 번호를 전달하지 않아 승인번호 확인이 어렵습니다.
|
|
9878
10155
|
따라서 결제 내역 조회시 승인 번호는 null로 리턴됩니다.
|
|
9879
10156
|
|
|
9880
10157
|
<details>
|
|
@@ -9919,7 +10196,7 @@ GET /payments/{imp_uid}
|
|
|
9919
10196
|
|
|
9920
10197
|
### 결제 수단 지정 시 카드 또는 포인트 지정 필요
|
|
9921
10198
|
|
|
9922
|
-
|
|
10199
|
+
나이스정보통신(신모듈)를 통한 네이버페이 결제 시 카드 또는 포인트 결제를 지정하여 호출해야합니다.
|
|
9923
10200
|
결제 수단(`pay_method`) 파라미터에 `naverpay` 입력은 불가능하며 `naverpay_card`(카드)
|
|
9924
10201
|
또는 `naverpay_point`(포인트/머니) 둘 중 하나로 입력해야 정상적으로 결제창이 호출되오니 유의하시기 바랍니다.
|
|
9925
10202
|
|
|
@@ -10004,9 +10281,9 @@ IMP.request_pay({
|
|
|
10004
10281
|
### SSGPAY 은행 계좌 결제시 현금영수증 발급 정보를 확인할 수 없음
|
|
10005
10282
|
|
|
10006
10283
|
SSGPAY 은행 계좌 결제 시 현금영수증 발급 정보를 입력하여 정상적으로 발급되더라도
|
|
10007
|
-
승인 완료(status: paid)시
|
|
10284
|
+
승인 완료(status: paid)시 나이스정보통신에서 현금영수증 발급 정보를 전달하지 않아
|
|
10008
10285
|
포트원 API로 결제/현금영수증 발급 내역 조회 또는 포트원 콘솔에서 현금영수증 내역을 확인할 수 없습니다.
|
|
10009
|
-
단,
|
|
10286
|
+
단, 나이스정보통신 어드민에서는 확인이 가능합니다.
|
|
10010
10287
|
|
|
10011
10288
|
<details>
|
|
10012
10289
|
|
|
@@ -10091,19 +10368,19 @@ IMP.request_pay(
|
|
|
10091
10368
|
# https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme
|
|
10092
10369
|
|
|
10093
10370
|
---
|
|
10094
|
-
title:
|
|
10095
|
-
description:
|
|
10371
|
+
title: 나이스정보통신 (신모듈)
|
|
10372
|
+
description: 나이스정보통신 연동 방법을 안내합니다.
|
|
10096
10373
|
targetVersions:
|
|
10097
10374
|
- v1
|
|
10098
10375
|
versionVariants:
|
|
10099
10376
|
v2: /opi/ko/integration/pg/v2/nice-v2
|
|
10100
10377
|
---
|
|
10101
10378
|
|
|
10102
|
-
## 1.
|
|
10379
|
+
## 1. 나이스정보통신(신모듈) 채널 설정하기
|
|
10103
10380
|
|
|
10104
10381
|
[결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
|
|
10105
10382
|
|
|
10106
|
-
아래 기능을 사용하시려면
|
|
10383
|
+
아래 기능을 사용하시려면 나이스정보통신에 사전 신청 후 계약이 완료되어야 합니다.
|
|
10107
10384
|
그렇지 않은 상태에서 해당 기능 이용시 PG창 호출에 실패하거나, 승인에 실패하거나,
|
|
10108
10385
|
승인에 성공하더라도 의도한 바와는 다른 응답을 얻게 될 수 있으니 주의 해주시기 바랍니다.
|
|
10109
10386
|
|
|
@@ -10134,7 +10411,7 @@ versionVariants:
|
|
|
10134
10411
|
|
|
10135
10412
|
## 2. 최신 JavaScript SDK로 업데이트하기 <a href="#2." id="2." />
|
|
10136
10413
|
|
|
10137
|
-
|
|
10414
|
+
나이스정보통신(신모듈) 결제는 최신 SDK에서만 지원되는 기능입니다.
|
|
10138
10415
|
|
|
10139
10416
|
```html title="JS SDK"
|
|
10140
10417
|
<script src="https://cdn.iamport.kr/v1/iamport.js"></script>
|
|
@@ -10142,7 +10419,7 @@ versionVariants:
|
|
|
10142
10419
|
|
|
10143
10420
|
<div class="hint" data-style="info">
|
|
10144
10421
|
|
|
10145
|
-
**(신)
|
|
10422
|
+
**(신) 나이스정보통신를 연동하기 위해서는 위에 안내된 JS SDK를 이용하셔야 합니다**
|
|
10146
10423
|
|
|
10147
10424
|
</div>
|
|
10148
10425
|
|
|
@@ -10168,7 +10445,7 @@ versionVariants:
|
|
|
10168
10445
|
## 3.결제 요청하기
|
|
10169
10446
|
|
|
10170
10447
|
[JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
|
|
10171
|
-
(신)
|
|
10448
|
+
(신) 나이스정보통신 결제창을 호출할 수 있습니다. **결제 결과**는 PC의 경우 `IMP.request_pay(param,
|
|
10172
10449
|
callback)` 호출 후 **callback**으로 수신되고 모바일의 경우
|
|
10173
10450
|
**m\_redirect\_url** 로 리디렉션됩니다.
|
|
10174
10451
|
|
|
@@ -10281,7 +10558,7 @@ IMP.request_pay(
|
|
|
10281
10558
|
|
|
10282
10559
|
**가상계좌 입금기한 (YYYY-MM-DD)**
|
|
10283
10560
|
|
|
10284
|
-
(신)
|
|
10561
|
+
(신) 나이스정보통신의 경우 필수 입력이며 날짜는 무조건 23:59:59로 설정 됨
|
|
10285
10562
|
|
|
10286
10563
|
- escrow: boolean
|
|
10287
10564
|
|
|
@@ -10333,6 +10610,8 @@ IMP.request_pay(
|
|
|
10333
10610
|
|
|
10334
10611
|
<div class="tabs-content" data-title="비인증 결제창 요청">
|
|
10335
10612
|
|
|
10613
|
+
(신) 나이스정보통신의 경우 비인증 결제창 방식은 간편결제(네이버페이 / 카카오페이)만 지원합니다.
|
|
10614
|
+
|
|
10336
10615
|
```ts title="Javascript SDK"
|
|
10337
10616
|
IMP.request_pay(
|
|
10338
10617
|
{
|
|
@@ -10459,22 +10738,22 @@ JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미
|
|
|
10459
10738
|
# https://developers.portone.io/opi/ko/integration/pg/v1/nice
|
|
10460
10739
|
|
|
10461
10740
|
---
|
|
10462
|
-
title: (구)
|
|
10463
|
-
description: (구)
|
|
10741
|
+
title: (구) 나이스정보통신
|
|
10742
|
+
description: (구) 나이스정보통신 결제창 연동 가이드를 안내합니다.
|
|
10464
10743
|
targetVersions:
|
|
10465
10744
|
- v1
|
|
10466
10745
|
---
|
|
10467
10746
|
|
|
10468
10747
|
<div class="hint" data-style="warning">
|
|
10469
10748
|
|
|
10470
|
-
|
|
10749
|
+
**나이스정보통신(구모듈) 연동 방법에 관한 매뉴얼**입니다.
|
|
10471
10750
|
|
|
10472
|
-
신규 연동 고객사이시거나
|
|
10751
|
+
신규 연동 고객사이시거나 나이스정보통신 신모듈로 업그레이드를 원하신다면 [나이스정보통신(신모듈) 연동 가이드](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme)를 참고하여 진행해주세요.
|
|
10473
10752
|
구모듈에 비해 신모듈에서 다양한 기능 및 결제수단을 지원하고 있습니다. 신규 고객사의 경우 가급적 신모듈로 연동하는 것을 권장드립니다.
|
|
10474
10753
|
|
|
10475
10754
|
</div>
|
|
10476
10755
|
|
|
10477
|
-
## 1.
|
|
10756
|
+
## 1. 나이스정보통신 채널 설정하기
|
|
10478
10757
|
|
|
10479
10758
|
[결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
|
|
10480
10759
|
|
|
@@ -10639,7 +10918,7 @@ curl -H "Content-Type: application/json" \
|
|
|
10639
10918
|
|
|
10640
10919
|
<div class="hint" data-style="info">
|
|
10641
10920
|
|
|
10642
|
-
|
|
10921
|
+
**나이스정보통신은 비인증 결제는 API 방식으로만 지원됩니다.**
|
|
10643
10922
|
|
|
10644
10923
|
비인증 결제를 연동하기 위해서는 카드정보를 획득할수 있는 UI를 구성해 주셔야 하며
|
|
10645
10924
|
해당 가이드는 [**비인증결제 연동하기**](https://developers.portone.io/opi/ko/integration/start/v1/non-auth)에서 확인해주시면 됩니다.
|
|
@@ -10984,6 +11263,96 @@ curl -H "Content-Type: application/json" \
|
|
|
10984
11263
|
</div>
|
|
10985
11264
|
|
|
10986
11265
|
|
|
11266
|
+
# https://developers.portone.io/opi/ko/integration/pg/v1/payletter-global
|
|
11267
|
+
|
|
11268
|
+
---
|
|
11269
|
+
title: 페이레터 해외결제
|
|
11270
|
+
description: 페이레터 해외결제 연동 방법을 안내합니다.
|
|
11271
|
+
targetVersions:
|
|
11272
|
+
- v1
|
|
11273
|
+
---
|
|
11274
|
+
|
|
11275
|
+
## 채널 설정하기
|
|
11276
|
+
|
|
11277
|
+
- [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기)의 페이레터 해외결제 채널 설정 내용을 참고하여 채널 설정을 진행합니다.
|
|
11278
|
+
|
|
11279
|
+
## 가능한 결제 수단
|
|
11280
|
+
|
|
11281
|
+
- **결제창 일반 결제**
|
|
11282
|
+
|
|
11283
|
+
페이레터의 경우, `pay_method` 파라미터를 지원하고 있지 않아,
|
|
11284
|
+
계약된 모든 결제 수단이 페이레터 결제창에 노출됩니다.
|
|
11285
|
+
|
|
11286
|
+
특정 결제 수단만 노출하고 싶으신 경우, 아래에 후술될 `bypass.payletter_global.pginfo` 파라미터를 사용하시면 됩니다.
|
|
11287
|
+
|
|
11288
|
+
- **일반 결제**
|
|
11289
|
+
- 특정 결제 수단만 결제창에 표기하고 싶으신 경우, `bypass.payletter_global.pginfo` 파라미터를 결제수단에 따라 아래와 같이 설정하시면 됩니다.
|
|
11290
|
+
- 해외카드 비인증 : `PLCreditCard`
|
|
11291
|
+
- 해외카드 인증(3DS) : `PLCreditCardMpi`
|
|
11292
|
+
- 유니온페이 : `PLUnionPay_HC`
|
|
11293
|
+
- 위챗페이 PC결제: `WeChatPayQRCodePayment`
|
|
11294
|
+
- 위챗페이 모바일결제 : `WeChatPayH5Payment`
|
|
11295
|
+
- 알리페이 : `ICBAlipay`
|
|
11296
|
+
|
|
11297
|
+
## SDK 결제 요청하기
|
|
11298
|
+
|
|
11299
|
+
결제 요청 시에는 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출해야 합니다.
|
|
11300
|
+
|
|
11301
|
+
## 가능한 빌링키 발급 및 결제 수단
|
|
11302
|
+
|
|
11303
|
+
- **빌링키 발급 및 결제**
|
|
11304
|
+
|
|
11305
|
+
페이레터의 경우, `pay_method` 파라미터를 지원하고 있지 않아,
|
|
11306
|
+
계약된 모든 빌링키 발급 및 결제 수단이 페이레터 결제창에 노출됩니다.
|
|
11307
|
+
특정 결제 수단만 노출하고 싶으신 경우, 아래에 후술될 `bypass.payletter_global.pginfo` 파라미터를 사용하시면 됩니다.
|
|
11308
|
+
|
|
11309
|
+
- **가능한 빌링키 발급 및 결제 수단**
|
|
11310
|
+
- 특정 빌링키 발급 및 결제 수단만 결제창에 표기하고 싶으신 경우, `bypass.payletter_global.pginfo` 파라미터를 결제 수단에 따라 아래와 같이 설정하시면 됩니다.
|
|
11311
|
+
|
|
11312
|
+
- 빌링키 발급 및 결제의 경우, 위챗, 알리페이 등의 간편결제 수단으로 발급하는 것을 지원하지 않고 있어 아래의 결제 수단으로만 발급이 가능합니다.
|
|
11313
|
+
- 해외카드 비인증 : `PLCreditCard`
|
|
11314
|
+
- 해외카드 인증(3DS) : `PLCreditCardMpi`
|
|
11315
|
+
- 유니온페이 : `PLUnionPay_HC`
|
|
11316
|
+
|
|
11317
|
+
## SDK 빌링키 발급 및 결제 요청하기
|
|
11318
|
+
|
|
11319
|
+
빌링키 발급 및 결제 요청 시에는 `customer_uid` 파라미터를 포함하여 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출해야 합니다.
|
|
11320
|
+
|
|
11321
|
+
<div class="hint" data-style="warning">
|
|
11322
|
+
|
|
11323
|
+
페이레터 해외결제는 **SDK 1.3.0 부터 사용 가능**합니다.
|
|
11324
|
+
|
|
11325
|
+
SDK 스크립트의 주소가 `https://cdn.iamport.kr/v1/iamport.js` 인지 확인해주세요.
|
|
11326
|
+
|
|
11327
|
+
위 JS SDK 를 이용하여 페이팔 정기결제 연동시 callback Data는 아래와 같이 두가지 형태로만 내려갑니다.
|
|
11328
|
+
|
|
11329
|
+
- `imp_uid`
|
|
11330
|
+
- `merchant_uid`
|
|
11331
|
+
|
|
11332
|
+
해당 SDK를 사용하실때는 IMP.request\_pay로부터 응답된 객체(또는 쿼리 파라미터)에서 imp\_uid를 가지고
|
|
11333
|
+
**포트원 REST API(GET /payments/imp\_uid)로 결제 상세 내역(승인 상태, 승인 결과 등등)을 조회**하여
|
|
11334
|
+
응답 파라미터 중 status(결제 상태) 파라미터에 따라 추가 로직을 구현해야 합니다.
|
|
11335
|
+
|
|
11336
|
+
</div>
|
|
11337
|
+
|
|
11338
|
+
### 비동기 결제
|
|
11339
|
+
|
|
11340
|
+
<div class="hint" data-style="warning">
|
|
11341
|
+
|
|
11342
|
+
페이레터 일반결제, 빌링키 발급 및 결제는 승인 요청 시 바로 승인되지 않고 일정 시간 후 처리되는 **승인 대기(pending) 상태**가 존재합니다. 따라서 고객사는 트랜잭션 종료시 콜백 함수로 전달되는 포트원 번호(imp\_uid)로 결제 내역을 조회(GET /payments/{imp\_uid})한 후 응답되는 status를 보고 각 상황에 맞는 후 처리 로직을 작성해야 합니다.
|
|
11343
|
+
|
|
11344
|
+
승인 대기 상태에서는 고객사는 반드시 (가상계좌나 정기결제와 같이 결제가 비동기로 승인되는 경우 포트원 → 고객사로 결제 결과를 통보해주는) 웹훅 기능을 연동해야 합니다.
|
|
11345
|
+
|
|
11346
|
+
</div>
|
|
11347
|
+
|
|
11348
|
+
## 유의사항
|
|
11349
|
+
|
|
11350
|
+
- `merchant_uid` 에는 영문, 숫자만으로 이루어진 문자열만 입력할 수 있습니다.
|
|
11351
|
+
- 페이레터의 경우 구매자 이메일을 필수로 받고있어,`buyer_email`을 필수로 입력하셔야 합니다.
|
|
11352
|
+
- 해외결제시 카드는 `KRW`, `USD`, `JPY`, 알리페이⋅위챗페이는 `CNY`를 지원합니다.
|
|
11353
|
+
- WeChatPay, Alipay 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
|
|
11354
|
+
|
|
11355
|
+
|
|
10987
11356
|
# https://developers.portone.io/opi/ko/integration/pg/v1/paymentwall
|
|
10988
11357
|
|
|
10989
11358
|
---
|
|
@@ -11416,7 +11785,7 @@ IMP.request_pay({
|
|
|
11416
11785
|
<div class="hint" data-style="info">
|
|
11417
11786
|
|
|
11418
11787
|
STC API를 사용하기 위해서는 **Paypal과의 STC 데이터 협의**가 필요하며,
|
|
11419
|
-
**포트원 지원팀(<support@portone.io>)을 통해 요청**해주시면 협의 프로세스를 안내해드리고 있습니다.
|
|
11788
|
+
**포트원 지원팀(<tech.support@portone.io>)을 통해 요청**해주시면 협의 프로세스를 안내해드리고 있습니다.
|
|
11420
11789
|
|
|
11421
11790
|
연동을 원하시는 경우 원활한 연동절차를 위해 요청 전 **아래 pdf의 Create REST API Application 섹션을 완료**해주세요.
|
|
11422
11791
|
|
|
@@ -11449,11 +11818,11 @@ versionVariants:
|
|
|
11449
11818
|
|
|
11450
11819
|
## 국내결제
|
|
11451
11820
|
|
|
11452
|
-
[
|
|
11821
|
+
[나이스정보통신 (신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme)
|
|
11453
11822
|
|
|
11454
|
-
[(구)
|
|
11823
|
+
[(구) 나이스정보통신](https://developers.portone.io/opi/ko/integration/pg/v1/nice)
|
|
11455
11824
|
|
|
11456
|
-
[NHN KCP](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp)
|
|
11825
|
+
[NHN KCP](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme)
|
|
11457
11826
|
|
|
11458
11827
|
[KG이니시스](https://developers.portone.io/opi/ko/integration/pg/v1/inicis)
|
|
11459
11828
|
|
|
@@ -11509,6 +11878,8 @@ versionVariants:
|
|
|
11509
11878
|
|
|
11510
11879
|
[페이팔(Express Checkout)](https://developers.portone.io/opi/ko/integration/pg/v1/paypal)
|
|
11511
11880
|
|
|
11881
|
+
[페이레터 해외결제](https://developers.portone.io/opi/ko/integration/pg/v1/payletter-global)
|
|
11882
|
+
|
|
11512
11883
|
|
|
11513
11884
|
# https://developers.portone.io/opi/ko/integration/pg/v1/rt/readme
|
|
11514
11885
|
|
|
@@ -12812,6 +13183,86 @@ curl -H "Content-Type: application/json" \
|
|
|
12812
13183
|
|
|
12813
13184
|
</div>
|
|
12814
13185
|
|
|
13186
|
+
## 3. 고정식 가상계좌 연동하기
|
|
13187
|
+
|
|
13188
|
+
헥토파이낸셜의 고정식 가상계좌 연동 방법을 안내합니다.
|
|
13189
|
+
|
|
13190
|
+
### 입금통보 설정
|
|
13191
|
+
|
|
13192
|
+
헥토파이낸셜 MID 발급 후 `settle_pgdev@settlebank.co.kr`에 아래 입금통보 주소로 설정 요청해야합니다.
|
|
13193
|
+
|
|
13194
|
+
요청 입금통보 주소: <https://service.iamport.kr/settle_payments/notice_vbank>
|
|
13195
|
+
|
|
13196
|
+
<div class="hint" data-style="info">
|
|
13197
|
+
|
|
13198
|
+
자세한 내용은 [가상계좌 입금통보 설정](https://developers.portone.io/opi/ko/integration/virtual-account/readme?v=v1)을 참고하세요.
|
|
13199
|
+
|
|
13200
|
+
</div>
|
|
13201
|
+
|
|
13202
|
+
### 가상계좌 발급 API
|
|
13203
|
+
|
|
13204
|
+
**주요 파라미터**
|
|
13205
|
+
|
|
13206
|
+
- `merchant_uid`: 고객사 거래 고유번호 (필수)
|
|
13207
|
+
- `amount`: 결제 금액 (고정식 가상계좌 시 필수)
|
|
13208
|
+
- `vbank_num`: PG사로부터 받은 가상계좌 번호 (필수)
|
|
13209
|
+
- `vbank_holder`: 가상계좌 예금주명 (필수)
|
|
13210
|
+
- `fixed_unlimited_vbank`: 고정식 무제한 가상계좌 여부
|
|
13211
|
+
- `pg`: PG사 구분자 `{PG사}.{PG상점 아이디}` (필수)
|
|
13212
|
+
|
|
13213
|
+
**에스크로 결제시 추가 파라미터**
|
|
13214
|
+
|
|
13215
|
+
- `escrow_password`: 에스크로 비밀번호 (필수)
|
|
13216
|
+
- `buyer_email`: 구매자 이메일 (필수)
|
|
13217
|
+
|
|
13218
|
+
<div class="hint" data-style="warning">
|
|
13219
|
+
|
|
13220
|
+
고정식 무제한 가상계좌 발급 유의사항
|
|
13221
|
+
|
|
13222
|
+
- `amount`는 생략 가능하며, 지정 시 0원으로 발급됩니다.
|
|
13223
|
+
- `tax_free`, `vat_amount` 파라미터를 사용할 수 없습니다.
|
|
13224
|
+
- 에스크로 결제를 지원하지 않습니다.
|
|
13225
|
+
|
|
13226
|
+
</div>
|
|
13227
|
+
|
|
13228
|
+
### 발급 정보 변경 API
|
|
13229
|
+
|
|
13230
|
+
입금 전 가상계좌의 입금기한이나 금액을 수정할 수 있습니다.
|
|
13231
|
+
|
|
13232
|
+
- `imp_uid`: 포트원 거래고유번호 (필수)
|
|
13233
|
+
- `amount`: 수정할 결제금액 (선택)
|
|
13234
|
+
- `vbank_due`: 수정할 입금기한 UNIX TIMESTAMP (필수)
|
|
13235
|
+
|
|
13236
|
+
<div class="hint" data-style="warning">
|
|
13237
|
+
|
|
13238
|
+
- 면세, 복합과세로 발급된 가상계좌의 경우 발급 정보 변경 기능이 제공되지 않습니다.
|
|
13239
|
+
- 고정식 무제한 가상계좌의 경우 amount 파라미터를 전달하여도 적용되지 않습니다.
|
|
13240
|
+
|
|
13241
|
+
</div>
|
|
13242
|
+
|
|
13243
|
+
### 입금 내역 확인
|
|
13244
|
+
|
|
13245
|
+
#### 결제건 조회 API
|
|
13246
|
+
|
|
13247
|
+
고정식 무제한 가상계좌의 경우 `deposit_history` 필드로 입금 내역을 확인할 수 있습니다.
|
|
13248
|
+
|
|
13249
|
+
**응답 필드 (주요)**
|
|
13250
|
+
|
|
13251
|
+
- `deposit_history`: 입금 내역 배열
|
|
13252
|
+
- `pg_tid`: PG사 승인번호
|
|
13253
|
+
- `amount`: 입금 금액
|
|
13254
|
+
- `depositor_name`: 입금자명
|
|
13255
|
+
- `deposited_at`: 입금 시각
|
|
13256
|
+
|
|
13257
|
+
<div class="hint" data-style="warning">
|
|
13258
|
+
|
|
13259
|
+
**유의 사항**
|
|
13260
|
+
|
|
13261
|
+
- **무제한 가상계좌**: 웹훅 수신 후 반드시 결제건 조회 API로 `deposit_history`를 확인하여 정확한 입금 내역을 검증하세요.
|
|
13262
|
+
- **취소 후 입금**: 취소된 무제한 가상계좌로 입금이 발생하면 status가 `cancelled`로 유지되므로, `deposit_history`와 `cancel_history`를 모두 확인해야 합니다.
|
|
13263
|
+
|
|
13264
|
+
</div>
|
|
13265
|
+
|
|
12815
13266
|
|
|
12816
13267
|
# https://developers.portone.io/opi/ko/integration/pg/v1/smartro-v2/api
|
|
12817
13268
|
|
|
@@ -14190,33 +14641,34 @@ STC 기능을 사용하시기 위해 다음 정보를 확인하셔야 합니다.
|
|
|
14190
14641
|
// 해당 파라미터들은 산업군 별로 추가가 필요하거나 제외해도 되는 파라미터들이 있습니다.
|
|
14191
14642
|
{
|
|
14192
14643
|
"additional_data": [
|
|
14644
|
+
// 상점의 구매자 계정 기준으로 정보 입력
|
|
14193
14645
|
{
|
|
14194
|
-
"key": "sender_account_id", //
|
|
14646
|
+
"key": "sender_account_id", // 구매자 계정 ID
|
|
14195
14647
|
"value": "A12345N343"
|
|
14196
14648
|
},
|
|
14197
14649
|
{
|
|
14198
|
-
"key": "sender_first_name", //
|
|
14650
|
+
"key": "sender_first_name", // 구매자 이름
|
|
14199
14651
|
"value": "John"
|
|
14200
14652
|
},
|
|
14201
14653
|
{
|
|
14202
|
-
"key": "sender_last_name", //
|
|
14654
|
+
"key": "sender_last_name", // 구매자 성
|
|
14203
14655
|
"value": "Doe"
|
|
14204
14656
|
},
|
|
14205
14657
|
{
|
|
14206
|
-
"key": "sender_email", //
|
|
14658
|
+
"key": "sender_email", // 구매자 이메일 주소
|
|
14207
14659
|
"value": "example@example.com"
|
|
14208
14660
|
},
|
|
14209
14661
|
{
|
|
14210
|
-
"key": "sender_phone", //
|
|
14662
|
+
"key": "sender_phone", // 구매자 휴대전화 번호
|
|
14211
14663
|
"value": "(02)16705176"
|
|
14212
14664
|
},
|
|
14213
14665
|
{
|
|
14214
|
-
"key": "sender_country_code", //
|
|
14666
|
+
"key": "sender_country_code", // 구매자 국가 코드
|
|
14215
14667
|
"value": "KR" // ISO Alpha-2 형식 국가 코드
|
|
14216
14668
|
},
|
|
14217
14669
|
{
|
|
14218
|
-
"key": "sender_create_date", //
|
|
14219
|
-
"value": "2023-10-10T23:59:59+09:00" //
|
|
14670
|
+
"key": "sender_create_date", // 구매자 계정 생성 시각
|
|
14671
|
+
"value": "2023-10-10T23:59:59+09:00" // RFC 3339 형식
|
|
14220
14672
|
}
|
|
14221
14673
|
]
|
|
14222
14674
|
}
|
|
@@ -14312,7 +14764,7 @@ STC 기능을 사용하시기 위해 다음 정보를 확인하셔야 합니다.
|
|
|
14312
14764
|
|
|
14313
14765
|
### Alternative Methods
|
|
14314
14766
|
|
|
14315
|
-
페이팔은 간편 결제를 Alternative Methods라고 부르고 있습니다. Alternative Methods도 Pay Later
|
|
14767
|
+
페이팔은 간편 결제를 Alternative Methods라고 부르고 있습니다. Alternative Methods도 Pay Later처럼 결제가 가능한 국가와 화폐는 매우 제한적입니다.
|
|
14316
14768
|
|
|
14317
14769
|
- Bancontact
|
|
14318
14770
|
- 구매자: BE / EUR
|
|
@@ -17669,6 +18121,7 @@ IMP.request_pay(
|
|
|
17669
18121
|
- kakaopay (카카오페이)
|
|
17670
18122
|
- payco (페이코)
|
|
17671
18123
|
- tosspay (토스페이)
|
|
18124
|
+
- naverpay (네이버페이)
|
|
17672
18125
|
|
|
17673
18126
|
- merchant\_uid: string
|
|
17674
18127
|
|
|
@@ -17864,18 +18317,19 @@ IMP.request_pay(
|
|
|
17864
18317
|
- 엘페이: LPAY
|
|
17865
18318
|
- 페이코: PAYCO
|
|
17866
18319
|
- 토스페이: TOSSPAY
|
|
18320
|
+
- 네이버페이: NPAY
|
|
17867
18321
|
|
|
17868
18322
|
- acceptmethod?: string\[]
|
|
17869
18323
|
|
|
17870
18324
|
**PC - 카드 결제 전용 파라미터**
|
|
17871
18325
|
|
|
17872
|
-
|형식 |설명
|
|
17873
|
-
|
|
17874
|
-
|SKIN(색상코드) |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d)
|
|
17875
|
-
|below1000 |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음
|
|
17876
|
-
|paypopup |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어
|
|
17877
|
-
|onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay`|
|
|
17878
|
-
|SLIMQUOTA(슬림 할부 설정) |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3)
|
|
18326
|
+
|형식 |설명 |
|
|
18327
|
+
|---------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
18328
|
+
|SKIN(색상코드) |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d) |
|
|
18329
|
+
|below1000 |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음 |
|
|
18330
|
+
|paypopup |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어 |
|
|
18331
|
+
|onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay` <br /> - 네이버페이: `naverpay`|
|
|
18332
|
+
|SLIMQUOTA(슬림 할부 설정) |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3) |
|
|
17879
18333
|
|
|
17880
18334
|
**PC - 휴대폰 소액 결제 전용 파라미터**
|
|
17881
18335
|
|
|
@@ -17951,6 +18405,7 @@ IMP.request_pay(
|
|
|
17951
18405
|
- kakaopay
|
|
17952
18406
|
- payco
|
|
17953
18407
|
- tosspay
|
|
18408
|
+
- naverpay
|
|
17954
18409
|
|
|
17955
18410
|
</details>
|
|
17956
18411
|
|
|
@@ -18892,7 +19347,7 @@ targetVersions:
|
|
|
18892
19347
|
- **지원 결제대행사**
|
|
18893
19348
|
- KG이니시스
|
|
18894
19349
|
- NHN KCP
|
|
18895
|
-
-
|
|
19350
|
+
- 나이스정보통신 (구모듈, 신모듈)
|
|
18896
19351
|
- 토스페이먼츠 (신모듈)
|
|
18897
19352
|
- 키움페이
|
|
18898
19353
|
- KSNET
|
|
@@ -18960,7 +19415,7 @@ const onetimeResponse = await fetch(
|
|
|
18960
19415
|
- **지원 결제대행사**
|
|
18961
19416
|
- KG이니시스
|
|
18962
19417
|
- NHN KCP
|
|
18963
|
-
-
|
|
19418
|
+
- 나이스정보통신 (구모듈, 신모듈)
|
|
18964
19419
|
- 토스페이먼츠 (신모듈)
|
|
18965
19420
|
- 키움페이
|
|
18966
19421
|
- KSNET
|
|
@@ -19223,8 +19678,6 @@ app.post("/iamport-callback/schedule", async (req, res) => {
|
|
|
19223
19678
|
포트원 서버에 결제 예약 요청을 하고 예약한 시간에 결제가 시도되면 지정된 웹훅 URL을 통해서
|
|
19224
19679
|
서버에 알리는 과정을 반복적으로 수행하여 반복 결제를 구현할 수 있습니다.
|
|
19225
19680
|
|
|
19226
|
-
(관련 이미지 첨부)
|
|
19227
|
-
|
|
19228
19681
|
예약된 결제가 시도되었을 때 발생하는 webhook 이벤트를 처리하는 로직에서 예약된 결제가 정상적으로 완료되고 결제 내역이 저장되면 다음 결제를 예약하는 예제입니다.
|
|
19229
19682
|
|
|
19230
19683
|
```ts title="server-side"
|
|
@@ -19301,8 +19754,6 @@ versionVariants:
|
|
|
19301
19754
|
v2: /opi/ko/integration/webhook/readme-v2
|
|
19302
19755
|
---
|
|
19303
19756
|
|
|
19304
|
-
(관련 이미지 첨부)
|
|
19305
|
-
|
|
19306
19757
|
## 웹훅(Webhook)이란?
|
|
19307
19758
|
|
|
19308
19759
|
특정 이벤트가 발생하였을 때 타 서비스나 응용프로그램으로 알림을 보내는 기능입니다.
|
|
@@ -19507,7 +19958,7 @@ app.post("/portone-webhook", async (req, res) => {
|
|
|
19507
19958
|
|
|
19508
19959
|
**웹훅 처리 전에 브라우저 결제 완료 처리가 진행되는 경우**
|
|
19509
19960
|
|
|
19510
|
-
기본적으로 포트원 서버는 웹훅을 호출한 뒤 고객사 응답을 기다리지 않고 브라우저에 302 redirect 응답을 보내기 때문에 결과 도달에 대한 순서를 보장하지 않습니다. 다만 고객사 요청이 있을 경우 webhook 호출 이후에 브라우저에 302 redirect 또는 callback 응답을 보내어 순서를 보장해 드리고 있습니다. 웹훅 우선순위 설정 요청은 <support@portone.io> 로 고객사 식별코드를 기재하여 요청해 주시면 됩니다.
|
|
19961
|
+
기본적으로 포트원 서버는 웹훅을 호출한 뒤 고객사 응답을 기다리지 않고 브라우저에 302 redirect 응답을 보내기 때문에 결과 도달에 대한 순서를 보장하지 않습니다. 다만 고객사 요청이 있을 경우 webhook 호출 이후에 브라우저에 302 redirect 또는 callback 응답을 보내어 순서를 보장해 드리고 있습니다. 웹훅 우선순위 설정 요청은 <tech.support@portone.io> 로 고객사 식별코드를 기재하여 요청해 주시면 됩니다.
|
|
19511
19962
|
|
|
19512
19963
|
</div>
|
|
19513
19964
|
|
|
@@ -19515,7 +19966,7 @@ app.post("/portone-webhook", async (req, res) => {
|
|
|
19515
19966
|
|
|
19516
19967
|
**웹훅 재 전송이 가능한가요?**
|
|
19517
19968
|
|
|
19518
|
-
웹훅은 기본적으로 1회 전송되도록 설정되어 있습니다. 네트워크 에러가 발생하거나 고객사 응답(HTTP 상태 코드)이 500번대인 경우, 재발송 설정을 원하신다면 웹훅이 최대 5회까지 1분 간격으로 재시도될 수 있습니다. 웹훅 재발송 설정 요청은 <support@portone.io> 로 고객사 식별코드를 기재하여 요청해 주시면 됩니다.
|
|
19969
|
+
웹훅은 기본적으로 1회 전송되도록 설정되어 있습니다. 네트워크 에러가 발생하거나 고객사 응답(HTTP 상태 코드)이 500번대인 경우, 재발송 설정을 원하신다면 웹훅이 최대 5회까지 1분 간격으로 재시도될 수 있습니다. 웹훅 재발송 설정 요청은 <tech.support@portone.io> 로 고객사 식별코드를 기재하여 요청해 주시면 됩니다.
|
|
19519
19970
|
|
|
19520
19971
|
</div>
|
|
19521
19972
|
|
|
@@ -19746,7 +20197,7 @@ targetVersions:
|
|
|
19746
20197
|
|
|
19747
20198
|
<details>
|
|
19748
20199
|
|
|
19749
|
-
<summary>토스페이먼츠 & 다날 &
|
|
20200
|
+
<summary>토스페이먼츠 & 다날 & 나이스정보통신 & KICC & 스마트로 & 헥토파이낸셜</summary>
|
|
19750
20201
|
|
|
19751
20202
|
- KB국민은행: `004`
|
|
19752
20203
|
- SC제일은행: `023`
|
|
@@ -19831,8 +20282,8 @@ targetVersions:
|
|
|
19831
20282
|
| NHN KCP 퀵페이 | `kcp_quick` |
|
|
19832
20283
|
| (구) 토스페이먼츠 | `uplus` |
|
|
19833
20284
|
| (신) 토스페이먼츠 | `tosspayments` |
|
|
19834
|
-
| (구)
|
|
19835
|
-
| (신)
|
|
20285
|
+
| (구) 나이스정보통신 | `nice` |
|
|
20286
|
+
| (신) 나이스정보통신 | `nice_v2` |
|
|
19836
20287
|
| 이지페이(KICC) | `kicc` |
|
|
19837
20288
|
| 카카오페이 | `kakaopay` |
|
|
19838
20289
|
|다날휴대폰결제/본인인증| `danal` |
|
|
@@ -19917,8 +20368,8 @@ API방식으로 연동하실 때는 [비인증 결제(일회성) API](https://de
|
|
|
19917
20368
|
|
|
19918
20369
|
| 결제대행사 |코드값(pg provider)|결제창 방식|API 방식| 발급과 동시에 결제 기능 (결제창기준) |
|
|
19919
20370
|
|:---------------------:|:-----------------:|:---------:|:------:|:--------------------------------------------------------------:|
|
|
19920
|
-
|
|
|
19921
|
-
|
|
|
20371
|
+
| 나이스정보통신(구모듈)| nice | X | O | - |
|
|
20372
|
+
| 나이스정보통신(신모듈)| nice\_v2 | X | O | - |
|
|
19922
20373
|
| 토스페이먼츠(신모듈) | tosspayments | O | O | 불가능 |
|
|
19923
20374
|
| KCP | kcp\_billing | O | X | 불가능 |
|
|
19924
20375
|
| KCP | kcp | X | O | - |
|
|
@@ -20594,7 +21045,7 @@ versionVariants:
|
|
|
20594
21045
|
- `kicc`(이지페이(한국정보통신) 결제창 일반/정기결제)
|
|
20595
21046
|
- `ksnet`(KSNET 결제창 일반결제 및 API 수기/정기결제)
|
|
20596
21047
|
- `mobilians`(모빌리언스 결제창 일반/정기결제)
|
|
20597
|
-
- `nice`(
|
|
21048
|
+
- `nice`(나이스정보통신(구모듈) 결제창 일반결제 및 API 수기/정기결제)
|
|
20598
21049
|
- `nice_v2`(나이스페이(신모듈) 결제창 일반결제 및 API 수기/정기결제)
|
|
20599
21050
|
- `settle`(헥토파이낸셜 결제창 일반결제 및 API 수기/정기결제)
|
|
20600
21051
|
- `settle_acc` (헥토파이낸셜 내통장결제)
|
|
@@ -20763,7 +21214,7 @@ versionVariants:
|
|
|
20763
21214
|
|
|
20764
21215
|
<summary>지원되는 PG사</summary>
|
|
20765
21216
|
|
|
20766
|
-
-
|
|
21217
|
+
- 나이스정보통신
|
|
20767
21218
|
- (신) 토스페이
|
|
20768
21219
|
|
|
20769
21220
|
</details>
|
|
@@ -20839,7 +21290,7 @@ versionVariants:
|
|
|
20839
21290
|
|
|
20840
21291
|
[**confirm\_process**](https://developers.portone.io/opi/ko/extra/confirm-process/readme-v1) **에 사용할 고객사 endpoint URL**
|
|
20841
21292
|
|
|
20842
|
-
- 사용 시 기술지원 메일로 별도 요청이 필요합니다. (<support@portone.io>)
|
|
21293
|
+
- 사용 시 기술지원 메일로 별도 요청이 필요합니다. (<tech.support@portone.io>)
|
|
20843
21294
|
|
|
20844
21295
|
- notice\_url?: string
|
|
20845
21296
|
|
|
@@ -21077,7 +21528,7 @@ PG사 또는 결제수단에 따라서 반환되는 속성들이 상이합니다
|
|
|
21077
21528
|
<script src="https://cdn.iamport.kr/v1/iamport.js"></script>
|
|
21078
21529
|
```
|
|
21079
21530
|
|
|
21080
|
-
위 JS SDK 버전을 사용하면서 (신) 토스페이먼츠, (신) 스마트로, (신)
|
|
21531
|
+
위 JS SDK 버전을 사용하면서 (신) 토스페이먼츠, (신) 스마트로, (신) 나이스정보통신, (신) 페이팔, KSNET, 웰컴페이먼츠 연동시에는
|
|
21081
21532
|
`imp_uid`, `merchant_uid`, `error_code`, `error_msg`만 제공됩니다.
|
|
21082
21533
|
|
|
21083
21534
|
결제 실패 사유와 코드 확인을 위해서는 `error_code`, `error_msg` 파라미터를 참고해주세요.
|
|
@@ -21188,7 +21639,7 @@ PG사 또는 결제수단에 따라서 반환되는 속성들이 상이합니다
|
|
|
21188
21639
|
- `kcp`(NHN KCP)
|
|
21189
21640
|
- `kcp_billing`(NHN KCP 정기결제)
|
|
21190
21641
|
- `uplus`((구) 토스페이먼츠(구 LG U+))
|
|
21191
|
-
- `nice`((구)
|
|
21642
|
+
- `nice`((구) 나이스정보통신)
|
|
21192
21643
|
- `kicc`(한국정보통신)
|
|
21193
21644
|
- `kakaopay`(카카오페이)
|
|
21194
21645
|
- `danal`(다날 휴대폰 소액결제)
|
|
@@ -21209,7 +21660,7 @@ PG사 또는 결제수단에 따라서 반환되는 속성들이 상이합니다
|
|
|
21209
21660
|
- `daou`(키움페이 (구. 페이조아))
|
|
21210
21661
|
- `tosspayments` ((신) 토스페이먼츠)
|
|
21211
21662
|
- `paypal_v2`((신) 페이팔)
|
|
21212
|
-
- `nice_v2`((신)
|
|
21663
|
+
- `nice_v2`((신) 나이스정보통신)
|
|
21213
21664
|
- `smartro_v2`((신) 스마트로)
|
|
21214
21665
|
- `toss_brandpay`(토스페이먼츠 브랜드페이)
|
|
21215
21666
|
- `welcome` (웰컴페이먼츠)
|
|
@@ -21630,7 +22081,7 @@ targetVersions:
|
|
|
21630
22081
|
|
|
21631
22082
|
- 결제대행사 필터는 하나의 결제대행사에 모든 `pg_provider`가 포함됩니다.
|
|
21632
22083
|
- KG이니시스 : inicis, html5\_inicis, inicis\_v2
|
|
21633
|
-
-
|
|
22084
|
+
- 나이스정보통신 : nice, nice\_v2
|
|
21634
22085
|
- 페이팔 : paypal, paypal\_v2
|
|
21635
22086
|
- 스마트로 : smartro, smartro\_v2
|
|
21636
22087
|
- 토스페이 : tosspay, tosspay\_v2
|
|
@@ -22900,7 +23351,7 @@ description: 결제대행사 및 결제수단을 선택하고 전자결제를
|
|
|
22900
23351
|
|
|
22901
23352
|
- [V2 연동 매뉴얼 바로가기](https://developers.portone.io/opi/ko/integration/ready/readme?v=v2)
|
|
22902
23353
|
|
|
22903
|
-
- 연동과 관련하여 궁금하신 사항은 **포트원 기술지원 이메일 <support@portone.io>**
|
|
23354
|
+
- 연동과 관련하여 궁금하신 사항은 **포트원 기술지원 이메일 <tech.support@portone.io>**
|
|
22904
23355
|
또는 채널톡으로 문의 주시기 바랍니다.
|
|
22905
23356
|
|
|
22906
23357
|
|
|
@@ -22916,7 +23367,7 @@ description: >-
|
|
|
22916
23367
|
## PG 거래대사 유의사항
|
|
22917
23368
|
|
|
22918
23369
|
- 포트원을 통해 연동된 아래 12개의 PG사 내역을 조회할 수 있습니다.
|
|
22919
|
-
- 지원 PG : **KCP, KG이니시스,
|
|
23370
|
+
- 지원 PG : **KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜**
|
|
22920
23371
|
- 고객사가 포트원을 통하지 않고 PG 직연동한 경우 지원 불가
|
|
22921
23372
|
- 9/26 이후 지원 예정 PG사 : KPN, 하이픈, KSNET
|
|
22922
23373
|
|
|
@@ -24132,7 +24583,7 @@ targetVersions:
|
|
|
24132
24583
|
## 프로모션이란?
|
|
24133
24584
|
|
|
24134
24585
|
고객사가 카드사와 계약하여 사용자에게 즉시 할인을 제공하는 **카드 즉시 할인 서비스**를 운영하고 관리할
|
|
24135
|
-
수 있는
|
|
24586
|
+
수 있는 서비스입니다.
|
|
24136
24587
|
|
|
24137
24588
|
카드 즉시 할인 서비스를 이용시 필요한 **프로모션 관리 시스템**과 **프로모션 정산 대사 시스템** 을 제공합니다.
|
|
24138
24589
|
포트원 콘솔에서 기간, 할인 조건, 예산 등 다양한 옵션의 프로모션을 설정할 수 있으며,
|
|
@@ -24478,7 +24929,7 @@ async function cancelPayment() {
|
|
|
24478
24929
|
|
|
24479
24930
|
---
|
|
24480
24931
|
title: 스마트 라우팅 - 콘솔 가이드
|
|
24481
|
-
description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화
|
|
24932
|
+
description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
|
|
24482
24933
|
targetVersions:
|
|
24483
24934
|
- v1
|
|
24484
24935
|
- v2
|
|
@@ -24555,7 +25006,7 @@ targetVersions:
|
|
|
24555
25006
|
|
|
24556
25007
|
---
|
|
24557
25008
|
title: 스마트 라우팅 - 연동하기
|
|
24558
|
-
description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화
|
|
25009
|
+
description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
|
|
24559
25010
|
targetVersions:
|
|
24560
25011
|
- v1
|
|
24561
25012
|
- v2
|
|
@@ -25868,7 +26319,7 @@ if (!issueResponse.ok)
|
|
|
25868
26319
|
사용 가능한 빌링키가 없는 경우 그룹 내 채널 비율이 0으로 설정되어있더라도 해당 결제대행사로 결제가
|
|
25869
26320
|
일어날 수 있습니다.
|
|
25870
26321
|
|
|
25871
|
-
예를 들어, 그룹 내에
|
|
26322
|
+
예를 들어, 그룹 내에 나이스정보통신, KG이니시스, 토스페이먼츠 총 3개의 결제대행사를 설정한 경우 빌링키
|
|
25872
26323
|
발급 시 3개의 결제대행사로부터 빌링키를 발급 받은 후 슈퍼 빌링키에 맵핑 됩니다.
|
|
25873
26324
|
이후 그룹 설정을 토스페이먼츠 0%, 스마트로 100%로 변경한 경우 위에 발급한 슈퍼 빌링키로 결제 요청 시
|
|
25874
26325
|
토스페이먼츠 빌링키만 사용이 가능하기 때문에 0%로 결제 비율이 설정되어있음에도 토스페이먼츠로 결제가
|
|
@@ -25883,7 +26334,7 @@ if (!issueResponse.ok)
|
|
|
25883
26334
|
|
|
25884
26335
|
---
|
|
25885
26336
|
title: 스마트 라우팅
|
|
25886
|
-
description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화
|
|
26337
|
+
description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
|
|
25887
26338
|
targetVersions:
|
|
25888
26339
|
- v1
|
|
25889
26340
|
- v2
|
|
@@ -25914,8 +26365,8 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
25914
26365
|
|
|
25915
26366
|
### 결제창(SDK) 인증결제
|
|
25916
26367
|
|
|
25917
|
-
-
|
|
25918
|
-
- **(구)
|
|
26368
|
+
- **나이스정보통신(신모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
26369
|
+
- **(구) 나이스정보통신** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
25919
26370
|
- **NHN KCP** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
25920
26371
|
- **KG 이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
25921
26372
|
- **토스페이먼츠(신모듈)** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
@@ -25934,7 +26385,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
25934
26385
|
|
|
25935
26386
|
### API 수기(키인)결제
|
|
25936
26387
|
|
|
25937
|
-
-
|
|
26388
|
+
- **나이스정보통신(신모듈)** : 카드
|
|
25938
26389
|
- **NHN KCP** : 카드
|
|
25939
26390
|
- **KG 이니시스** : 카드
|
|
25940
26391
|
- **토스페이먼츠(신모듈)** : 카드
|
|
@@ -25943,8 +26394,8 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
25943
26394
|
|
|
25944
26395
|
### API 빌링키 발급 및 정기결제
|
|
25945
26396
|
|
|
25946
|
-
-
|
|
25947
|
-
- **(구)
|
|
26397
|
+
- **나이스정보통신 (신모듈)** : 카드
|
|
26398
|
+
- **(구) 나이스정보통신** : 카드
|
|
25948
26399
|
- **NHN KCP** : 카드
|
|
25949
26400
|
- **KG이니시스** : 카드
|
|
25950
26401
|
- **토스페이먼츠(신모듈)** : 카드
|
|
@@ -25959,7 +26410,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
25959
26410
|
|
|
25960
26411
|
### 결제창(SDK) 인증결제
|
|
25961
26412
|
|
|
25962
|
-
-
|
|
26413
|
+
- **나이스정보통신** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
25963
26414
|
- **KG이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
25964
26415
|
- **토스페이먼츠** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
25965
26416
|
- **한국결제네트웍스(KPN)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
@@ -25969,7 +26420,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
25969
26420
|
|
|
25970
26421
|
### API 수기(키인)결제
|
|
25971
26422
|
|
|
25972
|
-
-
|
|
26423
|
+
- **나이스정보통신** : 카드 / 가상계좌
|
|
25973
26424
|
- **KG이니시스** : 카드 / 가상계좌
|
|
25974
26425
|
- **토스페이먼츠** : 카드 / 가상계좌
|
|
25975
26426
|
- **한국결제네트웍스(KPN)** : 카드 / 가상계좌
|
|
@@ -25979,7 +26430,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
25979
26430
|
|
|
25980
26431
|
### API 빌링키 발급 및 정기결제
|
|
25981
26432
|
|
|
25982
|
-
-
|
|
26433
|
+
- **나이스정보통신** : 카드
|
|
25983
26434
|
- **KG이니시스** : 카드
|
|
25984
26435
|
- **토스페이먼츠** : 카드
|
|
25985
26436
|
- **한국결제네트웍스(KPN)** : 카드
|
|
@@ -26174,7 +26625,7 @@ targetVersions:
|
|
|
26174
26625
|
|
|
26175
26626
|
<details>
|
|
26176
26627
|
|
|
26177
|
-
<summary
|
|
26628
|
+
<summary>나이스정보통신</summary>
|
|
26178
26629
|
|
|
26179
26630
|
<div class="hint" data-style="info">
|
|
26180
26631
|
|
|
@@ -26182,16 +26633,16 @@ targetVersions:
|
|
|
26182
26633
|
|
|
26183
26634
|
</div>
|
|
26184
26635
|
|
|
26185
|
-
1. [
|
|
26636
|
+
1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
|
|
26186
26637
|
2. \[가맹점정보]→\[KEY관리]를 클릭합니다.
|
|
26187
26638
|
3. MID 및 Key 값을 확인할 수 있습니다.
|
|
26188
26639
|
|
|
26189
|
-
(이미지 첨부:
|
|
26640
|
+
(이미지 첨부: 나이스정보통신 가맹점 관리자 내 KEY 조회 화면)
|
|
26190
26641
|
|
|
26191
26642
|
4. \[가맹점정보]→\[비밀번호관리]→\[거래취소비밀번호]를 클릭합니다.
|
|
26192
26643
|
5. 비밀번호를 설정합니다. 비밀번호는 최대 10자리까지 가능합니다.
|
|
26193
26644
|
|
|
26194
|
-
(이미지 첨부:
|
|
26645
|
+
(이미지 첨부: 나이스정보통신 가맹점 관리자 내 거래취소비밀번호 설정 화면)
|
|
26195
26646
|
|
|
26196
26647
|
6. 포트원 콘솔에서 채널 추가 시 \[MID], \[Key], \[결제취소 비밀번호]를 입력한 후 `저장`을 클릭합니다.
|
|
26197
26648
|
|
|
@@ -26510,7 +26961,17 @@ targetVersions:
|
|
|
26510
26961
|
|
|
26511
26962
|
<div class="tabs-content" data-title="통합 본인인증">
|
|
26512
26963
|
|
|
26513
|
-
|
|
26964
|
+
1. [KG이니시스 가맹점관리자](https://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
|
|
26965
|
+
2. \[상점정보]→\[계약정보]→\[KEY 정보]를 클릭합니다.
|
|
26966
|
+
3. \[부가서비스 연동 Key 정보]→\[통합인증 서비스] 항목에서 \[도메인 등록] 버튼을 클릭 후 아래 3개의 도메인을 등록합니다.
|
|
26967
|
+
|
|
26968
|
+
- 본인인증 서비스를 이용하는 고객사 서비스 도메인
|
|
26969
|
+
- iamport.co
|
|
26970
|
+
- iamport.kr
|
|
26971
|
+
|
|
26972
|
+
(이미지 첨부: KG이니시스 가맹점관리자 내 도메인 등록화면)
|
|
26973
|
+
|
|
26974
|
+
4. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
|
|
26514
26975
|
|
|
26515
26976
|
</div>
|
|
26516
26977
|
|
|
@@ -26606,7 +27067,17 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
|
|
|
26606
27067
|
|
|
26607
27068
|
<div class="tabs-content" data-title="통합 본인인증">
|
|
26608
27069
|
|
|
26609
|
-
|
|
27070
|
+
1. [KG이니시스 가맹점관리자](https://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
|
|
27071
|
+
2. \[상점정보]→\[계약정보]→\[KEY 정보]를 클릭합니다.
|
|
27072
|
+
3. \[부가서비스 연동 Key 정보]→\[통합인증 서비스] 항목에서 \[도메인 등록] 버튼을 클릭 후 아래 3개의 도메인을 등록합니다.
|
|
27073
|
+
|
|
27074
|
+
- 본인인증 서비스를 이용하는 고객사 서비스 도메인
|
|
27075
|
+
- iamport.co
|
|
27076
|
+
- iamport.kr
|
|
27077
|
+
|
|
27078
|
+
(이미지 첨부: KG이니시스 가맹점관리자 내 도메인 등록화면)
|
|
27079
|
+
|
|
27080
|
+
4. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
|
|
26610
27081
|
|
|
26611
27082
|
</div>
|
|
26612
27083
|
|
|
@@ -27036,8 +27507,6 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
|
|
|
27036
27507
|
|
|
27037
27508
|
</details>
|
|
27038
27509
|
|
|
27039
|
-
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
|
|
27040
|
-
|
|
27041
27510
|
<details>
|
|
27042
27511
|
|
|
27043
27512
|
<summary>페이레터 해외결제</summary>
|
|
@@ -27047,8 +27516,6 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
|
|
|
27047
27516
|
|
|
27048
27517
|
</details>
|
|
27049
27518
|
|
|
27050
|
-
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
|
|
27051
|
-
|
|
27052
27519
|
## <span id="integration-identifiers">4. 포트원 연동정보 확인하기</span>
|
|
27053
27520
|
|
|
27054
27521
|
포트원을 이용한 결제 연동 시 필요한 연동정보를 확인합니다.
|
|
@@ -27128,78 +27595,54 @@ targetVersions:
|
|
|
27128
27595
|
포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
|
|
27129
27596
|
AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
|
|
27130
27597
|
|
|
27131
|
-
|
|
27598
|
+
이외에도 포트원 콘솔에서 제공하는 기능 중 일부를 수행할 수 있습니다.
|
|
27599
|
+
아래 기능을 AI에게 요청하면 MCP 서버가 브라우저를 열어 포트원 콘솔 로그인을 요청하며, 로그인 후 기능이 수행됩니다.
|
|
27132
27600
|
|
|
27133
|
-
|
|
27601
|
+
- 채널 목록 조회
|
|
27602
|
+
- 테스트 채널 추가
|
|
27603
|
+
- 하위 상점 조회
|
|
27604
|
+
- 결제 내역 조회
|
|
27134
27605
|
|
|
27135
|
-
|
|
27606
|
+
### DXT를 이용한 설치
|
|
27136
27607
|
|
|
27137
|
-
|
|
27138
|
-
{
|
|
27139
|
-
// ...
|
|
27608
|
+
[DXT (Desktop Extensions)](https://github.com/anthropics/dxt)를 이용해 MCP 서버를 원클릭으로 설치할 수 있습니다.
|
|
27140
27609
|
|
|
27141
|
-
|
|
27142
|
-
|
|
27610
|
+
1. [GitHub Releases](https://github.com/portone-io/mcp-server/releases)에서 최신 `portone-mcp-server.dxt` 파일을 다운로드합니다.
|
|
27611
|
+
2. 지원하는 AI 도구(Claude Desktop 등)에서 다운로드한 `.dxt` 파일을 드래그 앤 드롭하거나 열기를 통해 설치합니다.
|
|
27612
|
+
3. 설치 후 도구를 재시작하여 MCP 서버가 정상적으로 등록되었는지 확인합니다.
|
|
27143
27613
|
|
|
27144
|
-
|
|
27145
|
-
"command": "uvx",
|
|
27146
|
-
"args": ["portone-mcp-server@latest"]
|
|
27147
|
-
}
|
|
27148
|
-
}
|
|
27149
|
-
}
|
|
27150
|
-
```
|
|
27151
|
-
|
|
27152
|
-
<div class="hint" data-style="info">
|
|
27153
|
-
|
|
27154
|
-
사용 환경에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야 합니다.
|
|
27155
|
-
|
|
27156
|
-
</div>
|
|
27157
|
-
|
|
27158
|
-
설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
|
|
27159
|
-
|
|
27160
|
-
#### 포트원 기능 사용하기
|
|
27161
|
-
|
|
27162
|
-
MCP 서버에 포트원 기능을 연동하면, AI가 아래와 같은 작업을 수행할 수 있습니다.
|
|
27614
|
+
<div class="hint" data-style="warning">
|
|
27163
27615
|
|
|
27164
|
-
|
|
27165
|
-
- 본인인증 내역 단건/다건 조회
|
|
27616
|
+
**Claude Desktop에서 DXT 파일 사용 시 주의사항**
|
|
27166
27617
|
|
|
27167
|
-
|
|
27618
|
+
현재 [알려진 이슈](https://github.com/anthropics/dxt/issues/45)로 인해 Claude Desktop에서 DXT 설치 후 MCP 서버가 정상적으로 작동하지 않을 수 있습니다.
|
|
27168
27619
|
|
|
27169
|
-
|
|
27170
|
-
{
|
|
27171
|
-
// ...
|
|
27620
|
+
이 경우 Node.js 22.6.0 이상을 설치하고 Claude Desktop 설정에서 **"MCP용 내장 Node.js 사용"** 옵션을 비활성화한 후 재시작하면 정상적으로 작동합니다.
|
|
27172
27621
|
|
|
27173
|
-
|
|
27174
|
-
// ...
|
|
27175
|
-
|
|
27176
|
-
"portone-mcp-server": {
|
|
27177
|
-
"command": "uvx",
|
|
27178
|
-
"args": ["portone-mcp-server@latest"],
|
|
27179
|
-
// 아래 env 블록을 추가하여 API 시크릿을 설정합니다.
|
|
27180
|
-
"env": {
|
|
27181
|
-
"API_SECRET": "<YOUR_PORTONE_API_SECRET>"
|
|
27182
|
-
}
|
|
27183
|
-
}
|
|
27184
|
-
}
|
|
27185
|
-
}
|
|
27186
|
-
```
|
|
27187
|
-
|
|
27188
|
-
<div class="hint" data-style="warning">
|
|
27622
|
+
</div>
|
|
27189
27623
|
|
|
27190
|
-
|
|
27624
|
+
### MCP 서버 등록하기
|
|
27191
27625
|
|
|
27192
|
-
|
|
27626
|
+
1. Node.js 22.6.0 이상이 설치되어 있어야 합니다.
|
|
27193
27627
|
|
|
27194
|
-
|
|
27628
|
+
2. 사용하는 AI 도구의 MCP 설정에서 아래 내용을 추가합니다. (Cursor, Windsurf, Claude Desktop, etc...)
|
|
27195
27629
|
|
|
27196
|
-
|
|
27630
|
+
```jsonc
|
|
27631
|
+
"mcpServers": {
|
|
27197
27632
|
|
|
27198
|
-
|
|
27633
|
+
// 기존 설정
|
|
27199
27634
|
|
|
27200
|
-
|
|
27635
|
+
"portone-mcp-server": {
|
|
27636
|
+
"command": "npx",
|
|
27637
|
+
"args": [
|
|
27638
|
+
"-y",
|
|
27639
|
+
"@portone/mcp-server@latest"
|
|
27640
|
+
]
|
|
27641
|
+
}
|
|
27642
|
+
}
|
|
27643
|
+
```
|
|
27201
27644
|
|
|
27202
|
-
|
|
27645
|
+
3. 도구를 재시작해 portone-mcp-server 및 해당 서버가 제공하는 도구들이 잘 등록되었는지 확인합니다.
|
|
27203
27646
|
|
|
27204
27647
|
<div class="hint" data-style="warning">
|
|
27205
27648
|
|
|
@@ -27210,7 +27653,7 @@ MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않
|
|
|
27210
27653
|
|
|
27211
27654
|
</div>
|
|
27212
27655
|
|
|
27213
|
-
###
|
|
27656
|
+
### MCP 서버 활용하기
|
|
27214
27657
|
|
|
27215
27658
|
사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
|
|
27216
27659
|
|
|
@@ -27280,8 +27723,8 @@ targetVersions:
|
|
|
27280
27723
|
|키움페이 |daou |<ul><li>발행 통지 URL: [https://service.iamport.kr/daou\_payments/result](http://service.iamport.kr/daou_payments/result)</li> <li>결과 통지 URL: [https://service.iamport.kr/daou\_payments/notice\_vbank](http://service.iamport.kr/daou_payments/notice_vbank)</li></ul>|
|
|
27281
27724
|
|토스페이먼츠(신모듈) |tosspayments |[https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments](http://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments) |
|
|
27282
27725
|
|스마트로(신모듈) |smartro\_v2 |입금 통보, 환불이체 URL 동일: [https://tx-gateway-service.prod.iamport.co/smartro-v2](http://tx-gateway-service.prod.iamport.co/smartro-v2) |
|
|
27283
|
-
|
|
27284
|
-
|
|
27726
|
+
|나이스정보통신(구모듈)|nice |[https://service.iamport.kr/nice\_payments/notice\_vbank](http://service.iamport.kr/nice_payments/notice_vbank) |
|
|
27727
|
+
|나이스정보통신(신모듈)|nice\_v2 |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2) |
|
|
27285
27728
|
|웰컴페이먼츠 |welcome |[https://tx-gateway-service.prod.iamport.co/welcome](http://tx-gateway-service.prod.iamport.co/welcome) |
|
|
27286
27729
|
|
|
27287
27730
|
<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
|
|
@@ -27292,7 +27735,7 @@ targetVersions:
|
|
|
27292
27735
|
|----------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-|
|
|
27293
27736
|
|토스페이먼츠 |tosspayments |[https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments](http://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments)| |
|
|
27294
27737
|
|스마트로 |smartro\_v2 |입금 통보, 환불이체 URL 동일: [https://tx-gateway-service.prod.iamport.co/smartro-v2](http://tx-gateway-service.prod.iamport.co/smartro-v2) | |
|
|
27295
|
-
|
|
27738
|
+
|나이스정보통신 |nice\_v2 |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2) | |
|
|
27296
27739
|
|KG이니시스 |inicis\_v2 |[https://tx-gateway-service.prod.iamport.co/inicis-v2](http://tx-gateway-service.prod.iamport.co/inicis-v2) | |
|
|
27297
27740
|
|한국결제네트웍스|kpn |[https://tx-gateway-service.prod.iamport.co/kpn/virtual-account](http://tx-gateway-service.prod.iamport.co/kpn/virtual-account) | |
|
|
27298
27741
|
|NHN KCP |kcp\_v2 |[https://tx-gateway-service.prod.iamport.co/kcp-v2](http://tx-gateway-service.prod.iamport.co/kcp-v2) | |
|
|
@@ -27333,9 +27776,9 @@ targetVersions:
|
|
|
27333
27776
|
|
|
27334
27777
|
<details>
|
|
27335
27778
|
|
|
27336
|
-
<summary
|
|
27779
|
+
<summary>나이스정보통신(구모듈) 설정 방법</summary>
|
|
27337
27780
|
|
|
27338
|
-
1. [
|
|
27781
|
+
1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
|
|
27339
27782
|
2. \[가맹점정보]→\[기본정보]를 클릭합니다.
|
|
27340
27783
|
3. \[결제데이터통보] 항목에서 **가상계좌**의 \[URL/IP]를 `https://service.iamport.kr/nice_payments/notice_vbank` 로 설정해주세요.
|
|
27341
27784
|
4. \[재전송 간격]은 1분, \[재전송 횟수]는 3회로 설정해주세요.
|
|
@@ -27345,7 +27788,7 @@ targetVersions:
|
|
|
27345
27788
|
- 재전송 간격: 최소 1분 \~ 최대 10분까지만 입력 가능합니다.
|
|
27346
27789
|
- 재전송 횟수: 최소 1회 \~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
|
|
27347
27790
|
|
|
27348
|
-
(이미지 첨부:
|
|
27791
|
+
(이미지 첨부: 나이스정보통신 가맹점 관리자 내 입금통보 URL 설정 화면)
|
|
27349
27792
|
|
|
27350
27793
|
</details>
|
|
27351
27794
|
|
|
@@ -27438,9 +27881,9 @@ KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 U
|
|
|
27438
27881
|
|
|
27439
27882
|
<details>
|
|
27440
27883
|
|
|
27441
|
-
<summary
|
|
27884
|
+
<summary>나이스정보통신(신모듈) 설정 방법</summary>
|
|
27442
27885
|
|
|
27443
|
-
1. [
|
|
27886
|
+
1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
|
|
27444
27887
|
2. \[가맹점정보]→\[기본정보]를 클릭합니다.
|
|
27445
27888
|
3. \[결제데이터통보] 항목에서 **가상계좌**의 \[URL/IP]를 `https://tx-gateway-service.prod.iamport.co/nicepay-v2` 로 설정해주세요.
|
|
27446
27889
|
4. \[재전송 간격]은 1분, \[재전송 횟수]는 3회로 설정해주세요.
|
|
@@ -27450,7 +27893,7 @@ KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 U
|
|
|
27450
27893
|
- 재전송 간격: 최소 1분 \~ 최대 10분까지만 입력 가능합니다.
|
|
27451
27894
|
- 재전송 횟수: 최소 1회 \~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
|
|
27452
27895
|
|
|
27453
|
-
(이미지 첨부:
|
|
27896
|
+
(이미지 첨부: 나이스정보통신 가맹점 관리자 내 입금통보 URL 설정 화면 )
|
|
27454
27897
|
|
|
27455
27898
|
</details>
|
|
27456
27899
|
|
|
@@ -27736,19 +28179,244 @@ targetVersions:
|
|
|
27736
28179
|
|
|
27737
28180
|
포트원 결제 연동 및 운영 과정에서 기술적인 어려움을 겪고 있다면, 아래 메일로 문의하세요.
|
|
27738
28181
|
|
|
27739
|
-
|
|
28182
|
+
- <tech.support@portone.io>
|
|
27740
28183
|
|
|
27741
|
-
- V1: <support@portone.io>
|
|
27742
|
-
- V2: <tech.support@portone.io>
|
|
27743
28184
|
|
|
27744
|
-
|
|
28185
|
+
# https://developers.portone.io/opi/ko/support/pg-terms
|
|
27745
28186
|
|
|
27746
|
-
|
|
28187
|
+
---
|
|
28188
|
+
title: 용어 사전
|
|
28189
|
+
description: 온라인 결제 시스템에서 자주 사용되는 용어들을 설명합니다.
|
|
28190
|
+
targetVersions:
|
|
28191
|
+
- v1
|
|
28192
|
+
- v2
|
|
28193
|
+
---
|
|
27747
28194
|
|
|
27748
|
-
|
|
27749
|
-
- V1: <support@portone.io>
|
|
28195
|
+
## 결제 대행 관련
|
|
27750
28196
|
|
|
27751
|
-
|
|
28197
|
+
### PG (Payment Gateway)
|
|
28198
|
+
|
|
28199
|
+
PG는 온라인 결제에서 결제 정보를 송수신하고 정산을 매개하는 서비스입니다. 온라인 결제를 받기 위해서는 PG사와의 계약과 연동이 필요합니다. 법적으로는 전자금융업상 전자지급결제대행업에 해당합니다.
|
|
28200
|
+
|
|
28201
|
+
PG에 따라 신용카드, 계좌이체, 가상계좌, 휴대폰 결제 등 다양한 결제 수단을 이용할 수 있으며, "결제의 관문"이라는 이름처럼 알맞은 시스템으로 결제 정보를 전달합니다.
|
|
28202
|
+
|
|
28203
|
+
### 포트원 원 페이먼트 인프라 (OPI)
|
|
28204
|
+
|
|
28205
|
+
다양한 PG의 파편화된 인터페이스를 통일하여 현대적인 연동 경험을 제공하는 **결제 오케스트레이션 서비스**입니다. 이를 통해 PG를 쉽게 연동 및 추가/변경하고, 다중 PG 시스템을 운영할 수 있습니다.
|
|
28206
|
+
|
|
28207
|
+
<div class="hint" data-style="info">
|
|
28208
|
+
|
|
28209
|
+
OPI 서비스는 결제 정보를 송수신하지만 자금 이동에는 관여하지 않습니다.
|
|
28210
|
+
|
|
28211
|
+
</div>
|
|
28212
|
+
|
|
28213
|
+
### PG 상점 아이디 (MID)
|
|
28214
|
+
|
|
28215
|
+
PG에서 상점에 부여하는 고유 식별자입니다. PG와의 계약을 통해 발급되며, 결제 수단, 과세 여부, 수수료 등 여러 설정이 MID 단위로 관리됩니다. PG 정책에 따라서는 이용 서비스 및 세부 설정별로 여러 개의 MID를 발급하기도 합니다.
|
|
28216
|
+
|
|
28217
|
+
포트원을 이용할 때에는 채널을 추가할 때 MID를 입력합니다.
|
|
28218
|
+
|
|
28219
|
+
<div class="hint" data-style="info">
|
|
28220
|
+
|
|
28221
|
+
**PG사별 상점 아이디 명칭**
|
|
28222
|
+
|
|
28223
|
+
- KG이니시스: 상점 아이디(MID)
|
|
28224
|
+
- 카카오페이: 고객사 코드(CID)
|
|
28225
|
+
- 네이버페이: 파트너 ID (하위 식별자로 체인 ID 존재)
|
|
28226
|
+
- 토스페이먼츠: 상점 아이디(MID)
|
|
28227
|
+
- NHN KCP: 사이트 코드
|
|
28228
|
+
|
|
28229
|
+
</div>
|
|
28230
|
+
|
|
28231
|
+
### 포트원 상점 아이디 (storeId)
|
|
28232
|
+
|
|
28233
|
+
포트원 관리자 콘솔에서 확인할 수 있는 상점 식별자입니다. 연동 시 `storeId`라는 이름으로 많은 API에 등장합니다.
|
|
28234
|
+
|
|
28235
|
+
포트원 V1에서는 고객사 식별코드라는 별도 값을 이용합니다.
|
|
28236
|
+
|
|
28237
|
+
## 결제 방식 관련 용어
|
|
28238
|
+
|
|
28239
|
+
### 간편결제사
|
|
28240
|
+
|
|
28241
|
+
네이버페이, 카카오페이, 토스페이, 페이코와 같이 신용카드나 계좌번호 등의 결제 정보를 등록해 비밀번호 입력, 지문 인식만으로 결제할 수 있는 서비스를 제공하는 사업자입니다.
|
|
28242
|
+
|
|
28243
|
+
### PG 제휴 간편결제
|
|
28244
|
+
|
|
28245
|
+
간편결제사와 직접 계약을 맺지 않고 일반 PG사와의 계약만으로 간편결제사의 서비스 이용이 가능한 서비스입니다. 구매자가 보기에는 동일한 간편결제사의 결제창이 호출됩니다.
|
|
28246
|
+
|
|
28247
|
+
<div class="hint" data-style="warning">
|
|
28248
|
+
|
|
28249
|
+
**PG 제휴 간편결제 주의사항**
|
|
28250
|
+
|
|
28251
|
+
PG 제휴로 간편결제를 이용할 경우 간편결제 포인트 적립이 안 되는 등 일부 기능을 사용할 수 없는 경우가 있습니다.
|
|
28252
|
+
|
|
28253
|
+
</div>
|
|
28254
|
+
|
|
28255
|
+
### 인증결제
|
|
28256
|
+
|
|
28257
|
+
신용카드, 간편결제, 계좌이체, 휴대폰 결제 등에서 결제 정보가 본인임을 확인하는 과정을 거친 이후 결제되는 방식을 총칭합니다. 쇼핑몰 등에서 이용되는 일회성 결제로 가장 일반적인 결제 방식입니다.
|
|
28258
|
+
|
|
28259
|
+
### 키인결제
|
|
28260
|
+
|
|
28261
|
+
카드 번호 등 결제 정보를 구매자로부터 직접 입력받아 API 호출을 통해 결제를 일으키는 비인증결제 방식입니다.
|
|
28262
|
+
|
|
28263
|
+
### 빌링결제
|
|
28264
|
+
|
|
28265
|
+
구매자에게 최초 1회 결제 정보를 입력받아 빌링키를 발급함으로써, 이후에 고객사에서 임의 시점에 결제를 반복하여 일으키는 결제 방식입니다. 결제를 일으킬 때에는 별도로 사용자 인증이 필요 없으므로 비인증결제에 속합니다. 정기결제 등을 구현하기 위해 사용합니다.
|
|
28266
|
+
|
|
28267
|
+
<div class="hint" data-style="warning">
|
|
28268
|
+
|
|
28269
|
+
**빌링키 사용 제한**
|
|
28270
|
+
|
|
28271
|
+
빌링키는 해당 빌링키를 발급한 PG에서만 사용 가능합니다. 또, 빌링키를 다른 포트원 상점 또는 다른 PG MID로 이관하려면 별도 요청이 필요합니다.
|
|
28272
|
+
|
|
28273
|
+
</div>
|
|
28274
|
+
|
|
28275
|
+
## 거래 식별 관련 용어
|
|
28276
|
+
|
|
28277
|
+
### 결제 ID (paymentId, 고객사 주문번호)
|
|
28278
|
+
|
|
28279
|
+
결제를 요청할 때 고객사가 채번한 고유 번호입니다. V1에서는 `merchant_uid`라는 이름을 사용합니다.
|
|
28280
|
+
|
|
28281
|
+
### PG 거래번호 (TID)
|
|
28282
|
+
|
|
28283
|
+
PG사가 채번한 거래 번호입니다. PG사에 따라 취소 건에도 별도의 거래 번호를 부여할 수 있습니다.
|
|
28284
|
+
|
|
28285
|
+
### 카드 승인번호
|
|
28286
|
+
|
|
28287
|
+
승인 성공 시 카드사가 부여한 8자리 숫자로, 매입을 진행하거나 취소를 할 때 필요합니다. 당일에 한 카드사에 유니크하나 몇몇 카드사는 당일에 중복되는 경우도 있습니다.
|
|
28288
|
+
|
|
28289
|
+
## 카드 결제
|
|
28290
|
+
|
|
28291
|
+
신용/체크/선불카드를 통한 결제는 인증, 승인, 매입의 과정을 거칩니다.
|
|
28292
|
+
|
|
28293
|
+
### 인증 (Authentication)
|
|
28294
|
+
|
|
28295
|
+
인증결제에서, 카드 소유주가 본인임을 확인하는 과정입니다. 웹에서 비밀번호를 입력하거나 앱에서 지문 인식을 하는 등 카드사마다 방식이 다릅니다.
|
|
28296
|
+
|
|
28297
|
+
### 승인 (Authorization)
|
|
28298
|
+
|
|
28299
|
+
승인 거래가 생성되고, 카드 한도를 차감합니다. 실제로 대금이 이동하지는 않습니다.
|
|
28300
|
+
|
|
28301
|
+
포트원에서는 인증이 완료되면 자동으로 승인을 진행합니다. 또는, V2에서 수동 승인 기능을 이용하면 인증 후 승인 요청을 별도로 할 수 있습니다.
|
|
28302
|
+
|
|
28303
|
+
### 매입 (Capture)
|
|
28304
|
+
|
|
28305
|
+
매입은 승인된 카드 거래의 대금을 청구하는 일을 말합니다. 일반적으로 PG가 매일 정해진 시간에 승인 건들을 모아 자동으로 매입합니다.
|
|
28306
|
+
|
|
28307
|
+
결제 승인 시점과 상품 공급 시점이 크게 다른 상점에서는 자동 매입을 끄고 PG에 건별로 매입을 요청하는 수동 매입을 이용할 수 있습니다. 매입이 오랫동안 일어나지 않으면 자동으로 승인이 취소됩니다. 포트원에서는 아직 수동 매입을 지원하지 않습니다.
|
|
28308
|
+
|
|
28309
|
+
카드 결제를 취소할 경우 원리상 매입 전 취소와 매입 후 취소가 구분되고, 매입 후 취소는 보통 3\~4 영업일이 소요됩니다.
|
|
28310
|
+
|
|
28311
|
+
## 카드 관련 용어
|
|
28312
|
+
|
|
28313
|
+
### 카드사 유형
|
|
28314
|
+
|
|
28315
|
+
신용, 체크카드와 관련된 개념으로 발급사, 매입사, 네트워크(브랜드)가 있습니다.
|
|
28316
|
+
|
|
28317
|
+
- **발급사**: 카드를 발급한 회사
|
|
28318
|
+
- **매입사**: 상점과 계약하여 카드 거래 매입을 담당하는 회사
|
|
28319
|
+
- **네트워크**: 매입사와 발급사 사이를 중개하는 인프라 (비자, 마스터카드, JCB, 아메리칸 익스프레스, 다이너스 클럽, 디스커버, 유니온페이 등)
|
|
28320
|
+
|
|
28321
|
+
국내는 카드에 따라 매입사가 하나로 정해져 있기 때문에 PG가 각 매입사와 계약을 맺습니다.
|
|
28322
|
+
|
|
28323
|
+
<div class="hint" data-style="info">
|
|
28324
|
+
|
|
28325
|
+
**예시: 카카오뱅크 카드**
|
|
28326
|
+
|
|
28327
|
+
- 발급사: 카카오뱅크
|
|
28328
|
+
- 매입사: 국민카드
|
|
28329
|
+
- 네트워크: 없음 (해외 사용 시 비자, 마스터카드 등 선택)
|
|
28330
|
+
|
|
28331
|
+
</div>
|
|
28332
|
+
|
|
28333
|
+
### PLCC (Private Label Credit Card)
|
|
28334
|
+
|
|
28335
|
+
상업자표시 신용카드로, 카드명에 특정 브랜드를 표기한 것을 말합니다. 제휴 업체와 함께 카드 상품을 공동으로 기획하여 비용과 수익을 분담하며, 제휴사의 충성도 높은 고객을 확보할 수 있는 장점이 있습니다.
|
|
28336
|
+
|
|
28337
|
+
**PLCC 예시:**
|
|
28338
|
+
|
|
28339
|
+
- 스타벅스 현대카드
|
|
28340
|
+
- 배민 현대카드
|
|
28341
|
+
- 11번가 신한카드
|
|
28342
|
+
|
|
28343
|
+
### 제휴카드
|
|
28344
|
+
|
|
28345
|
+
카드사가 특정 기업 혹은 단체와 협약을 맺어 발급하는 카드입니다. 카드사는 제휴사 카드 상품을 출시하고 마케팅 비용이나 카드 수익 등을 모두 관리하며, 반면 제휴사는 카드 모집만 담당합니다.
|
|
28346
|
+
|
|
28347
|
+
## 기타 결제 관련 용어
|
|
28348
|
+
|
|
28349
|
+
### 가상계좌
|
|
28350
|
+
|
|
28351
|
+
은행이 고객사에 발급한 입금 전용 계좌로, 고객사는 납부자와 가상계좌 번호를 일대일로 매핑하여 발급합니다. 보통 가상계좌는 입금 시 바로 삭제되며 해당 계좌번호는 재활용되어 다른 납부자에게 발급될 수 있습니다.
|
|
28352
|
+
|
|
28353
|
+
### 고정식 가상계좌
|
|
28354
|
+
|
|
28355
|
+
전기요금 고지서처럼 납부자가 하나의 입금 계좌번호를 부여받아 지속적으로 입금하고자 할 때 이용하는 가상계좌입니다.
|
|
28356
|
+
|
|
28357
|
+
### 에스크로
|
|
28358
|
+
|
|
28359
|
+
구매자의 구매 확인 의사인 구매결정을 통보받은 후 판매자에게 결제 대금을 지급하는 안전한 결제 서비스입니다. 2006년 4월 1일부터 에스크로 의무화 시행에 따라 가상계좌, 계좌이체와 같은 모든 현금 거래에는 의무적으로 적용해야 합니다.
|
|
28360
|
+
|
|
28361
|
+
## 취소
|
|
28362
|
+
|
|
28363
|
+
결제 완료 이후에 API나 콘솔을 통해 결제를 취소할 수 있습니다. 결제 금액의 일부만 취소하는 것도 가능합니다.
|
|
28364
|
+
|
|
28365
|
+
가상계좌 환불이나 휴대폰 익월 환불의 경우 환불받을 계좌를 입력해야 합니다.
|
|
28366
|
+
|
|
28367
|
+
환불 가능 기한이 지난 등의 이유로 PG를 통한 취소가 불가능한 경우에는 고객사에서 직접 구매자에게 자체 환불 처리해야 합니다.
|
|
28368
|
+
|
|
28369
|
+
### 카드
|
|
28370
|
+
|
|
28371
|
+
매입 전 취소의 경우 즉시 환불됩니다. 매입 후 취소는 일반적으로 3\~4 영업일이 소요됩니다.
|
|
28372
|
+
|
|
28373
|
+
### 계좌이체
|
|
28374
|
+
|
|
28375
|
+
즉시 환불됩니다.
|
|
28376
|
+
|
|
28377
|
+
### 가상계좌
|
|
28378
|
+
|
|
28379
|
+
환불받을 계좌를 입력해야 환불이 가능합니다. 일반적으로 2 영업일이 소요됩니다.
|
|
28380
|
+
|
|
28381
|
+
### 휴대폰
|
|
28382
|
+
|
|
28383
|
+
결제가 일어난 해당 월에만 취소가 가능합니다. 실제 지불 전이므로 즉시 취소됩니다. 일부 PG에서는 익월 환불이라 하여 해당 월이 지난 뒤에도 계좌로 환불하는 기능을 제공합니다.
|
|
28384
|
+
|
|
28385
|
+
## 세금 관련 용어
|
|
28386
|
+
|
|
28387
|
+
### 부가가치세
|
|
28388
|
+
|
|
28389
|
+
일반적으로 매출 발생시 10%의 부가가치세를 국가에 납부해야 합니다. 또한, PG 서비스 수수료에도 10%의 부가가치세가 발생합니다. 수수료에 대한 부가가치세는 매입 세액에 속합니다.
|
|
28390
|
+
|
|
28391
|
+
<div class="hint" data-style="info">
|
|
28392
|
+
|
|
28393
|
+
**정산 수수료 계산 예시**
|
|
28394
|
+
|
|
28395
|
+
1,000원의 결제에 대해 3%의 수수료를 적용한다면:
|
|
28396
|
+
|
|
28397
|
+
- 수수료: 30원
|
|
28398
|
+
- 수수료 부가세: 3원 (수수료의 10%)
|
|
28399
|
+
- 정산 금액: 967원
|
|
28400
|
+
|
|
28401
|
+
</div>
|
|
28402
|
+
|
|
28403
|
+
### 면세
|
|
28404
|
+
|
|
28405
|
+
세금을 부과하지 않는 소득을 의미합니다. 저소득층의 세금 부담 경감 또는 기타 정책적 목적으로 일부 재화나 용역의 공급에 대해 부가가치세를 면제하는 것을 말합니다. 대표적으로 기초생활필수품, 문화 관련 재화, 용역 등이 있습니다.
|
|
28406
|
+
|
|
28407
|
+
### 영세율
|
|
28408
|
+
|
|
28409
|
+
일정한 재화 또는 용역의 공급에 대해 0의 세율을 적용하는 제도로, 수출업자, 기타 외화 획득 사업자 등이 영세사업자로 적용됩니다.
|
|
28410
|
+
|
|
28411
|
+
## 할인 관련 용어
|
|
28412
|
+
|
|
28413
|
+
### 즉시할인
|
|
28414
|
+
|
|
28415
|
+
상품의 가격에 즉시 할인 금액을 적용하여 할인된 금액을 결제하는 방식입니다.
|
|
28416
|
+
|
|
28417
|
+
### 청구할인
|
|
28418
|
+
|
|
28419
|
+
본래의 상품 가격을 결제했다가 조건 충족 시 결제 대금의 할인된 금액이 반영되는 방식입니다. 청구할인은 할인 여부를 챙겨봐야 하기 때문에 즉시할인이 납부자에게 더 선호됩니다.
|
|
27752
28420
|
|
|
27753
28421
|
|
|
27754
28422
|
# https://developers.portone.io/opi/ko/support/tls-support
|
|
@@ -28316,24 +28984,144 @@ SDK를 지원하지 않는 플랫폼을 포함하여 다양한 플랫폼에서
|
|
|
28316
28984
|
|
|
28317
28985
|
---
|
|
28318
28986
|
title: 용어 사전
|
|
28319
|
-
description:
|
|
28987
|
+
description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용어를 설명합니다.
|
|
28320
28988
|
---
|
|
28321
28989
|
|
|
28322
|
-
|
|
28323
|
-
|
|
28324
|
-
|
|
28325
|
-
|
|
28326
|
-
|
|
28327
|
-
|
|
28328
|
-
|
|
28329
|
-
|
|
28330
|
-
|
|
28331
|
-
|
|
28332
|
-
|
|
28333
|
-
|
|
28334
|
-
|
|
28335
|
-
|
|
28336
|
-
|
|
28990
|
+
|
|
28991
|
+
|
|
28992
|
+
## **서비스 용어**
|
|
28993
|
+
|
|
28994
|
+
### 정산금 계산 자동화
|
|
28995
|
+
|
|
28996
|
+
파트너에게 정산할 금액을 자동 계산하고 관리하는 대표 서비스입니다.
|
|
28997
|
+
파트너를 등록하여 파트너 정보를 관리하고, 플랫폼 정책에 맞는 각종 계약을 등록할 수 있으며, 선택한 파트너와 계약을 기반으로 자동 정산금 계산을 지원합니다.
|
|
28998
|
+
|
|
28999
|
+
### 지급대행 서비스
|
|
29000
|
+
|
|
29001
|
+
전자금융거래법을 준수하기 위해 PG 정산금의 수취 및 이체를 대행하는 서비스로
|
|
29002
|
+
안전하고 편리한 지급대행 서비스를 지원합니다. 포트원 지급대행은 일반 PG사와 다르게 즉시(바로)지급과 자유로운 예약지급 설정으로 보다 유연한 관리가 가능합니다.
|
|
29003
|
+
|
|
29004
|
+
### 전자세금계산서 서비스
|
|
29005
|
+
|
|
29006
|
+
역발행과 정발행을 지원하는 전자세금계산서 서비스입니다.
|
|
29007
|
+
세금계산서 발행 뿐만 아니라 히스토리 관리, 일괄(대량) 발행을 지원합니다.
|
|
29008
|
+
|
|
29009
|
+
<div class="hint" data-style="info">
|
|
29010
|
+
|
|
29011
|
+
파트너 정산 자동화 솔루션 안에서 3가지의 서비스를 제공하고 있습니다.
|
|
29012
|
+
|
|
29013
|
+
</div>
|
|
29014
|
+
|
|
29015
|
+
---
|
|
29016
|
+
|
|
29017
|
+
## **공통 용어**
|
|
29018
|
+
|
|
29019
|
+
### 고객사 / 파트너
|
|
29020
|
+
|
|
29021
|
+
고객사는 포트원의 결제서비스를 이용하고 있는 포트원의 고객을 의미합니다.
|
|
29022
|
+
|
|
29023
|
+
파트너는 고객사가 결제사정산 이후 하위정산을 받을 고객사의 파트너사 (하위셀러) 입니다.
|
|
29024
|
+
|
|
29025
|
+
### 사업자 휴폐업 조회
|
|
29026
|
+
|
|
29027
|
+
파트너의 사업자등록번호 유효성과 영업 상태를 확인하는 서비스입니다. 사업자 휴폐업 조회를 사전에 진행하여 비즈니스의 안전성과 신뢰성을 확보할 수 있습니다. 또한 미리 휴폐업을 조회하지 못해 생기는 리소스 낭비를 줄일 수 있습니다.
|
|
29028
|
+
|
|
29029
|
+
### 영업일
|
|
29030
|
+
|
|
29031
|
+
은행이 영업을 하는 날로, 휴일이 아닌 날입니다.
|
|
29032
|
+
|
|
29033
|
+
<div class="hint" data-style="success">
|
|
29034
|
+
|
|
29035
|
+
예를 들어, 10일(금), 11일(토), 12(일), 13(월)이라고 할 때, 11, 12, 13일의 전 영업일은 10일이고, 10, 11, 12일의 후 영업일은 13일입니다.
|
|
29036
|
+
|
|
29037
|
+
</div>
|
|
29038
|
+
|
|
29039
|
+
---
|
|
29040
|
+
|
|
29041
|
+
## **정산금 계산 자동화 용어**
|
|
29042
|
+
|
|
29043
|
+
### 계약
|
|
29044
|
+
|
|
29045
|
+
고객사와 파트너 사이에 정산이 이루어지기 위한 조건입니다. 계약은 파트너 정산 자동화의 정산 정책 관리 페이지에서 등록할 수 있습니다. 계약 등록을 통해 플랫폼 중개 수수료를 설정하거나 부가세 분담 주체, 정산 주기 등을 설정할 수 있으며, 각 플랫폼사의 정책에 맞게 커스터마이징이 가능합니다.
|
|
29046
|
+
|
|
29047
|
+
### 수수료
|
|
29048
|
+
|
|
29049
|
+
절차 및 중개 등을 지원할 때 수수하는 금전입니다.
|
|
29050
|
+
플랫폼사에서는 중개수수료와 추가수수료 등을 수취합니다. **중개수수료**는 플랫폼이 거래 중개 서비스에 대해 부과하는 수수료이고, **추가수수료**는 PG사 수수료, 마케팅 채널 수수료 등 특정 서비스에 대해 부과하는 수수료입니다.
|
|
29051
|
+
|
|
29052
|
+
### 원천 징수세
|
|
29053
|
+
|
|
29054
|
+
소득자(개인 파트너)가 자신의 세금을 직접 납부하지 않고, 원천징수 대상소득을 지급하는 원천징수 의무자(플랫폼사)가 그 금액을 미리 떼어서 대신 납부하는 세금입니다. 원천 징수세는 계약 등록에서 미리 설정할 수 있습니다.
|
|
29055
|
+
|
|
29056
|
+
---
|
|
29057
|
+
|
|
29058
|
+
## **지급대행 서비스 용어**
|
|
29059
|
+
|
|
29060
|
+
### 결제사 정산
|
|
29061
|
+
|
|
29062
|
+
포트원의 결제 이후 결제대행사(PG) 또는 간편결제사로부터 고객사가 받는 정산입니다.
|
|
29063
|
+
|
|
29064
|
+
### 파트너 정산
|
|
29065
|
+
|
|
29066
|
+
결제사 정산 이후에 고객사가 파트너에게 내려주는 정산입니다.
|
|
29067
|
+
|
|
29068
|
+
### 일괄지급
|
|
29069
|
+
|
|
29070
|
+
여러 파트너에게 동시에 정산금을 지급하는 기능으로, 한 번의 실행으로 대량 송금이 가능합니다. 정산일을 설정하고 정산할 건을 선택하여 일괄지급할 수 있습니다.
|
|
29071
|
+
|
|
29072
|
+
### 즉시지급(바로지급)과 예약지급
|
|
29073
|
+
|
|
29074
|
+
**즉시지급**은 지급 요청 즉시 실시간으로 송금이 실행되는 지급 방식입니다.
|
|
29075
|
+
**예약지급**은 미래의 특정 시점에 지급이 실행되도록 예약하는 지급 방식입니다. 예약지급은 주말과 공휴일도 포함시켜 달력일로 예약할 수 있습니다.
|
|
29076
|
+
|
|
29077
|
+
<div class="hint" data-style="warning">
|
|
29078
|
+
|
|
29079
|
+
단, 은행 점검 시간에는 지급 및 예약이 불가합니다.
|
|
29080
|
+
|
|
29081
|
+
</div>
|
|
29082
|
+
|
|
29083
|
+
---
|
|
29084
|
+
|
|
29085
|
+
## **세금계산서 서비스 용어**
|
|
29086
|
+
|
|
29087
|
+
### 세금계산서 역발행
|
|
29088
|
+
|
|
29089
|
+
세금계산서 발행 주체인 공급자(파트너)가 아니라, 공급받는자(플랫폼)가 공급자 대신 세금계산서를 작성하여 공급자에게 발행을 요청하는 기능입니다.
|
|
29090
|
+
|
|
29091
|
+
플랫폼사가 직접 파트너에게 지급할 정산대금 정보를 작성하고, 해당 내용을 바탕으로 공급자는 이메일을 통해 검토만 하고 승인할 수 있는 구조이기 때문에 파트너와의 소통을 줄일 수 있습니다.
|
|
29092
|
+
|
|
29093
|
+
### 발행 취소
|
|
29094
|
+
|
|
29095
|
+
세금계산서를 국세청으로 전송하기 전까지 발행을 취소할 수 있는 기능으로, '발행 요청' 상태의 세금계산서 우측에 있는 '발행 취소' 버튼을 눌러 취소할 수 있습니다.
|
|
29096
|
+
|
|
29097
|
+
<div class="hint" data-style="warning">
|
|
29098
|
+
|
|
29099
|
+
세금계산서 내역 관리의 **삭제** 버튼은 발행 취소와 다른 기능으로 세금계산서의 상태가 실패, 거절, 취소 등의 최종 상태일 경우에만 적용됩니다.
|
|
29100
|
+
|
|
29101
|
+
</div>
|
|
29102
|
+
|
|
29103
|
+
### 수정 발행
|
|
29104
|
+
|
|
29105
|
+
세금계산서가 국세청으로 전송되면 (전송 완료 상태) 수정 발행으로 취소 및 수정이 가능합니다. 단, 수정 발행 시 사유 확인이 필요합니다.
|
|
29106
|
+
|
|
29107
|
+
### 재전송
|
|
29108
|
+
|
|
29109
|
+
역발행 세금계산서의 승인을 요청하는 메일을 파트너에게 다시 전송하는 기능입니다.
|
|
29110
|
+
|
|
29111
|
+
### 지연 발행
|
|
29112
|
+
|
|
29113
|
+
세금계산서 지연 발행 상태는 재화 또는 용역을 공급한 날이 속한 달의 다음 달 10일까지 세금계산서를 발급하지 않고, 그 기간을 넘겨 발행하면 지연 발행에 해당합니다.
|
|
29114
|
+
|
|
29115
|
+
예를 들어, 9월 16일에 재화나 용역을 제공했다면, 다음 달인 10월 10일까지 세금계산서를 발행해야 합니다. 이 기한을 넘겨 발행하면 지연 발행에 해당합니다.
|
|
29116
|
+
|
|
29117
|
+
<div class="hint" data-style="info">
|
|
29118
|
+
|
|
29119
|
+
지연 발행 시에는 가산세가 부과됩니다.
|
|
29120
|
+
|
|
29121
|
+
- 공급자는 지연 발행 가산세로 공급가액의 1%를 부담하게 됩니다.
|
|
29122
|
+
- 공급받는자는 지연 수취 가산세로 공급가액의 0.5%가 부과됩니다.
|
|
29123
|
+
|
|
29124
|
+
</div>
|
|
28337
29125
|
|
|
28338
29126
|
|
|
28339
29127
|
# https://developers.portone.io/platform/ko/guides/process
|
|
@@ -28347,7 +29135,7 @@ description: ''
|
|
|
28347
29135
|
|
|
28348
29136
|
<div class="hint" data-style="etc">
|
|
28349
29137
|
|
|
28350
|
-
📘 **파트너정산은 간단한 API연동과 관리자 콘솔 등록을 통해 파트너정산을 자동화 하는
|
|
29138
|
+
📘 **파트너정산은 간단한 API연동과 관리자 콘솔 등록을 통해 파트너정산을 자동화 하는 서비스입니다.**
|
|
28351
29139
|
|
|
28352
29140
|
</div>
|
|
28353
29141
|
|
|
@@ -28518,7 +29306,7 @@ app.post("/webhook/taxinvoice", (req, res) => {
|
|
|
28518
29306
|
### 설정 요청 절차
|
|
28519
29307
|
|
|
28520
29308
|
1. 웹훅 수신 URL을 준비해주세요.
|
|
28521
|
-
2. 기술지원 이메일(<support
|
|
29309
|
+
2. 기술지원 이메일(<tech.support@portone.io>)로 웹훅 URL(운영 환경, 테스트 환경 별도 적용 가능)을 전달해주세요.
|
|
28522
29310
|
3. 테스트 모드 설정이 완료되었다는 회신을 받으면 테스트 모드에서 웹훅 정상 작동 여부를 확인해주세요
|
|
28523
29311
|
4. 운영 환경에도 적용을 요청하신 뒤 운영 환경에서 웹훅 정상 작동 여부를 확인해주세요.
|
|
28524
29312
|
|
|
@@ -30767,78 +31555,54 @@ targetVersions:
|
|
|
30767
31555
|
포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
|
|
30768
31556
|
AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
|
|
30769
31557
|
|
|
30770
|
-
|
|
31558
|
+
이외에도 포트원 콘솔에서 제공하는 기능 중 일부를 수행할 수 있습니다.
|
|
31559
|
+
아래 기능을 AI에게 요청하면 MCP 서버가 브라우저를 열어 포트원 콘솔 로그인을 요청하며, 로그인 후 기능이 수행됩니다.
|
|
30771
31560
|
|
|
30772
|
-
|
|
31561
|
+
- 채널 목록 조회
|
|
31562
|
+
- 테스트 채널 추가
|
|
31563
|
+
- 하위 상점 조회
|
|
31564
|
+
- 결제 내역 조회
|
|
30773
31565
|
|
|
30774
|
-
|
|
31566
|
+
### DXT를 이용한 설치
|
|
30775
31567
|
|
|
30776
|
-
|
|
30777
|
-
{
|
|
30778
|
-
// ...
|
|
30779
|
-
|
|
30780
|
-
"mcpServers": {
|
|
30781
|
-
// ...
|
|
30782
|
-
|
|
30783
|
-
"portone-mcp-server": {
|
|
30784
|
-
"command": "uvx",
|
|
30785
|
-
"args": ["portone-mcp-server@latest"]
|
|
30786
|
-
}
|
|
30787
|
-
}
|
|
30788
|
-
}
|
|
30789
|
-
```
|
|
31568
|
+
[DXT (Desktop Extensions)](https://github.com/anthropics/dxt)를 이용해 MCP 서버를 원클릭으로 설치할 수 있습니다.
|
|
30790
31569
|
|
|
30791
|
-
|
|
30792
|
-
|
|
30793
|
-
|
|
30794
|
-
|
|
30795
|
-
</div>
|
|
30796
|
-
|
|
30797
|
-
설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
|
|
31570
|
+
1. [GitHub Releases](https://github.com/portone-io/mcp-server/releases)에서 최신 `portone-mcp-server.dxt` 파일을 다운로드합니다.
|
|
31571
|
+
2. 지원하는 AI 도구(Claude Desktop 등)에서 다운로드한 `.dxt` 파일을 드래그 앤 드롭하거나 열기를 통해 설치합니다.
|
|
31572
|
+
3. 설치 후 도구를 재시작하여 MCP 서버가 정상적으로 등록되었는지 확인합니다.
|
|
30798
31573
|
|
|
30799
|
-
|
|
30800
|
-
|
|
30801
|
-
MCP 서버에 포트원 기능을 연동하면, AI가 아래와 같은 작업을 수행할 수 있습니다.
|
|
30802
|
-
|
|
30803
|
-
- 결제 내역 단건/다건 조회
|
|
30804
|
-
- 본인인증 내역 단건/다건 조회
|
|
30805
|
-
|
|
30806
|
-
연동을 활성화하려면, MCP 설정 파일의 env 블록에 포트원 관리자 콘솔에서 발급받은 API\_SECRET을 추가합니다.
|
|
31574
|
+
<div class="hint" data-style="warning">
|
|
30807
31575
|
|
|
30808
|
-
|
|
30809
|
-
{
|
|
30810
|
-
// ...
|
|
31576
|
+
**Claude Desktop에서 DXT 파일 사용 시 주의사항**
|
|
30811
31577
|
|
|
30812
|
-
|
|
30813
|
-
// ...
|
|
31578
|
+
현재 [알려진 이슈](https://github.com/anthropics/dxt/issues/45)로 인해 Claude Desktop에서 DXT 설치 후 MCP 서버가 정상적으로 작동하지 않을 수 있습니다.
|
|
30814
31579
|
|
|
30815
|
-
|
|
30816
|
-
"command": "uvx",
|
|
30817
|
-
"args": ["portone-mcp-server@latest"],
|
|
30818
|
-
// 아래 env 블록을 추가하여 API 시크릿을 설정합니다.
|
|
30819
|
-
"env": {
|
|
30820
|
-
"API_SECRET": "<YOUR_PORTONE_API_SECRET>"
|
|
30821
|
-
}
|
|
30822
|
-
}
|
|
30823
|
-
}
|
|
30824
|
-
}
|
|
30825
|
-
```
|
|
31580
|
+
이 경우 Node.js 22.6.0 이상을 설치하고 Claude Desktop 설정에서 **"MCP용 내장 Node.js 사용"** 옵션을 비활성화한 후 재시작하면 정상적으로 작동합니다.
|
|
30826
31581
|
|
|
30827
|
-
|
|
31582
|
+
</div>
|
|
30828
31583
|
|
|
30829
|
-
|
|
31584
|
+
### MCP 서버 등록하기
|
|
30830
31585
|
|
|
30831
|
-
|
|
31586
|
+
1. Node.js 22.6.0 이상이 설치되어 있어야 합니다.
|
|
30832
31587
|
|
|
30833
|
-
|
|
31588
|
+
2. 사용하는 AI 도구의 MCP 설정에서 아래 내용을 추가합니다. (Cursor, Windsurf, Claude Desktop, etc...)
|
|
30834
31589
|
|
|
30835
|
-
|
|
31590
|
+
```jsonc
|
|
31591
|
+
"mcpServers": {
|
|
30836
31592
|
|
|
30837
|
-
|
|
31593
|
+
// 기존 설정
|
|
30838
31594
|
|
|
30839
|
-
|
|
31595
|
+
"portone-mcp-server": {
|
|
31596
|
+
"command": "npx",
|
|
31597
|
+
"args": [
|
|
31598
|
+
"-y",
|
|
31599
|
+
"@portone/mcp-server@latest"
|
|
31600
|
+
]
|
|
31601
|
+
}
|
|
31602
|
+
}
|
|
31603
|
+
```
|
|
30840
31604
|
|
|
30841
|
-
|
|
31605
|
+
3. 도구를 재시작해 portone-mcp-server 및 해당 서버가 제공하는 도구들이 잘 등록되었는지 확인합니다.
|
|
30842
31606
|
|
|
30843
31607
|
<div class="hint" data-style="warning">
|
|
30844
31608
|
|
|
@@ -30849,7 +31613,7 @@ MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않
|
|
|
30849
31613
|
|
|
30850
31614
|
</div>
|
|
30851
31615
|
|
|
30852
|
-
###
|
|
31616
|
+
### MCP 서버 활용하기
|
|
30853
31617
|
|
|
30854
31618
|
사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
|
|
30855
31619
|
|
|
@@ -31094,13 +31858,13 @@ writtenAt: 2023-07-12T00:00:00.000Z
|
|
|
31094
31858
|
|
|
31095
31859
|
## 주요 업데이트 사항
|
|
31096
31860
|
|
|
31097
|
-
### **결제 모듈 V1**✔️
|
|
31861
|
+
### **결제 모듈 V1**✔️ 나이스정보통신의 새로운 결제창을 이용할 수 있습니다
|
|
31098
31862
|
|
|
31099
|
-
포트원을 통해
|
|
31863
|
+
포트원을 통해 나이스정보통신의 새로운 결제창(이하 ‘(신) 나이스정보통신’)을 이용할 수 있습니다. 이번
|
|
31100
31864
|
업데이트를 통해 기존 모듈보다 확장된 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트
|
|
31101
31865
|
호출을 지원합니다.
|
|
31102
31866
|
|
|
31103
|
-
(신)
|
|
31867
|
+
(신) 나이스정보통신에서 이용 가능한 간편결제는 다음과 같습니다.
|
|
31104
31868
|
|
|
31105
31869
|
- 카카오페이
|
|
31106
31870
|
- 네이버페이
|
|
@@ -31113,13 +31877,13 @@ writtenAt: 2023-07-12T00:00:00.000Z
|
|
|
31113
31877
|
|
|
31114
31878
|
이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 회수, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다.
|
|
31115
31879
|
|
|
31116
|
-
(신)
|
|
31880
|
+
(신) 나이스정보통신 이용시 고려해야 하는 조건들이 있으니 다음 문서를 참고하시기 바랍니다.
|
|
31117
31881
|
|
|
31118
|
-
[→ (신)
|
|
31882
|
+
[→ (신)나이스정보통신 일반결제 연동 유의사항](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/payment-caution)
|
|
31119
31883
|
|
|
31120
|
-
[→ (신)
|
|
31884
|
+
[→ (신)나이스정보통신 비인증결제 연동 유의사항(빌링키 발급 및 API 연동)](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution)
|
|
31121
31885
|
|
|
31122
|
-
기존에
|
|
31886
|
+
기존에 나이스정보통신를 이용 중이라면 간편결제사와 별도의 계약없이 간단한 신청만으로 간편결제를
|
|
31123
31887
|
이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이
|
|
31124
31888
|
안내드리겠습니다.
|
|
31125
31889
|
|
|
@@ -31174,7 +31938,7 @@ KCP 인증결제창에서 할인쿠폰 적용 여부를 컨트롤 할수 있는
|
|
|
31174
31938
|
할인쿠폰기능을 사용하기 위해서는 KCP와 협의가 먼저 선행되어야 하는점 유의하세요
|
|
31175
31939
|
|
|
31176
31940
|
본 기능 설정을 위한 자세한 내용은 SDK 가이드 문서를 확인 해주세요
|
|
31177
|
-
[→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/
|
|
31941
|
+
[→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)
|
|
31178
31942
|
|
|
31179
31943
|
|
|
31180
31944
|
# https://developers.portone.io/release-notes/api-sdk/2023-08-31
|
|
@@ -31197,7 +31961,7 @@ NHN KCP결제창을 통한 빌링키 발급시 파라미터를 통해 빌링키
|
|
|
31197
31961
|
선택할수 있도록 하였습니다.
|
|
31198
31962
|
|
|
31199
31963
|
본 기능 설정을 위한 자세한 내용은 SDK 가이드 문서를 확인 해주세요
|
|
31200
|
-
[→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/
|
|
31964
|
+
[→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)
|
|
31201
31965
|
|
|
31202
31966
|
### **결제 모듈 V1**✔️ 결제 URL 생성 API 지원 PG사 확대
|
|
31203
31967
|
|
|
@@ -31207,7 +31971,7 @@ NHN KCP결제창을 통한 빌링키 발급시 파라미터를 통해 빌링키
|
|
|
31207
31971
|
- (신)스마트로
|
|
31208
31972
|
- KSNET
|
|
31209
31973
|
- (신)페이팔 일반결제/정기결제
|
|
31210
|
-
- (신)
|
|
31974
|
+
- (신)나이스정보통신
|
|
31211
31975
|
|
|
31212
31976
|
|
|
31213
31977
|
# https://developers.portone.io/release-notes/api-sdk/2023-12-15
|
|
@@ -31235,11 +31999,11 @@ writtenAt: 2024-01-08T00:00:00.000Z
|
|
|
31235
31999
|
|
|
31236
32000
|
## 주요 업데이트 사항
|
|
31237
32001
|
|
|
31238
|
-
### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서
|
|
32002
|
+
### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 나이스정보통신 결제를 지원합니다.
|
|
31239
32003
|
|
|
31240
|
-
이제 포트원 V2를 통해
|
|
32004
|
+
이제 포트원 V2를 통해 나이스정보통신 일반결제/정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다.
|
|
31241
32005
|
|
|
31242
|
-
|
|
32006
|
+
나이스정보통신에서 지원하는 결제수단 아래와 같습니다.
|
|
31243
32007
|
|
|
31244
32008
|
- 카드
|
|
31245
32009
|
|
|
@@ -31263,7 +32027,7 @@ writtenAt: 2024-01-08T00:00:00.000Z
|
|
|
31263
32027
|
|
|
31264
32028
|
이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 말소, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다.
|
|
31265
32029
|
|
|
31266
|
-
|
|
32030
|
+
나이스정보통신 연동에 대해 자세히 알고 싶다면 [→ 나이스정보통신 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/nice-v2?v=v2) 에서 확인하실 수 있습니다.
|
|
31267
32031
|
|
|
31268
32032
|
|
|
31269
32033
|
# https://developers.portone.io/release-notes/api-sdk/2024-01-11
|
|
@@ -31643,7 +32407,7 @@ writtenAt: 2024-06-03T00:00:00.000Z
|
|
|
31643
32407
|
|
|
31644
32408
|
**지원 결제대행사**
|
|
31645
32409
|
|
|
31646
|
-
-
|
|
32410
|
+
- 나이스정보통신
|
|
31647
32411
|
- KG이니시스
|
|
31648
32412
|
- 토스페이먼츠
|
|
31649
32413
|
- 스마트로
|
|
@@ -31851,7 +32615,6 @@ writtenAt: 2024-09-05T00:00:00.000Z
|
|
|
31851
32615
|
- 토스
|
|
31852
32616
|
- 카카오
|
|
31853
32617
|
- 네이버
|
|
31854
|
-
- 페이코
|
|
31855
32618
|
- 금융결제원
|
|
31856
32619
|
- KB국민은행
|
|
31857
32620
|
- 신한은행
|
|
@@ -31888,7 +32651,7 @@ PG 거래대사 내의 **거래 정산 내역** 메뉴에서 정산일 또는
|
|
|
31888
32651
|
|
|
31889
32652
|
### **PG 거래대사**✔️ KSNET, KPN, 하이픈에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다.
|
|
31890
32653
|
|
|
31891
|
-
기존에 12개 PG사 (KCP, KG이니시스,
|
|
32654
|
+
기존에 12개 PG사 (KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠,
|
|
31892
32655
|
토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN, 하이픈까지 확장하여
|
|
31893
32656
|
총 15개 PG사 데이터에 한하여 제공됩니다.
|
|
31894
32657
|
|
|
@@ -32342,6 +33105,57 @@ writtenAt: 2024-09-05T00:00:00.000Z
|
|
|
32342
33105
|
- 좌측 메뉴 영역 상단의 \[계정 정보]를 클릭한 후 \[로그아웃]을 클릭해 주세요.
|
|
32343
33106
|
|
|
32344
33107
|
|
|
33108
|
+
# https://developers.portone.io/release-notes/console/2025-10-17
|
|
33109
|
+
|
|
33110
|
+
---
|
|
33111
|
+
releasedAt: 2025-10-17T00:00:00.000Z
|
|
33112
|
+
writtenAt: 2025-10-17T00:00:00.000Z
|
|
33113
|
+
---
|
|
33114
|
+
|
|
33115
|
+
## 콘솔 일부 설정 업데이트 안내
|
|
33116
|
+
|
|
33117
|
+
안녕하세요, 포트원 입니다.
|
|
33118
|
+
|
|
33119
|
+
더욱 쾌적하고 편리한 서비스 이용을 위해, 콘솔 내의 일부 디자인 시스템이 변경되어 안내해 드립니다.
|
|
33120
|
+
|
|
33121
|
+
---
|
|
33122
|
+
|
|
33123
|
+
## 관리자 콘솔
|
|
33124
|
+
|
|
33125
|
+
### 표설정 기능 업데이트
|
|
33126
|
+
|
|
33127
|
+
기존에는 콘솔에서 확인할 수 있는 다양한 표 내부 컬럼의 순서를 변경할 수 없었습니다. 하지만 이번 업데이트를 통해 표설정 기능을 추가하여 드래그 방식으로 손쉽게 내부 컬럼의 순서를 변경하고, 유지할 수 있습니다. 표설정 기능을 활용하여 더 중요한 정보들을 앞으로 가져오는 등의 편리한 커스터마이징이 가능합니다.
|
|
33128
|
+
|
|
33129
|
+
파트너 정산 서비스 뿐만 아니라 포트원 전자결제를 함께 이용중이라면, 전자결제 서비스의 표 설정 또한 브라우저에 저장될 수 있습니다.
|
|
33130
|
+
|
|
33131
|
+
(이미지 첨부: 표 순서 변경 기능)
|
|
33132
|
+
|
|
33133
|
+
## 파트너 정산
|
|
33134
|
+
|
|
33135
|
+
### 보관함 설정 업데이트
|
|
33136
|
+
|
|
33137
|
+
기존 정산 정책 관리 및 파트너 관리 페이지에서 보관함 보기 토글을 이용하여 보관함을 조회한 후, 페이지를 새로고침하면 보관함이 아닌 일반 정책 목록이 조회되는 현상이 발생했습니다. 업데이트 후에는 보관함 보기 상태로 새로고침을 해도 해당 상태가 풀리지 않고 유지되어 사용 편의성이 높아집니다.
|
|
33138
|
+
|
|
33139
|
+
### 파트너 관리 UI 업데이트
|
|
33140
|
+
|
|
33141
|
+
기존 파트너 관리 페이지의 계약 일괄 변경 페이지에서는 변경할 신규 계약과 정산 시작일 기준 적용 시점만을 선택해야 했고, 계약 아이디로만 계약을 관리했기 때문에 실제 계약 정보 확인 없이 작업을 진행해야 하는 불편함이 있었습니다.
|
|
33142
|
+
|
|
33143
|
+
이제부터는 계약 이름으로 변경할 계약 정보를 직접 검색 및 조회할 수 있게 됩니다. 계약을 선택하면 중개 수수료율, 정산 보류일, 정산 주기와 같은 주요 정산 정보를 즉시 확인할 수 있어 더 정확한 계약 변경이 가능해집니다. 아울러, 정산 시작일 기준 적용 시점을 선택할 때 사용되는 달력 UI도 직관적으로 변경되어 적용 시점 설정이 더욱 쉬워졌습니다.
|
|
33144
|
+
|
|
33145
|
+
(이미지 첨부: 파트너 관리 UI 업데이트)
|
|
33146
|
+
|
|
33147
|
+
### 콘솔 표 설정 업데이트
|
|
33148
|
+
|
|
33149
|
+
정산 상세 조회, 정산 내역 관리, 일괄 지급 내역 관리, 지급 내역 관리, 이체 내역 관리, 일괄 이체 내역 관리, 세금계산서 작성 목록, 세금계산서 내역 관리, 일괄 세금계산서 내역 관리 페이지의 표 설정이 일괄 변경됩니다. 이제 해당 페이지들에서 표(테이블)의 필터 값을 설정한 후 페이지를 새로고침하더라도, 설정했던 필터 값이 초기화되지 않고 그대로 유지됩니다. 따라서 반복적으로 필터를 재설정할 필요 없이 더 빠르고 효율적으로 데이터를 조회할 수 있습니다.
|
|
33150
|
+
|
|
33151
|
+
---
|
|
33152
|
+
|
|
33153
|
+
작성일자: **2025년 10월 17일**
|
|
33154
|
+
|
|
33155
|
+
- 일반 문의: <cs@portone.io> / 채널톡
|
|
33156
|
+
- 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널
|
|
33157
|
+
|
|
33158
|
+
|
|
32345
33159
|
# https://developers.portone.io/release-notes/platform/2023-08-31
|
|
32346
33160
|
|
|
32347
33161
|
---
|
|
@@ -33550,7 +34364,7 @@ writtenAt: 2025-03-17T00:00:00.000Z
|
|
|
33550
34364
|
- 기존 파트너정산자동화 제품을 이용하고 계신 고객이더라도, 세금계산서 역발행 기능 사용을 위해서는 별도 문의가 필요합니다.
|
|
33551
34365
|
|
|
33552
34366
|
- 세금계산서 상태변화 웹훅 및 사업자번호 기업정보조회 API 연동이 필요하신 고객사는
|
|
33553
|
-
[📩 support
|
|
34367
|
+
[📩 tech.support@portone.io](mailto:tech.support@portone.io)로 문의해 주세요.
|
|
33554
34368
|
|
|
33555
34369
|
포트원의 전체 업데이트 소식은 [개발자센터 릴리즈노트](https://developers.portone.io/release-notes) 페이지에서 확인할 수 있습니다.
|
|
33556
34370
|
|
|
@@ -33991,7 +34805,465 @@ writtenAt: 2025-07-07T00:00:00.000Z
|
|
|
33991
34805
|
|
|
33992
34806
|
일반 문의 <cs@portone.io> / 채널톡
|
|
33993
34807
|
|
|
33994
|
-
기술지원 문의 <support@portone.io> / 파트너스 슬랙 채널
|
|
34808
|
+
기술지원 문의 <tech.support@portone.io> / 파트너스 슬랙 채널
|
|
34809
|
+
|
|
34810
|
+
|
|
34811
|
+
# https://developers.portone.io/release-notes/platform/2025-07-23
|
|
34812
|
+
|
|
34813
|
+
---
|
|
34814
|
+
releasedAt: 2025-07-23T00:00:00.000Z
|
|
34815
|
+
writtenAt: 2025-07-23T00:00:00.000Z
|
|
34816
|
+
---
|
|
34817
|
+
|
|
34818
|
+
안녕하세요, 파트너 정산 자동화 팀입니다.
|
|
34819
|
+
|
|
34820
|
+
2025년 7월 23일 업데이트 사항을 확인해 보세요.
|
|
34821
|
+
|
|
34822
|
+
|**업데이트 항목** |**변경 전** |**변경 후** |
|
|
34823
|
+
|:---------------------------------------|:---------------------------------------------------------|:-------------------------------------------------------|
|
|
34824
|
+
|**세금계산서 API 출시** |세금계산서 기능을 콘솔에서만 이용 |**API 제공으로 시스템 연동 및 자동화 가능** |
|
|
34825
|
+
|**세금계산서 정발행 기능 (API) 추가** |역발행만 가능 |**정발행 및 역발행 모두 지원 (API)** |
|
|
34826
|
+
|**정산 정책 관리 사용성 개선** |정책 수정사항 확인 불가 |**정책 수정 히스토리 조회 가능** |
|
|
34827
|
+
|**정산 상세 조회 내 필터 개선** |수기 정산 건 조회 어려움<br />새로고침 시 필터 조건 초기화|**정산일 기준으로 조회<br />새로고침 시 필터 조건 유지**|
|
|
34828
|
+
|**파트너 정산 자동화 제품 UI 색상 변경**|오렌지 컬러 |**블루 컬러** |
|
|
34829
|
+
|
|
34830
|
+
## API 출시 안내
|
|
34831
|
+
|
|
34832
|
+
## 세금계산서 API 출시
|
|
34833
|
+
|
|
34834
|
+
이제 파트너정산 세금계산서 기능을 **콘솔이 아닌 API**로도 이용하실 수 있습니다.
|
|
34835
|
+
|
|
34836
|
+
API를 활용하면 각 기업의 자체 서비스, 백오피스, 외부 시스템과의 연동을 통해 세금계산서 발행, 조회, 관리 등 다양한 업무를 **완전 자동화**할 수 있어, 반복적인 수기 업무의 부담을 크게 줄이고 효율적인 업무 처리가 가능합니다.
|
|
34837
|
+
|
|
34838
|
+
## 세금계산서 정발행 기능 (API) 추가
|
|
34839
|
+
|
|
34840
|
+
기존에는 ‘역발행’만 지원하였으나, 이번 업데이트로 **‘정발행’** 기능이 API에도 포함되었습니다.
|
|
34841
|
+
|
|
34842
|
+
기업간 거래 상황에 따라 어떤 발행 방식이든, 이제는 포트원 하나로 발행 및 관리가 모두 가능해집니다.
|
|
34843
|
+
정발행 기능의 콘솔 지원도 2025년 3분기 내 업데이트 예정이니 많은 기대 부탁드립니다.
|
|
34844
|
+
|
|
34845
|
+
**기술 변경 사항 안내**
|
|
34846
|
+
신규 세금계산서 API 카테고리 및 상세 문서가 [**개발자센터**](https://developers.portone.io/api/rest-v2/b2b.taxInvoice?v=v2) 에 추가되었습니다.
|
|
34847
|
+
기존 콘솔 UI 기반의 역발행 외에, 정발행 기능이 API로 제공됩니다.
|
|
34848
|
+
연동 개발 시 개발자센터의 세금계산서 관련 문서를 참고해주시기 바랍니다.
|
|
34849
|
+
|
|
34850
|
+
---
|
|
34851
|
+
|
|
34852
|
+
## 파트너 정산 자동화 제품 개선 안내
|
|
34853
|
+
|
|
34854
|
+
### 정산 정책 관리 사용성 개선
|
|
34855
|
+
|
|
34856
|
+
정산 정책 관리 페이지의 사용성이 개선되었습니다.
|
|
34857
|
+
|
|
34858
|
+
- 페이지 사용성 개선
|
|
34859
|
+
|
|
34860
|
+
계약 등록 및 상세 조회, 할인 분담 정책 등록 및 상세 조회, 추가 수수료 정책 등록 및 상세 조회 등 정산 정책 관리 내의 다양한 페이지의 사용성이 개선되었습니다.
|
|
34861
|
+
|
|
34862
|
+
- 계약 내용 수정 이력 조회 기능 추가
|
|
34863
|
+
|
|
34864
|
+
계약 관리 페이지에서 계약 내용 수정 시, 수정 사항을 확인할 수 있는 히스토리 조회 기능이 추가되었습니다.\
|
|
34865
|
+
이제 계약 상세 페이지에서 변경 이력을 확인할 수 있어 더 효율적이고 투명한 계약 관리가 가능합니다.
|
|
34866
|
+
|
|
34867
|
+
(관련 이미지 첨부)
|
|
34868
|
+
|
|
34869
|
+
### 정산 상세 조회 내 필터 개선
|
|
34870
|
+
|
|
34871
|
+
정산 상세 조회 페이지에서 더욱 편리하게 정산 내역을 확인하실 수 있도록 필터 기능이 개선되었습니다.
|
|
34872
|
+
|
|
34873
|
+
- 기본 조회 기준 변경
|
|
34874
|
+
|
|
34875
|
+
정산 건 조회 시 기본 조회 기준이 기존 '정산 기준일'에서 '정산일'로 변경되었습니다.
|
|
34876
|
+
정산 시작일이 설정되지 않은 수기 정산 건도 쉽게 조회할 수 있습니다.
|
|
34877
|
+
|
|
34878
|
+
- 기본 조회 기간 확대
|
|
34879
|
+
기존 30일 → 90일로 확대되어 더 넓은 범위의 데이터를 한 번에 확인하실 수 있습니다.
|
|
34880
|
+
|
|
34881
|
+
- 필터 조건 유지 및 버그 수정
|
|
34882
|
+
|
|
34883
|
+
정산 건을 검색할 때 미리 지정한 필터값이 해제되던 버그가 수정되었으며,
|
|
34884
|
+
이제 페이지를 새로 고침 시에도 이전에 설정한 필터 조건이 그대로 유지됩니다.
|
|
34885
|
+
|
|
34886
|
+
(관련 이미지 첨부)
|
|
34887
|
+
|
|
34888
|
+
### 파트너 정산 자동화 제품 사용자 인터페이스 색상 변경
|
|
34889
|
+
|
|
34890
|
+
파트너 정산 자동화 제품의 전반적인 사용자 인터페이스 색상이 기존 오렌지에서 블루로 변경되었습니다.
|
|
34891
|
+
|
|
34892
|
+
---
|
|
34893
|
+
|
|
34894
|
+
작성일자: **2025년 07월 23일**
|
|
34895
|
+
|
|
34896
|
+
- 일반 문의: <cs@portone.io> / 채널톡
|
|
34897
|
+
- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
|
|
34898
|
+
|
|
34899
|
+
|
|
34900
|
+
# https://developers.portone.io/release-notes/platform/2025-08-13
|
|
34901
|
+
|
|
34902
|
+
---
|
|
34903
|
+
releasedAt: 2025-08-13T00:00:00.000Z
|
|
34904
|
+
writtenAt: 2025-08-13T00:00:00.000Z
|
|
34905
|
+
---
|
|
34906
|
+
|
|
34907
|
+
안녕하세요, 파트너 정산 자동화 팀입니다.
|
|
34908
|
+
|
|
34909
|
+
2025년 8월 13일 업데이트 사항을 확인해 보세요.
|
|
34910
|
+
|
|
34911
|
+
---
|
|
34912
|
+
|
|
34913
|
+
## 정산 내역서 발송 기능 업데이트
|
|
34914
|
+
|
|
34915
|
+
이제, 파트너 정산 콘솔에서 생성된 정산 내역을 기반으로, 파트너에게 정산 내역서를 보낼 수 있습니다.
|
|
34916
|
+
|
|
34917
|
+
일괄지급 내역 상세 및 지급 내역 관리 페이지에서 원하는 정산 내역을 단건, 혹은 다건으로 선택하여 한 번에 정산내역서 이메일을 발송할 수 있습니다.
|
|
34918
|
+
|
|
34919
|
+
**발신자/수신자 설정**: 발신자 이메일 설정은 필수이며, 도메인 인증을 통해 도메인을 활용한 발신이 가능합니다. 인증 완료된 도메인이 없는 경우, 기본 메일 <no-reply@portone.io>로 정산내역서를 발송할 수 있습니다.
|
|
34920
|
+
|
|
34921
|
+
수신자 이메일은 등록해 둔 파트너의 담당자 이메일로 지정되고, 담당자 이메일을 수정하는 것으로 수신자 이메일을 수정할 수 있습니다. 모든 설정을 완료하고, '정산내역서 발송' 버튼을 클릭하면 선택된 지급 내역의 파트너 전체에게 이메일이 차례대로 발송됩니다.
|
|
34922
|
+
|
|
34923
|
+
(관련 이미지 첨부)
|
|
34924
|
+
|
|
34925
|
+
---
|
|
34926
|
+
|
|
34927
|
+
## 정산 내역서 템플릿 생성 및 수정
|
|
34928
|
+
|
|
34929
|
+
정산 내역서 템플릿을 자유롭게 생성하고, 수정할 수 있습니다.
|
|
34930
|
+
|
|
34931
|
+
정산내역서 템플릿 관리 페이지에서 템플릿을 다양하게 만들어 관리할 수 있습니다. 지급 내역 생성 여부와 관계없이 템플릿을 생성할 수 있으며, 템플릿 목록 조회, 신규 생성 및 수정, 보관, 복원이 가능합니다. 템플릿 구성 항목의 포함 여부(on/off)를 관리할 수 있고, 구성 항목은 다음과 같습니다.
|
|
34932
|
+
|
|
34933
|
+
(관련 이미지 첨부)
|
|
34934
|
+
|
|
34935
|
+
**발신자 정보**
|
|
34936
|
+
|
|
34937
|
+
- 우리 회사 상호
|
|
34938
|
+
|
|
34939
|
+
**수신자(파트너) 정보**
|
|
34940
|
+
|
|
34941
|
+
- 파트너 이름 및 법인명
|
|
34942
|
+
- 파트너 유형
|
|
34943
|
+
- 과세, 소득 유형
|
|
34944
|
+
- 예금주명
|
|
34945
|
+
- 은행정보 (계좌번호 및 은행명)
|
|
34946
|
+
|
|
34947
|
+
**정산 기본 정보**
|
|
34948
|
+
|
|
34949
|
+
- 정산 기간
|
|
34950
|
+
|
|
34951
|
+
**정산 금액 정보**
|
|
34952
|
+
|
|
34953
|
+
- 지급 금액 (필수값)
|
|
34954
|
+
- 원천징수세액 (소득세, 지방 소득세)
|
|
34955
|
+
- 정산 금액
|
|
34956
|
+
- 확정 공급가액
|
|
34957
|
+
- 확정 부가세액
|
|
34958
|
+
- 정산 면세액
|
|
34959
|
+
- 확정 면세액
|
|
34960
|
+
|
|
34961
|
+
---
|
|
34962
|
+
|
|
34963
|
+
## 지급 내역에서 정산 내역서의 상태를 확인
|
|
34964
|
+
|
|
34965
|
+
지급 내역 페이지에서 정산 내역서 상태 컬럼이 추가되어 발송 상태를 확인할 수 있습니다.
|
|
34966
|
+
|
|
34967
|
+
지급 내역 페이지에 `정산내역서 상태`, `정산내역서 ID`, `정산내역서 발송 일시` 컬럼이 추가됩니다. 정산 내역서의 상태는 정산내역서가 아직 생성 및 발송되지 않은 상태인 **미발송**, 이메일이 수신자에게 성공적으로 전달된 **발송 완료**, 이메일 발송을 시도했으나, 주소 오류 등의 이유로 실패한 상태인 **발송 실패** 총 3개의 상태가 존재합니다.
|
|
34968
|
+
|
|
34969
|
+
(관련 이미지 첨부)
|
|
34970
|
+
|
|
34971
|
+
---
|
|
34972
|
+
|
|
34973
|
+
## API 변경 안내
|
|
34974
|
+
|
|
34975
|
+
지급내역 `PlatformPayout` 에 정산내역서 요약 정보가 추가되었고, 지급내역 다건 조회 시 정산내역서 정보를 기준으로 필터링할 수 있습니다.
|
|
34976
|
+
|
|
34977
|
+
**지급 내역** `PlatformPayout` **필드 추가**
|
|
34978
|
+
|
|
34979
|
+
신규 필드: `settlementStatement`: `PlatformPayoutSettlementStatementSummary`
|
|
34980
|
+
|
|
34981
|
+
- `id` – 정산내역서 아이디
|
|
34982
|
+
- `status` – 정산내역서 상태
|
|
34983
|
+
- `issuedAt` – 정산내역서 발송 일시
|
|
34984
|
+
|
|
34985
|
+
**지급 내역 필터** `PlatformPayoutFilterInput` **옵션 추가**
|
|
34986
|
+
|
|
34987
|
+
- `settlementStatementStatuses`: 정산내역서 상태
|
|
34988
|
+
- `criteria.settlementStatementIssuedTimestampRange`: 정산내역서 발송 일시 범위
|
|
34989
|
+
- `criteria.settlementStatementId`: 정산내역서 아이디
|
|
34990
|
+
|
|
34991
|
+
---
|
|
34992
|
+
|
|
34993
|
+
작성일자: **2025년 08월 13일**
|
|
34994
|
+
|
|
34995
|
+
- 일반 문의: <cs@portone.io> / 채널톡
|
|
34996
|
+
- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
|
|
34997
|
+
|
|
34998
|
+
|
|
34999
|
+
# https://developers.portone.io/release-notes/platform/2025-08-21
|
|
35000
|
+
|
|
35001
|
+
---
|
|
35002
|
+
releasedAt: 2025-08-21T00:00:00.000Z
|
|
35003
|
+
writtenAt: 2025-08-21T00:00:00.000Z
|
|
35004
|
+
---
|
|
35005
|
+
|
|
35006
|
+
안녕하세요, 파트너 정산 자동화 팀입니다.
|
|
35007
|
+
|
|
35008
|
+
2025년 8월 21일 업데이트 사항을 확인해 보세요.
|
|
35009
|
+
|
|
35010
|
+
---
|
|
35011
|
+
|
|
35012
|
+
## 세금계산서 정발행 기능 출시
|
|
35013
|
+
|
|
35014
|
+
고객에게 발행하는 정발행 세금계산서를 발행하고 관리할 수 있습니다.
|
|
35015
|
+
|
|
35016
|
+
이제, 역발행 뿐 아니라 정발행 기능을 콘솔에서 사용할 수 있습니다. 단건 발행 및 일괄 발행으로 정발행 세금계산서를 발행할 수 있게 되어 정산뿐만 아니라 모든 거래에 대한 세금계산서 커버가 가능해집니다.
|
|
35017
|
+
|
|
35018
|
+
기존 역발행과 다르게 정발행은 파트너 등록 및 <strong>국세청 연동 없이</strong> 이용할 수 있으며, 파트너 등록을 하지 않더라도 정발행시 입력한 공급받는 자(거래처) 정보를 다시 불러와 사용할 수 있습니다.
|
|
35019
|
+
|
|
35020
|
+
(관련 이미지 첨부)
|
|
35021
|
+
|
|
35022
|
+
---
|
|
35023
|
+
|
|
35024
|
+
## 엑셀, CSV 일괄 정/역발행
|
|
35025
|
+
|
|
35026
|
+
기존 일괄 세금계산서 발행은 CSV 파일만 지원되었지만, 이번 업데이트를 통해 엑셀 파일 업로드도 가능해집니다. 제공되는 엑셀 및 CSV 파일 양식을 다운로드 받아 일괄적으로 세금계산서를 작성하여 업로드할 수 있습니다. 기존 역발행과 동일하게 미리보기 후 임시 저장하거나 즉시 발행할 수 있습니다.
|
|
35027
|
+
|
|
35028
|
+
(관련 이미지 첨부)
|
|
35029
|
+
|
|
35030
|
+
---
|
|
35031
|
+
|
|
35032
|
+
## 세금계산서 내역 관리
|
|
35033
|
+
|
|
35034
|
+
기존 역발행 건과 정발행 건의 자연스러운 통합을 위해 세금계산서 내역 관리 페이지에 발행 유형 필터가 추가됩니다. 세금계산서 내역 테이블 내 사업자 정보 컬럼이 기존 공급자 정보에서 거래처(공급자/공급받는자) 정보로 변경되어 역발행의 경우 공급자, 정발행의 경우 공급받는자 정보가 표기됩니다.
|
|
35035
|
+
|
|
35036
|
+
일괄 세금계산서 내역 관리 페이지에서 발행 대기 상태와 발행 실패 상태가 추가됩니다. 발행 대기 상태는 일괄 세금계산서 발행 처리 중 상태를 의미하며 발행 실패 상태는 시스템 처리 실패를 의미합니다. 또한 정발행과 역발행을 구분하는 발행 유형 정보 및 필터가 추가됩니다.
|
|
35037
|
+
|
|
35038
|
+
(관련 이미지 첨부)
|
|
35039
|
+
|
|
35040
|
+
---
|
|
35041
|
+
|
|
35042
|
+
## 세금계산서 안내 메일 발송
|
|
35043
|
+
|
|
35044
|
+
공급받는 자에게 이메일이 발송됩니다.
|
|
35045
|
+
|
|
35046
|
+
세금계산서를 발행하는 시점에 공급받는자 (고객) 에게 팝빌 (포트원과 연동된 세금계산서 서비스) 로부터 이메일이 발송됩니다. 공급자는 발행 주체이므로, 별도의 알림 이메일은 발송되지 않습니다.
|
|
35047
|
+
|
|
35048
|
+
---
|
|
35049
|
+
|
|
35050
|
+
작성일자: **2025년 08월 21일**
|
|
35051
|
+
|
|
35052
|
+
- 일반 문의: <cs@portone.io> / 채널톡
|
|
35053
|
+
- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
|
|
35054
|
+
|
|
35055
|
+
|
|
35056
|
+
# https://developers.portone.io/release-notes/platform/2025-08-28
|
|
35057
|
+
|
|
35058
|
+
---
|
|
35059
|
+
releasedAt: 2025-08-28T00:00:00.000Z
|
|
35060
|
+
writtenAt: 2025-08-28T00:00:00.000Z
|
|
35061
|
+
---
|
|
35062
|
+
|
|
35063
|
+
안녕하세요, 파트너 정산 자동화 팀입니다.
|
|
35064
|
+
|
|
35065
|
+
2025년 8월 28일 업데이트 사항을 확인해 보세요.
|
|
35066
|
+
|
|
35067
|
+
---
|
|
35068
|
+
|
|
35069
|
+
## 2단계 인증수단
|
|
35070
|
+
|
|
35071
|
+
### 2단계 인증수단이란?
|
|
35072
|
+
|
|
35073
|
+
관리자 계정 접근 및 이체 실행 시, 공동 인증서 외에 다른 방식의 인증 절차를 요구하여 보안을 유지하는 방식입니다. 포트원은 2단계 인증 수단으로 Google Authenticator (Google OTP) 를 사용합니다. 파트너 정산을 이용하시는 고객님의 빠르고 편리한 이체를 돕기 위해 관리자 콘솔에서 2단계 인증 수단을 이용할 수 있습니다.
|
|
35074
|
+
|
|
35075
|
+
---
|
|
35076
|
+
|
|
35077
|
+
## 이체 시 2단계 인증수단 업데이트
|
|
35078
|
+
|
|
35079
|
+
### 공동인증서 없이 2단계 인증수단 (OTP) 을 이용하여 쉽게 이체하세요.
|
|
35080
|
+
|
|
35081
|
+
이제, 공동인증서 없이 콘솔에서 2단계 인증수단을 이용하여 손쉽게 이체를 진행할 수 있습니다. 설정의 내 정보 관리탭에서 2차인증을 눌러 Google Authenticator 를 등록하여 2단계 인증 수단으로 설정할 수 있습니다. 등록이 완료되면 송금대행 일괄이체 실행 페이지의 최종 단계에서 전자서명 대신 2단계 인증번호를 입력할 수 있는 다이얼로그가 노출됩니다.
|
|
35082
|
+
|
|
35083
|
+
(이미지 첨부: 2단계 인증번호 입력 화면)
|
|
35084
|
+
|
|
35085
|
+
---
|
|
35086
|
+
|
|
35087
|
+
## 보안 관련 사항
|
|
35088
|
+
|
|
35089
|
+
### 2단계 인증수단 신청 방식
|
|
35090
|
+
|
|
35091
|
+
공동인증서 대신 2단계 인증수단 등록을 위해서는 포트원 세일즈/CS 팀으로 요청하셔야하며, <bd@portone.io> 를 통해 요청하실 수 있습니다. 요청이 완료되었더라도, 2단계 인증 설정이 완료된 Admin 계정의 유저만 사용이 가능합니다.
|
|
35092
|
+
|
|
35093
|
+
또한, 강력한 보안 조치를 위해 포트원 관리자 콘솔 세션 접근 시 인증을 진행하였더라도, 이체 시에 2단계 인증 수단을 통한 재인증이 요구됩니다.
|
|
35094
|
+
|
|
35095
|
+
---
|
|
35096
|
+
|
|
35097
|
+
## 가상계좌 과출금 방지 기능 업데이트
|
|
35098
|
+
|
|
35099
|
+
### 권장 출금 금액보다 많은 금액을 인출할 때 과출금 방지 경고를 받습니다.
|
|
35100
|
+
|
|
35101
|
+
실시간으로 안전한 출금을 지원하고, 과출금 리스크를 방지하기 위해 과출금 방지 기능이 업데이트 되었습니다. 권장 출금 금액 (계좌 잔액 - 예상 지급 금액) 을 자동 계산하여, 권장 출금 금액보다 많은 금액을 출금하려고 할 때 과출금 방지 경고를 받을 수 있습니다. 예상 지급 금액은 정산내역과 지급내역을 통해 계산되며, 가상계좌 출금 페이지에서 예상 지급 금액 정보를 바로 확인할 수 있습니다.
|
|
35102
|
+
|
|
35103
|
+
(이미지 첨부: 과출금 방지 화면)
|
|
35104
|
+
|
|
35105
|
+
---
|
|
35106
|
+
|
|
35107
|
+
작성일자: **2025년 08월 28일**
|
|
35108
|
+
|
|
35109
|
+
- 일반 문의: <cs@portone.io> / 채널톡
|
|
35110
|
+
- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
|
|
35111
|
+
|
|
35112
|
+
|
|
35113
|
+
# https://developers.portone.io/release-notes/platform/2025-10-02
|
|
35114
|
+
|
|
35115
|
+
---
|
|
35116
|
+
releasedAt: 2025-10-02T00:00:00.000Z
|
|
35117
|
+
writtenAt: 2025-10-02T00:00:00.000Z
|
|
35118
|
+
---
|
|
35119
|
+
|
|
35120
|
+
안녕하세요, 파트너 정산 자동화 팀입니다.
|
|
35121
|
+
|
|
35122
|
+
파트너 정산 자동화 제품의 테스트 환경 확장에 따른 API 변경 사항을 안내드립니다.
|
|
35123
|
+
|
|
35124
|
+
---
|
|
35125
|
+
|
|
35126
|
+
## \[파트너 정산 자동화] 테스트 환경 분리 및 API 변경 사전 안내
|
|
35127
|
+
|
|
35128
|
+
이번 업데이트로 운영 환경과 테스트 환경이 완전히 분리되어, 설정·정산 정책·내역서 템플릿 등을 독립적으로 관리하실 수 있습니다.
|
|
35129
|
+
|
|
35130
|
+
## 주요 변경 사항
|
|
35131
|
+
|
|
35132
|
+
- 신규 쿼리 파라미터: test: Boolean (선택값)
|
|
35133
|
+
|
|
35134
|
+
- 적용 대상: 모든 파트너 정산 REST API
|
|
35135
|
+
|
|
35136
|
+
- 적용 예정 일자: 2025년 11월 중 (정확한 일자는 추후 별도 안내 예정)
|
|
35137
|
+
|
|
35138
|
+
- 기본값: false
|
|
35139
|
+
|
|
35140
|
+
- 연동 환경 별 설정
|
|
35141
|
+
- 라이브: 하위호환성이 보장되어 영향이 없습니다.
|
|
35142
|
+
- 테스트: test=true 쿼리 파라미터 추가 설정이 필요합니다.
|
|
35143
|
+
|
|
35144
|
+
(이미지 첨부: as is - to be)
|
|
35145
|
+
|
|
35146
|
+
이번 변경으로 라이브/테스트 환경이 완전히 분리되어 더욱 자유로운 테스트가 가능해집니다.\
|
|
35147
|
+
_기존 데이터는 테스트 및 라이브 환경에 복제되어 기존 그대로 활용하실 수 있습니다._
|
|
35148
|
+
|
|
35149
|
+
---
|
|
35150
|
+
|
|
35151
|
+
## 개선 사항
|
|
35152
|
+
|
|
35153
|
+
### 1. 정산 정책 및 수식 테스트 환경 분리
|
|
35154
|
+
|
|
35155
|
+
기존에는 정산 정책 및 정산 수식을 변경할 때 별도의 테스트 환경이 없어 운영에 영향을 줄 우려가 있었습니다.\
|
|
35156
|
+
이번 개선으로 라이브 환경과 완전히 분리된 테스트 환경을 제공하여, 정산 정책 및 수식을 실제 운영에 영향 없이 안전하게 테스트할 수 있습니다.
|
|
35157
|
+
|
|
35158
|
+
### 2. 파트너 데이터 환경 분리
|
|
35159
|
+
|
|
35160
|
+
테스트를 위해 등록한 파트너가 라이브 데이터에 그대로 남아 실제 파트너와 함께 조회되는 불편함이 있었습니다.\
|
|
35161
|
+
테스트용 파트너는 테스트 환경에 별도로 등록하여, 실제 파트너 데이터와 분리하여 관리할 수 있습니다.
|
|
35162
|
+
|
|
35163
|
+
### 3. 국세청 연동 환경 분리
|
|
35164
|
+
|
|
35165
|
+
국세청 연동 시 라이브와 테스트 환경에 동시에 연동되어 불필요한 연동 안내 메일을 중복으로 받는 문제가 있었습니다.\
|
|
35166
|
+
환경별로 독립적인 국세청 연동이 가능해져 필요한 환경에서만 선택적으로 연동할 수 있습니다.
|
|
35167
|
+
|
|
35168
|
+
---
|
|
35169
|
+
|
|
35170
|
+
## 세부 변경 사항
|
|
35171
|
+
|
|
35172
|
+
### 1. 기존 요청 본문에서 테스트 환경 구분이 가능한 API
|
|
35173
|
+
|
|
35174
|
+
요청 본문(body)의 `isForTest` 파라미터로 환경을 지정하던 방식은 deprecated 되었습니다.\
|
|
35175
|
+
쿼리 파라미터 `test`로 대체 해 주시기 바랍니다. deprecated 필드는 2026년 이후 별도 공지와 함께 지원이 중단될 예정입니다.
|
|
35176
|
+
|
|
35177
|
+
```http
|
|
35178
|
+
#Query Parameter가 우선 적용
|
|
35179
|
+
POST /platform/transfers/order?test=true
|
|
35180
|
+
{
|
|
35181
|
+
"isForTest": false, // 무시됨, Query Parameter의 true가 적용
|
|
35182
|
+
...
|
|
35183
|
+
}
|
|
35184
|
+
|
|
35185
|
+
#Query Parameter 가 없으면 Request Body 값 사용
|
|
35186
|
+
POST /platform/transfers/order
|
|
35187
|
+
{
|
|
35188
|
+
"isForTest": true, // 이 값이 적용
|
|
35189
|
+
...
|
|
35190
|
+
}
|
|
35191
|
+
```
|
|
35192
|
+
|
|
35193
|
+
우선순위는 아래와 같습니다.
|
|
35194
|
+
|
|
35195
|
+
1. Query Parameter 의미 `test` (최우선)
|
|
35196
|
+
2. Request Body 의 `isForTest` (Query Parameter 없을 때)
|
|
35197
|
+
3. 기본값 `false` (둘 다 없을 때)
|
|
35198
|
+
|
|
35199
|
+
영향 받는 API는 다음과 같습니다.
|
|
35200
|
+
|
|
35201
|
+
- 정산 상세 내역 다운로드 `GET /platform/transfer-summaries/sheet-file`
|
|
35202
|
+
- 정산건 다건 조회 `GET /platform/transfer-summaries`
|
|
35203
|
+
- 수기 정산건 생성 `POST /platform/transfers/manual`
|
|
35204
|
+
- 주문 정산건 생성 `POST /platform/transfers/order`
|
|
35205
|
+
- 주문 취소 정산건 생성 `POST /platform/transfers/order-cancel`
|
|
35206
|
+
- 정산 내역 다건 조회 `GET /platform/partner-settlements`
|
|
35207
|
+
- 지급 내역 다건 조회 `GET /platform/payouts`
|
|
35208
|
+
- 일괄 지급 내역 다건 조회 `GET /platform/bulk-payouts`
|
|
35209
|
+
- 이체 내역 다건 조회 `GET /platform/account-transfers`
|
|
35210
|
+
- 일괄 이체 내역 다건 조회 `GET /platform/bulk-account-transfers`
|
|
35211
|
+
|
|
35212
|
+
### 2. 테스트 환경 지정이 필요한 API
|
|
35213
|
+
|
|
35214
|
+
테스트 환경 지정을 위해 쿼리 파라미터 `test`가 추가되었습니다.\
|
|
35215
|
+
해당 파라미터는 선택 값이며 기본값은 `false`입니다.
|
|
35216
|
+
|
|
35217
|
+
```http
|
|
35218
|
+
#라이브 환경 데이터만 조회 (기본값)
|
|
35219
|
+
GET /platform/transfers/{id}
|
|
35220
|
+
|
|
35221
|
+
#테스트 환경 데이터만 조회
|
|
35222
|
+
GET /platform/transfers/{id}?test=true
|
|
35223
|
+
```
|
|
35224
|
+
|
|
35225
|
+
영향 받는 API는 다음과 같습니다.
|
|
35226
|
+
|
|
35227
|
+
- 정산건 조회 `GET /platform/transfers/{id}`
|
|
35228
|
+
- 정산건 삭제 `DELETE /platform/transfers/{id}`
|
|
35229
|
+
- 추가 수수료 정책 다건 조회 `GET /platform/additional-fee-policies`
|
|
35230
|
+
- 추가 수수료 정책 생성 `POST /platform/additional-fee-policies`
|
|
35231
|
+
- 추가 수수료 정책 조회 `GET /platform/additional-fee-policies/{id}`
|
|
35232
|
+
- 추가 수수료 정책 수정 `PATCH /platform/additional-fee-policies/{id}`
|
|
35233
|
+
- 추가 수수료 정책 보관 `POST /platform/additional-fee-policies/{id}/archive`
|
|
35234
|
+
- 추가 수수료 정책 복원 `POST /platform/additional-fee-policies/{id}/recover`
|
|
35235
|
+
- 계약 다건 조회 `GET /platform/contracts`
|
|
35236
|
+
- 계약 생성 `POST /platform/contracts`
|
|
35237
|
+
- 계약 조회 `GET /platform/contracts/{id}`
|
|
35238
|
+
- 계약 수정 `PATCH /platform/contracts/{id}`
|
|
35239
|
+
- 계약 보관 `POST /platform/contracts/{id}/archive`
|
|
35240
|
+
- 계약 복원 `POST /platform/contracts/{id}/recover`
|
|
35241
|
+
- 할인 분담 정책 다건 조회 `GET /platform/discount-share-policies`
|
|
35242
|
+
- 할인 분담 정책 생성 `POST /platform/discount-share-policies`
|
|
35243
|
+
- 할인 분담 정책 조회 `GET /platform/discount-share-policies/{id}`
|
|
35244
|
+
- 할인 분담 정책 수정 `PATCH /platform/discount-share-policies/{id}`
|
|
35245
|
+
- 할인 분담 정책 보관 `POST /platform/discount-share-policies/{id}/archive`
|
|
35246
|
+
- 할인 분담 정책 복원 `POST /platform/discount-share-policies/{id}/recover`
|
|
35247
|
+
- 파트너 다건 조회 `GET /platform/partners`
|
|
35248
|
+
- 파트너 생성 `POST /platform/partners`
|
|
35249
|
+
- 파트너 다건 생성 `POST /platform/partners/batch`
|
|
35250
|
+
- 파트너 일괄 국세청 연동 `POST /platform/partners/member-company-connect`
|
|
35251
|
+
- 파트너 국세청 연동 `POST /platform/partners/member-company-connect/{id}`
|
|
35252
|
+
- 파트너 일괄 국세청 연동 해제 `POST /platform/partners/member-company-disconnect`
|
|
35253
|
+
- 파트너 국세청 연동 해제 `POST /platform/partners/member-company-disconnect/{id}`
|
|
35254
|
+
- 파트너 조회 `GET /platform/partners/{id}`
|
|
35255
|
+
- 파트너 수정 `PATCH /platform/partners/{id}`
|
|
35256
|
+
- 파트너 보관 `POST /platform/partners/{id}/archive`
|
|
35257
|
+
- 파트너 복원 `POST /platform/partners/{id}/recover`
|
|
35258
|
+
- 예금주 조회 `GET /platform/bank-accounts/{bank}/{accountNumber}/holder`
|
|
35259
|
+
- 사업자 조회 `GET /platform/companies/{businessRegistrationNumber}/state`
|
|
35260
|
+
|
|
35261
|
+
---
|
|
35262
|
+
|
|
35263
|
+
작성일자: **2025년 10월 02일**
|
|
35264
|
+
|
|
35265
|
+
- 일반 문의: <cs@portone.io> / 채널톡
|
|
35266
|
+
- 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널
|
|
33995
35267
|
|
|
33996
35268
|
|
|
33997
35269
|
# https://developers.portone.io/blog/posts/2024-02/v2-oom
|