@portone/mcp-server 0.14.0 → 0.15.0-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -2
- package/assets/docs/_components/ko/docs-for-llms.md +21 -0
- package/assets/docs/_components/ko/llms-txt-support.md +15 -0
- package/assets/docs/_components/ko/using-mcp-server.md +60 -0
- package/assets/docs/help/admin-console/analytics/content32.md +4 -4
- package/assets/docs/help/admin-console/payment-service/content29.md +223 -110
- package/assets/docs/help/admin-console/pg-settlement/content30.md +103 -208
- package/assets/docs/help/admin-console/pg-settlement-history/content35.md +167 -0
- package/assets/docs/help/admin-console/platform-settlement/partner_settlement_service_guide.md +268 -0
- package/assets/docs/help/api-sdk-2025-05-14.md +71 -0
- package/assets/docs/help/applepay.md +1 -1
- package/assets/docs/help/content100002.md +1 -1
- package/assets/docs/help/content100029.md +1 -1
- package/assets/docs/help/content100060.md +2 -2
- package/assets/docs/help/content200015.md +1 -1
- package/assets/docs/help/content200019.md +1 -1
- package/assets/docs/help/content200023.md +2 -2
- package/assets/docs/help/content200050.md +1 -1
- package/assets/docs/help/content61.md +0 -2
- package/assets/docs/help/core-service/channel-setting/danal.md +6 -8
- package/assets/docs/help/core-service/channel-setting/eximbay.md +224 -17
- package/assets/docs/help/core-service/channel-setting/kcp_channel.md +80 -13
- package/assets/docs/help/core-service/channel-setting/naverpay.md +6 -8
- package/assets/docs/help/core-service/channel-setting/nice.md +49 -47
- package/assets/docs/help/core-service/channel-setting/payletter.md +91 -0
- package/assets/docs/help/core-service/channel-setting/paymentwall.md +4 -1
- package/assets/docs/help/core-service/how-to-use/additional-nice.md +19 -19
- package/assets/docs/help/core-service/how-to-use/cancel-reversal.md +2 -2
- package/assets/docs/help/core-service/how-to-use/content200009.md +2 -2
- package/assets/docs/help/core-service/how-to-use/danal-contract.md +2 -2
- package/assets/docs/help/core-service/how-to-use/daou-contract.md +2 -2
- package/assets/docs/help/core-service/how-to-use/eximbay-contract.md +1 -1
- package/assets/docs/help/core-service/how-to-use/high-risk-industry.md +9 -9
- package/assets/docs/help/core-service/how-to-use/identity-verification-age-restriction.md +29 -0
- package/assets/docs/help/core-service/how-to-use/information-pg.md +4 -10
- package/assets/docs/help/core-service/how-to-use/kakao-contract.md +2 -2
- package/assets/docs/help/core-service/how-to-use/ksnet-contract.md +1 -1
- package/assets/docs/help/core-service/how-to-use/nice-contract.md +15 -15
- package/assets/docs/help/core-service/how-to-use/open-immediately.md +1 -1
- package/assets/docs/help/core-service/how-to-use/point-service.md +7 -7
- package/assets/docs/help/core-service/how-to-use/settle-contract.md +2 -2
- package/assets/docs/help/core-service/how-to-use/shopify-available-list.md +4 -4
- package/assets/docs/help/core-service/how-to-use/shopify-guide.md +1 -1
- package/assets/docs/help/core-service/how-to-use/test-mode-cancel.md +3 -3
- package/assets/docs/help/core-service/how-to-use/tosspayments-contract.md +4 -4
- package/assets/docs/help/core-service/payment-type/content200007.md +8 -7
- package/assets/docs/help/core-service/payment-type/content200036.md +17 -18
- package/assets/docs/help/core-service/payment-type/content200042.md +3 -3
- package/assets/docs/help/core-service/payment-type/content200052.md +2 -2
- package/assets/docs/help/core-service/payment-type/content200053.md +7 -3
- package/assets/docs/help/core-service/payment-type/hub-service-fee.md +19 -17
- package/assets/docs/help/core-service/payment-type/inicis-easypay-hub-fee.md +5 -6
- package/assets/docs/help/core-service/payment-type/inicis-international.md +10 -10
- package/assets/docs/help/core-service/payment-type/internationl-pg.md +7 -3
- package/assets/docs/help/core-service/payment-type/kcp-easypay-hub-apply.md +4 -5
- package/assets/docs/help/core-service/payment-type/kcp-international.md +2 -3
- package/assets/docs/help/core-service/payment-type/nice-easypay-hub-fee.md +8 -8
- package/assets/docs/help/core-service/payment-type/nice-international.md +14 -14
- package/assets/docs/help/core-service/payment-type/payletter-international.md +105 -0
- package/assets/docs/help/core-service/payment-type/paypal-payment-status.md +3 -3
- package/assets/docs/help/core-service/payment-type/schedule-requirement.md +2 -2
- package/assets/docs/help/faq/console-faq/change-console-url.md +2 -0
- package/assets/docs/help/faq/general-inquiry/confirm-process.md +16 -16
- package/assets/docs/help/faq/general-inquiry/identity-verification-suspended-ip.md +35 -0
- package/assets/docs/help/faq/general-inquiry/kcp-business-number-error.md +29 -0
- package/assets/docs/help/faq/general-inquiry/platform-contract-method.md +4 -5
- package/assets/docs/help/faq/general-inquiry/platform-contract-pg.md +2 -2
- package/assets/docs/help/faq/general-inquiry/real-channel-info.md +1 -1
- package/assets/docs/help/faq/payment-faq/cash-receipt-guide.md +2 -2
- package/assets/docs/help/faq/payment-faq/kcp-cash-receipt.md +34 -0
- package/assets/docs/help/faq/payment-faq/payment-failure-danal-insufficient-funds.md +29 -0
- package/assets/docs/help/faq/payment-faq/payment-failure-kcp-insufficient-funds.md +35 -0
- package/assets/docs/help/faq/payment-faq/payment-failure-kiwoompay-insufficient-funds.md +25 -0
- package/assets/docs/help/faq/payment-faq/payment-failure-nice-insufficient-funds.md +28 -0
- package/assets/docs/help/faq/payment-faq/pg-max-min-amount.md +3 -3
- package/assets/docs/help/faq/payment-faq/vbank-service-detail.md +10 -10
- package/assets/docs/help/faq/payment-faq/wordpress-woocommerce-taxation.md +67 -0
- package/assets/docs/help/faq/platform-faq/platform_additional_fee_setting.md +28 -0
- package/assets/docs/help/faq/platform-faq/platform_api_docs.md +24 -0
- package/assets/docs/help/faq/platform-faq/platform_definition_partner.md +34 -0
- package/assets/docs/help/faq/platform-faq/platform_definition_payout_agency.md +23 -0
- package/assets/docs/help/faq/platform-faq/platform_definition_platform.md +17 -0
- package/assets/docs/help/faq/platform-faq/platform_definition_settlement.md +29 -0
- package/assets/docs/help/faq/platform-faq/platform_difference_settlement_payout.md +29 -0
- package/assets/docs/help/faq/platform-faq/platform_ecommerce_discount_policy.md +19 -0
- package/assets/docs/help/faq/platform-faq/platform_introduction.md +15 -0
- package/assets/docs/help/faq/platform-faq/platform_introduction_conditions.md +16 -0
- package/assets/docs/help/faq/platform-faq/platform_nocode_guide.md +5 -5
- package/assets/docs/help/faq/platform-faq/platform_nocode_hosting.md +20 -0
- package/assets/docs/help/faq/platform-faq/platform_nocode_use.md +28 -0
- package/assets/docs/help/faq/platform-faq/platform_partner_bulk_registration.md +31 -0
- package/assets/docs/help/faq/platform-faq/platform_partner_info_guide.md +49 -0
- package/assets/docs/help/faq/platform-faq/platform_partner_management_tags.md +14 -0
- package/assets/docs/help/faq/platform-faq/platform_partner_tax_type.md +18 -0
- package/assets/docs/help/faq/platform-faq/platform_partnerships.md +16 -0
- package/assets/docs/help/faq/platform-faq/platform_payment_formula_setting.md +20 -0
- package/assets/docs/help/faq/platform-faq/platform_paymentdetails_definition.md +11 -0
- package/assets/docs/help/faq/platform-faq/platform_paymentdetails_view_features.md +18 -0
- package/assets/docs/help/faq/platform-faq/platform_payoutagency_realtime_payment.md +22 -0
- package/assets/docs/help/faq/platform-faq/platform_payoutagency_safety_legality.md +22 -0
- package/assets/docs/help/faq/platform-faq/platform_payoutagency_scheduled_payment.md +18 -0
- package/assets/docs/help/faq/platform-faq/platform_pg_fee_handling.md +18 -0
- package/assets/docs/help/faq/platform-faq/platform_policymanagement_calculator.md +1 -1
- package/assets/docs/help/faq/platform-faq/platform_privacypolicy_creation_guide.md +24 -0
- package/assets/docs/help/faq/platform-faq/platform_privacypolicy_definition.md +19 -0
- package/assets/docs/help/faq/platform-faq/platform_privacypolicy_service_compliance.md +28 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_auto_calculation_setting.md +39 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_cancellation_data.md +21 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_custom_attributes.md +18 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_custom_formula_request.md +20 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_cycle_setting.md +42 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_decimal_rounding.md +23 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_hold_date_setting.md +35 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_holidays.md +9 -0
- package/assets/docs/help/faq/platform-faq/platform_settlement_manual_registration.md +32 -0
- package/assets/docs/help/faq/platform-faq/platform_settlementdetails_view_features.md +26 -0
- package/assets/docs/help/faq/platform-faq/platform_settlmentandpayout_guide.md +4 -4
- package/assets/docs/help/faq/platform-faq/platform_supported_bank_codes.md +85 -0
- package/assets/docs/help/faq/platform-faq/platform_supported_currencies.md +33 -0
- package/assets/docs/help/faq/platform-faq/platform_tax_calculation.md +17 -0
- package/assets/docs/help/faq/platform-faq/platform_tax_setting_guide.md +1 -1
- package/assets/docs/help/faq/platform-faq/platform_tax_withholding_tax_definition.md +14 -0
- package/assets/docs/help/faq/platform-faq/platform_virtual_account_withdrawal.md +16 -0
- package/assets/docs/help/faq/platform-faq/platform_webhook_definition.md +24 -0
- package/assets/docs/help/faq/platform-faq/recommended_withdrawal.md +16 -0
- package/assets/docs/help/faq/platform-faq/system_test_environment.md +13 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_bulk_issuance.md +25 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_cancel.md +12 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_delayed.md +18 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_forward_issuance.md +23 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_guide_atoz.md +202 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_partner_peristalsis.md +60 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_buyer_process.md +52 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_definition.md +46 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_partner_signup.md +23 -0
- package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_supplier_process.md +47 -0
- package/assets/docs/help/notice-payletter-2025-10-21.md +29 -0
- package/assets/docs/help/notice-payletter-2025-10-24.md +46 -0
- package/assets/docs/help/notice-v1-api-2025-11-24.md +78 -0
- package/assets/docs/help/notice-v1-api-2025-11-25.md +59 -0
- package/assets/docs/help/platform-2025-07-02.md +73 -0
- package/assets/docs/help/platform-2025-07-07.md +56 -0
- package/assets/docs/help/pricing/pg/domestic-and-oversea-fees.md +2 -2
- package/assets/docs/help/pricing/portone/portone-pricing.md +1 -1
- package/assets/docs/help/procedure/payment-integration/test-integration.md +2 -2
- package/assets/docs/help/procedure/pg-application/content59.md +1 -1
- package/assets/docs/help/procedure/pg-application/start.md +1 -1
- package/assets/docs/help/procedure/recommendation/package.md +14 -8
- package/assets/docs/help/service/identity-verification/identity-verification.md +6 -6
- package/assets/docs/help/service/paymethod/paymethod.md +2 -2
- package/assets/docs/help/service/pg/pg-service-list.md +25 -13
- package/assets/docs/help/service/version/portone-version.md +1 -1
- package/assets/docs/opi/ko/console/guide/billing-payments.md +1 -1
- package/assets/docs/opi/ko/console/guide/reg.md +1 -1
- package/assets/docs/opi/ko/console/guide/smartrouting.md +0 -2
- package/assets/docs/opi/ko/console/pg.md +7 -7
- package/assets/docs/opi/ko/etc/recon.md +2 -2
- package/assets/docs/opi/ko/extra/confirm-process/readme-v1.md +2 -2
- package/assets/docs/opi/ko/extra/confirm-process/readme-v2.md +11 -4
- package/assets/docs/opi/ko/extra/identity-verification/readme-v2.md +2 -2
- package/assets/docs/opi/ko/extra/identity-verification/v1/all/3.md +3 -3
- package/assets/docs/opi/ko/extra/identity-verification/v1/all/readme.md +1 -1
- package/assets/docs/opi/ko/extra/identity-verification/v1/credit-auth/4.md +3 -3
- package/assets/docs/opi/ko/extra/identity-verification/v1/phone/4.md +3 -3
- package/assets/docs/opi/ko/extra/manual-confirm/readme-v2.md +74 -0
- package/assets/docs/opi/ko/extra/plugins/wordpress/button.md +1 -1
- package/assets/docs/opi/ko/extra/plugins/wordpress/edd.md +1 -1
- package/assets/docs/opi/ko/extra/plugins/wordpress/woocommerce/subscription.md +1 -1
- package/assets/docs/opi/ko/extra/promotion/intro.md +1 -1
- package/assets/docs/opi/ko/extra/smart-routing/console-guide.md +1 -1
- package/assets/docs/opi/ko/extra/smart-routing/integration.md +2 -2
- package/assets/docs/opi/ko/extra/smart-routing/intro.md +9 -10
- package/assets/docs/opi/ko/integration/pg/v1/danal.md +6 -1
- package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +10 -1
- package/assets/docs/opi/ko/integration/pg/v1/daou/undefined.md +8 -0
- package/assets/docs/opi/ko/integration/pg/v1/eximbay.md +0 -14
- package/assets/docs/opi/ko/integration/pg/v1/inicis.md +60 -2
- package/assets/docs/opi/ko/integration/pg/v1/kakaopay.md +12 -1
- package/assets/docs/opi/ko/integration/pg/v1/kicc.md +3 -1
- package/assets/docs/opi/ko/integration/pg/v1/ksnet/readme.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/newtoss/readme.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/kcp-quickpay.md +710 -0
- package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/readme.md +661 -0
- package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp.md +0 -34
- package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md +11 -11
- package/assets/docs/opi/ko/integration/pg/v1/nice-v2/payment-caution.md +16 -16
- package/assets/docs/opi/ko/integration/pg/v1/nice-v2/readme.md +10 -8
- package/assets/docs/opi/ko/integration/pg/v1/nice.md +7 -7
- package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md +91 -0
- package/assets/docs/opi/ko/integration/pg/v1/paypal.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/readme.md +5 -5
- package/assets/docs/opi/ko/integration/pg/v1/rt/readme.md +3 -3
- package/assets/docs/opi/ko/integration/pg/v1/rt/warning.md +2 -2
- package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md +81 -1
- package/assets/docs/opi/ko/integration/pg/v1/smartro-v2/caution.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md +10 -9
- package/assets/docs/opi/ko/integration/pg/v1/tosspay-v2/readme.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v1/welcome/readme.md +10 -7
- package/assets/docs/opi/ko/integration/pg/v2/eximbay-v2.md +140 -22
- package/assets/docs/opi/ko/integration/pg/v2/hyphen.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v2/inicis-unified-identity-verification.md +0 -1
- package/assets/docs/opi/ko/integration/pg/v2/inicis-v2.md +13 -1
- package/assets/docs/opi/ko/integration/pg/v2/kcp-v2.md +4 -2
- package/assets/docs/opi/ko/integration/pg/v2/naverpay.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v2/nice-v2.md +40 -40
- package/assets/docs/opi/ko/integration/pg/v2/payletter-global.md +17 -3
- package/assets/docs/opi/ko/integration/pg/v2/paypal-v2.md +14 -13
- package/assets/docs/opi/ko/integration/pg/v2/readme.md +1 -9
- package/assets/docs/opi/ko/integration/pg/v2/smartro-v2.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v2/tosspayments.md +1 -1
- package/assets/docs/opi/ko/integration/pg/v2/welcome.md +8 -7
- package/assets/docs/opi/ko/integration/ready/readme.md +44 -42
- package/assets/docs/opi/ko/integration/start/v1/non-auth.md +2 -4
- package/assets/docs/opi/ko/integration/start/v2/billing/issue.md +1 -1
- package/assets/docs/opi/ko/integration/start/v2/checkout.md +4 -2
- package/assets/docs/opi/ko/integration/start/v2/readme.md +2 -3
- package/assets/docs/opi/ko/integration/using-ai-tools.md +33 -57
- package/assets/docs/opi/ko/integration/virtual-account/readme.md +9 -9
- package/assets/docs/opi/ko/integration/webhook/readme-v1.md +2 -4
- package/assets/docs/opi/ko/integration/webhook/readme-v2.md +3 -5
- package/assets/docs/opi/ko/quick-guide/payment.md +25 -77
- package/assets/docs/opi/ko/support/code-info/pg-1.md +1 -1
- package/assets/docs/opi/ko/support/code-info/pg-2.md +2 -2
- package/assets/docs/opi/ko/support/code-info/pg.md +2 -2
- package/assets/docs/opi/ko/support/contact.md +1 -13
- package/assets/docs/opi/ko/support/pg-terms.md +233 -0
- package/assets/docs/platform/ko/guides/dictionary.md +136 -16
- package/assets/docs/platform/ko/guides/process.md +1 -1
- package/assets/docs/platform/ko/guides/webhook.md +1 -1
- package/assets/docs/platform/ko/using-ai-tools.md +33 -57
- package/assets/docs/release-notes/api-sdk/2023-07-10.md +7 -7
- package/assets/docs/release-notes/api-sdk/2023-07-31.md +1 -1
- package/assets/docs/release-notes/api-sdk/2023-08-31.md +2 -2
- package/assets/docs/release-notes/api-sdk/2024-01-08.md +4 -4
- package/assets/docs/release-notes/api-sdk/2024-06-03.md +1 -1
- package/assets/docs/release-notes/api-sdk/2024-09-05.md +0 -1
- package/assets/docs/release-notes/api-sdk/2024-09-27.md +4 -4
- package/assets/docs/release-notes/console/2025-10-17.md +47 -0
- package/assets/docs/release-notes/platform/2025-03-17.md +1 -1
- package/assets/docs/release-notes/platform/2025-07-07.md +1 -1
- package/assets/docs/release-notes/platform/2025-07-23.md +85 -0
- package/assets/docs/release-notes/platform/2025-08-13.md +95 -0
- package/assets/docs/release-notes/platform/2025-08-21.md +53 -0
- package/assets/docs/release-notes/platform/2025-08-28.md +53 -0
- package/assets/docs/release-notes/platform/2025-10-02.md +152 -0
- package/assets/docs/schema/browser-sdk.schema.json +510 -0
- package/assets/docs/schema/browser-sdk.yml +196 -69
- package/assets/docs/schema/v1.openapi.json +845 -887
- package/assets/docs/schema/v1.openapi.yml +1062 -1737
- package/assets/docs/schema/v2.openapi.json +9177 -2044
- package/assets/docs/schema/v2.openapi.yml +7499 -1479
- package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrq.md +3 -3
- package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrt.md +3 -3
- package/assets/docs/sdk/ko/v2-mobile-sdk/android.md +1 -1
- package/assets/docs/sdk/ko/v2-server-sdk/jvm.md +12 -5
- package/assets/docs/sdk/ko/v2-server-sdk/python.md +12 -3
- package/assets/docs/v1-docs-full.md +2395 -1336
- package/assets/docs/v2-docs-full.md +1422 -649
- package/assets/docs/website-links.md +23 -15
- package/assets/instructions.md +4 -2
- package/manifest.json +1 -1
- package/package.json +17 -20
- package/server/index.js +135 -97
- package/assets/docs/help/admin-console/platform-settlement/content33-1.md +0 -201
- package/assets/docs/help/core-service/payment-type/schedule-logic-guide.md +0 -49
- package/assets/docs/help/core-service/payment-type/tosspayments-easypay-hub-fee.md +0 -42
- package/assets/docs/help/faq/platform-faq/taxinvoice_guide.md +0 -107
- package/assets/docs/help/faq/platform-faq/taxinvoice_signupemail.md +0 -67
|
@@ -64,12 +64,12 @@
|
|
|
64
64
|
### V2 통합 가이드
|
|
65
65
|
|
|
66
66
|
- [스마트 라우팅](https://developers.portone.io/opi/ko/console/guide/smartrouting): 포트원 스마트 라우팅을 사용하기 위한 그룹 설정을 관리할 수 있습니다. 관리자콘솔 내 스마트 라우팅 그룹 설정 방법을 안내합니다.
|
|
67
|
-
- [컨펌 프로세스](https://developers.portone.io/opi/ko/extra/confirm-process/readme-v2):
|
|
67
|
+
- [컨펌 프로세스](https://developers.portone.io/opi/ko/extra/confirm-process/readme-v2): 결제 승인의 주체를 고객사 서버로 가져갈 수 있는 서비스입니다.
|
|
68
68
|
- [본인인증 연동하기](https://developers.portone.io/opi/ko/extra/identity-verification/readme-v2): 포트원을 이용하여 간편하게 본인인증을 연동하는 방법을 확인합니다.
|
|
69
|
+
- [수동 승인](https://developers.portone.io/opi/ko/extra/manual-confirm/readme-v2): 고객사 서버에서 API를 호출하여 결제를 승인하는 연동 방식입니다.
|
|
69
70
|
- [결제취소(환불) 연동하기](https://developers.portone.io/opi/ko/integration/cancel/v2/readme): 포트원 V2 결제취소 API를 이용한 결제취소 방법을 안내합니다.
|
|
70
71
|
- [다날 본인인증](https://developers.portone.io/opi/ko/integration/pg/v2/danal-identity-verification): 다날 본인인증 연동 방법을 안내합니다.
|
|
71
72
|
- [엑심베이](https://developers.portone.io/opi/ko/integration/pg/v2/eximbay-v2): 엑심베이 결제 연동 방법을 안내합니다.
|
|
72
|
-
- [하이픈](https://developers.portone.io/opi/ko/integration/pg/v2/hyphen): 하이픈 결제 연동 방법을 안내합니다.
|
|
73
73
|
- [KG이니시스 일본결제](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-jp): KG이니시스 일본결제 연동 방법을 안내합니다.
|
|
74
74
|
- [KG이니시스 통합인증](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-unified-identity-verification): KG이니시스 통합인증 연동 방법을 안내합니다.
|
|
75
75
|
- [KG이니시스](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-v2): KG이니시스 결제 연동 방법을 안내합니다.
|
|
@@ -79,7 +79,7 @@
|
|
|
79
79
|
- [한국결제네트웍스(KPN)](https://developers.portone.io/opi/ko/integration/pg/v2/kpn): 한국결제네트웍스(KPN) 결제 연동 방법을 안내합니다.
|
|
80
80
|
- [KSNET](https://developers.portone.io/opi/ko/integration/pg/v2/ksnet): KSNET 결제 연동 방법을 안내합니다.
|
|
81
81
|
- [네이버페이 (결제형)](https://developers.portone.io/opi/ko/integration/pg/v2/naverpay): 네이버페이 간편결제 연동 방법을 안내합니다.
|
|
82
|
-
- [
|
|
82
|
+
- [나이스정보통신](https://developers.portone.io/opi/ko/integration/pg/v2/nice-v2): 나이스정보통신 결제 연동 방법을 안내합니다.
|
|
83
83
|
- [페이레터 해외결제](https://developers.portone.io/opi/ko/integration/pg/v2/payletter-global): 페이레터 해외결제 연동 방법을 안내합니다.
|
|
84
84
|
- [페이팔](https://developers.portone.io/opi/ko/integration/pg/v2/paypal-v2): 페이팔 결제 연동 방법을 안내합니다.
|
|
85
85
|
- [결제대행사 선택하여 연동하기](https://developers.portone.io/opi/ko/integration/pg/v2/readme): 각 PG사별 결제 연동 방법을 확인할 수 있습니다.
|
|
@@ -111,19 +111,20 @@
|
|
|
111
111
|
- [프로모션 결제 연동하기](https://developers.portone.io/opi/ko/extra/promotion/integration): 프로모션 할인금액을 적용하는 방법을 안내합니다.
|
|
112
112
|
- [프로모션](https://developers.portone.io/opi/ko/extra/promotion/intro): 카드 즉시 할인을 쉽게 운영 및 관리할 수 있는 서비스입니다.
|
|
113
113
|
- [프로모션 결제 취소하기](https://developers.portone.io/opi/ko/extra/promotion/refund): 프로모션을 적용하여 승인된 결제건들에 대하여 취소/환불하는 방법을 안내합니다.
|
|
114
|
-
- [스마트 라우팅 - 콘솔 가이드](https://developers.portone.io/opi/ko/extra/smart-routing/console-guide): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화
|
|
115
|
-
- [스마트 라우팅 - 연동하기](https://developers.portone.io/opi/ko/extra/smart-routing/integration): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화
|
|
116
|
-
- [스마트 라우팅](https://developers.portone.io/opi/ko/extra/smart-routing/intro): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화
|
|
114
|
+
- [스마트 라우팅 - 콘솔 가이드](https://developers.portone.io/opi/ko/extra/smart-routing/console-guide): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
|
|
115
|
+
- [스마트 라우팅 - 연동하기](https://developers.portone.io/opi/ko/extra/smart-routing/integration): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
|
|
116
|
+
- [스마트 라우팅](https://developers.portone.io/opi/ko/extra/smart-routing/intro): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
|
|
117
117
|
- [결제 연동 준비하기](https://developers.portone.io/opi/ko/integration/ready/readme): 포트원을 이용한 연동 개발이 처음이시라면 아래 안내 사항에 따라 진행하세요.
|
|
118
118
|
- [AI 도구 활용하기](https://developers.portone.io/opi/ko/integration/using-ai-tools): AI 도구를 활용하여 쉽고 빠르게 포트원을 연동하세요. 연동 코드 작성은 물론, 24시간 언제나 관련 질의에 대한 답변을 받을 수 있습니다.
|
|
119
119
|
- [가상계좌 입금통보 설정](https://developers.portone.io/opi/ko/integration/virtual-account/readme): 결제대행사별 입금통보 URL을 안내합니다.
|
|
120
120
|
- [포트원 결제 연동 Doc](https://developers.portone.io/opi/ko/readme): 포트원 결제 연동 가이드입니다. 빠른 시간 안에 결제를 연동할 수 있게 도와드립니다.
|
|
121
121
|
- [직접 문의하기](https://developers.portone.io/opi/ko/support/contact): 기술지원 문의를 위한 연락처 정보입니다.
|
|
122
|
+
- [용어 사전](https://developers.portone.io/opi/ko/support/pg-terms): 온라인 결제 시스템에서 자주 사용되는 용어들을 설명합니다.
|
|
122
123
|
- [TLS 지원 범위](https://developers.portone.io/opi/ko/support/tls-support): 포트원 v1 API의 TLS 지원 범위 및 설정 가이드를 확인할 수 있습니다.
|
|
123
124
|
|
|
124
125
|
### 파트너정산
|
|
125
126
|
|
|
126
|
-
- [용어 사전](https://developers.portone.io/platform/ko/guides/dictionary)
|
|
127
|
+
- [용어 사전](https://developers.portone.io/platform/ko/guides/dictionary): 파트너 정산 자동화 솔루션에서 자주 사용되는 용어를 설명합니다.
|
|
127
128
|
- [서비스 프로세스](https://developers.portone.io/platform/ko/guides/process)
|
|
128
129
|
- [세금계산서 웹훅 가이드](https://developers.portone.io/platform/ko/guides/webhook): 세금계산서 상태 변화 웹훅의 사용 방법과 설정 가이드입니다.
|
|
129
130
|
- [파트너 정산 자동화 서비스 가이드](https://developers.portone.io/platform/ko/readme)
|
|
@@ -183,6 +184,7 @@
|
|
|
183
184
|
- [관리자콘솔 2023-09-12](https://developers.portone.io/release-notes/console/2023-09-12)
|
|
184
185
|
- [관리자콘솔 2023-12-27](https://developers.portone.io/release-notes/console/2023-12-27)
|
|
185
186
|
- [관리자콘솔 2024-09-05](https://developers.portone.io/release-notes/console/2024-09-05)
|
|
187
|
+
- [관리자콘솔 2025-10-17](https://developers.portone.io/release-notes/console/2025-10-17)
|
|
186
188
|
- [파트너 정산 자동화 2023-08-31](https://developers.portone.io/release-notes/platform/2023-08-31)
|
|
187
189
|
- [파트너 정산 자동화 2023-11-08](https://developers.portone.io/release-notes/platform/2023-11-08)
|
|
188
190
|
- [파트너 정산 자동화 2023-11-14](https://developers.portone.io/release-notes/platform/2023-11-14)
|
|
@@ -209,6 +211,11 @@
|
|
|
209
211
|
- [파트너 정산 자동화 2025-05-14](https://developers.portone.io/release-notes/platform/2025-05-14)
|
|
210
212
|
- [파트너 정산 자동화 2025-07-02](https://developers.portone.io/release-notes/platform/2025-07-02)
|
|
211
213
|
- [파트너 정산 자동화 2025-07-07](https://developers.portone.io/release-notes/platform/2025-07-07)
|
|
214
|
+
- [파트너 정산 자동화 2025-07-23](https://developers.portone.io/release-notes/platform/2025-07-23)
|
|
215
|
+
- [파트너 정산 자동화 2025-08-13](https://developers.portone.io/release-notes/platform/2025-08-13)
|
|
216
|
+
- [파트너 정산 자동화 2025-08-21](https://developers.portone.io/release-notes/platform/2025-08-21)
|
|
217
|
+
- [파트너 정산 자동화 2025-08-28](https://developers.portone.io/release-notes/platform/2025-08-28)
|
|
218
|
+
- [파트너 정산 자동화 2025-10-02](https://developers.portone.io/release-notes/platform/2025-10-02)
|
|
212
219
|
|
|
213
220
|
### 블로그
|
|
214
221
|
|
|
@@ -234,8 +241,6 @@ targetVersions:
|
|
|
234
241
|
|
|
235
242
|
스마트 라우팅 기능이 궁금하다면 [스마트 라우팅 기능 소개](https://developers.portone.io/opi/ko/extra/smart-routing/intro)를 확인해 보세요!
|
|
236
243
|
|
|
237
|
-
스마트 라우팅은 **V2 결제 서비스 이용시**에만 사용이 가능합니다.
|
|
238
|
-
|
|
239
244
|
</div>
|
|
240
245
|
|
|
241
246
|
## 스마트 라우팅 그룹 생성하기
|
|
@@ -303,7 +308,7 @@ targetVersions:
|
|
|
303
308
|
|
|
304
309
|
---
|
|
305
310
|
title: 컨펌 프로세스
|
|
306
|
-
description:
|
|
311
|
+
description: 결제 승인의 주체를 고객사 서버로 가져갈 수 있는 서비스입니다.
|
|
307
312
|
targetVersions:
|
|
308
313
|
- v2
|
|
309
314
|
versionVariants:
|
|
@@ -312,11 +317,18 @@ versionVariants:
|
|
|
312
317
|
|
|
313
318
|
**해당 서비스는 결제 승인 직전에 고객사에서 결제 의사를 최종적으로 확인하는 서비스입니다.**
|
|
314
319
|
|
|
315
|
-
|
|
320
|
+
<div class="hint" data-style="info">
|
|
321
|
+
|
|
322
|
+
**수동 승인 기능 안내**
|
|
323
|
+
|
|
324
|
+
V2 신규 연동 시에는 컨펌 프로세스와 동일한 목적으로 사용할 수 있는 [수동 승인](https://developers.portone.io/opi/ko/extra/manual-confirm/readme-v2) 기능을 이용하시기를 권장합니다.
|
|
325
|
+
수동 승인은 더 간편한 연동 방식을 제공하며, 채널 설정에서 간단히 켤 수 있습니다.
|
|
326
|
+
|
|
327
|
+
</div>
|
|
316
328
|
|
|
317
329
|
## 컨펌 프로세스란?
|
|
318
330
|
|
|
319
|
-
- 결제 승인 직전 고객사에 결제 승인 요청 의사를 마지막으로 확인하는
|
|
331
|
+
- 결제 승인 직전 고객사에 결제 승인 요청 의사를 마지막으로 확인하는 서비스입니다.
|
|
320
332
|
|
|
321
333
|
- 기본적인 결제 플로우상 고객사에서 결제 요청 후 별도의 확인 없이 결제 승인되는 구조입니다.
|
|
322
334
|
하지만 해당 서비스 이용 시 고객사가 최종적으로 결제 승인 요청의 주체가 될 수 있습니다.
|
|
@@ -365,7 +377,7 @@ versionVariants:
|
|
|
365
377
|
|
|
366
378
|
**컨펌 프로세스 신청 방법**
|
|
367
379
|
|
|
368
|
-
기술지원 메일(<support@portone.io>)로 **상점 아이디**를 기재하여 메일 발송
|
|
380
|
+
기술지원 메일(<tech.support@portone.io>)로 **상점 아이디**를 기재하여 메일 발송
|
|
369
381
|
|
|
370
382
|
포트원 콘솔 로그인 후 \[결제연동] 페이지 상단에서 상점 아이디를 확인 하실 수 있습니다.
|
|
371
383
|
|
|
@@ -469,8 +481,8 @@ versionVariants:
|
|
|
469
481
|
**본인인증 서비스**란 인증 절차를 거쳐 본인 여부와 입력한 정보의 정확성을 확인하여 주는 서비스입니다. 현재 지원하는 본인인증 서비스는 아래와 같습니다.
|
|
470
482
|
|
|
471
483
|
- 다날 휴대폰 본인인증
|
|
472
|
-
- KG이니시스 통합인증
|
|
473
484
|
- KCP 휴대폰 본인인증
|
|
485
|
+
- KG이니시스 통합인증
|
|
474
486
|
|
|
475
487
|
## 휴대폰 본인인증
|
|
476
488
|
|
|
@@ -499,7 +511,7 @@ versionVariants:
|
|
|
499
511
|
이용하거나 사용자 본인이 가입된 간편인증을 통해 인증요청을 보내고 간편인증 페이지에서 인증처리를
|
|
500
512
|
하는 방식으로 이루어집니다.
|
|
501
513
|
|
|
502
|
-
> **이용가능 수단 : 네이버 / PASS /
|
|
514
|
+
> **이용가능 수단 : 네이버 / PASS / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스**
|
|
503
515
|
|
|
504
516
|
(이미지 첨부: 휴대폰 본인인증 화면 예시)
|
|
505
517
|
|
|
@@ -720,6 +732,84 @@ app.post("/identity-verifications", async (req, res) => {
|
|
|
720
732
|
```
|
|
721
733
|
|
|
722
734
|
|
|
735
|
+
# https://developers.portone.io/opi/ko/extra/manual-confirm/readme-v2
|
|
736
|
+
|
|
737
|
+
---
|
|
738
|
+
title: 수동 승인
|
|
739
|
+
description: 고객사 서버에서 API를 호출하여 결제를 승인하는 연동 방식입니다.
|
|
740
|
+
targetVersions:
|
|
741
|
+
- v2
|
|
742
|
+
---
|
|
743
|
+
|
|
744
|
+
포트원을 통해 PG의 결제 UI를 표시하면, 구매자는 UI에서 정보 입력 및 인증을 진행합니다. 이 과정이 끝나고 UI가 닫히면 자동으로 결제 승인(또는 가상계좌 발급, 빌링키 발급)이 일어납니다.
|
|
745
|
+
|
|
746
|
+
그러나 채널 설정에서 **수동 승인**을 켜면, 결제 UI가 완료되더라도 고객사 서버에서 포트원의 **수동 승인** API를 호출하지 않으면 결제 승인 등이 일어나지 않습니다.
|
|
747
|
+
|
|
748
|
+
<div class="hint" data-style="warning">
|
|
749
|
+
|
|
750
|
+
**수동 승인을 사용할 수 없는 PG**
|
|
751
|
+
|
|
752
|
+
엑심베이, 페이레터 해외결제의 경우 수동 승인을 지원하지 않고, 채널 설정에서도 해당 항목이 보이지 않습니다.
|
|
753
|
+
|
|
754
|
+
이는 근본적으로 위챗 결제와 같이 일부 해외 결제수단이 수동 승인을 지원하지 않기 때문입니다. 따라서 추후 포트원에 추가되는 PG가 이러한 결제수단을 지원한다면, 해당 PG에서는 수동 승인을 이용할 수 없을 가능성이 높습니다.
|
|
755
|
+
|
|
756
|
+
</div>
|
|
757
|
+
|
|
758
|
+
<div class="hint" data-style="info">
|
|
759
|
+
|
|
760
|
+
**컨펌 프로세스와의 비교**
|
|
761
|
+
|
|
762
|
+
수동 승인은 컨펌 프로세스와 동일한 목적의 기능이며, V2 신규 연동에서는 더 간편한 수동 승인 이용을 권장합니다.
|
|
763
|
+
|
|
764
|
+
컨펌 프로세스를 이용할 수 있는 PG의 목록도 수동 승인과 동일합니다.
|
|
765
|
+
|
|
766
|
+
</div>
|
|
767
|
+
|
|
768
|
+
## 수동 승인이 유용한 경우
|
|
769
|
+
|
|
770
|
+
- 결제 승인 전 마지막으로 재고 확인이 필요할 때
|
|
771
|
+
- 수량이 한정된 선착순 판매일 때
|
|
772
|
+
- 결제 완료 상태를 웹훅으로 수신하기보다, 직접 API를 호출해서 결제를 완료시키는 것을 선호할 때
|
|
773
|
+
- 수동 승인 방식으로 타 결제사를 연동한 상태에서 포트원도 같은 구조로 연동하고 싶을 때
|
|
774
|
+
|
|
775
|
+
## 자동 승인이 유용한 경우
|
|
776
|
+
|
|
777
|
+
- 수동 승인을 지원하지 않는 PG를 이용할 때
|
|
778
|
+
- 수동 승인을 지원하지 않는 PG를 추후 연동할 가능성이 높을 때 (특히, 위챗 등 다양한 해외 결제수단 연동을 고려하고 있을 때)
|
|
779
|
+
- 결제 완료 등 결제 상태를 웹훅으로 수신하는 데 불편함이 없을 때
|
|
780
|
+
|
|
781
|
+
## 인증 결제 수동 승인 이용 방법
|
|
782
|
+
|
|
783
|
+
채널 설정에서 수동 승인을 켭니다. 수동 승인 설정은 채널별로 적용됩니다.
|
|
784
|
+
|
|
785
|
+
수동 승인이 켜진 채널로 `PortOne.requestPayment`를 호출하면 응답에 `paymentToken` 필드가 포함됩니다.
|
|
786
|
+
(수동 승인을 켜지 않은 채널이면 `paymentToken` 필드는 포함되지 않습니다.)
|
|
787
|
+
|
|
788
|
+
이렇게 UI 호출 응답으로 받은 `paymentToken`을 이용해 서버에서 [인증 결제 수동 승인](https://developers.portone.io/api/rest-v2/payment?v=v2#post%20%2Fpayments%2F%7BpaymentId%7D%2Fconfirm) API를 호출하면 결제가 승인됩니다. (가상계좌 발급 건의 경우 수동 승인 API 호출 시에 가상계좌가 발급됩니다.)
|
|
789
|
+
|
|
790
|
+
## 빌링키 발급 수동 승인 이용 방법
|
|
791
|
+
|
|
792
|
+
채널 설정에서 수동 승인을 켭니다. 수동 승인 설정은 채널별로 적용됩니다.
|
|
793
|
+
|
|
794
|
+
수동 승인이 켜진 채널로 `PortOne.requestIssueBillingKey`나 `PortOne.requestIssueBillingKeyAndPay`를 호출하면 응답에 `billingIssueToken` 필드가 포함됩니다.
|
|
795
|
+
(수동 승인을 켜지 않은 채널이면 `billingIssueToken` 필드는 포함되지 않습니다.)
|
|
796
|
+
|
|
797
|
+
이때 빌링키는 아직 발급된 상태가 아닙니다. 따라서 응답으로 전달되는 `billingKey` 값은 `NEEDS_CONFIRMATION`입니다. `requestIssueBillingKeyAndPay`를 사용한 경우에는 `txId` 값 또한 `NEEDS_CONFIRMATION`으로 전달됩니다.
|
|
798
|
+
|
|
799
|
+
이렇게 UI 호출 응답으로 받은 `billingIssueToken`을 이용해 서버에서 포트원 API를 호출하면 빌링키가 발급됩니다. `requestIssueBillingKeyAndPay`의 경우 빌링키 발급과 함께 초회 결제도 일어납니다.
|
|
800
|
+
|
|
801
|
+
- `requestIssueBillingKey`의 경우 [빌링키 발급 수동 승인](https://developers.portone.io/api/rest-v2/payment.billingKey?v=v2#post%20%2Fbilling-keys%2Fconfirm) API를 호출합니다.
|
|
802
|
+
- `requestIssueBillingKeyAndPay`의 경우 [빌링키 발급 및 초회 결제 수동 승인](https://developers.portone.io/api/rest-v2/payment.billingKey?v=v2#post%20%2Fbilling-keys%2Fconfirm-issue-and-pay) API를 호출합니다.
|
|
803
|
+
|
|
804
|
+
<div class="hint" data-style="info">
|
|
805
|
+
|
|
806
|
+
**수동 승인 API 호출 시점**
|
|
807
|
+
|
|
808
|
+
수동 승인 API는 가능한 한 즉시 호출하는 것을 권장합니다. 타임아웃 시간은 PG별로 상이하지만, 오래 대기하면 승인이 실패할 수 있습니다.
|
|
809
|
+
|
|
810
|
+
</div>
|
|
811
|
+
|
|
812
|
+
|
|
723
813
|
# https://developers.portone.io/opi/ko/integration/cancel/v2/readme
|
|
724
814
|
|
|
725
815
|
---
|
|
@@ -1248,19 +1338,13 @@ targetVersions:
|
|
|
1248
1338
|
|
|
1249
1339
|
## 가능한 결제수단
|
|
1250
1340
|
|
|
1251
|
-
|
|
1252
|
-
|
|
1253
|
-
엑심베이의 경우 포트원의 결제수단 구분과 상관없이 여러 결제수단을 표시할 수 있습니다.
|
|
1254
|
-
`payMethod`를 생략하고, 특정 결제수단만을 노출할 경우 `bypass.eximbay_v2`를 사용해야 합니다.
|
|
1255
|
-
|
|
1256
|
-
- MID에 설정된 기본 결제수단을 전부 표시하려면 `bypass.eximbay_v2.payment`를 생략해야 합니다.
|
|
1257
|
-
- 특정 결제수단을 단독으로 표시하려면 `bypass.eximbay_v2.payment.payment_method`를 설정합니다.
|
|
1258
|
-
- 일부 결제수단만을 표시하려면 `bypass.eximbay_v2.payment.multi_payment_method`에 결제수단 목록을 전달합니다.
|
|
1259
|
-
- 엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
|
|
1341
|
+
엑심베이의 경우 포트원의 결제수단 구분과 상관없이 MID에 설정된 여러 결제수단을 표시할 수 있습니다.
|
|
1342
|
+
`payMethod`를 생략하고, 특정 결제수단만을 노출할 경우 `bypass.eximbay_v2`를 사용해야 합니다.
|
|
1260
1343
|
|
|
1261
|
-
-
|
|
1262
|
-
|
|
1263
|
-
|
|
1344
|
+
- MID에 설정된 기본 결제수단을 전부 표시하려면 `bypass.eximbay_v2.payment`를 생략해야 합니다.
|
|
1345
|
+
- 특정 결제수단을 단독으로 표시하려면 `bypass.eximbay_v2.payment.payment_method`를 설정합니다.
|
|
1346
|
+
- 일부 결제수단만을 표시하려면 `bypass.eximbay_v2.payment.multi_payment_method`에 결제수단 목록을 전달합니다.
|
|
1347
|
+
- 엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
|
|
1264
1348
|
|
|
1265
1349
|
## SDK 결제 요청하기
|
|
1266
1350
|
|
|
@@ -1385,6 +1469,35 @@ function requestPayment() {
|
|
|
1385
1469
|
|
|
1386
1470
|
결제 완료 메일이 발송됩니다.
|
|
1387
1471
|
|
|
1472
|
+
- products?: object\[]
|
|
1473
|
+
|
|
1474
|
+
**구매 상품 정보**
|
|
1475
|
+
|
|
1476
|
+
- 해외카드 결제를 제외하고 필수 입력입니다.
|
|
1477
|
+
- 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
|
|
1478
|
+
|
|
1479
|
+
* id: string
|
|
1480
|
+
|
|
1481
|
+
**상품 ID**
|
|
1482
|
+
|
|
1483
|
+
* name: string
|
|
1484
|
+
|
|
1485
|
+
**상품명**
|
|
1486
|
+
|
|
1487
|
+
* amount: number
|
|
1488
|
+
|
|
1489
|
+
**상품 단위 가격**
|
|
1490
|
+
|
|
1491
|
+
결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
|
|
1492
|
+
|
|
1493
|
+
* quantity: number
|
|
1494
|
+
|
|
1495
|
+
**상품 수량**
|
|
1496
|
+
|
|
1497
|
+
* link: string
|
|
1498
|
+
|
|
1499
|
+
**상품 판매 URL**
|
|
1500
|
+
|
|
1388
1501
|
- bypass?: oneof object
|
|
1389
1502
|
|
|
1390
1503
|
- eximbay\_v2?: object
|
|
@@ -1548,7 +1661,6 @@ function issueBillingKeyAndPay() {
|
|
|
1548
1661
|
orderName: "PortOne Recurring Payment",
|
|
1549
1662
|
totalAmount: 100, // 1 USD
|
|
1550
1663
|
currency: "USD",
|
|
1551
|
-
billingKeyAndPayMethod: "CARD",
|
|
1552
1664
|
customer: {
|
|
1553
1665
|
fullName: "PortOne",
|
|
1554
1666
|
email: "test@example.com",
|
|
@@ -1601,12 +1713,6 @@ function issueBillingKeyAndPay() {
|
|
|
1601
1713
|
- ISO 4217 통화 코드
|
|
1602
1714
|
- [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)
|
|
1603
1715
|
|
|
1604
|
-
- billingKeyAndPayMethod: string
|
|
1605
|
-
|
|
1606
|
-
**빌링키 발급 및 결제 방법**
|
|
1607
|
-
|
|
1608
|
-
- `CARD`: 신용카드 결제
|
|
1609
|
-
|
|
1610
1716
|
- locale?: Locale
|
|
1611
1717
|
|
|
1612
1718
|
**결제창 언어**
|
|
@@ -1658,12 +1764,55 @@ function issueBillingKeyAndPay() {
|
|
|
1658
1764
|
|
|
1659
1765
|
결제 완료 메일이 발송됩니다.
|
|
1660
1766
|
|
|
1767
|
+
- products?: object\[]
|
|
1768
|
+
|
|
1769
|
+
**구매 상품 정보**
|
|
1770
|
+
|
|
1771
|
+
- 해외카드 결제를 제외하고 필수 입력입니다.
|
|
1772
|
+
- 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
|
|
1773
|
+
|
|
1774
|
+
* id: string
|
|
1775
|
+
|
|
1776
|
+
**상품 ID**
|
|
1777
|
+
|
|
1778
|
+
* name: string
|
|
1779
|
+
|
|
1780
|
+
**상품명**
|
|
1781
|
+
|
|
1782
|
+
* amount: number
|
|
1783
|
+
|
|
1784
|
+
**상품 단위 가격**
|
|
1785
|
+
|
|
1786
|
+
결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
|
|
1787
|
+
|
|
1788
|
+
* quantity: number
|
|
1789
|
+
|
|
1790
|
+
**상품 수량**
|
|
1791
|
+
|
|
1792
|
+
* link: string
|
|
1793
|
+
|
|
1794
|
+
**상품 판매 URL**
|
|
1795
|
+
|
|
1661
1796
|
- bypass?: oneof object
|
|
1662
1797
|
|
|
1663
1798
|
- eximbay\_v2?: object
|
|
1664
1799
|
|
|
1665
1800
|
**엑심베이 특수 파라미터**
|
|
1666
1801
|
|
|
1802
|
+
- payment?: object
|
|
1803
|
+
|
|
1804
|
+
- payment\_method?: string
|
|
1805
|
+
|
|
1806
|
+
**결제수단 단독 노출**
|
|
1807
|
+
|
|
1808
|
+
엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
|
|
1809
|
+
|
|
1810
|
+
- multi\_payment\_method?: string\[]
|
|
1811
|
+
|
|
1812
|
+
**결제수단 노출 목록**
|
|
1813
|
+
|
|
1814
|
+
여러 결제수단을 노출합니다.
|
|
1815
|
+
|
|
1667
1816
|
- merchant?: object
|
|
1668
1817
|
|
|
1669
1818
|
- shop?: string
|
|
@@ -1861,6 +2010,35 @@ const response = await axios({
|
|
|
1861
2010
|
|
|
1862
2011
|
**구매자 이메일**
|
|
1863
2012
|
|
|
2013
|
+
- products?: object\[]
|
|
2014
|
+
|
|
2015
|
+
**구매 상품 정보**
|
|
2016
|
+
|
|
2017
|
+
- 해외카드 결제를 제외하고 필수 입력입니다.
|
|
2018
|
+
- 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
|
|
2019
|
+
|
|
2020
|
+
* id: string
|
|
2021
|
+
|
|
2022
|
+
**상품 ID**
|
|
2023
|
+
|
|
2024
|
+
* name: string
|
|
2025
|
+
|
|
2026
|
+
**상품명**
|
|
2027
|
+
|
|
2028
|
+
* amount: number
|
|
2029
|
+
|
|
2030
|
+
**상품 단위 가격**
|
|
2031
|
+
|
|
2032
|
+
결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
|
|
2033
|
+
|
|
2034
|
+
* quantity: number
|
|
2035
|
+
|
|
2036
|
+
**상품 수량**
|
|
2037
|
+
|
|
2038
|
+
* link: string
|
|
2039
|
+
|
|
2040
|
+
**상품 판매 URL**
|
|
2041
|
+
|
|
1864
2042
|
- bypass?: oneof object
|
|
1865
2043
|
|
|
1866
2044
|
- eximbayV2?: object
|
|
@@ -2071,6 +2249,35 @@ const response = await axios({
|
|
|
2071
2249
|
|
|
2072
2250
|
**구매자 이메일**
|
|
2073
2251
|
|
|
2252
|
+
- products?: object\[]
|
|
2253
|
+
|
|
2254
|
+
**구매 상품 정보**
|
|
2255
|
+
|
|
2256
|
+
- 해외카드 결제를 제외하고 필수 입력입니다.
|
|
2257
|
+
- 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
|
|
2258
|
+
|
|
2259
|
+
* id: string
|
|
2260
|
+
|
|
2261
|
+
**상품 ID**
|
|
2262
|
+
|
|
2263
|
+
* name: string
|
|
2264
|
+
|
|
2265
|
+
**상품명**
|
|
2266
|
+
|
|
2267
|
+
* amount: number
|
|
2268
|
+
|
|
2269
|
+
**상품 단위 가격**
|
|
2270
|
+
|
|
2271
|
+
결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
|
|
2272
|
+
|
|
2273
|
+
* quantity: number
|
|
2274
|
+
|
|
2275
|
+
**상품 수량**
|
|
2276
|
+
|
|
2277
|
+
* link: string
|
|
2278
|
+
|
|
2279
|
+
**상품 판매 URL**
|
|
2280
|
+
|
|
2074
2281
|
- bypass?: oneof object
|
|
2075
2282
|
|
|
2076
2283
|
- eximbayV2?: object
|
|
@@ -2176,9 +2383,10 @@ const response = await axios({
|
|
|
2176
2383
|
### 공통
|
|
2177
2384
|
|
|
2178
2385
|
- `customer.name` 및 `customer.email`은 필수 입력 항목입니다.
|
|
2386
|
+
- 해외카드 결제를 제외하고 `products`를 필수로 입력해야 합니다. 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
|
|
2179
2387
|
- `products` 입력 시 `link`를 필수로 입력해야 합니다.
|
|
2180
2388
|
|
|
2181
|
-
### SDK 결제 요청
|
|
2389
|
+
### SDK 결제 / 빌링키 발급 및 결제 요청
|
|
2182
2390
|
|
|
2183
2391
|
- 네이버페이 포인트로 결제할 경우에는 `bypass.eximbay_v2.tax` 내용을 모두 입력해야 합니다.
|
|
2184
2392
|
|
|
@@ -2186,222 +2394,13 @@ const response = await axios({
|
|
|
2186
2394
|
|
|
2187
2395
|
- `bypass.eximbay_v2.payment_method`에 일본 편의점 결제를 지정할 경우 `customer.phoneNumber`을 필수로 입력해야 합니다.
|
|
2188
2396
|
|
|
2189
|
-
- 간편결제 사용 시 `products`를 필수로 입력해야 합니다.
|
|
2190
|
-
|
|
2191
2397
|
- 아래 결제수단의 경우 사용이 제한되므로 결제 연동 시 유의해 주시기 바랍니다.
|
|
2192
2398
|
- 가상계좌(`P305`) : 호환성 이슈로 추후 지원 예정
|
|
2193
2399
|
- Klarna(`P197`) : 엑심베이 정책에 따라 신규 결제 사용 불가
|
|
2194
2400
|
|
|
2195
2401
|
- 모바일 앱 내에서 결제를 연동할 경우 `appScheme` 파라미터를 설정하고 `bypass.eximbay_v2.settings.call_from_app` 파라미터를 "Y"로 설정해야 합니다.
|
|
2196
2402
|
|
|
2197
|
-
|
|
2198
|
-
# https://developers.portone.io/opi/ko/integration/pg/v2/hyphen
|
|
2199
|
-
|
|
2200
|
-
---
|
|
2201
|
-
title: 하이픈
|
|
2202
|
-
description: 하이픈 결제 연동 방법을 안내합니다.
|
|
2203
|
-
targetVersions:
|
|
2204
|
-
- v2
|
|
2205
|
-
versionVariants:
|
|
2206
|
-
v1: /opi/ko/integration/pg/v1/hyphen
|
|
2207
|
-
---
|
|
2208
|
-
|
|
2209
|
-
## 채널 설정하기
|
|
2210
|
-
|
|
2211
|
-
- [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기)의 내용을 참고하여 PG 설정을 진행합니다.
|
|
2212
|
-
|
|
2213
|
-
## 가능한 결제 수단
|
|
2214
|
-
|
|
2215
|
-
- 간편 결제
|
|
2216
|
-
|
|
2217
|
-
하이픈은 계좌 간편 결제를 전용으로 지원하는 PG사로, 등록한 계좌를 이용한 결제만 가능하며 다른 결제 수단은 지원하지 않습니다.
|
|
2218
|
-
|
|
2219
|
-
따라서 `payMethod` 파라미터를 아래와 같이 설정해야 합니다.
|
|
2220
|
-
|
|
2221
|
-
- 간편결제 : `EASY_PAY`
|
|
2222
|
-
|
|
2223
|
-
### 계좌 간편 결제란?
|
|
2224
|
-
|
|
2225
|
-
고객이 PG사에서 제공하는 결제 페이지에서 본인 명의의 계좌를 등록하고, 상품 구매 시 비밀번호 인증 등을 통해 등록된 계좌에서 출금하여 결제하는 서비스를 의미합니다.
|
|
2226
|
-
|
|
2227
|
-
### 계좌 간편 결제의 장점
|
|
2228
|
-
|
|
2229
|
-
계좌 간편 결제는 아래와 같은 장점을 제공합니다.
|
|
2230
|
-
|
|
2231
|
-
1. **우수한 사용성**
|
|
2232
|
-
|
|
2233
|
-
보안 프로그램이나 추가 앱 설치 과정이 필요하지 않습니다.
|
|
2234
|
-
또한 복잡한 계좌 입력이나 인증 과정 없이 최초 한 번만 계좌를 등록하고 이후에는 비밀번호를 통해 간편하게 인증할 수 있습니다.
|
|
2235
|
-
|
|
2236
|
-
2. **낮은 수수료**
|
|
2237
|
-
|
|
2238
|
-
바로 계좌 결제는 오픈 뱅킹 기반의 계좌 이체 서비스로, 신용카드 결제에 비해 낮은 수수료로 해당 서비스를 이용할 수 있습니다.
|
|
2239
|
-
|
|
2240
|
-
3. **빠른 정산 주기**
|
|
2241
|
-
|
|
2242
|
-
하이픈의 계좌 간편 결제 서비스는 통상 D+2일 주기로 정산을 해드리고 있습니다. 빠른 정산을 통해 현금 흐름을 효율적으로 관리할 수 있습니다.
|
|
2243
|
-
|
|
2244
|
-
## SDK 결제 요청하기
|
|
2245
|
-
|
|
2246
|
-
결제 요청 시에는 `requestPayment` 함수를 호출해야 합니다.
|
|
2247
|
-
`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 하이픈 채널 사용을 명시해주세요.
|
|
2248
|
-
|
|
2249
|
-
하이픈 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
2250
|
-
|
|
2251
|
-
<div class="tabs-container">
|
|
2252
|
-
|
|
2253
|
-
<div class="tabs-content" data-title="SDK 결제 요청">
|
|
2254
|
-
|
|
2255
|
-
```javascript
|
|
2256
|
-
import * as PortOne from "@portone/browser-sdk/v2";
|
|
2257
|
-
function requestPayment() {
|
|
2258
|
-
PortOne.requestPayment({
|
|
2259
|
-
storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요.
|
|
2260
|
-
channelKey: "channel-key-9987cb87-6458-4888-b94e-68d9a2da896d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요.
|
|
2261
|
-
paymentId: `payment${crypto.randomUUID()}`,
|
|
2262
|
-
orderName: "나이키 와플 트레이너 2 SD",
|
|
2263
|
-
totalAmount: 1000,
|
|
2264
|
-
currency: "CURRENCY_KRW",
|
|
2265
|
-
payMethod: "EASY_PAY",
|
|
2266
|
-
storeDetails: {
|
|
2267
|
-
businessName: "상호명",
|
|
2268
|
-
},
|
|
2269
|
-
customer: {
|
|
2270
|
-
fullName: "포트원",
|
|
2271
|
-
phoneNumber: "010-0000-1234",
|
|
2272
|
-
email: "test@portone.io",
|
|
2273
|
-
},
|
|
2274
|
-
});
|
|
2275
|
-
}
|
|
2276
|
-
```
|
|
2277
|
-
|
|
2278
|
-
</div>
|
|
2279
|
-
|
|
2280
|
-
</div>
|
|
2281
|
-
|
|
2282
|
-
### 주요 파라미터
|
|
2283
|
-
|
|
2284
|
-
- storeId: string
|
|
2285
|
-
|
|
2286
|
-
**상점 아이디**
|
|
2287
|
-
|
|
2288
|
-
포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다.
|
|
2289
|
-
|
|
2290
|
-
- paymentId: string
|
|
2291
|
-
|
|
2292
|
-
**고객사 주문 고유 번호**
|
|
2293
|
-
|
|
2294
|
-
고객사에서 채번하는 주문 고유 번호로 매번 고유하게 채번되어야 합니다. 이미 승인 완료된 `paymentId`로 결제를 시도하는 경우 에러가 발생합니다.
|
|
2295
|
-
|
|
2296
|
-
- orderName: string
|
|
2297
|
-
|
|
2298
|
-
**주문명**
|
|
2299
|
-
|
|
2300
|
-
주문명으로 고객사에서 자유롭게 입력합니다.
|
|
2301
|
-
|
|
2302
|
-
- channelKey: string
|
|
2303
|
-
|
|
2304
|
-
**채널 키**
|
|
2305
|
-
|
|
2306
|
-
포트원 콘솔 내 \[연동 관리] > \[연동 정보] > \[채널 관리] 화면에서 채널 추가 시 생성되는 값입니다. 결제 호출 시 채널을 지정할 때 사용됩니다.
|
|
2307
|
-
|
|
2308
|
-
- totalAmount: number
|
|
2309
|
-
|
|
2310
|
-
**결제 금액**
|
|
2311
|
-
|
|
2312
|
-
결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
|
|
2313
|
-
|
|
2314
|
-
- currency: string
|
|
2315
|
-
|
|
2316
|
-
**결제 통화**
|
|
2317
|
-
|
|
2318
|
-
결제통화로 원화 결제 시 `KRW`로 입력해야 합니다.
|
|
2319
|
-
|
|
2320
|
-
- payMethod: string
|
|
2321
|
-
|
|
2322
|
-
**결제수단 구분코드**
|
|
2323
|
-
|
|
2324
|
-
결제 호출 시 결제수단을 지정할 때 사용됩니다. 하이픈의 경우 해당 값은 `EASY_PAY`로 고정해주세요.
|
|
2325
|
-
|
|
2326
|
-
- customer?: object
|
|
2327
|
-
|
|
2328
|
-
**고객 정보**
|
|
2329
|
-
|
|
2330
|
-
- fullName?: string
|
|
2331
|
-
|
|
2332
|
-
**구매자 전체 이름**
|
|
2333
|
-
|
|
2334
|
-
- 하이픈의 경우 fullName 혹은 (firstName + lastName)을 필수로 입력해야 합니다.
|
|
2335
|
-
|
|
2336
|
-
- firstName?: string
|
|
2337
|
-
|
|
2338
|
-
**구매자 이름**
|
|
2339
|
-
|
|
2340
|
-
- 하이픈의 경우 fullName 혹은 (firstName + lastName)을 필수로 입력해야 합니다.
|
|
2341
|
-
|
|
2342
|
-
- lastName?: string
|
|
2343
|
-
|
|
2344
|
-
**구매자 성**
|
|
2345
|
-
|
|
2346
|
-
- 하이픈의 경우 fullName 혹은 (firstName + lastName)을 필수로 입력해야 합니다.
|
|
2347
|
-
|
|
2348
|
-
- storeDetails?: object
|
|
2349
|
-
|
|
2350
|
-
**상점 정보**
|
|
2351
|
-
|
|
2352
|
-
- businessName?: string
|
|
2353
|
-
|
|
2354
|
-
**상호명**
|
|
2355
|
-
|
|
2356
|
-
- 결제창에 표시될 상호명입니다. 입력하지 않으면 포트원 대표상점명으로 표시됩니다.
|
|
2357
|
-
|
|
2358
|
-
- bypass?: oneof object
|
|
2359
|
-
|
|
2360
|
-
**PG사 결제창 호출 시 PG사로 그대로 bypass할 파라미터들의 모음**
|
|
2361
|
-
|
|
2362
|
-
- hyphen?: object
|
|
2363
|
-
|
|
2364
|
-
**하이픈에서 제공하는 파라미터 모음**
|
|
2365
|
-
|
|
2366
|
-
- designCd?: string
|
|
2367
|
-
|
|
2368
|
-
**결제창 디자인 색상 코드**
|
|
2369
|
-
|
|
2370
|
-
- `#`으로 시작하는 여섯자리 Hex 값을 입력합니다. (ex. `#C1272C`)
|
|
2371
|
-
|
|
2372
|
-
#### 예시 코드
|
|
2373
|
-
|
|
2374
|
-
```json title="bypass 예시 코드"
|
|
2375
|
-
{
|
|
2376
|
-
"bypass": {
|
|
2377
|
-
"hyphen": {
|
|
2378
|
-
"designCd": "#C1272C"
|
|
2379
|
-
}
|
|
2380
|
-
}
|
|
2381
|
-
}
|
|
2382
|
-
```
|
|
2383
|
-
|
|
2384
|
-
### 유의사항
|
|
2385
|
-
|
|
2386
|
-
<details>
|
|
2387
|
-
|
|
2388
|
-
<summary>`paymentId` 허용 문자 및 길이 제한</summary>
|
|
2389
|
-
|
|
2390
|
-
`paymentId` 에는 영문, 숫자, `_`(underscore) 만으로 이루어진 문자열만 입력할 수 있습니다.
|
|
2391
|
-
|
|
2392
|
-
여기에 포함되지 않는 한글이나 `♤`, `♡`, `♧` 등의 특수 문자는 허용되지 않습니다.
|
|
2393
|
-
|
|
2394
|
-
또한 `paymentId`의 최대 길이는 50자이므로, 해당 길이를 넘지 않는 값으로 결제를 요청해주세요.
|
|
2395
|
-
|
|
2396
|
-
</details>
|
|
2397
|
-
|
|
2398
|
-
<details>
|
|
2399
|
-
|
|
2400
|
-
<summary>`orderName` 길이 제한</summary>
|
|
2401
|
-
|
|
2402
|
-
`orderName`의 최대 길이는 100byte 입니다. (UTF-8 인코딩 기준)
|
|
2403
|
-
|
|
2404
|
-
</details>
|
|
2403
|
+
- 엑심베이의 경우 결제창을 닫은 이후에 결제가 성공 처리될 수 있습니다. 웹훅을 연동하여 결제 실패 상태에서 결제 성공 상태로 바뀌는 경우를 처리해야 합니다.
|
|
2405
2404
|
|
|
2406
2405
|
|
|
2407
2406
|
# https://developers.portone.io/opi/ko/integration/pg/v2/inicis-jp
|
|
@@ -2880,7 +2879,6 @@ PortOne.requestIdentityVerification({
|
|
|
2880
2879
|
|
|
2881
2880
|
<summary>인증 업체 코드 확인하기</summary>
|
|
2882
2881
|
|
|
2883
|
-
- PAYCO(페이코)
|
|
2884
2882
|
- PASS(패스 (통신사))
|
|
2885
2883
|
- TOSS(토스)
|
|
2886
2884
|
- KFTC(금융결제원)
|
|
@@ -3117,7 +3115,7 @@ function requestPayment() {
|
|
|
3117
3115
|
"Ini_SSGPAY_MDN": "01012341234",
|
|
3118
3116
|
"acceptmethod": ["SKIN(#C1272C)", "below1000", "ocb"],
|
|
3119
3117
|
"P_CARD_OPTION": "selcode=14",
|
|
3120
|
-
"
|
|
3118
|
+
"P_MNAME": "포트원",
|
|
3121
3119
|
"P_RESERVED": ["below1000=Y", "noeasypay=Y"]
|
|
3122
3120
|
}
|
|
3123
3121
|
}
|
|
@@ -3246,6 +3244,18 @@ function requestPayment() {
|
|
|
3246
3244
|
|
|
3247
3245
|
<details>
|
|
3248
3246
|
|
|
3247
|
+
<summary>계약 사항에 따라 결제 정보에서 카드 정보가 누락될 수 있습니다.</summary>
|
|
3248
|
+
|
|
3249
|
+
KG이니시스와의 계약에서 결제 결과에 카드번호를 전송하지 않도록 설정된 경우, 결제 조회 시 다음 카드 관련 필드들이 누락될 수 있습니다.
|
|
3250
|
+
|
|
3251
|
+
- `card.issuer`: 카드 발급사
|
|
3252
|
+
- `card.publisher`: 카드 발행사
|
|
3253
|
+
- `card.name`: 카드명
|
|
3254
|
+
|
|
3255
|
+
</details>
|
|
3256
|
+
|
|
3257
|
+
<details>
|
|
3258
|
+
|
|
3249
3259
|
<summary>PC와 모바일에서 파라미터 필수 여부가 상이합니다.</summary>
|
|
3250
3260
|
|
|
3251
3261
|
위의 주요 파라미터 설명에도 안내되어 있듯이, PC 결제와 모바일 결제에서 필수 여부가 상이한 파라미터가 존재합니다. 아래 필드들은 PC 결제에서는 필수이지만, 모바일 결제에서는 선택입니다.
|
|
@@ -4921,7 +4931,7 @@ description: NHN KCP 연동 방법을 안내합니다.
|
|
|
4921
4931
|
targetVersions:
|
|
4922
4932
|
- v2
|
|
4923
4933
|
versionVariants:
|
|
4924
|
-
v1: /opi/ko/integration/pg/v1/nhn-kcp
|
|
4934
|
+
v1: /opi/ko/integration/pg/v1/nhn-kcp/readme
|
|
4925
4935
|
---
|
|
4926
4936
|
|
|
4927
4937
|
## 채널 설정하기
|
|
@@ -5120,8 +5130,10 @@ function requestPayment() {
|
|
|
5120
5130
|
|
|
5121
5131
|
- shop\_user\_id?: string
|
|
5122
5132
|
|
|
5123
|
-
|
|
5133
|
+
**리스크 관리 조치를 위한 고객사 회원 ID**
|
|
5124
5134
|
|
|
5135
|
+
- KCP에서 부정거래를 신속하게 탐지하기 위한 파라미터입니다.
|
|
5136
|
+
- 고객사에서 관리하는 구매자의 회원 ID를 입력합니다.
|
|
5125
5137
|
- 상품권, 휴대폰 결제 시 필수로 입력해야 합니다.
|
|
5126
5138
|
|
|
5127
5139
|
- site\_name?: string
|
|
@@ -8000,7 +8012,7 @@ versionVariants:
|
|
|
8000
8012
|
- `easyPay.availableCards`
|
|
8001
8013
|
- 네이버페이는 지원하지 않습니다.
|
|
8002
8014
|
|
|
8003
|
-
### 빌링키 발급 (`
|
|
8015
|
+
### 빌링키 발급 (`requestIssueBillingKey`)
|
|
8004
8016
|
|
|
8005
8017
|
- `billingKeyMethod`
|
|
8006
8018
|
- `EASY_PAY` 로 설정해야 합니다
|
|
@@ -8050,8 +8062,8 @@ versionVariants:
|
|
|
8050
8062
|
# https://developers.portone.io/opi/ko/integration/pg/v2/nice-v2
|
|
8051
8063
|
|
|
8052
8064
|
---
|
|
8053
|
-
title:
|
|
8054
|
-
description:
|
|
8065
|
+
title: 나이스정보통신
|
|
8066
|
+
description: 나이스정보통신 결제 연동 방법을 안내합니다.
|
|
8055
8067
|
targetVersions:
|
|
8056
8068
|
- v2
|
|
8057
8069
|
versionVariants:
|
|
@@ -8061,7 +8073,7 @@ versionVariants:
|
|
|
8061
8073
|
## 채널 설정하기
|
|
8062
8074
|
|
|
8063
8075
|
- [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
|
|
8064
|
-
V2 결제 모듈을 사용하시려면
|
|
8076
|
+
V2 결제 모듈을 사용하시려면 나이스정보통신(신모듈)로 연동하셔야 합니다.
|
|
8065
8077
|
|
|
8066
8078
|
## 가능한 결제수단
|
|
8067
8079
|
|
|
@@ -8075,7 +8087,7 @@ versionVariants:
|
|
|
8075
8087
|
- 간편 결제 : `EASY_PAY`
|
|
8076
8088
|
|
|
8077
8089
|
- **결제창 빌링키 발급**
|
|
8078
|
-
- `billingKeyMethod` 파라미터를 `EASY_PAY`로 설정해야 합니다.
|
|
8090
|
+
- 결제창 빌링키 발급은 간편결제(네이버페이 / 카카오페이)만 지원하므로 `billingKeyMethod` 파라미터를 `EASY_PAY`로 설정해야 합니다.
|
|
8079
8091
|
|
|
8080
8092
|
- **API 수기(키인) 결제**
|
|
8081
8093
|
- `method`파라미터를 `card`로 설정해야 합니다.
|
|
@@ -8086,9 +8098,9 @@ versionVariants:
|
|
|
8086
8098
|
## SDK 결제 요청하기
|
|
8087
8099
|
|
|
8088
8100
|
결제 요청 시에는 `requestPayment` 함수를 호출해야 합니다.
|
|
8089
|
-
`channelKey`파라미터에 결제 채널 연동 시 생성된 채널 키값을 지정하여
|
|
8101
|
+
`channelKey`파라미터에 결제 채널 연동 시 생성된 채널 키값을 지정하여 나이스정보통신 채널 사용을 명시해주세요.
|
|
8090
8102
|
|
|
8091
|
-
|
|
8103
|
+
나이스정보통신 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
8092
8104
|
|
|
8093
8105
|
<div class="tabs-container">
|
|
8094
8106
|
|
|
@@ -8143,7 +8155,7 @@ function requestPayment() {
|
|
|
8143
8155
|
|
|
8144
8156
|
- currency: string
|
|
8145
8157
|
|
|
8146
|
-
결제통화로 원화 결제 시 `KRW`로 입력해야 합니다.
|
|
8158
|
+
결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. 나이스정보통신의 경우 `KRW`와 `USD`를 지원합니다.
|
|
8147
8159
|
|
|
8148
8160
|
- payMethod: string
|
|
8149
8161
|
|
|
@@ -8151,7 +8163,7 @@ function requestPayment() {
|
|
|
8151
8163
|
|
|
8152
8164
|
- taxFreeAmount?: number
|
|
8153
8165
|
|
|
8154
|
-
면세금액으로
|
|
8166
|
+
면세금액으로 나이스정보통신와 상점아이디 계약시 지정금액 혹은 복합과세 방식으로 계약한 경우 면세 처리를 위해 면세금액을 반드시 입력해야 합니다.
|
|
8155
8167
|
|
|
8156
8168
|
면세금액 미 입력 시 면세금액은 0원으로 자동 처리되며, 결제 요청 금액은 모두 과세 처리 되오니 이 점 유의하시기 바랍니다.
|
|
8157
8169
|
|
|
@@ -8163,7 +8175,7 @@ function requestPayment() {
|
|
|
8163
8175
|
|
|
8164
8176
|
- `card.installment.monthOption.fixedMonth`
|
|
8165
8177
|
|
|
8166
|
-
|
|
8178
|
+
나이스정보통신은 **카드사 다이렉트 호출시 고정 할부 개월수를 필수로 입력**해야 합니다. 결제
|
|
8167
8179
|
금액이 할부 지원 금액 미만(대부분 50,000원이상 할부지원이나 카드사에 따라 상이함)인 경우 **할부
|
|
8168
8180
|
개월수를 0(일시불)으로 전달**해야 합니다.
|
|
8169
8181
|
|
|
@@ -8177,15 +8189,15 @@ function requestPayment() {
|
|
|
8177
8189
|
|
|
8178
8190
|
- `giftCertificate.certificateType`
|
|
8179
8191
|
|
|
8180
|
-
|
|
8192
|
+
나이스정보통신은 컬쳐랜드만 지원하므로 상품권 결제시 항상 `CULTURELAND`로 지정해주어야 합니다.
|
|
8181
8193
|
|
|
8182
8194
|
- `bypass.nice_v2.MallUserID`
|
|
8183
8195
|
|
|
8184
|
-
|
|
8196
|
+
나이스정보통신 상품권 결제시 고객사 구매자 ID를 의미하는 MalluserID는 필수로 입력해주어야 합니다.
|
|
8185
8197
|
|
|
8186
8198
|
- `easyPay.availablePayMethods`
|
|
8187
8199
|
|
|
8188
|
-
|
|
8200
|
+
나이스정보통신를 통한 간편결제 결제 요청 시 다른 간편결제 수단과 다르게 네이버페이, SSG페이, 토스페이의
|
|
8189
8201
|
경우 어떤 방식으로 결제하느냐에 따라 availablePayMethods을 입력해야 합니다.
|
|
8190
8202
|
|
|
8191
8203
|
- 네이버페이의 경우 카드 결제인 경우 `CARD`, 포인트 혹은 머니 결제인 경우 `CHARGE` 로 입력해야
|
|
@@ -8200,9 +8212,9 @@ function requestPayment() {
|
|
|
8200
8212
|
## 결제창 빌링키 발급
|
|
8201
8213
|
|
|
8202
8214
|
빌링키 발급 요청 시에는 `requestIssueBillingKey` 함수를 호출해야 합니다.
|
|
8203
|
-
`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여
|
|
8215
|
+
`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 나이스정보통신 채널 사용을 명시해주세요.
|
|
8204
8216
|
|
|
8205
|
-
|
|
8217
|
+
나이스정보통신 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
8206
8218
|
|
|
8207
8219
|
<div class="tabs-container">
|
|
8208
8220
|
|
|
@@ -8214,7 +8226,7 @@ function requestIssueBillingKey() {
|
|
|
8214
8226
|
PortOne.requestIssueBillingKey({
|
|
8215
8227
|
storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요.
|
|
8216
8228
|
channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요.
|
|
8217
|
-
billingKeyMethod: "EASY_PAY",
|
|
8229
|
+
billingKeyMethod: "EASY_PAY", // 간편결제만 지원합니다.
|
|
8218
8230
|
issueId: "testIssueId",
|
|
8219
8231
|
issueName: "testIssueName",
|
|
8220
8232
|
customer: {
|
|
@@ -8251,21 +8263,21 @@ function requestIssueBillingKey() {
|
|
|
8251
8263
|
|
|
8252
8264
|
**빌링키 발급수단**
|
|
8253
8265
|
|
|
8254
|
-
|
|
8266
|
+
나이스정보통신은 결제창 방식으로 빌링키 발급 시 간편결제(네이버페이 / 카카오페이)만을 지원하므로 `EASY_PAY`로 설정해야 합니다.
|
|
8255
8267
|
|
|
8256
8268
|
- issueId: string
|
|
8257
8269
|
|
|
8258
8270
|
**빌링키 발급 건 고유 ID**
|
|
8259
8271
|
|
|
8260
8272
|
- 고객사에서 채번하여 사용해야 합니다.
|
|
8261
|
-
-
|
|
8273
|
+
- 나이스정보통신의 경우 필수 입력해야 합니다.
|
|
8262
8274
|
- 영문 대소문자와 숫자만 사용하여 40자 이내로 입력합니다.
|
|
8263
8275
|
|
|
8264
8276
|
- issueName: string
|
|
8265
8277
|
|
|
8266
8278
|
**빌링키 발급 시 결제창에 표시되는 제목**
|
|
8267
8279
|
|
|
8268
|
-
-
|
|
8280
|
+
- 나이스정보통신의 경우 필수 입력해야 합니다.
|
|
8269
8281
|
|
|
8270
8282
|
- customer?: object
|
|
8271
8283
|
|
|
@@ -8384,7 +8396,7 @@ const issueResponse = await axios({
|
|
|
8384
8396
|
|
|
8385
8397
|
- taxFree?: number
|
|
8386
8398
|
|
|
8387
|
-
면세 금액으로
|
|
8399
|
+
면세 금액으로 나이스정보통신과 상점아이디 계약시 지정금액 혹은 복합과세 방식으로 계약한 경우 면세 처리를 위해 면세금액을 반드시 입력해야 합니다.
|
|
8388
8400
|
면세금액 미 입력 시 면세금액은 0원으로 자동 처리되며, 결제 요청 금액은 모두 과세 처리 되오니 이 점 유의하시기 바랍니다.
|
|
8389
8401
|
|
|
8390
8402
|
- currency: string
|
|
@@ -8582,7 +8594,7 @@ const response = await axios({
|
|
|
8582
8594
|
|
|
8583
8595
|
결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
|
|
8584
8596
|
|
|
8585
|
-
|
|
8597
|
+
나이스정보통신와 지정금액 혹은 복합과세 방식으로 계약한 경우 면세금액을 반드시 입력해야 합니다.
|
|
8586
8598
|
카드 빌링키의 경우 면세금액 미입력 시 면세금액은 0원으로 자동 처리되며, 결제 요청 금액은 모두 과세 처리 되오니 이 점 유의하시기 바랍니다.
|
|
8587
8599
|
간편결제 빌링키의 경우 면세금액 미입력 시 오류가 발생합니다.
|
|
8588
8600
|
|
|
@@ -8592,13 +8604,13 @@ const response = await axios({
|
|
|
8592
8604
|
|
|
8593
8605
|
결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
|
|
8594
8606
|
|
|
8595
|
-
|
|
8607
|
+
나이스정보통신와 지정금액 혹은 복합과세 방식으로 계약한 경우 간편결제 빌링키 이용 시 부가세를 반드시 입력해야 합니다.
|
|
8596
8608
|
|
|
8597
8609
|
- currency: string
|
|
8598
8610
|
|
|
8599
8611
|
**결제 통화**
|
|
8600
8612
|
|
|
8601
|
-
결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. (신)
|
|
8613
|
+
결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. (신)나이스정보통신의 경우 빌링키로 결제시 `KRW`만 지원합니다.
|
|
8602
8614
|
|
|
8603
8615
|
- customer: object
|
|
8604
8616
|
|
|
@@ -8671,9 +8683,9 @@ const response = await axios({
|
|
|
8671
8683
|
|
|
8672
8684
|
## 연동 유의사항
|
|
8673
8685
|
|
|
8674
|
-
###
|
|
8686
|
+
### 나이스정보통신와 사전 계약이 필요한 경우
|
|
8675
8687
|
|
|
8676
|
-
아래 기능을 사용하시려면
|
|
8688
|
+
아래 기능을 사용하시려면 나이스정보통신에 사전 신청 후 계약이 완료되어야 합니다.
|
|
8677
8689
|
그렇지 않은 상태에서 해당 기능 이용시 PG창 호출에 실패하거나, 승인에 실패하거나,
|
|
8678
8690
|
승인에 성공하더라도 의도한 바와는 다른 응답을 얻게 될 수 있으니 이 점 유의하시길 바랍니다.
|
|
8679
8691
|
|
|
@@ -8722,9 +8734,9 @@ const response = await axios({
|
|
|
8722
8734
|
|비 다이렉트 호출 + 리스트 할부 개월수|`PC만 가능` |
|
|
8723
8735
|
|
|
8724
8736
|
- 토스뱅크 카드의 경우 카드사 다이렉트 호출 불가능합니다.
|
|
8725
|
-
-
|
|
8737
|
+
- 나이스정보통신의 경우 토스뱅크 카드 다이렉트 호출이 지원되지 않습니다.
|
|
8726
8738
|
|
|
8727
|
-
- 모바일 환경에서는 다이렉트 호출시에만 할부 옵션 설정이 가능합니다.
|
|
8739
|
+
- 모바일 환경에서는 다이렉트 호출시에만 할부 옵션 설정이 가능합니다. -나이스정보통신의 경우 일반
|
|
8728
8740
|
카드 결제 시(간편결제 제외) 할부 옵션(고정 할부 개월수)사용이 가능하나 **모바일 환경**에서는
|
|
8729
8741
|
**카드사 다이렉트 호출할 때만 할부 옵션 사용이 가능합니다.** 만약 모바일 환경에서 다이렉트 호출
|
|
8730
8742
|
코드 없이 할부 옵션을 전달하는 경우 무시됩니다.
|
|
@@ -8732,18 +8744,18 @@ const response = await axios({
|
|
|
8732
8744
|
### 계좌이체 일반결제 유의사항
|
|
8733
8745
|
|
|
8734
8746
|
- 계좌이체 다이렉트 호출 시 은행 코드 지정이 불가능합니다.
|
|
8735
|
-
-
|
|
8747
|
+
- 나이스정보통신의 경우 계좌이체 다이렉트 호출을 하더라도 뱅크페이가 호출되오니 이 점 유의하시기 바랍니다.
|
|
8736
8748
|
- 다이렉트 호출을 원하시는 경우 은행코드 대신 bypass 파라미터인 `DirectShowOpt`를 설정하여 사용하시길 바랍니다.
|
|
8737
8749
|
|
|
8738
8750
|
- 계좌이체 에스크로 결제시에는 다이렉트 호출이 불가능합니다.
|
|
8739
|
-
-
|
|
8751
|
+
- 나이스정보통신 정책상 에스크로를 사용한 계좌이체 결제시에는 다이렉트 호출이 불가능합니다. 아래와
|
|
8740
8752
|
같이 계좌이체 + 에스크로 + 다이렉트 호출을 위한 파라미터를 설정할 경우 "나이스페이 V2 계좌이체
|
|
8741
8753
|
에스크로 결제시 다이렉트 호출은 불가능합니다."라는 에러 메시지가 리턴되며, 결제창이 호출되지
|
|
8742
8754
|
않으니 유의하시기 바랍니다.
|
|
8743
8755
|
|
|
8744
8756
|
- 계좌이체 에스크로 결제시 결제창에 올바른 이메일을 입력해야 합니다.
|
|
8745
8757
|
- 존재하지 않는 이메일을 입력할 경우 **이메일 주소 오류**라는 에러 메시지와 함께 승인 실패됩니다.
|
|
8746
|
-
또한 실제로 존재하는 이메일 도메인이더라도
|
|
8758
|
+
또한 실제로 존재하는 이메일 도메인이더라도 나이스정보통신 정책상 유효하지 않다고 취급하는 이메일
|
|
8747
8759
|
주소((예) <ex@portone.finance>)를 입력한 경우 정상 승인되지만 **이후 에스크로 API를 이용하여 배송
|
|
8748
8760
|
정보 등록 시 에스크로 구매 확정 이메일이 전송되지 않습니다.**
|
|
8749
8761
|
|
|
@@ -8751,8 +8763,8 @@ const response = await axios({
|
|
|
8751
8763
|
|
|
8752
8764
|
### 상품권 일반결제 유의사항
|
|
8753
8765
|
|
|
8754
|
-
- 승인 완료시
|
|
8755
|
-
-
|
|
8766
|
+
- 승인 완료시 나이스정보통신로부터 승인번호(`approvalNumber`)가 전달되지 않으니 이 점 유의하시기 바랍니다.
|
|
8767
|
+
- 나이스정보통신은 상품권 결제시 별도의 승인 번호를 전달하지 않습니다. 따라서 결제 내역 조회시 승인 번호가 null로 리턴됩니다.
|
|
8756
8768
|
|
|
8757
8769
|
### 카카오페이 일반결제 유의사항
|
|
8758
8770
|
|
|
@@ -8832,9 +8844,9 @@ const response = await axios({
|
|
|
8832
8844
|
|
|
8833
8845
|
- SSGPAY 계좌 결제 시 현금영수증 발급 정보를 확인할 수 없습니다.
|
|
8834
8846
|
- SSGPAY 은행 계좌 결제 시 현금영수증 발급 정보를 입력하여 정상적으로 발급되더라도 승인
|
|
8835
|
-
완료(status: paid)시
|
|
8847
|
+
완료(status: paid)시 나이스정보통신에서 현금영수증 발급 정보를 전달하지 않아 포트원 API로
|
|
8836
8848
|
결제/현금영수증 발급 내역 조회 또는 포트원 콘솔에서 현금영수증 내역을 확인할 수 없습니다. 단,
|
|
8837
|
-
|
|
8849
|
+
나이스정보통신 어드민에서는 확인이 가능하오니 확인이 필요한 경우 나이스정보통신 어드민에서
|
|
8838
8850
|
확인하시길 바랍니다.
|
|
8839
8851
|
|
|
8840
8852
|
<details>
|
|
@@ -8873,7 +8885,7 @@ PortOne.requestPayment({
|
|
|
8873
8885
|
|
|
8874
8886
|
### API 지원 기능
|
|
8875
8887
|
|
|
8876
|
-
|
|
8888
|
+
나이스정보통신은 API를 통해 아래 기능들을 지원합니다.
|
|
8877
8889
|
|
|
8878
8890
|
- 카드 빌링키 발급
|
|
8879
8891
|
- 카드 및 간편결제 빌링키 결제
|
|
@@ -8887,9 +8899,9 @@ PortOne.requestPayment({
|
|
|
8887
8899
|
### 가상계좌 발급 API 유의사항
|
|
8888
8900
|
|
|
8889
8901
|
- 고정식 가상계좌 지원합니다.
|
|
8890
|
-
-
|
|
8902
|
+
- 나이스정보통신의 경우 API를 통한 고정식 가상계좌 사용을 지원합니다. 고정식 가상계좌를 사용하기
|
|
8891
8903
|
위해서는 `virtualAccount.option.type`를 `FIXED`로 전달해야 합니다. 단, 고정식 가상계좌 및
|
|
8892
|
-
과오납체크를 사용하도록
|
|
8904
|
+
과오납체크를 사용하도록 나이스정보통신와 사전 협의가 필요합니다.
|
|
8893
8905
|
|
|
8894
8906
|
### 에스크로 API 유의사항
|
|
8895
8907
|
|
|
@@ -8899,23 +8911,23 @@ PortOne.requestPayment({
|
|
|
8899
8911
|
- 배송지 주소인 `receiver.address` 파라미터가 필수입니다.
|
|
8900
8912
|
|
|
8901
8913
|
- 이메일 전송 여부인 `sendEmail` 파라미터가 필수입니다.
|
|
8902
|
-
-
|
|
8914
|
+
- 나이스정보통신의 경우 다른 PG에서는 지원하지 않는 `sendEmail` 파라미터를 지원합니다.
|
|
8903
8915
|
- 에스크로 구매 확정시 결제 창에 입력했던 이메일로 해당 사실을 전송할지 여부. (기본값: true | boolean type)
|
|
8904
8916
|
|
|
8905
8917
|
- 배송 정보 수정 불가합니다.
|
|
8906
|
-
-
|
|
8918
|
+
- 나이스정보통신은 API로 에스크로 배송 정보 등록은 가능하지만 **수정은 불가능**합니다.
|
|
8907
8919
|
|
|
8908
8920
|
### 현금영수증 API 유의사항
|
|
8909
8921
|
|
|
8910
8922
|
- 결제창에서 발급 받지 못한 현금영수증은 API로 발급 불가능합니다.
|
|
8911
|
-
-
|
|
8923
|
+
- 나이스정보통신의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서
|
|
8912
8924
|
현금영수증을 발급 요청할 수 있습니다. 이때 결제 승인 단계에서 현금영수증을 발급 요청하지 못한
|
|
8913
8925
|
경우, 현금영수증 발급 API(`POST /cash-receipts`)를 사용한다고 하더라도 발급이 되지 않으니 참고
|
|
8914
8926
|
부탁드립니다.
|
|
8915
8927
|
|
|
8916
8928
|
- API로 현금영수증 발급 시, 현금영수증 카드 사용이 불가능합니다.
|
|
8917
8929
|
- API로 현금영수증 발급(`POST /cash-receipts`)시 발급 받을 현금영수증 정보(현금영수증 발급 유형,
|
|
8918
|
-
현금영수증 발행 식별 정보)를 전달해야 합니다. 단,
|
|
8930
|
+
현금영수증 발행 식별 정보)를 전달해야 합니다. 단, 나이스정보통신의 경우 **발행 식별 정보 중
|
|
8919
8931
|
현금영수증 카드 번호는 사용이 불가능**하오니 참고 부탁드립니다.
|
|
8920
8932
|
|
|
8921
8933
|
|
|
@@ -8946,9 +8958,16 @@ targetVersions:
|
|
|
8946
8958
|
- 해외카드 비인증 : `PLCreditCard`
|
|
8947
8959
|
- 해외카드 인증(3DS) : `PLCreditCardMpi`
|
|
8948
8960
|
- 유니온페이 : `PLUnionPay_HC`
|
|
8949
|
-
- 위챗페이 PC
|
|
8961
|
+
- 위챗페이 PC결제 : `WeChatPayQRCodePayment`
|
|
8950
8962
|
- 위챗페이 모바일결제 : `WeChatPayH5Payment`
|
|
8951
8963
|
- 알리페이 : `ICBAlipay`
|
|
8964
|
+
- 알리페이 HK (알리페이+) : `AlipayPlusAlipayHK`
|
|
8965
|
+
- BPI (알리페이+) : `AlipayPlusBPI`
|
|
8966
|
+
- Dana (알리페이+) : `AlipayPlusDana`
|
|
8967
|
+
- GCash (알리페이+) : `AlipayPlusGcash`
|
|
8968
|
+
- Rabbit LINE Pay (알리페이+) : `AlipayPlusRabbitLinePay`
|
|
8969
|
+
- Touch 'n Go (알리페이+) : `AlipayPlusTNG`
|
|
8970
|
+
- TrueMoney (알리페이+) : `AlipayPlusTrueMoney`
|
|
8952
8971
|
|
|
8953
8972
|
## SDK 결제 요청하기
|
|
8954
8973
|
|
|
@@ -8977,12 +8996,19 @@ targetVersions:
|
|
|
8977
8996
|
빌링키 발급 및 결제 요청 시에는 [requestIssueBillingKeyAndPay](https://developers.portone.io/sdk/ko/v2-sdk/billing-key-and-pay-request?v=v2) 함수를 호출해야 합니다.
|
|
8978
8997
|
`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 페이레터 해외결제 채널 사용을 명시해주세요.
|
|
8979
8998
|
|
|
8999
|
+
## 결제수단별 승인 가능 통화
|
|
9000
|
+
|
|
9001
|
+
- 카드: `KRW`, `USD`, `JPY`
|
|
9002
|
+
- Alipay: `USD`, `CNY`
|
|
9003
|
+
- Alipay+: `USD`
|
|
9004
|
+
- WeChatPay: `KRW`, `USD`, `CNY`
|
|
9005
|
+
|
|
8980
9006
|
## 유의사항
|
|
8981
9007
|
|
|
8982
9008
|
- `paymentId` 에는 영문, 숫자만으로 이루어진 문자열만 입력할 수 있습니다.
|
|
8983
9009
|
- 페이레터의 경우 구매자 이메일을 필수로 받고있어,`customer.email`을 필수로 입력하셔야 합니다.
|
|
8984
|
-
-
|
|
8985
|
-
-
|
|
9010
|
+
- WeChatPay, Alipay, Alipay+ 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
|
|
9011
|
+
- 페이레터의 경우 결제창을 닫은 이후에 결제가 성공 처리될 수 있습니다. 웹훅을 연동하여 결제 실패 상태에서 결제 성공 상태로 바뀌는 경우를 처리해야 합니다.
|
|
8986
9012
|
|
|
8987
9013
|
|
|
8988
9014
|
# https://developers.portone.io/opi/ko/integration/pg/v2/paypal-v2
|
|
@@ -9278,33 +9304,34 @@ STC 기능을 사용하기 위해 다음 정보를 확인해 주세요.
|
|
|
9278
9304
|
// 해당 파라미터들은 예시로 산업군에 따라 추가 또는 제외 가능한 파라미터들이 있습니다.
|
|
9279
9305
|
_({
|
|
9280
9306
|
additional_data: [
|
|
9307
|
+
// 상점의 구매자 계정 기준으로 정보 입력
|
|
9281
9308
|
{
|
|
9282
|
-
key: "sender_account_id", //
|
|
9309
|
+
key: "sender_account_id", // 구매자 계정 ID
|
|
9283
9310
|
value: "A12345N343",
|
|
9284
9311
|
},
|
|
9285
9312
|
{
|
|
9286
|
-
key: "sender_first_name", //
|
|
9313
|
+
key: "sender_first_name", // 구매자 이름
|
|
9287
9314
|
value: "John",
|
|
9288
9315
|
},
|
|
9289
9316
|
{
|
|
9290
|
-
key: "sender_last_name", //
|
|
9317
|
+
key: "sender_last_name", // 구매자 성
|
|
9291
9318
|
value: "Doe",
|
|
9292
9319
|
},
|
|
9293
9320
|
{
|
|
9294
|
-
key: "sender_email", //
|
|
9321
|
+
key: "sender_email", // 구매자 이메일 주소
|
|
9295
9322
|
value: "example@example.com",
|
|
9296
9323
|
},
|
|
9297
9324
|
{
|
|
9298
|
-
key: "sender_phone", //
|
|
9325
|
+
key: "sender_phone", // 구매자 휴대전화 번호
|
|
9299
9326
|
value: "(02)16705176",
|
|
9300
9327
|
},
|
|
9301
9328
|
{
|
|
9302
|
-
key: "sender_country_code", //
|
|
9303
|
-
value: "KR", // ISO
|
|
9329
|
+
key: "sender_country_code", // 구매자 국가 코드
|
|
9330
|
+
value: "KR", // ISO 3166-2 alpha-2 코드
|
|
9304
9331
|
},
|
|
9305
9332
|
{
|
|
9306
|
-
key: "sender_create_date", //
|
|
9307
|
-
value: "2023-10-10T23:59:59+09:00", //
|
|
9333
|
+
key: "sender_create_date", // 구매자 계정 생성 시각
|
|
9334
|
+
value: "2023-10-10T23:59:59+09:00", // RFC 3339 형식
|
|
9308
9335
|
},
|
|
9309
9336
|
],
|
|
9310
9337
|
});
|
|
@@ -10748,7 +10775,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
|
|
|
10748
10775
|
페이팔은 이상 거래를 줄이기 위해 Risk Data Acquisition 정책을 시행하고 있습니다.
|
|
10749
10776
|
일반적으로 페이팔 창에서 진행되는 결제나 빌링키 발급은 페이팔이 구매자 접속 정보를 직접 확인하여 이상 거래를 판단합니다.
|
|
10750
10777
|
|
|
10751
|
-
하지만 발급된 빌링키로 브라우저에서
|
|
10778
|
+
하지만 발급된 빌링키로 브라우저에서 결제하는 경우 \[고객사 브라우저]에서 \[포트원 API]를 통해 \[페이팔 API]가 호출되는 구조로 페이팔이 구매자 접속 정보를 직접 확인할 수 없어 이상거래를 판단하기 어렵습니다.
|
|
10752
10779
|
따라서 구매자의 브라우저/디바이스 접속 정보를 페이팔에 전달해야 합니다.
|
|
10753
10780
|
때문에 브라우저에서 발급된 빌링키를 이용하여 결제를 호출하는 경우 **고객사 클라이언트 페이지에 페이팔 Fraudnet 스크립트/Magnes SDK를 반드시 추가해야** 합니다.
|
|
10754
10781
|
|
|
@@ -10813,7 +10840,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
|
|
|
10813
10840
|
|
|
10814
10841
|
- 안드로이드
|
|
10815
10842
|
|
|
10816
|
-
[**Android Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/android/) 가이드 문서에 따라 아래와 같이 collectAndSubmit
|
|
10843
|
+
[**Android Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/android/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야 합니다. 이때 두 번째 파라미터(`paypalClientMetaDataId`)로는 주문번호(`paymentId`)를 전달해야 합니다.
|
|
10817
10844
|
|
|
10818
10845
|
```java title="코드 예시"
|
|
10819
10846
|
MagnesResult magnesResult = MagnesSDK.getInstance()
|
|
@@ -10826,7 +10853,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
|
|
|
10826
10853
|
|
|
10827
10854
|
- iOS Switft
|
|
10828
10855
|
|
|
10829
|
-
[**iOS Swift SDK Integration**](http://developer.paypal.com/limited-release/magnes/integrate/ios-swift/) 가이드 문서에 따라 아래와 같이 collectAndSubmit
|
|
10856
|
+
[**iOS Swift SDK Integration**](http://developer.paypal.com/limited-release/magnes/integrate/ios-swift/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야합니다. 이때 첫번째 파라미터(withPayPalClientMetadataId)로는 주문번호(paymentId)를 전달해야 합니다.
|
|
10830
10857
|
|
|
10831
10858
|
```swift title="코드 예시"
|
|
10832
10859
|
let magnesResult: MagnesResult =
|
|
@@ -10838,7 +10865,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
|
|
|
10838
10865
|
|
|
10839
10866
|
- iOS Objective-C
|
|
10840
10867
|
|
|
10841
|
-
[**iOS Objective-C SDK Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/ios-objective-c/) 가이드 문서에 따라 아래와 같이 collectAndSubmitWithPayPalClientMetadataId
|
|
10868
|
+
[**iOS Objective-C SDK Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/ios-objective-c/) 가이드 문서에 따라 아래와 같이 collectAndSubmitWithPayPalClientMetadataId 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야 합니다. 이때 첫번째 파라미터(YOUR-PAYPAL-CLIENT-METADATA-ID)로는 주문번호(paymentId)를 전달해주시면 됩니다.
|
|
10842
10869
|
|
|
10843
10870
|
```objc title="코드 예시"
|
|
10844
10871
|
//PPRMOCMagnesSDK *magnesSDK = [PPRMOCMagnesSDK shared];
|
|
@@ -10916,7 +10943,7 @@ versionVariants:
|
|
|
10916
10943
|
- 결제창/API 정기결제 : 카드
|
|
10917
10944
|
- 간편결제 허브형 : 카카오페이 / 네이버페이 / 페이코 / LPay / 핀페이
|
|
10918
10945
|
|
|
10919
|
-
-
|
|
10946
|
+
- **나이스정보통신**
|
|
10920
10947
|
|
|
10921
10948
|
- 연동 기능: 인증결제(결제창) / 비인증결제(API) / 정기결제(API) / 간편결제(결제창/다이렉트 호출)
|
|
10922
10949
|
|
|
@@ -11005,14 +11032,6 @@ versionVariants:
|
|
|
11005
11032
|
|
|
11006
11033
|
- 간편결제 : 토스페이
|
|
11007
11034
|
|
|
11008
|
-
- **하이픈**
|
|
11009
|
-
|
|
11010
|
-
- 연동 기능 : 간편결제(결제창)
|
|
11011
|
-
|
|
11012
|
-
- 결제 수단
|
|
11013
|
-
|
|
11014
|
-
- 간편결제 : 바로계좌결제
|
|
11015
|
-
|
|
11016
11035
|
#### 해외결제
|
|
11017
11036
|
|
|
11018
11037
|
- **페이팔**
|
|
@@ -11272,7 +11291,7 @@ function requestPayment() {
|
|
|
11272
11291
|
|
|
11273
11292
|
## SDK 빌링키 발급 요청하기
|
|
11274
11293
|
|
|
11275
|
-
빌링키 발급 요청 시에는 `
|
|
11294
|
+
빌링키 발급 요청 시에는 `requestIssueBillingKey` 함수를 호출해야 합니다.
|
|
11276
11295
|
`channelKey`파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 스마트로 채널 사용을 명시해주세요.
|
|
11277
11296
|
|
|
11278
11297
|
스마트로 기준으로 작성한 예시 코드는 아래와 같습니다.
|
|
@@ -12767,7 +12786,7 @@ async function schedulePayment() {
|
|
|
12767
12786
|
- 상품권 결제 요청 시, 사용하고자 하는 상품권 종류에 따라 아래 목록을 참고하여 `giftCertificateType` 파라미터를 입력해야 합니다.
|
|
12768
12787
|
- 도서문화상품권 : `BOOKNLIFE`
|
|
12769
12788
|
- 스마트문상 ((구)게임문화상품권) : `SMART_MUNSANG`
|
|
12770
|
-
- 문화상품권 : `CULTURELAND`
|
|
12789
|
+
- 컬쳐랜드 문화상품권 : `CULTURELAND`
|
|
12771
12790
|
|
|
12772
12791
|
- `paymentId`
|
|
12773
12792
|
- 토스페이먼츠를 사용하는 경우 영문 대소문자, 숫자, 특수문자(-,\_)만 허용되며, 6자 이상 64자 이하만 가능합니다.
|
|
@@ -13325,13 +13344,13 @@ function requestPayment() {
|
|
|
13325
13344
|
|
|
13326
13345
|
**PC - 카드 결제 전용 파라미터**
|
|
13327
13346
|
|
|
13328
|
-
|형식 |설명
|
|
13329
|
-
|
|
13330
|
-
|SKIN(색상코드) |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d)
|
|
13331
|
-
|below1000 |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음
|
|
13332
|
-
|paypopup |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어
|
|
13333
|
-
|onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay`|
|
|
13334
|
-
|SLIMQUOTA(슬림 할부 설정) |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3)
|
|
13347
|
+
|형식 |설명 |
|
|
13348
|
+
|---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
13349
|
+
|SKIN(색상코드) |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d) |
|
|
13350
|
+
|below1000 |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음 |
|
|
13351
|
+
|paypopup |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어 |
|
|
13352
|
+
|onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay` <br /> - 네이버페이: `npay`|
|
|
13353
|
+
|SLIMQUOTA(슬림 할부 설정) |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3) |
|
|
13335
13354
|
|
|
13336
13355
|
**PC - 휴대폰 소액 결제 전용 파라미터**
|
|
13337
13356
|
|
|
@@ -13502,6 +13521,7 @@ SDK를 통한 결제 요청 파라미터에는 부가세를 지정할 수 있는
|
|
|
13502
13521
|
- lpay: `LPAY`
|
|
13503
13522
|
- 토스페이: `TOSSPAY`
|
|
13504
13523
|
- 페이코: `PAYCO`
|
|
13524
|
+
- 네이버페이: `NAVERPAY`
|
|
13505
13525
|
|
|
13506
13526
|
</details>
|
|
13507
13527
|
|
|
@@ -14588,7 +14608,7 @@ versionVariants:
|
|
|
14588
14608
|
브라우저에서 포트원 SDK를 호출하여 빌링키를 발급하고, 서버로 빌링키를 전달합니다.
|
|
14589
14609
|
|
|
14590
14610
|
```ts
|
|
14591
|
-
const issueResponse = PortOne.requestIssueBillingKey({
|
|
14611
|
+
const issueResponse = await PortOne.requestIssueBillingKey({
|
|
14592
14612
|
storeId: "store-9bf6076d-beef-4729-9521-ae66c14e0569",
|
|
14593
14613
|
channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d",
|
|
14594
14614
|
billingKeyMethod: "CARD",
|
|
@@ -14964,7 +14984,8 @@ async function requestPayment() {
|
|
|
14964
14984
|
}
|
|
14965
14985
|
```
|
|
14966
14986
|
|
|
14967
|
-
결과값에 들어 있는 필드는 다음과 같습니다.
|
|
14987
|
+
결과값에 들어 있는 주요 필드는 다음과 같습니다.
|
|
14988
|
+
전체 필드 목록은 [requestPayment 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/payment-response)을 참조해 주시기 바랍니다.
|
|
14968
14989
|
|
|
14969
14990
|
|필드명 |설명 |비고 |
|
|
14970
14991
|
|---------|-------------------|----------------------------|
|
|
@@ -14987,7 +15008,8 @@ PortOne.requestPayment({
|
|
|
14987
15008
|
});
|
|
14988
15009
|
```
|
|
14989
15010
|
|
|
14990
|
-
쿼리 문자열로 전달되는
|
|
15011
|
+
쿼리 문자열로 전달되는 주요 필드는 다음과 같습니다.
|
|
15012
|
+
전체 필드 목록은 [requestPayment 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/payment-response)을 참조해 주시기 바랍니다.
|
|
14991
15013
|
|
|
14992
15014
|
|키 |설명 |비고 |
|
|
14993
15015
|
|---------|-------------------|----------------------------|
|
|
@@ -15204,7 +15226,7 @@ V2는 모든 데이터를 수집하고 기록합니다. [Event Sourcing](https:/
|
|
|
15204
15226
|
|
|
15205
15227
|
### 기능 확장: 신속한 업데이트와 혁신
|
|
15206
15228
|
|
|
15207
|
-
V2는 최신 결제 기능을 가장 빠르게 제공합니다.
|
|
15229
|
+
V2는 최신 결제 기능을 가장 빠르게 제공합니다.
|
|
15208
15230
|
최신 기능을 통해 결제 프로세스를 혁신하고, 고객의 결제 경험을 향상시킬 수 있습니다.
|
|
15209
15231
|
|
|
15210
15232
|
## 사용 가능한 PG사
|
|
@@ -15218,13 +15240,12 @@ V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될
|
|
|
15218
15240
|
- **카카오페이**
|
|
15219
15241
|
- **네이버페이**
|
|
15220
15242
|
- **스마트로**
|
|
15221
|
-
-
|
|
15243
|
+
- **나이스정보통신**
|
|
15222
15244
|
- **페이팔**
|
|
15223
15245
|
- **KG이니시스**
|
|
15224
15246
|
- **한국결제네트웍스(KPN)**
|
|
15225
15247
|
- **NHN KCP**
|
|
15226
15248
|
- **토스페이**
|
|
15227
|
-
- **하이픈 바로계좌결제**
|
|
15228
15249
|
|
|
15229
15250
|
### 본인인증
|
|
15230
15251
|
|
|
@@ -15257,8 +15278,6 @@ versionVariants:
|
|
|
15257
15278
|
v1: /opi/ko/integration/webhook/readme-v1
|
|
15258
15279
|
---
|
|
15259
15280
|
|
|
15260
|
-
(관련 이미지 첨부)
|
|
15261
|
-
|
|
15262
15281
|
## 웹훅(Webhook) 이란?
|
|
15263
15282
|
|
|
15264
15283
|
특정 이벤트가 발생하였을 때 타 서비스나 응용프로그램으로 알림을 보내는 기능입니다.
|
|
@@ -15298,7 +15317,7 @@ Webhook을 활용하면 커스텀 기능이나 다른 애플리케이션과 연
|
|
|
15298
15317
|
- `Transaction.PartialCancelled`: **결제가 부분 취소**되었을 때
|
|
15299
15318
|
- `Transaction.Cancelled`: **결제가 완전 취소**되었을 때
|
|
15300
15319
|
- `Transaction.Failed`: **결제(예약 결제 포함)가 실패**했을 때
|
|
15301
|
-
- `Transaction.PayPending`: **결제 승인 대기** 상태가 되었을 때 (
|
|
15320
|
+
- `Transaction.PayPending`: **결제 승인 대기** 상태가 되었을 때 (페이팔에서 발생 가능)
|
|
15302
15321
|
- `Transaction.CancelPending`: (결제 취소가 비동기로 수행되는 경우) **결제 취소를 요청**했을 때
|
|
15303
15322
|
- `Transaction.DisputeCreated`: **분쟁이 발생**되었을 때
|
|
15304
15323
|
- `Transaction.DisputeResolved`: **분쟁이 해소**되었을 때
|
|
@@ -15379,7 +15398,7 @@ Webhook을 활용하면 커스텀 기능이나 다른 애플리케이션과 연
|
|
|
15379
15398
|
- `PartialCancelled`: **결제가 부분 취소**되었을 때
|
|
15380
15399
|
- `Cancelled`: **결제가 완전 취소**되었을 때
|
|
15381
15400
|
- `Failed`: **결제(예약 결제 포함)가 실패**했을 때
|
|
15382
|
-
- `PayPending`: **결제 승인 대기** 상태가 되었을 때 (
|
|
15401
|
+
- `PayPending`: **결제 승인 대기** 상태가 되었을 때 (페이팔에서 발생 가능)
|
|
15383
15402
|
- `CancelPending`: (결제 취소가 비동기로 수행되는 경우) **결제 취소를 요청**했을 때
|
|
15384
15403
|
|
|
15385
15404
|
웹훅 payload 예시:
|
|
@@ -15834,7 +15853,7 @@ Connection Timeout 및 Read Timeout 모두 30초 입니다.
|
|
|
15834
15853
|
|
|
15835
15854
|
**웹훅 처리 전에 브라우저 결제 완료 처리가 진행되는 경우**
|
|
15836
15855
|
|
|
15837
|
-
기본적으로 포트원 서버는 웹훅을 호출한 뒤 고객사 응답을 기다리지 않고 브라우저에 302 redirect 응답을 보내기 때문에 결과 도달에 대한 순서를 보장하지 않습니다. 다만 고객사 요청이 있을 경우 webhook 호출 이후에 브라우저에 302 redirect 또는 callback 응답을 보내어 순서를 보장해 드리고 있습니다. 웹훅 우선순위 요청은 <support@portone.io> 로
|
|
15856
|
+
기본적으로 포트원 서버는 웹훅을 호출한 뒤 고객사 응답을 기다리지 않고 브라우저에 302 redirect 응답을 보내기 때문에 결과 도달에 대한 순서를 보장하지 않습니다. 다만 고객사 요청이 있을 경우 webhook 호출 이후에 브라우저에 302 redirect 또는 callback 응답을 보내어 순서를 보장해 드리고 있습니다. 웹훅 우선순위 요청은 <tech.support@portone.io> 로 상점 아이디(storeId)를 기재하여 요청해 주시면 됩니다.
|
|
15838
15857
|
|
|
15839
15858
|
</div>
|
|
15840
15859
|
|
|
@@ -16017,16 +16036,6 @@ ni @portone/browser-sdk
|
|
|
16017
16036
|
|
|
16018
16037
|
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'inicis' END -->
|
|
16019
16038
|
|
|
16020
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' START -->
|
|
16021
|
-
|
|
16022
|
-
<div class="hint" data-style="warning">
|
|
16023
|
-
|
|
16024
|
-
하이픈의 경우 영문 대소문자, 숫자, `_`만 허용되며, 50자 이하로 입력합니다.
|
|
16025
|
-
|
|
16026
|
-
</div>
|
|
16027
|
-
|
|
16028
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' END -->
|
|
16029
|
-
|
|
16030
16039
|
- orderName: string
|
|
16031
16040
|
|
|
16032
16041
|
**주문명**
|
|
@@ -16037,7 +16046,7 @@ ni @portone/browser-sdk
|
|
|
16037
16046
|
|
|
16038
16047
|
<div class="hint" data-style="warning">
|
|
16039
16048
|
|
|
16040
|
-
|
|
16049
|
+
나이스정보통신의 경우 최대 40바이트까지 입력할 수 있으며, 사용 가능한 특수문자는 아래와 같습니다.
|
|
16041
16050
|
|
|
16042
16051
|
- 사용 가능: `_`
|
|
16043
16052
|
- 사용 불가: `% & | $ - + = [ ]`
|
|
@@ -16098,16 +16107,6 @@ ni @portone/browser-sdk
|
|
|
16098
16107
|
|
|
16099
16108
|
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'naver' END -->
|
|
16100
16109
|
|
|
16101
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' START -->
|
|
16102
|
-
|
|
16103
|
-
<div class="hint" data-style="warning">
|
|
16104
|
-
|
|
16105
|
-
하이픈의 경우 최대 1000바이트까지 입력할 수 있습니다.
|
|
16106
|
-
|
|
16107
|
-
</div>
|
|
16108
|
-
|
|
16109
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' END -->
|
|
16110
|
-
|
|
16111
16110
|
- totalAmount: number
|
|
16112
16111
|
|
|
16113
16112
|
**결제 금액**
|
|
@@ -16141,7 +16140,7 @@ ni @portone/browser-sdk
|
|
|
16141
16140
|
|
|
16142
16141
|
<div class="hint" data-style="warning">
|
|
16143
16142
|
|
|
16144
|
-
|
|
16143
|
+
나이스정보통신은 `KRW`만을 지원합니다.
|
|
16145
16144
|
|
|
16146
16145
|
</div>
|
|
16147
16146
|
|
|
@@ -16337,11 +16336,11 @@ ni @portone/browser-sdk
|
|
|
16337
16336
|
|
|
16338
16337
|
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'kcp' END -->
|
|
16339
16338
|
|
|
16340
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => ['kakao', 'naver', 'tosspay'
|
|
16339
|
+
<!-- CONDITIONAL CONTENT pgName=(name) => ['kakao', 'naver', 'tosspay'].includes(name) START -->
|
|
16341
16340
|
|
|
16342
16341
|
- 간편결제: `EASY_PAY`
|
|
16343
16342
|
|
|
16344
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => ['kakao', 'naver', 'tosspay'
|
|
16343
|
+
<!-- CONDITIONAL CONTENT pgName=(name) => ['kakao', 'naver', 'tosspay'].includes(name) END -->
|
|
16345
16344
|
|
|
16346
16345
|
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'eximbay' START -->
|
|
16347
16346
|
|
|
@@ -16379,7 +16378,7 @@ ni @portone/browser-sdk
|
|
|
16379
16378
|
|
|
16380
16379
|
<div class="hint" data-style="warning">
|
|
16381
16380
|
|
|
16382
|
-
|
|
16381
|
+
나이스정보통신의 경우 카드사 단독 노출 시 `card.installment.monthOption.fixedMonth`를 필수로 지정해야 합니다.
|
|
16383
16382
|
결제 금액이 할부 지원 금액 미만인 경우 할부 개월 수를 `0`으로 전달해야 합니다.
|
|
16384
16383
|
|
|
16385
16384
|
</div>
|
|
@@ -16677,7 +16676,7 @@ ni @portone/browser-sdk
|
|
|
16677
16676
|
|
|
16678
16677
|
<div class="hint" data-style="warning">
|
|
16679
16678
|
|
|
16680
|
-
|
|
16679
|
+
나이스정보통신의 경우 카드사 포인트 사용 시 별도 계약이 필요합니다.
|
|
16681
16680
|
|
|
16682
16681
|
</div>
|
|
16683
16682
|
|
|
@@ -16900,7 +16899,7 @@ ni @portone/browser-sdk
|
|
|
16900
16899
|
|
|
16901
16900
|
<div class="hint" data-style="warning">
|
|
16902
16901
|
|
|
16903
|
-
|
|
16902
|
+
나이스정보통신의 경우 입금 만료기한을 필수로 입력해야 합니다.
|
|
16904
16903
|
|
|
16905
16904
|
</div>
|
|
16906
16905
|
|
|
@@ -17067,7 +17066,7 @@ ni @portone/browser-sdk
|
|
|
17067
17066
|
|
|
17068
17067
|
<div class="hint" data-style="warning">
|
|
17069
17068
|
|
|
17070
|
-
|
|
17069
|
+
나이스정보통신의 경우 상품권 유형을 필수로 지정해야 합니다.s
|
|
17071
17070
|
|
|
17072
17071
|
</div>
|
|
17073
17072
|
|
|
@@ -17091,19 +17090,19 @@ ni @portone/browser-sdk
|
|
|
17091
17090
|
|
|
17092
17091
|
- `BOOKNLIFE` (도서문화상품권)
|
|
17093
17092
|
- `SMART_MUNSANG` (스마트문상, (구)게임문화상품권)
|
|
17094
|
-
- `CULTURELAND` (문화상품권)
|
|
17093
|
+
- `CULTURELAND` (컬쳐랜드 문화상품권)
|
|
17095
17094
|
|
|
17096
17095
|
<!-- CONDITIONAL CONTENT pgName=(name) => ['toss', 'inicis'].includes(name) END -->
|
|
17097
17096
|
|
|
17098
17097
|
<!-- CONDITIONAL CONTENT pgName=(name) => name === "nice" START -->
|
|
17099
17098
|
|
|
17100
|
-
- `CULTURELAND` (문화상품권)
|
|
17099
|
+
- `CULTURELAND` (컬쳐랜드 문화상품권)
|
|
17101
17100
|
|
|
17102
17101
|
<!-- CONDITIONAL CONTENT pgName=(name) => name === "nice" END -->
|
|
17103
17102
|
|
|
17104
17103
|
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'kcp' START -->
|
|
17105
17104
|
|
|
17106
|
-
- `CULTURELAND` (문화상품권)
|
|
17105
|
+
- `CULTURELAND` (컬쳐랜드 문화상품권)
|
|
17107
17106
|
- `BOOKNLIFE` (도서문화상품권)
|
|
17108
17107
|
|
|
17109
17108
|
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'kcp' END -->
|
|
@@ -17120,7 +17119,7 @@ ni @portone/browser-sdk
|
|
|
17120
17119
|
|
|
17121
17120
|
`payMethod`가 `EASY_PAY`인 경우 간편결제와 관련한 추가 정보를 입력할 수 있습니다.
|
|
17122
17121
|
|
|
17123
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => !['kakao', 'naver', 'tosspay'
|
|
17122
|
+
<!-- CONDITIONAL CONTENT pgName=(name) => !['kakao', 'naver', 'tosspay'].includes(name) START -->
|
|
17124
17123
|
|
|
17125
17124
|
- easyPayProvider?: string
|
|
17126
17125
|
|
|
@@ -17251,7 +17250,7 @@ ni @portone/browser-sdk
|
|
|
17251
17250
|
|
|
17252
17251
|
</details>
|
|
17253
17252
|
|
|
17254
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => !['kakao', 'naver', 'tosspay'
|
|
17253
|
+
<!-- CONDITIONAL CONTENT pgName=(name) => !['kakao', 'naver', 'tosspay'].includes(name) END -->
|
|
17255
17254
|
|
|
17256
17255
|
<!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'ksnet'].includes(name) START -->
|
|
17257
17256
|
|
|
@@ -17263,7 +17262,7 @@ ni @portone/browser-sdk
|
|
|
17263
17262
|
|
|
17264
17263
|
<div class="hint" data-style="warning">
|
|
17265
17264
|
|
|
17266
|
-
|
|
17265
|
+
나이스정보통신의 경우 카카오페이, 네이버페이, 애플페이, LPAY 사용 시 상점분담 무이자를 사용하실 수 없습니다.
|
|
17267
17266
|
|
|
17268
17267
|
</div>
|
|
17269
17268
|
|
|
@@ -17279,7 +17278,7 @@ ni @portone/browser-sdk
|
|
|
17279
17278
|
|
|
17280
17279
|
<!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis'].includes(name) END -->
|
|
17281
17280
|
|
|
17282
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'naver', 'tosspay'
|
|
17281
|
+
<!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'naver', 'tosspay'].includes(name) START -->
|
|
17283
17282
|
|
|
17284
17283
|
- availableCards?: string\[]
|
|
17285
17284
|
|
|
@@ -17388,7 +17387,7 @@ ni @portone/browser-sdk
|
|
|
17388
17387
|
|
|
17389
17388
|
</details>
|
|
17390
17389
|
|
|
17391
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'naver', 'tosspay'
|
|
17390
|
+
<!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'naver', 'tosspay'].includes(name) END -->
|
|
17392
17391
|
|
|
17393
17392
|
<!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'naverpay'].includes(name) START -->
|
|
17394
17393
|
|
|
@@ -17400,7 +17399,7 @@ ni @portone/browser-sdk
|
|
|
17400
17399
|
|
|
17401
17400
|
<div class="hint" data-style="warning">
|
|
17402
17401
|
|
|
17403
|
-
|
|
17402
|
+
나이스정보통신의 경우 할부 사용 시 별도 계약이 필요합니다.
|
|
17404
17403
|
|
|
17405
17404
|
</div>
|
|
17406
17405
|
|
|
@@ -17523,7 +17522,7 @@ ni @portone/browser-sdk
|
|
|
17523
17522
|
|
|
17524
17523
|
<div class="hint" data-style="warning">
|
|
17525
17524
|
|
|
17526
|
-
|
|
17525
|
+
나이스정보통신의 경우 일부 간편결제 수단에 대해 `availablePayMethods`가 필수입니다.
|
|
17527
17526
|
|
|
17528
17527
|
- 네이버페이: 카드 결제인 경우 `CARD`, 포인트 혹은 머니 결제인 경우 `CHARGE`를 입력합니다.
|
|
17529
17528
|
- SSG페이: 계좌 결제를 노출하는 `TRANSFER`만 유효하며, 카드 혹은 머니 결제인 경우 `availablePayMethods`를 생략해야 합니다.
|
|
@@ -17559,7 +17558,7 @@ ni @portone/browser-sdk
|
|
|
17559
17558
|
|
|
17560
17559
|
<div class="hint" data-style="warning">
|
|
17561
17560
|
|
|
17562
|
-
|
|
17561
|
+
나이스정보통신와 계약 시 지정된 면세금액을 반드시 입력해야 합니다.
|
|
17563
17562
|
|
|
17564
17563
|
</div>
|
|
17565
17564
|
|
|
@@ -17672,16 +17671,6 @@ ni @portone/browser-sdk
|
|
|
17672
17671
|
|
|
17673
17672
|
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'naver' END -->
|
|
17674
17673
|
|
|
17675
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' START -->
|
|
17676
|
-
|
|
17677
|
-
<div class="hint" data-style="warning">
|
|
17678
|
-
|
|
17679
|
-
하이픈의 경우 구매자 이름을 필수로 입력해야 합니다.
|
|
17680
|
-
|
|
17681
|
-
</div>
|
|
17682
|
-
|
|
17683
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' END -->
|
|
17684
|
-
|
|
17685
17674
|
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'eximbay' START -->
|
|
17686
17675
|
|
|
17687
17676
|
<div class="hint" data-style="warning">
|
|
@@ -17843,7 +17832,7 @@ ni @portone/browser-sdk
|
|
|
17843
17832
|
|
|
17844
17833
|
<div class="hint" data-style="warning">
|
|
17845
17834
|
|
|
17846
|
-
|
|
17835
|
+
나이스정보통신와 별도 계약이 필요합니다.
|
|
17847
17836
|
|
|
17848
17837
|
</div>
|
|
17849
17838
|
|
|
@@ -17868,7 +17857,7 @@ ni @portone/browser-sdk
|
|
|
17868
17857
|
|
|
17869
17858
|
<div class="hint" data-style="warning">
|
|
17870
17859
|
|
|
17871
|
-
|
|
17860
|
+
나이스정보통신와 별도 계약이 필요합니다.
|
|
17872
17861
|
|
|
17873
17862
|
</div>
|
|
17874
17863
|
|
|
@@ -17909,7 +17898,7 @@ ni @portone/browser-sdk
|
|
|
17909
17898
|
|
|
17910
17899
|
<div class="hint" data-style="warning">
|
|
17911
17900
|
|
|
17912
|
-
|
|
17901
|
+
나이스정보통신와 별도 계약이 필요합니다.
|
|
17913
17902
|
|
|
17914
17903
|
</div>
|
|
17915
17904
|
|
|
@@ -17921,7 +17910,7 @@ ni @portone/browser-sdk
|
|
|
17921
17910
|
|
|
17922
17911
|
<div class="hint" data-style="warning">
|
|
17923
17912
|
|
|
17924
|
-
|
|
17913
|
+
나이스정보통신와 별도 계약이 필요합니다.
|
|
17925
17914
|
|
|
17926
17915
|
</div>
|
|
17927
17916
|
|
|
@@ -17936,7 +17925,7 @@ ni @portone/browser-sdk
|
|
|
17936
17925
|
|
|
17937
17926
|
<div class="hint" data-style="warning">
|
|
17938
17927
|
|
|
17939
|
-
|
|
17928
|
+
나이스정보통신와 별도 계약이 필요합니다.
|
|
17940
17929
|
|
|
17941
17930
|
</div>
|
|
17942
17931
|
|
|
@@ -18214,18 +18203,6 @@ ni @portone/browser-sdk
|
|
|
18214
18203
|
|
|
18215
18204
|
<!-- CONDITIONAL CONTENT pgName=(name) => name === "tosspay" END -->
|
|
18216
18205
|
|
|
18217
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => name === "hyphen" START -->
|
|
18218
|
-
|
|
18219
|
-
- hyphen?: object
|
|
18220
|
-
|
|
18221
|
-
- designCd?: string
|
|
18222
|
-
|
|
18223
|
-
**결제창 디자인 코드**
|
|
18224
|
-
|
|
18225
|
-
`#`으로 시작하는 여섯 자리 16진수 코드입니다.
|
|
18226
|
-
|
|
18227
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => name === "hyphen" END -->
|
|
18228
|
-
|
|
18229
18206
|
<!-- CONDITIONAL CONTENT pgName=(name) => name === "eximbay" START -->
|
|
18230
18207
|
|
|
18231
18208
|
- eximbay?: object
|
|
@@ -18577,16 +18554,6 @@ ni @portone/browser-sdk
|
|
|
18577
18554
|
|
|
18578
18555
|
**상점 사업자명**
|
|
18579
18556
|
|
|
18580
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' START -->
|
|
18581
|
-
|
|
18582
|
-
<div class="hint" data-style="warning">
|
|
18583
|
-
|
|
18584
|
-
하이픈의 경우 미입력 시 대표상점명으로 설정됩니다.
|
|
18585
|
-
|
|
18586
|
-
</div>
|
|
18587
|
-
|
|
18588
|
-
<!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' END -->
|
|
18589
|
-
|
|
18590
18557
|
- businessRegistrationNumber?: string
|
|
18591
18558
|
|
|
18592
18559
|
**상점 사업자 번호**
|
|
@@ -18627,7 +18594,7 @@ ni @portone/browser-sdk
|
|
|
18627
18594
|
|
|
18628
18595
|
<div class="hint" data-style="warning">
|
|
18629
18596
|
|
|
18630
|
-
|
|
18597
|
+
나이스정보통신의 경우 에스크로 사용 시 별도 계약이 필요합니다.
|
|
18631
18598
|
|
|
18632
18599
|
</div>
|
|
18633
18600
|
|
|
@@ -20070,7 +20037,7 @@ targetVersions:
|
|
|
20070
20037
|
|
|
20071
20038
|
- 결제대행사 필터는 하나의 결제대행사에 모든 `pg_provider`가 포함됩니다.
|
|
20072
20039
|
- KG이니시스 : inicis, html5\_inicis, inicis\_v2
|
|
20073
|
-
-
|
|
20040
|
+
- 나이스정보통신 : nice, nice\_v2
|
|
20074
20041
|
- 페이팔 : paypal, paypal\_v2
|
|
20075
20042
|
- 스마트로 : smartro, smartro\_v2
|
|
20076
20043
|
- 토스페이 : tosspay, tosspay\_v2
|
|
@@ -21340,7 +21307,7 @@ description: 결제대행사 및 결제수단을 선택하고 전자결제를
|
|
|
21340
21307
|
|
|
21341
21308
|
- [V2 연동 매뉴얼 바로가기](https://developers.portone.io/opi/ko/integration/ready/readme?v=v2)
|
|
21342
21309
|
|
|
21343
|
-
- 연동과 관련하여 궁금하신 사항은 **포트원 기술지원 이메일 <support@portone.io>**
|
|
21310
|
+
- 연동과 관련하여 궁금하신 사항은 **포트원 기술지원 이메일 <tech.support@portone.io>**
|
|
21344
21311
|
또는 채널톡으로 문의 주시기 바랍니다.
|
|
21345
21312
|
|
|
21346
21313
|
|
|
@@ -21356,9 +21323,9 @@ description: >-
|
|
|
21356
21323
|
## PG 거래대사 유의사항
|
|
21357
21324
|
|
|
21358
21325
|
- 포트원을 통해 연동된 아래 12개의 PG사 내역을 조회할 수 있습니다.
|
|
21359
|
-
- 지원 PG : **KCP, KG이니시스,
|
|
21326
|
+
- 지원 PG : **KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜**
|
|
21360
21327
|
- 고객사가 포트원을 통하지 않고 PG 직연동한 경우 지원 불가
|
|
21361
|
-
- 9/26 이후 지원 예정 PG사 : KPN,
|
|
21328
|
+
- 9/26 이후 지원 예정 PG사 : KPN, KSNET
|
|
21362
21329
|
|
|
21363
21330
|
- 고객사 주문번호를 정확하게 확인하기 위해서는 **실제 사용하시는 주문번호의 연동**이 필요합니다.
|
|
21364
21331
|
|
|
@@ -22572,7 +22539,7 @@ targetVersions:
|
|
|
22572
22539
|
## 프로모션이란?
|
|
22573
22540
|
|
|
22574
22541
|
고객사가 카드사와 계약하여 사용자에게 즉시 할인을 제공하는 **카드 즉시 할인 서비스**를 운영하고 관리할
|
|
22575
|
-
수 있는
|
|
22542
|
+
수 있는 서비스입니다.
|
|
22576
22543
|
|
|
22577
22544
|
카드 즉시 할인 서비스를 이용시 필요한 **프로모션 관리 시스템**과 **프로모션 정산 대사 시스템** 을 제공합니다.
|
|
22578
22545
|
포트원 콘솔에서 기간, 할인 조건, 예산 등 다양한 옵션의 프로모션을 설정할 수 있으며,
|
|
@@ -22918,7 +22885,7 @@ async function cancelPayment() {
|
|
|
22918
22885
|
|
|
22919
22886
|
---
|
|
22920
22887
|
title: 스마트 라우팅 - 콘솔 가이드
|
|
22921
|
-
description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화
|
|
22888
|
+
description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
|
|
22922
22889
|
targetVersions:
|
|
22923
22890
|
- v1
|
|
22924
22891
|
- v2
|
|
@@ -22995,7 +22962,7 @@ targetVersions:
|
|
|
22995
22962
|
|
|
22996
22963
|
---
|
|
22997
22964
|
title: 스마트 라우팅 - 연동하기
|
|
22998
|
-
description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화
|
|
22965
|
+
description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
|
|
22999
22966
|
targetVersions:
|
|
23000
22967
|
- v1
|
|
23001
22968
|
- v2
|
|
@@ -24308,7 +24275,7 @@ if (!issueResponse.ok)
|
|
|
24308
24275
|
사용 가능한 빌링키가 없는 경우 그룹 내 채널 비율이 0으로 설정되어있더라도 해당 결제대행사로 결제가
|
|
24309
24276
|
일어날 수 있습니다.
|
|
24310
24277
|
|
|
24311
|
-
예를 들어, 그룹 내에
|
|
24278
|
+
예를 들어, 그룹 내에 나이스정보통신, KG이니시스, 토스페이먼츠 총 3개의 결제대행사를 설정한 경우 빌링키
|
|
24312
24279
|
발급 시 3개의 결제대행사로부터 빌링키를 발급 받은 후 슈퍼 빌링키에 맵핑 됩니다.
|
|
24313
24280
|
이후 그룹 설정을 토스페이먼츠 0%, 스마트로 100%로 변경한 경우 위에 발급한 슈퍼 빌링키로 결제 요청 시
|
|
24314
24281
|
토스페이먼츠 빌링키만 사용이 가능하기 때문에 0%로 결제 비율이 설정되어있음에도 토스페이먼츠로 결제가
|
|
@@ -24323,7 +24290,7 @@ if (!issueResponse.ok)
|
|
|
24323
24290
|
|
|
24324
24291
|
---
|
|
24325
24292
|
title: 스마트 라우팅
|
|
24326
|
-
description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화
|
|
24293
|
+
description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
|
|
24327
24294
|
targetVersions:
|
|
24328
24295
|
- v1
|
|
24329
24296
|
- v2
|
|
@@ -24354,8 +24321,8 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
24354
24321
|
|
|
24355
24322
|
### 결제창(SDK) 인증결제
|
|
24356
24323
|
|
|
24357
|
-
-
|
|
24358
|
-
- **(구)
|
|
24324
|
+
- **나이스정보통신(신모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
24325
|
+
- **(구) 나이스정보통신** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
24359
24326
|
- **NHN KCP** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
24360
24327
|
- **KG 이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
24361
24328
|
- **토스페이먼츠(신모듈)** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
@@ -24370,11 +24337,10 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
24370
24337
|
- **이지페이(KICC)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
24371
24338
|
- **웰컴페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
24372
24339
|
- **엑심베이** : 카드
|
|
24373
|
-
- **하이픈** : 실시간 계좌이체
|
|
24374
24340
|
|
|
24375
24341
|
### API 수기(키인)결제
|
|
24376
24342
|
|
|
24377
|
-
-
|
|
24343
|
+
- **나이스정보통신(신모듈)** : 카드
|
|
24378
24344
|
- **NHN KCP** : 카드
|
|
24379
24345
|
- **KG 이니시스** : 카드
|
|
24380
24346
|
- **토스페이먼츠(신모듈)** : 카드
|
|
@@ -24383,8 +24349,8 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
24383
24349
|
|
|
24384
24350
|
### API 빌링키 발급 및 정기결제
|
|
24385
24351
|
|
|
24386
|
-
-
|
|
24387
|
-
- **(구)
|
|
24352
|
+
- **나이스정보통신 (신모듈)** : 카드
|
|
24353
|
+
- **(구) 나이스정보통신** : 카드
|
|
24388
24354
|
- **NHN KCP** : 카드
|
|
24389
24355
|
- **KG이니시스** : 카드
|
|
24390
24356
|
- **토스페이먼츠(신모듈)** : 카드
|
|
@@ -24399,7 +24365,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
24399
24365
|
|
|
24400
24366
|
### 결제창(SDK) 인증결제
|
|
24401
24367
|
|
|
24402
|
-
-
|
|
24368
|
+
- **나이스정보통신** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
24403
24369
|
- **KG이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
24404
24370
|
- **토스페이먼츠** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
24405
24371
|
- **한국결제네트웍스(KPN)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
|
|
@@ -24409,7 +24375,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
24409
24375
|
|
|
24410
24376
|
### API 수기(키인)결제
|
|
24411
24377
|
|
|
24412
|
-
-
|
|
24378
|
+
- **나이스정보통신** : 카드 / 가상계좌
|
|
24413
24379
|
- **KG이니시스** : 카드 / 가상계좌
|
|
24414
24380
|
- **토스페이먼츠** : 카드 / 가상계좌
|
|
24415
24381
|
- **한국결제네트웍스(KPN)** : 카드 / 가상계좌
|
|
@@ -24419,7 +24385,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
|
|
|
24419
24385
|
|
|
24420
24386
|
### API 빌링키 발급 및 정기결제
|
|
24421
24387
|
|
|
24422
|
-
-
|
|
24388
|
+
- **나이스정보통신** : 카드
|
|
24423
24389
|
- **KG이니시스** : 카드
|
|
24424
24390
|
- **토스페이먼츠** : 카드
|
|
24425
24391
|
- **한국결제네트웍스(KPN)** : 카드
|
|
@@ -24614,7 +24580,7 @@ targetVersions:
|
|
|
24614
24580
|
|
|
24615
24581
|
<details>
|
|
24616
24582
|
|
|
24617
|
-
<summary
|
|
24583
|
+
<summary>나이스정보통신</summary>
|
|
24618
24584
|
|
|
24619
24585
|
<div class="hint" data-style="info">
|
|
24620
24586
|
|
|
@@ -24622,16 +24588,16 @@ targetVersions:
|
|
|
24622
24588
|
|
|
24623
24589
|
</div>
|
|
24624
24590
|
|
|
24625
|
-
1. [
|
|
24591
|
+
1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
|
|
24626
24592
|
2. \[가맹점정보]→\[KEY관리]를 클릭합니다.
|
|
24627
24593
|
3. MID 및 Key 값을 확인할 수 있습니다.
|
|
24628
24594
|
|
|
24629
|
-
(이미지 첨부:
|
|
24595
|
+
(이미지 첨부: 나이스정보통신 가맹점 관리자 내 KEY 조회 화면)
|
|
24630
24596
|
|
|
24631
24597
|
4. \[가맹점정보]→\[비밀번호관리]→\[거래취소비밀번호]를 클릭합니다.
|
|
24632
24598
|
5. 비밀번호를 설정합니다. 비밀번호는 최대 10자리까지 가능합니다.
|
|
24633
24599
|
|
|
24634
|
-
(이미지 첨부:
|
|
24600
|
+
(이미지 첨부: 나이스정보통신 가맹점 관리자 내 거래취소비밀번호 설정 화면)
|
|
24635
24601
|
|
|
24636
24602
|
6. 포트원 콘솔에서 채널 추가 시 \[MID], \[Key], \[결제취소 비밀번호]를 입력한 후 `저장`을 클릭합니다.
|
|
24637
24603
|
|
|
@@ -24950,7 +24916,17 @@ targetVersions:
|
|
|
24950
24916
|
|
|
24951
24917
|
<div class="tabs-content" data-title="통합 본인인증">
|
|
24952
24918
|
|
|
24953
|
-
|
|
24919
|
+
1. [KG이니시스 가맹점관리자](https://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
|
|
24920
|
+
2. \[상점정보]→\[계약정보]→\[KEY 정보]를 클릭합니다.
|
|
24921
|
+
3. \[부가서비스 연동 Key 정보]→\[통합인증 서비스] 항목에서 \[도메인 등록] 버튼을 클릭 후 아래 3개의 도메인을 등록합니다.
|
|
24922
|
+
|
|
24923
|
+
- 본인인증 서비스를 이용하는 고객사 서비스 도메인
|
|
24924
|
+
- iamport.co
|
|
24925
|
+
- iamport.kr
|
|
24926
|
+
|
|
24927
|
+
(이미지 첨부: KG이니시스 가맹점관리자 내 도메인 등록화면)
|
|
24928
|
+
|
|
24929
|
+
4. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
|
|
24954
24930
|
|
|
24955
24931
|
</div>
|
|
24956
24932
|
|
|
@@ -25046,7 +25022,17 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
|
|
|
25046
25022
|
|
|
25047
25023
|
<div class="tabs-content" data-title="통합 본인인증">
|
|
25048
25024
|
|
|
25049
|
-
|
|
25025
|
+
1. [KG이니시스 가맹점관리자](https://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
|
|
25026
|
+
2. \[상점정보]→\[계약정보]→\[KEY 정보]를 클릭합니다.
|
|
25027
|
+
3. \[부가서비스 연동 Key 정보]→\[통합인증 서비스] 항목에서 \[도메인 등록] 버튼을 클릭 후 아래 3개의 도메인을 등록합니다.
|
|
25028
|
+
|
|
25029
|
+
- 본인인증 서비스를 이용하는 고객사 서비스 도메인
|
|
25030
|
+
- iamport.co
|
|
25031
|
+
- iamport.kr
|
|
25032
|
+
|
|
25033
|
+
(이미지 첨부: KG이니시스 가맹점관리자 내 도메인 등록화면)
|
|
25034
|
+
|
|
25035
|
+
4. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
|
|
25050
25036
|
|
|
25051
25037
|
</div>
|
|
25052
25038
|
|
|
@@ -25302,38 +25288,6 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
|
|
|
25302
25288
|
|
|
25303
25289
|
<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
|
|
25304
25290
|
|
|
25305
|
-
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
|
|
25306
|
-
|
|
25307
|
-
<details>
|
|
25308
|
-
|
|
25309
|
-
<summary>하이픈</summary>
|
|
25310
|
-
|
|
25311
|
-
1. [HYPHEN PAY & 바로계좌결제 운영 백오피스](http://payadmin.hyphen.im/) 접속 후 **바로계좌결제** 선택 후
|
|
25312
|
-
로그인을 합니다.
|
|
25313
|
-
|
|
25314
|
-
(이미지 첨부: HYPHEN 백오피스 로그인 화면)
|
|
25315
|
-
|
|
25316
|
-
2. \[상점관리]→\[바로계좌결제 상점정보관리]를 클릭합니다.
|
|
25317
|
-
|
|
25318
|
-
3. 상점명을 클릭합니다.
|
|
25319
|
-
|
|
25320
|
-
(이미지 첨부: HYPHEN \[상점관리] - \[상점정보관리] 예시 화면)
|
|
25321
|
-
|
|
25322
|
-
4. \[상점 기본정보]에서 \[상점번호]를 확인합니다.
|
|
25323
|
-
|
|
25324
|
-
(이미지 첨부: HYPHEN \[상점 기본정보] 예시 화면)
|
|
25325
|
-
|
|
25326
|
-
5. \[암호화 키, 토큰]에서 \[암호화 키]와 \[암호화 토큰]을 확인합니다.
|
|
25327
|
-
|
|
25328
|
-
(이미지 첨부: HYPHEN \[암호화 키, 토큰] 예시 화면)
|
|
25329
|
-
|
|
25330
|
-
6. 포트원 콘솔에서 채널 추가 시 \[PG상점아이디(상점 번호)], \[암호화 키], \[암호화 토큰]을
|
|
25331
|
-
입력한 후 \[저장]을 클릭합니다.
|
|
25332
|
-
|
|
25333
|
-
</details>
|
|
25334
|
-
|
|
25335
|
-
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
|
|
25336
|
-
|
|
25337
25291
|
#### 해외 결제대행사
|
|
25338
25292
|
|
|
25339
25293
|
<details>
|
|
@@ -25371,6 +25325,24 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
|
|
|
25371
25325
|
|
|
25372
25326
|
3. 포트원 콘솔에서 채널 추가 시 \[Project Key], \[Secret Key]를 입력한 후 `저장`을 클릭합니다.
|
|
25373
25327
|
|
|
25328
|
+
#### 핑백(Pingback) URL 설정하기
|
|
25329
|
+
|
|
25330
|
+
페이먼트월에서 포트원으로 결제 결과를 전달받기 위해 핑백 URL을 설정해야 합니다.
|
|
25331
|
+
|
|
25332
|
+
1. [페이먼트월](https://api.paymentwall.com/developers/applications) 페이지에서 \[My Projects]를 클릭합니다.
|
|
25333
|
+
|
|
25334
|
+
(이미지 첨부: 페이먼트월 My Projects 메뉴)
|
|
25335
|
+
|
|
25336
|
+
2. 사용할 프로젝트의 \[Settings] 탭을 클릭합니다.
|
|
25337
|
+
|
|
25338
|
+
(이미지 첨부: 페이먼트월 프로젝트 setting 탭)
|
|
25339
|
+
|
|
25340
|
+
3. \[Pingback type]을 `URL`로 선택합니다.
|
|
25341
|
+
4. \[Pingback URL]에 `https://service.iamport.kr/paymentwall/webhook`를 입력합니다.
|
|
25342
|
+
5. \[Pingback signature version]을 `3`으로 설정합니다.
|
|
25343
|
+
|
|
25344
|
+
(이미지 첨부: 페이먼트월 Pingback 설정 화면)
|
|
25345
|
+
|
|
25374
25346
|
</details>
|
|
25375
25347
|
|
|
25376
25348
|
<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
|
|
@@ -25476,8 +25448,6 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
|
|
|
25476
25448
|
|
|
25477
25449
|
</details>
|
|
25478
25450
|
|
|
25479
|
-
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
|
|
25480
|
-
|
|
25481
25451
|
<details>
|
|
25482
25452
|
|
|
25483
25453
|
<summary>페이레터 해외결제</summary>
|
|
@@ -25487,8 +25457,6 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
|
|
|
25487
25457
|
|
|
25488
25458
|
</details>
|
|
25489
25459
|
|
|
25490
|
-
<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
|
|
25491
|
-
|
|
25492
25460
|
## <span id="integration-identifiers">4. 포트원 연동정보 확인하기</span>
|
|
25493
25461
|
|
|
25494
25462
|
포트원을 이용한 결제 연동 시 필요한 연동정보를 확인합니다.
|
|
@@ -25561,85 +25529,61 @@ targetVersions:
|
|
|
25561
25529
|
- v2
|
|
25562
25530
|
---
|
|
25563
25531
|
|
|
25564
|
-
## 포트원 MCP (Model Context Protocol) 서버
|
|
25565
|
-
|
|
25566
|
-
포트원은 쉬운 연동과 빠른 개발을 위해 MCP 서버를 제공합니다. [(GitHub 저장소 바로가기)](https://github.com/portone-io/mcp-server)
|
|
25567
|
-
|
|
25568
|
-
포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
|
|
25569
|
-
AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
|
|
25570
|
-
|
|
25571
|
-
### 1. MCP 서버 등록하기
|
|
25572
|
-
|
|
25573
|
-
포트원 MCP 서버를 사용하기 위해서는 먼저 사용하는 AI 도구에 서버를 등록해야 합니다.
|
|
25574
|
-
|
|
25575
|
-
Cursor, Windsurf, Claude Code, Claude for Desktop 등 다양한 AI 도구의 설정 파일에서 아래 내용을 추가하여 MCP 서버를 등록할 수 있습니다.
|
|
25576
|
-
|
|
25577
|
-
```json
|
|
25578
|
-
{
|
|
25579
|
-
// ...
|
|
25580
|
-
|
|
25581
|
-
"mcpServers": {
|
|
25582
|
-
// ...
|
|
25583
|
-
|
|
25584
|
-
"portone-mcp-server": {
|
|
25585
|
-
"command": "uvx",
|
|
25586
|
-
"args": ["portone-mcp-server@latest"]
|
|
25587
|
-
}
|
|
25588
|
-
}
|
|
25589
|
-
}
|
|
25590
|
-
```
|
|
25532
|
+
## 포트원 MCP (Model Context Protocol) 서버
|
|
25591
25533
|
|
|
25592
|
-
|
|
25534
|
+
포트원은 쉬운 연동과 빠른 개발을 위해 MCP 서버를 제공합니다. [(GitHub 저장소 바로가기)](https://github.com/portone-io/mcp-server)
|
|
25593
25535
|
|
|
25594
|
-
|
|
25536
|
+
포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
|
|
25537
|
+
AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
|
|
25595
25538
|
|
|
25596
|
-
|
|
25539
|
+
이외에도 포트원 콘솔에서 제공하는 기능 중 일부를 수행할 수 있습니다.
|
|
25540
|
+
아래 기능을 AI에게 요청하면 MCP 서버가 브라우저를 열어 포트원 콘솔 로그인을 요청하며, 로그인 후 기능이 수행됩니다.
|
|
25597
25541
|
|
|
25598
|
-
|
|
25542
|
+
- 채널 목록 조회
|
|
25543
|
+
- 테스트 채널 추가
|
|
25544
|
+
- 하위 상점 조회
|
|
25545
|
+
- 결제 내역 조회
|
|
25599
25546
|
|
|
25600
|
-
|
|
25547
|
+
### DXT를 이용한 설치
|
|
25601
25548
|
|
|
25602
|
-
|
|
25549
|
+
[DXT (Desktop Extensions)](https://github.com/anthropics/dxt)를 이용해 MCP 서버를 원클릭으로 설치할 수 있습니다.
|
|
25603
25550
|
|
|
25604
|
-
-
|
|
25605
|
-
|
|
25551
|
+
1. [GitHub Releases](https://github.com/portone-io/mcp-server/releases)에서 최신 `portone-mcp-server.dxt` 파일을 다운로드합니다.
|
|
25552
|
+
2. 지원하는 AI 도구(Claude Desktop 등)에서 다운로드한 `.dxt` 파일을 드래그 앤 드롭하거나 열기를 통해 설치합니다.
|
|
25553
|
+
3. 설치 후 도구를 재시작하여 MCP 서버가 정상적으로 등록되었는지 확인합니다.
|
|
25606
25554
|
|
|
25607
|
-
|
|
25555
|
+
<div class="hint" data-style="warning">
|
|
25608
25556
|
|
|
25609
|
-
|
|
25610
|
-
{
|
|
25611
|
-
// ...
|
|
25557
|
+
**Claude Desktop에서 DXT 파일 사용 시 주의사항**
|
|
25612
25558
|
|
|
25613
|
-
|
|
25614
|
-
// ...
|
|
25559
|
+
현재 [알려진 이슈](https://github.com/anthropics/dxt/issues/45)로 인해 Claude Desktop에서 DXT 설치 후 MCP 서버가 정상적으로 작동하지 않을 수 있습니다.
|
|
25615
25560
|
|
|
25616
|
-
|
|
25617
|
-
"command": "uvx",
|
|
25618
|
-
"args": ["portone-mcp-server@latest"],
|
|
25619
|
-
// 아래 env 블록을 추가하여 API 시크릿을 설정합니다.
|
|
25620
|
-
"env": {
|
|
25621
|
-
"API_SECRET": "<YOUR_PORTONE_API_SECRET>"
|
|
25622
|
-
}
|
|
25623
|
-
}
|
|
25624
|
-
}
|
|
25625
|
-
}
|
|
25626
|
-
```
|
|
25561
|
+
이 경우 Node.js 22.6.0 이상을 설치하고 Claude Desktop 설정에서 **"MCP용 내장 Node.js 사용"** 옵션을 비활성화한 후 재시작하면 정상적으로 작동합니다.
|
|
25627
25562
|
|
|
25628
|
-
|
|
25563
|
+
</div>
|
|
25629
25564
|
|
|
25630
|
-
|
|
25565
|
+
### MCP 서버 등록하기
|
|
25631
25566
|
|
|
25632
|
-
|
|
25567
|
+
1. Node.js 22.6.0 이상이 설치되어 있어야 합니다.
|
|
25633
25568
|
|
|
25634
|
-
|
|
25569
|
+
2. 사용하는 AI 도구의 MCP 설정에서 아래 내용을 추가합니다. (Cursor, Windsurf, Claude Desktop, etc...)
|
|
25635
25570
|
|
|
25636
|
-
|
|
25571
|
+
```jsonc
|
|
25572
|
+
"mcpServers": {
|
|
25637
25573
|
|
|
25638
|
-
|
|
25574
|
+
// 기존 설정
|
|
25639
25575
|
|
|
25640
|
-
|
|
25576
|
+
"portone-mcp-server": {
|
|
25577
|
+
"command": "npx",
|
|
25578
|
+
"args": [
|
|
25579
|
+
"-y",
|
|
25580
|
+
"@portone/mcp-server@latest"
|
|
25581
|
+
]
|
|
25582
|
+
}
|
|
25583
|
+
}
|
|
25584
|
+
```
|
|
25641
25585
|
|
|
25642
|
-
|
|
25586
|
+
3. 도구를 재시작해 portone-mcp-server 및 해당 서버가 제공하는 도구들이 잘 등록되었는지 확인합니다.
|
|
25643
25587
|
|
|
25644
25588
|
<div class="hint" data-style="warning">
|
|
25645
25589
|
|
|
@@ -25650,7 +25594,7 @@ MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않
|
|
|
25650
25594
|
|
|
25651
25595
|
</div>
|
|
25652
25596
|
|
|
25653
|
-
###
|
|
25597
|
+
### MCP 서버 활용하기
|
|
25654
25598
|
|
|
25655
25599
|
사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
|
|
25656
25600
|
|
|
@@ -25720,8 +25664,8 @@ targetVersions:
|
|
|
25720
25664
|
|키움페이 |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>|
|
|
25721
25665
|
|토스페이먼츠(신모듈) |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) |
|
|
25722
25666
|
|스마트로(신모듈) |smartro\_v2 |입금 통보, 환불이체 URL 동일: [https://tx-gateway-service.prod.iamport.co/smartro-v2](http://tx-gateway-service.prod.iamport.co/smartro-v2) |
|
|
25723
|
-
|
|
25724
|
-
|
|
25667
|
+
|나이스정보통신(구모듈)|nice |[https://service.iamport.kr/nice\_payments/notice\_vbank](http://service.iamport.kr/nice_payments/notice_vbank) |
|
|
25668
|
+
|나이스정보통신(신모듈)|nice\_v2 |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2) |
|
|
25725
25669
|
|웰컴페이먼츠 |welcome |[https://tx-gateway-service.prod.iamport.co/welcome](http://tx-gateway-service.prod.iamport.co/welcome) |
|
|
25726
25670
|
|
|
25727
25671
|
<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
|
|
@@ -25732,7 +25676,7 @@ targetVersions:
|
|
|
25732
25676
|
|----------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-|
|
|
25733
25677
|
|토스페이먼츠 |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)| |
|
|
25734
25678
|
|스마트로 |smartro\_v2 |입금 통보, 환불이체 URL 동일: [https://tx-gateway-service.prod.iamport.co/smartro-v2](http://tx-gateway-service.prod.iamport.co/smartro-v2) | |
|
|
25735
|
-
|
|
25679
|
+
|나이스정보통신 |nice\_v2 |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2) | |
|
|
25736
25680
|
|KG이니시스 |inicis\_v2 |[https://tx-gateway-service.prod.iamport.co/inicis-v2](http://tx-gateway-service.prod.iamport.co/inicis-v2) | |
|
|
25737
25681
|
|한국결제네트웍스|kpn |[https://tx-gateway-service.prod.iamport.co/kpn/virtual-account](http://tx-gateway-service.prod.iamport.co/kpn/virtual-account) | |
|
|
25738
25682
|
|NHN KCP |kcp\_v2 |[https://tx-gateway-service.prod.iamport.co/kcp-v2](http://tx-gateway-service.prod.iamport.co/kcp-v2) | |
|
|
@@ -25773,9 +25717,9 @@ targetVersions:
|
|
|
25773
25717
|
|
|
25774
25718
|
<details>
|
|
25775
25719
|
|
|
25776
|
-
<summary
|
|
25720
|
+
<summary>나이스정보통신(구모듈) 설정 방법</summary>
|
|
25777
25721
|
|
|
25778
|
-
1. [
|
|
25722
|
+
1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
|
|
25779
25723
|
2. \[가맹점정보]→\[기본정보]를 클릭합니다.
|
|
25780
25724
|
3. \[결제데이터통보] 항목에서 **가상계좌**의 \[URL/IP]를 `https://service.iamport.kr/nice_payments/notice_vbank` 로 설정해주세요.
|
|
25781
25725
|
4. \[재전송 간격]은 1분, \[재전송 횟수]는 3회로 설정해주세요.
|
|
@@ -25785,7 +25729,7 @@ targetVersions:
|
|
|
25785
25729
|
- 재전송 간격: 최소 1분 \~ 최대 10분까지만 입력 가능합니다.
|
|
25786
25730
|
- 재전송 횟수: 최소 1회 \~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
|
|
25787
25731
|
|
|
25788
|
-
(이미지 첨부:
|
|
25732
|
+
(이미지 첨부: 나이스정보통신 가맹점 관리자 내 입금통보 URL 설정 화면)
|
|
25789
25733
|
|
|
25790
25734
|
</details>
|
|
25791
25735
|
|
|
@@ -25878,9 +25822,9 @@ KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 U
|
|
|
25878
25822
|
|
|
25879
25823
|
<details>
|
|
25880
25824
|
|
|
25881
|
-
<summary
|
|
25825
|
+
<summary>나이스정보통신(신모듈) 설정 방법</summary>
|
|
25882
25826
|
|
|
25883
|
-
1. [
|
|
25827
|
+
1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
|
|
25884
25828
|
2. \[가맹점정보]→\[기본정보]를 클릭합니다.
|
|
25885
25829
|
3. \[결제데이터통보] 항목에서 **가상계좌**의 \[URL/IP]를 `https://tx-gateway-service.prod.iamport.co/nicepay-v2` 로 설정해주세요.
|
|
25886
25830
|
4. \[재전송 간격]은 1분, \[재전송 횟수]는 3회로 설정해주세요.
|
|
@@ -25890,7 +25834,7 @@ KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 U
|
|
|
25890
25834
|
- 재전송 간격: 최소 1분 \~ 최대 10분까지만 입력 가능합니다.
|
|
25891
25835
|
- 재전송 횟수: 최소 1회 \~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
|
|
25892
25836
|
|
|
25893
|
-
(이미지 첨부:
|
|
25837
|
+
(이미지 첨부: 나이스정보통신 가맹점 관리자 내 입금통보 URL 설정 화면 )
|
|
25894
25838
|
|
|
25895
25839
|
</details>
|
|
25896
25840
|
|
|
@@ -26176,19 +26120,244 @@ targetVersions:
|
|
|
26176
26120
|
|
|
26177
26121
|
포트원 결제 연동 및 운영 과정에서 기술적인 어려움을 겪고 있다면, 아래 메일로 문의하세요.
|
|
26178
26122
|
|
|
26179
|
-
|
|
26123
|
+
- <tech.support@portone.io>
|
|
26180
26124
|
|
|
26181
|
-
- V1: <support@portone.io>
|
|
26182
|
-
- V2: <tech.support@portone.io>
|
|
26183
26125
|
|
|
26184
|
-
|
|
26126
|
+
# https://developers.portone.io/opi/ko/support/pg-terms
|
|
26185
26127
|
|
|
26186
|
-
|
|
26128
|
+
---
|
|
26129
|
+
title: 용어 사전
|
|
26130
|
+
description: 온라인 결제 시스템에서 자주 사용되는 용어들을 설명합니다.
|
|
26131
|
+
targetVersions:
|
|
26132
|
+
- v1
|
|
26133
|
+
- v2
|
|
26134
|
+
---
|
|
26187
26135
|
|
|
26188
|
-
|
|
26189
|
-
- V1: <support@portone.io>
|
|
26136
|
+
## 결제 대행 관련
|
|
26190
26137
|
|
|
26191
|
-
|
|
26138
|
+
### PG (Payment Gateway)
|
|
26139
|
+
|
|
26140
|
+
PG는 온라인 결제에서 결제 정보를 송수신하고 정산을 매개하는 서비스입니다. 온라인 결제를 받기 위해서는 PG사와의 계약과 연동이 필요합니다. 법적으로는 전자금융업상 전자지급결제대행업에 해당합니다.
|
|
26141
|
+
|
|
26142
|
+
PG에 따라 신용카드, 계좌이체, 가상계좌, 휴대폰 결제 등 다양한 결제 수단을 이용할 수 있으며, "결제의 관문"이라는 이름처럼 알맞은 시스템으로 결제 정보를 전달합니다.
|
|
26143
|
+
|
|
26144
|
+
### 포트원 원 페이먼트 인프라 (OPI)
|
|
26145
|
+
|
|
26146
|
+
다양한 PG의 파편화된 인터페이스를 통일하여 현대적인 연동 경험을 제공하는 **결제 오케스트레이션 서비스**입니다. 이를 통해 PG를 쉽게 연동 및 추가/변경하고, 다중 PG 시스템을 운영할 수 있습니다.
|
|
26147
|
+
|
|
26148
|
+
<div class="hint" data-style="info">
|
|
26149
|
+
|
|
26150
|
+
OPI 서비스는 결제 정보를 송수신하지만 자금 이동에는 관여하지 않습니다.
|
|
26151
|
+
|
|
26152
|
+
</div>
|
|
26153
|
+
|
|
26154
|
+
### PG 상점 아이디 (MID)
|
|
26155
|
+
|
|
26156
|
+
PG에서 상점에 부여하는 고유 식별자입니다. PG와의 계약을 통해 발급되며, 결제 수단, 과세 여부, 수수료 등 여러 설정이 MID 단위로 관리됩니다. PG 정책에 따라서는 이용 서비스 및 세부 설정별로 여러 개의 MID를 발급하기도 합니다.
|
|
26157
|
+
|
|
26158
|
+
포트원을 이용할 때에는 채널을 추가할 때 MID를 입력합니다.
|
|
26159
|
+
|
|
26160
|
+
<div class="hint" data-style="info">
|
|
26161
|
+
|
|
26162
|
+
**PG사별 상점 아이디 명칭**
|
|
26163
|
+
|
|
26164
|
+
- KG이니시스: 상점 아이디(MID)
|
|
26165
|
+
- 카카오페이: 고객사 코드(CID)
|
|
26166
|
+
- 네이버페이: 파트너 ID (하위 식별자로 체인 ID 존재)
|
|
26167
|
+
- 토스페이먼츠: 상점 아이디(MID)
|
|
26168
|
+
- NHN KCP: 사이트 코드
|
|
26169
|
+
|
|
26170
|
+
</div>
|
|
26171
|
+
|
|
26172
|
+
### 포트원 상점 아이디 (storeId)
|
|
26173
|
+
|
|
26174
|
+
포트원 관리자 콘솔에서 확인할 수 있는 상점 식별자입니다. 연동 시 `storeId`라는 이름으로 많은 API에 등장합니다.
|
|
26175
|
+
|
|
26176
|
+
포트원 V1에서는 고객사 식별코드라는 별도 값을 이용합니다.
|
|
26177
|
+
|
|
26178
|
+
## 결제 방식 관련 용어
|
|
26179
|
+
|
|
26180
|
+
### 간편결제사
|
|
26181
|
+
|
|
26182
|
+
네이버페이, 카카오페이, 토스페이, 페이코와 같이 신용카드나 계좌번호 등의 결제 정보를 등록해 비밀번호 입력, 지문 인식만으로 결제할 수 있는 서비스를 제공하는 사업자입니다.
|
|
26183
|
+
|
|
26184
|
+
### PG 제휴 간편결제
|
|
26185
|
+
|
|
26186
|
+
간편결제사와 직접 계약을 맺지 않고 일반 PG사와의 계약만으로 간편결제사의 서비스 이용이 가능한 서비스입니다. 구매자가 보기에는 동일한 간편결제사의 결제창이 호출됩니다.
|
|
26187
|
+
|
|
26188
|
+
<div class="hint" data-style="warning">
|
|
26189
|
+
|
|
26190
|
+
**PG 제휴 간편결제 주의사항**
|
|
26191
|
+
|
|
26192
|
+
PG 제휴로 간편결제를 이용할 경우 간편결제 포인트 적립이 안 되는 등 일부 기능을 사용할 수 없는 경우가 있습니다.
|
|
26193
|
+
|
|
26194
|
+
</div>
|
|
26195
|
+
|
|
26196
|
+
### 인증결제
|
|
26197
|
+
|
|
26198
|
+
신용카드, 간편결제, 계좌이체, 휴대폰 결제 등에서 결제 정보가 본인임을 확인하는 과정을 거친 이후 결제되는 방식을 총칭합니다. 쇼핑몰 등에서 이용되는 일회성 결제로 가장 일반적인 결제 방식입니다.
|
|
26199
|
+
|
|
26200
|
+
### 키인결제
|
|
26201
|
+
|
|
26202
|
+
카드 번호 등 결제 정보를 구매자로부터 직접 입력받아 API 호출을 통해 결제를 일으키는 비인증결제 방식입니다.
|
|
26203
|
+
|
|
26204
|
+
### 빌링결제
|
|
26205
|
+
|
|
26206
|
+
구매자에게 최초 1회 결제 정보를 입력받아 빌링키를 발급함으로써, 이후에 고객사에서 임의 시점에 결제를 반복하여 일으키는 결제 방식입니다. 결제를 일으킬 때에는 별도로 사용자 인증이 필요 없으므로 비인증결제에 속합니다. 정기결제 등을 구현하기 위해 사용합니다.
|
|
26207
|
+
|
|
26208
|
+
<div class="hint" data-style="warning">
|
|
26209
|
+
|
|
26210
|
+
**빌링키 사용 제한**
|
|
26211
|
+
|
|
26212
|
+
빌링키는 해당 빌링키를 발급한 PG에서만 사용 가능합니다. 또, 빌링키를 다른 포트원 상점 또는 다른 PG MID로 이관하려면 별도 요청이 필요합니다.
|
|
26213
|
+
|
|
26214
|
+
</div>
|
|
26215
|
+
|
|
26216
|
+
## 거래 식별 관련 용어
|
|
26217
|
+
|
|
26218
|
+
### 결제 ID (paymentId, 고객사 주문번호)
|
|
26219
|
+
|
|
26220
|
+
결제를 요청할 때 고객사가 채번한 고유 번호입니다. V1에서는 `merchant_uid`라는 이름을 사용합니다.
|
|
26221
|
+
|
|
26222
|
+
### PG 거래번호 (TID)
|
|
26223
|
+
|
|
26224
|
+
PG사가 채번한 거래 번호입니다. PG사에 따라 취소 건에도 별도의 거래 번호를 부여할 수 있습니다.
|
|
26225
|
+
|
|
26226
|
+
### 카드 승인번호
|
|
26227
|
+
|
|
26228
|
+
승인 성공 시 카드사가 부여한 8자리 숫자로, 매입을 진행하거나 취소를 할 때 필요합니다. 당일에 한 카드사에 유니크하나 몇몇 카드사는 당일에 중복되는 경우도 있습니다.
|
|
26229
|
+
|
|
26230
|
+
## 카드 결제
|
|
26231
|
+
|
|
26232
|
+
신용/체크/선불카드를 통한 결제는 인증, 승인, 매입의 과정을 거칩니다.
|
|
26233
|
+
|
|
26234
|
+
### 인증 (Authentication)
|
|
26235
|
+
|
|
26236
|
+
인증결제에서, 카드 소유주가 본인임을 확인하는 과정입니다. 웹에서 비밀번호를 입력하거나 앱에서 지문 인식을 하는 등 카드사마다 방식이 다릅니다.
|
|
26237
|
+
|
|
26238
|
+
### 승인 (Authorization)
|
|
26239
|
+
|
|
26240
|
+
승인 거래가 생성되고, 카드 한도를 차감합니다. 실제로 대금이 이동하지는 않습니다.
|
|
26241
|
+
|
|
26242
|
+
포트원에서는 인증이 완료되면 자동으로 승인을 진행합니다. 또는, V2에서 수동 승인 기능을 이용하면 인증 후 승인 요청을 별도로 할 수 있습니다.
|
|
26243
|
+
|
|
26244
|
+
### 매입 (Capture)
|
|
26245
|
+
|
|
26246
|
+
매입은 승인된 카드 거래의 대금을 청구하는 일을 말합니다. 일반적으로 PG가 매일 정해진 시간에 승인 건들을 모아 자동으로 매입합니다.
|
|
26247
|
+
|
|
26248
|
+
결제 승인 시점과 상품 공급 시점이 크게 다른 상점에서는 자동 매입을 끄고 PG에 건별로 매입을 요청하는 수동 매입을 이용할 수 있습니다. 매입이 오랫동안 일어나지 않으면 자동으로 승인이 취소됩니다. 포트원에서는 아직 수동 매입을 지원하지 않습니다.
|
|
26249
|
+
|
|
26250
|
+
카드 결제를 취소할 경우 원리상 매입 전 취소와 매입 후 취소가 구분되고, 매입 후 취소는 보통 3\~4 영업일이 소요됩니다.
|
|
26251
|
+
|
|
26252
|
+
## 카드 관련 용어
|
|
26253
|
+
|
|
26254
|
+
### 카드사 유형
|
|
26255
|
+
|
|
26256
|
+
신용, 체크카드와 관련된 개념으로 발급사, 매입사, 네트워크(브랜드)가 있습니다.
|
|
26257
|
+
|
|
26258
|
+
- **발급사**: 카드를 발급한 회사
|
|
26259
|
+
- **매입사**: 상점과 계약하여 카드 거래 매입을 담당하는 회사
|
|
26260
|
+
- **네트워크**: 매입사와 발급사 사이를 중개하는 인프라 (비자, 마스터카드, JCB, 아메리칸 익스프레스, 다이너스 클럽, 디스커버, 유니온페이 등)
|
|
26261
|
+
|
|
26262
|
+
국내는 카드에 따라 매입사가 하나로 정해져 있기 때문에 PG가 각 매입사와 계약을 맺습니다.
|
|
26263
|
+
|
|
26264
|
+
<div class="hint" data-style="info">
|
|
26265
|
+
|
|
26266
|
+
**예시: 카카오뱅크 카드**
|
|
26267
|
+
|
|
26268
|
+
- 발급사: 카카오뱅크
|
|
26269
|
+
- 매입사: 국민카드
|
|
26270
|
+
- 네트워크: 없음 (해외 사용 시 비자, 마스터카드 등 선택)
|
|
26271
|
+
|
|
26272
|
+
</div>
|
|
26273
|
+
|
|
26274
|
+
### PLCC (Private Label Credit Card)
|
|
26275
|
+
|
|
26276
|
+
상업자표시 신용카드로, 카드명에 특정 브랜드를 표기한 것을 말합니다. 제휴 업체와 함께 카드 상품을 공동으로 기획하여 비용과 수익을 분담하며, 제휴사의 충성도 높은 고객을 확보할 수 있는 장점이 있습니다.
|
|
26277
|
+
|
|
26278
|
+
**PLCC 예시:**
|
|
26279
|
+
|
|
26280
|
+
- 스타벅스 현대카드
|
|
26281
|
+
- 배민 현대카드
|
|
26282
|
+
- 11번가 신한카드
|
|
26283
|
+
|
|
26284
|
+
### 제휴카드
|
|
26285
|
+
|
|
26286
|
+
카드사가 특정 기업 혹은 단체와 협약을 맺어 발급하는 카드입니다. 카드사는 제휴사 카드 상품을 출시하고 마케팅 비용이나 카드 수익 등을 모두 관리하며, 반면 제휴사는 카드 모집만 담당합니다.
|
|
26287
|
+
|
|
26288
|
+
## 기타 결제 관련 용어
|
|
26289
|
+
|
|
26290
|
+
### 가상계좌
|
|
26291
|
+
|
|
26292
|
+
은행이 고객사에 발급한 입금 전용 계좌로, 고객사는 납부자와 가상계좌 번호를 일대일로 매핑하여 발급합니다. 보통 가상계좌는 입금 시 바로 삭제되며 해당 계좌번호는 재활용되어 다른 납부자에게 발급될 수 있습니다.
|
|
26293
|
+
|
|
26294
|
+
### 고정식 가상계좌
|
|
26295
|
+
|
|
26296
|
+
전기요금 고지서처럼 납부자가 하나의 입금 계좌번호를 부여받아 지속적으로 입금하고자 할 때 이용하는 가상계좌입니다.
|
|
26297
|
+
|
|
26298
|
+
### 에스크로
|
|
26299
|
+
|
|
26300
|
+
구매자의 구매 확인 의사인 구매결정을 통보받은 후 판매자에게 결제 대금을 지급하는 안전한 결제 서비스입니다. 2006년 4월 1일부터 에스크로 의무화 시행에 따라 가상계좌, 계좌이체와 같은 모든 현금 거래에는 의무적으로 적용해야 합니다.
|
|
26301
|
+
|
|
26302
|
+
## 취소
|
|
26303
|
+
|
|
26304
|
+
결제 완료 이후에 API나 콘솔을 통해 결제를 취소할 수 있습니다. 결제 금액의 일부만 취소하는 것도 가능합니다.
|
|
26305
|
+
|
|
26306
|
+
가상계좌 환불이나 휴대폰 익월 환불의 경우 환불받을 계좌를 입력해야 합니다.
|
|
26307
|
+
|
|
26308
|
+
환불 가능 기한이 지난 등의 이유로 PG를 통한 취소가 불가능한 경우에는 고객사에서 직접 구매자에게 자체 환불 처리해야 합니다.
|
|
26309
|
+
|
|
26310
|
+
### 카드
|
|
26311
|
+
|
|
26312
|
+
매입 전 취소의 경우 즉시 환불됩니다. 매입 후 취소는 일반적으로 3\~4 영업일이 소요됩니다.
|
|
26313
|
+
|
|
26314
|
+
### 계좌이체
|
|
26315
|
+
|
|
26316
|
+
즉시 환불됩니다.
|
|
26317
|
+
|
|
26318
|
+
### 가상계좌
|
|
26319
|
+
|
|
26320
|
+
환불받을 계좌를 입력해야 환불이 가능합니다. 일반적으로 2 영업일이 소요됩니다.
|
|
26321
|
+
|
|
26322
|
+
### 휴대폰
|
|
26323
|
+
|
|
26324
|
+
결제가 일어난 해당 월에만 취소가 가능합니다. 실제 지불 전이므로 즉시 취소됩니다. 일부 PG에서는 익월 환불이라 하여 해당 월이 지난 뒤에도 계좌로 환불하는 기능을 제공합니다.
|
|
26325
|
+
|
|
26326
|
+
## 세금 관련 용어
|
|
26327
|
+
|
|
26328
|
+
### 부가가치세
|
|
26329
|
+
|
|
26330
|
+
일반적으로 매출 발생시 10%의 부가가치세를 국가에 납부해야 합니다. 또한, PG 서비스 수수료에도 10%의 부가가치세가 발생합니다. 수수료에 대한 부가가치세는 매입 세액에 속합니다.
|
|
26331
|
+
|
|
26332
|
+
<div class="hint" data-style="info">
|
|
26333
|
+
|
|
26334
|
+
**정산 수수료 계산 예시**
|
|
26335
|
+
|
|
26336
|
+
1,000원의 결제에 대해 3%의 수수료를 적용한다면:
|
|
26337
|
+
|
|
26338
|
+
- 수수료: 30원
|
|
26339
|
+
- 수수료 부가세: 3원 (수수료의 10%)
|
|
26340
|
+
- 정산 금액: 967원
|
|
26341
|
+
|
|
26342
|
+
</div>
|
|
26343
|
+
|
|
26344
|
+
### 면세
|
|
26345
|
+
|
|
26346
|
+
세금을 부과하지 않는 소득을 의미합니다. 저소득층의 세금 부담 경감 또는 기타 정책적 목적으로 일부 재화나 용역의 공급에 대해 부가가치세를 면제하는 것을 말합니다. 대표적으로 기초생활필수품, 문화 관련 재화, 용역 등이 있습니다.
|
|
26347
|
+
|
|
26348
|
+
### 영세율
|
|
26349
|
+
|
|
26350
|
+
일정한 재화 또는 용역의 공급에 대해 0의 세율을 적용하는 제도로, 수출업자, 기타 외화 획득 사업자 등이 영세사업자로 적용됩니다.
|
|
26351
|
+
|
|
26352
|
+
## 할인 관련 용어
|
|
26353
|
+
|
|
26354
|
+
### 즉시할인
|
|
26355
|
+
|
|
26356
|
+
상품의 가격에 즉시 할인 금액을 적용하여 할인된 금액을 결제하는 방식입니다.
|
|
26357
|
+
|
|
26358
|
+
### 청구할인
|
|
26359
|
+
|
|
26360
|
+
본래의 상품 가격을 결제했다가 조건 충족 시 결제 대금의 할인된 금액이 반영되는 방식입니다. 청구할인은 할인 여부를 챙겨봐야 하기 때문에 즉시할인이 납부자에게 더 선호됩니다.
|
|
26192
26361
|
|
|
26193
26362
|
|
|
26194
26363
|
# https://developers.portone.io/opi/ko/support/tls-support
|
|
@@ -26756,24 +26925,144 @@ SDK를 지원하지 않는 플랫폼을 포함하여 다양한 플랫폼에서
|
|
|
26756
26925
|
|
|
26757
26926
|
---
|
|
26758
26927
|
title: 용어 사전
|
|
26759
|
-
description:
|
|
26928
|
+
description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용어를 설명합니다.
|
|
26929
|
+
---
|
|
26930
|
+
|
|
26931
|
+
|
|
26932
|
+
|
|
26933
|
+
## **서비스 용어**
|
|
26934
|
+
|
|
26935
|
+
### 정산금 계산 자동화
|
|
26936
|
+
|
|
26937
|
+
파트너에게 정산할 금액을 자동 계산하고 관리하는 대표 서비스입니다.
|
|
26938
|
+
파트너를 등록하여 파트너 정보를 관리하고, 플랫폼 정책에 맞는 각종 계약을 등록할 수 있으며, 선택한 파트너와 계약을 기반으로 자동 정산금 계산을 지원합니다.
|
|
26939
|
+
|
|
26940
|
+
### 지급대행 서비스
|
|
26941
|
+
|
|
26942
|
+
전자금융거래법을 준수하기 위해 PG 정산금의 수취 및 이체를 대행하는 서비스로
|
|
26943
|
+
안전하고 편리한 지급대행 서비스를 지원합니다. 포트원 지급대행은 일반 PG사와 다르게 즉시(바로)지급과 자유로운 예약지급 설정으로 보다 유연한 관리가 가능합니다.
|
|
26944
|
+
|
|
26945
|
+
### 전자세금계산서 서비스
|
|
26946
|
+
|
|
26947
|
+
역발행과 정발행을 지원하는 전자세금계산서 서비스입니다.
|
|
26948
|
+
세금계산서 발행 뿐만 아니라 히스토리 관리, 일괄(대량) 발행을 지원합니다.
|
|
26949
|
+
|
|
26950
|
+
<div class="hint" data-style="info">
|
|
26951
|
+
|
|
26952
|
+
파트너 정산 자동화 솔루션 안에서 3가지의 서비스를 제공하고 있습니다.
|
|
26953
|
+
|
|
26954
|
+
</div>
|
|
26955
|
+
|
|
26956
|
+
---
|
|
26957
|
+
|
|
26958
|
+
## **공통 용어**
|
|
26959
|
+
|
|
26960
|
+
### 고객사 / 파트너
|
|
26961
|
+
|
|
26962
|
+
고객사는 포트원의 결제서비스를 이용하고 있는 포트원의 고객을 의미합니다.
|
|
26963
|
+
|
|
26964
|
+
파트너는 고객사가 결제사정산 이후 하위정산을 받을 고객사의 파트너사 (하위셀러) 입니다.
|
|
26965
|
+
|
|
26966
|
+
### 사업자 휴폐업 조회
|
|
26967
|
+
|
|
26968
|
+
파트너의 사업자등록번호 유효성과 영업 상태를 확인하는 서비스입니다. 사업자 휴폐업 조회를 사전에 진행하여 비즈니스의 안전성과 신뢰성을 확보할 수 있습니다. 또한 미리 휴폐업을 조회하지 못해 생기는 리소스 낭비를 줄일 수 있습니다.
|
|
26969
|
+
|
|
26970
|
+
### 영업일
|
|
26971
|
+
|
|
26972
|
+
은행이 영업을 하는 날로, 휴일이 아닌 날입니다.
|
|
26973
|
+
|
|
26974
|
+
<div class="hint" data-style="success">
|
|
26975
|
+
|
|
26976
|
+
예를 들어, 10일(금), 11일(토), 12(일), 13(월)이라고 할 때, 11, 12, 13일의 전 영업일은 10일이고, 10, 11, 12일의 후 영업일은 13일입니다.
|
|
26977
|
+
|
|
26978
|
+
</div>
|
|
26979
|
+
|
|
26980
|
+
---
|
|
26981
|
+
|
|
26982
|
+
## **정산금 계산 자동화 용어**
|
|
26983
|
+
|
|
26984
|
+
### 계약
|
|
26985
|
+
|
|
26986
|
+
고객사와 파트너 사이에 정산이 이루어지기 위한 조건입니다. 계약은 파트너 정산 자동화의 정산 정책 관리 페이지에서 등록할 수 있습니다. 계약 등록을 통해 플랫폼 중개 수수료를 설정하거나 부가세 분담 주체, 정산 주기 등을 설정할 수 있으며, 각 플랫폼사의 정책에 맞게 커스터마이징이 가능합니다.
|
|
26987
|
+
|
|
26988
|
+
### 수수료
|
|
26989
|
+
|
|
26990
|
+
절차 및 중개 등을 지원할 때 수수하는 금전입니다.
|
|
26991
|
+
플랫폼사에서는 중개수수료와 추가수수료 등을 수취합니다. **중개수수료**는 플랫폼이 거래 중개 서비스에 대해 부과하는 수수료이고, **추가수수료**는 PG사 수수료, 마케팅 채널 수수료 등 특정 서비스에 대해 부과하는 수수료입니다.
|
|
26992
|
+
|
|
26993
|
+
### 원천 징수세
|
|
26994
|
+
|
|
26995
|
+
소득자(개인 파트너)가 자신의 세금을 직접 납부하지 않고, 원천징수 대상소득을 지급하는 원천징수 의무자(플랫폼사)가 그 금액을 미리 떼어서 대신 납부하는 세금입니다. 원천 징수세는 계약 등록에서 미리 설정할 수 있습니다.
|
|
26996
|
+
|
|
26997
|
+
---
|
|
26998
|
+
|
|
26999
|
+
## **지급대행 서비스 용어**
|
|
27000
|
+
|
|
27001
|
+
### 결제사 정산
|
|
27002
|
+
|
|
27003
|
+
포트원의 결제 이후 결제대행사(PG) 또는 간편결제사로부터 고객사가 받는 정산입니다.
|
|
27004
|
+
|
|
27005
|
+
### 파트너 정산
|
|
27006
|
+
|
|
27007
|
+
결제사 정산 이후에 고객사가 파트너에게 내려주는 정산입니다.
|
|
27008
|
+
|
|
27009
|
+
### 일괄지급
|
|
27010
|
+
|
|
27011
|
+
여러 파트너에게 동시에 정산금을 지급하는 기능으로, 한 번의 실행으로 대량 송금이 가능합니다. 정산일을 설정하고 정산할 건을 선택하여 일괄지급할 수 있습니다.
|
|
27012
|
+
|
|
27013
|
+
### 즉시지급(바로지급)과 예약지급
|
|
27014
|
+
|
|
27015
|
+
**즉시지급**은 지급 요청 즉시 실시간으로 송금이 실행되는 지급 방식입니다.
|
|
27016
|
+
**예약지급**은 미래의 특정 시점에 지급이 실행되도록 예약하는 지급 방식입니다. 예약지급은 주말과 공휴일도 포함시켜 달력일로 예약할 수 있습니다.
|
|
27017
|
+
|
|
27018
|
+
<div class="hint" data-style="warning">
|
|
27019
|
+
|
|
27020
|
+
단, 은행 점검 시간에는 지급 및 예약이 불가합니다.
|
|
27021
|
+
|
|
27022
|
+
</div>
|
|
27023
|
+
|
|
26760
27024
|
---
|
|
26761
27025
|
|
|
26762
|
-
|
|
26763
|
-
|
|
26764
|
-
|
|
26765
|
-
|
|
26766
|
-
|
|
26767
|
-
|
|
26768
|
-
|
|
26769
|
-
|
|
26770
|
-
|
|
26771
|
-
|
|
26772
|
-
|
|
26773
|
-
|
|
26774
|
-
|
|
26775
|
-
|
|
26776
|
-
|
|
27026
|
+
## **세금계산서 서비스 용어**
|
|
27027
|
+
|
|
27028
|
+
### 세금계산서 역발행
|
|
27029
|
+
|
|
27030
|
+
세금계산서 발행 주체인 공급자(파트너)가 아니라, 공급받는자(플랫폼)가 공급자 대신 세금계산서를 작성하여 공급자에게 발행을 요청하는 기능입니다.
|
|
27031
|
+
|
|
27032
|
+
플랫폼사가 직접 파트너에게 지급할 정산대금 정보를 작성하고, 해당 내용을 바탕으로 공급자는 이메일을 통해 검토만 하고 승인할 수 있는 구조이기 때문에 파트너와의 소통을 줄일 수 있습니다.
|
|
27033
|
+
|
|
27034
|
+
### 발행 취소
|
|
27035
|
+
|
|
27036
|
+
세금계산서를 국세청으로 전송하기 전까지 발행을 취소할 수 있는 기능으로, '발행 요청' 상태의 세금계산서 우측에 있는 '발행 취소' 버튼을 눌러 취소할 수 있습니다.
|
|
27037
|
+
|
|
27038
|
+
<div class="hint" data-style="warning">
|
|
27039
|
+
|
|
27040
|
+
세금계산서 내역 관리의 **삭제** 버튼은 발행 취소와 다른 기능으로 세금계산서의 상태가 실패, 거절, 취소 등의 최종 상태일 경우에만 적용됩니다.
|
|
27041
|
+
|
|
27042
|
+
</div>
|
|
27043
|
+
|
|
27044
|
+
### 수정 발행
|
|
27045
|
+
|
|
27046
|
+
세금계산서가 국세청으로 전송되면 (전송 완료 상태) 수정 발행으로 취소 및 수정이 가능합니다. 단, 수정 발행 시 사유 확인이 필요합니다.
|
|
27047
|
+
|
|
27048
|
+
### 재전송
|
|
27049
|
+
|
|
27050
|
+
역발행 세금계산서의 승인을 요청하는 메일을 파트너에게 다시 전송하는 기능입니다.
|
|
27051
|
+
|
|
27052
|
+
### 지연 발행
|
|
27053
|
+
|
|
27054
|
+
세금계산서 지연 발행 상태는 재화 또는 용역을 공급한 날이 속한 달의 다음 달 10일까지 세금계산서를 발급하지 않고, 그 기간을 넘겨 발행하면 지연 발행에 해당합니다.
|
|
27055
|
+
|
|
27056
|
+
예를 들어, 9월 16일에 재화나 용역을 제공했다면, 다음 달인 10월 10일까지 세금계산서를 발행해야 합니다. 이 기한을 넘겨 발행하면 지연 발행에 해당합니다.
|
|
27057
|
+
|
|
27058
|
+
<div class="hint" data-style="info">
|
|
27059
|
+
|
|
27060
|
+
지연 발행 시에는 가산세가 부과됩니다.
|
|
27061
|
+
|
|
27062
|
+
- 공급자는 지연 발행 가산세로 공급가액의 1%를 부담하게 됩니다.
|
|
27063
|
+
- 공급받는자는 지연 수취 가산세로 공급가액의 0.5%가 부과됩니다.
|
|
27064
|
+
|
|
27065
|
+
</div>
|
|
26777
27066
|
|
|
26778
27067
|
|
|
26779
27068
|
# https://developers.portone.io/platform/ko/guides/process
|
|
@@ -26787,7 +27076,7 @@ description: ''
|
|
|
26787
27076
|
|
|
26788
27077
|
<div class="hint" data-style="etc">
|
|
26789
27078
|
|
|
26790
|
-
📘 **파트너정산은 간단한 API연동과 관리자 콘솔 등록을 통해 파트너정산을 자동화 하는
|
|
27079
|
+
📘 **파트너정산은 간단한 API연동과 관리자 콘솔 등록을 통해 파트너정산을 자동화 하는 서비스입니다.**
|
|
26791
27080
|
|
|
26792
27081
|
</div>
|
|
26793
27082
|
|
|
@@ -26958,7 +27247,7 @@ app.post("/webhook/taxinvoice", (req, res) => {
|
|
|
26958
27247
|
### 설정 요청 절차
|
|
26959
27248
|
|
|
26960
27249
|
1. 웹훅 수신 URL을 준비해주세요.
|
|
26961
|
-
2. 기술지원 이메일(<support
|
|
27250
|
+
2. 기술지원 이메일(<tech.support@portone.io>)로 웹훅 URL(운영 환경, 테스트 환경 별도 적용 가능)을 전달해주세요.
|
|
26962
27251
|
3. 테스트 모드 설정이 완료되었다는 회신을 받으면 테스트 모드에서 웹훅 정상 작동 여부를 확인해주세요
|
|
26963
27252
|
4. 운영 환경에도 적용을 요청하신 뒤 운영 환경에서 웹훅 정상 작동 여부를 확인해주세요.
|
|
26964
27253
|
|
|
@@ -29207,78 +29496,54 @@ targetVersions:
|
|
|
29207
29496
|
포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
|
|
29208
29497
|
AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
|
|
29209
29498
|
|
|
29210
|
-
|
|
29211
|
-
|
|
29212
|
-
포트원 MCP 서버를 사용하기 위해서는 먼저 사용하는 AI 도구에 서버를 등록해야 합니다.
|
|
29213
|
-
|
|
29214
|
-
Cursor, Windsurf, Claude Code, Claude for Desktop 등 다양한 AI 도구의 설정 파일에서 아래 내용을 추가하여 MCP 서버를 등록할 수 있습니다.
|
|
29215
|
-
|
|
29216
|
-
```json
|
|
29217
|
-
{
|
|
29218
|
-
// ...
|
|
29219
|
-
|
|
29220
|
-
"mcpServers": {
|
|
29221
|
-
// ...
|
|
29222
|
-
|
|
29223
|
-
"portone-mcp-server": {
|
|
29224
|
-
"command": "uvx",
|
|
29225
|
-
"args": ["portone-mcp-server@latest"]
|
|
29226
|
-
}
|
|
29227
|
-
}
|
|
29228
|
-
}
|
|
29229
|
-
```
|
|
29230
|
-
|
|
29231
|
-
<div class="hint" data-style="info">
|
|
29232
|
-
|
|
29233
|
-
사용 환경에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야 합니다.
|
|
29499
|
+
이외에도 포트원 콘솔에서 제공하는 기능 중 일부를 수행할 수 있습니다.
|
|
29500
|
+
아래 기능을 AI에게 요청하면 MCP 서버가 브라우저를 열어 포트원 콘솔 로그인을 요청하며, 로그인 후 기능이 수행됩니다.
|
|
29234
29501
|
|
|
29235
|
-
|
|
29236
|
-
|
|
29237
|
-
|
|
29238
|
-
|
|
29239
|
-
#### 포트원 기능 사용하기
|
|
29240
|
-
|
|
29241
|
-
MCP 서버에 포트원 기능을 연동하면, AI가 아래와 같은 작업을 수행할 수 있습니다.
|
|
29502
|
+
- 채널 목록 조회
|
|
29503
|
+
- 테스트 채널 추가
|
|
29504
|
+
- 하위 상점 조회
|
|
29505
|
+
- 결제 내역 조회
|
|
29242
29506
|
|
|
29243
|
-
|
|
29244
|
-
- 본인인증 내역 단건/다건 조회
|
|
29245
|
-
|
|
29246
|
-
연동을 활성화하려면, MCP 설정 파일의 env 블록에 포트원 관리자 콘솔에서 발급받은 API\_SECRET을 추가합니다.
|
|
29247
|
-
|
|
29248
|
-
```json
|
|
29249
|
-
{
|
|
29250
|
-
// ...
|
|
29507
|
+
### DXT를 이용한 설치
|
|
29251
29508
|
|
|
29252
|
-
|
|
29253
|
-
// ...
|
|
29509
|
+
[DXT (Desktop Extensions)](https://github.com/anthropics/dxt)를 이용해 MCP 서버를 원클릭으로 설치할 수 있습니다.
|
|
29254
29510
|
|
|
29255
|
-
|
|
29256
|
-
|
|
29257
|
-
|
|
29258
|
-
// 아래 env 블록을 추가하여 API 시크릿을 설정합니다.
|
|
29259
|
-
"env": {
|
|
29260
|
-
"API_SECRET": "<YOUR_PORTONE_API_SECRET>"
|
|
29261
|
-
}
|
|
29262
|
-
}
|
|
29263
|
-
}
|
|
29264
|
-
}
|
|
29265
|
-
```
|
|
29511
|
+
1. [GitHub Releases](https://github.com/portone-io/mcp-server/releases)에서 최신 `portone-mcp-server.dxt` 파일을 다운로드합니다.
|
|
29512
|
+
2. 지원하는 AI 도구(Claude Desktop 등)에서 다운로드한 `.dxt` 파일을 드래그 앤 드롭하거나 열기를 통해 설치합니다.
|
|
29513
|
+
3. 설치 후 도구를 재시작하여 MCP 서버가 정상적으로 등록되었는지 확인합니다.
|
|
29266
29514
|
|
|
29267
29515
|
<div class="hint" data-style="warning">
|
|
29268
29516
|
|
|
29269
|
-
**
|
|
29517
|
+
**Claude Desktop에서 DXT 파일 사용 시 주의사항**
|
|
29270
29518
|
|
|
29271
|
-
|
|
29519
|
+
현재 [알려진 이슈](https://github.com/anthropics/dxt/issues/45)로 인해 Claude Desktop에서 DXT 설치 후 MCP 서버가 정상적으로 작동하지 않을 수 있습니다.
|
|
29520
|
+
|
|
29521
|
+
이 경우 Node.js 22.6.0 이상을 설치하고 Claude Desktop 설정에서 **"MCP용 내장 Node.js 사용"** 옵션을 비활성화한 후 재시작하면 정상적으로 작동합니다.
|
|
29272
29522
|
|
|
29273
29523
|
</div>
|
|
29274
29524
|
|
|
29275
|
-
|
|
29525
|
+
### MCP 서버 등록하기
|
|
29276
29526
|
|
|
29277
|
-
|
|
29527
|
+
1. Node.js 22.6.0 이상이 설치되어 있어야 합니다.
|
|
29278
29528
|
|
|
29279
|
-
|
|
29529
|
+
2. 사용하는 AI 도구의 MCP 설정에서 아래 내용을 추가합니다. (Cursor, Windsurf, Claude Desktop, etc...)
|
|
29280
29530
|
|
|
29281
|
-
|
|
29531
|
+
```jsonc
|
|
29532
|
+
"mcpServers": {
|
|
29533
|
+
|
|
29534
|
+
// 기존 설정
|
|
29535
|
+
|
|
29536
|
+
"portone-mcp-server": {
|
|
29537
|
+
"command": "npx",
|
|
29538
|
+
"args": [
|
|
29539
|
+
"-y",
|
|
29540
|
+
"@portone/mcp-server@latest"
|
|
29541
|
+
]
|
|
29542
|
+
}
|
|
29543
|
+
}
|
|
29544
|
+
```
|
|
29545
|
+
|
|
29546
|
+
3. 도구를 재시작해 portone-mcp-server 및 해당 서버가 제공하는 도구들이 잘 등록되었는지 확인합니다.
|
|
29282
29547
|
|
|
29283
29548
|
<div class="hint" data-style="warning">
|
|
29284
29549
|
|
|
@@ -29289,7 +29554,7 @@ MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않
|
|
|
29289
29554
|
|
|
29290
29555
|
</div>
|
|
29291
29556
|
|
|
29292
|
-
###
|
|
29557
|
+
### MCP 서버 활용하기
|
|
29293
29558
|
|
|
29294
29559
|
사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
|
|
29295
29560
|
|
|
@@ -29534,13 +29799,13 @@ writtenAt: 2023-07-12T00:00:00.000Z
|
|
|
29534
29799
|
|
|
29535
29800
|
## 주요 업데이트 사항
|
|
29536
29801
|
|
|
29537
|
-
### **결제 모듈 V1**✔️
|
|
29802
|
+
### **결제 모듈 V1**✔️ 나이스정보통신의 새로운 결제창을 이용할 수 있습니다
|
|
29538
29803
|
|
|
29539
|
-
포트원을 통해
|
|
29804
|
+
포트원을 통해 나이스정보통신의 새로운 결제창(이하 ‘(신) 나이스정보통신’)을 이용할 수 있습니다. 이번
|
|
29540
29805
|
업데이트를 통해 기존 모듈보다 확장된 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트
|
|
29541
29806
|
호출을 지원합니다.
|
|
29542
29807
|
|
|
29543
|
-
(신)
|
|
29808
|
+
(신) 나이스정보통신에서 이용 가능한 간편결제는 다음과 같습니다.
|
|
29544
29809
|
|
|
29545
29810
|
- 카카오페이
|
|
29546
29811
|
- 네이버페이
|
|
@@ -29553,13 +29818,13 @@ writtenAt: 2023-07-12T00:00:00.000Z
|
|
|
29553
29818
|
|
|
29554
29819
|
이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 회수, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다.
|
|
29555
29820
|
|
|
29556
|
-
(신)
|
|
29821
|
+
(신) 나이스정보통신 이용시 고려해야 하는 조건들이 있으니 다음 문서를 참고하시기 바랍니다.
|
|
29557
29822
|
|
|
29558
|
-
[→ (신)
|
|
29823
|
+
[→ (신)나이스정보통신 일반결제 연동 유의사항](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/payment-caution)
|
|
29559
29824
|
|
|
29560
|
-
[→ (신)
|
|
29825
|
+
[→ (신)나이스정보통신 비인증결제 연동 유의사항(빌링키 발급 및 API 연동)](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution)
|
|
29561
29826
|
|
|
29562
|
-
기존에
|
|
29827
|
+
기존에 나이스정보통신를 이용 중이라면 간편결제사와 별도의 계약없이 간단한 신청만으로 간편결제를
|
|
29563
29828
|
이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이
|
|
29564
29829
|
안내드리겠습니다.
|
|
29565
29830
|
|
|
@@ -29614,7 +29879,7 @@ KCP 인증결제창에서 할인쿠폰 적용 여부를 컨트롤 할수 있는
|
|
|
29614
29879
|
할인쿠폰기능을 사용하기 위해서는 KCP와 협의가 먼저 선행되어야 하는점 유의하세요
|
|
29615
29880
|
|
|
29616
29881
|
본 기능 설정을 위한 자세한 내용은 SDK 가이드 문서를 확인 해주세요
|
|
29617
|
-
[→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/
|
|
29882
|
+
[→ 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)
|
|
29618
29883
|
|
|
29619
29884
|
|
|
29620
29885
|
# https://developers.portone.io/release-notes/api-sdk/2023-08-31
|
|
@@ -29637,7 +29902,7 @@ NHN KCP결제창을 통한 빌링키 발급시 파라미터를 통해 빌링키
|
|
|
29637
29902
|
선택할수 있도록 하였습니다.
|
|
29638
29903
|
|
|
29639
29904
|
본 기능 설정을 위한 자세한 내용은 SDK 가이드 문서를 확인 해주세요
|
|
29640
|
-
[→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/
|
|
29905
|
+
[→ 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)
|
|
29641
29906
|
|
|
29642
29907
|
### **결제 모듈 V1**✔️ 결제 URL 생성 API 지원 PG사 확대
|
|
29643
29908
|
|
|
@@ -29647,7 +29912,7 @@ NHN KCP결제창을 통한 빌링키 발급시 파라미터를 통해 빌링키
|
|
|
29647
29912
|
- (신)스마트로
|
|
29648
29913
|
- KSNET
|
|
29649
29914
|
- (신)페이팔 일반결제/정기결제
|
|
29650
|
-
- (신)
|
|
29915
|
+
- (신)나이스정보통신
|
|
29651
29916
|
|
|
29652
29917
|
|
|
29653
29918
|
# https://developers.portone.io/release-notes/api-sdk/2023-12-15
|
|
@@ -29675,11 +29940,11 @@ writtenAt: 2024-01-08T00:00:00.000Z
|
|
|
29675
29940
|
|
|
29676
29941
|
## 주요 업데이트 사항
|
|
29677
29942
|
|
|
29678
|
-
### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서
|
|
29943
|
+
### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 나이스정보통신 결제를 지원합니다.
|
|
29679
29944
|
|
|
29680
|
-
이제 포트원 V2를 통해
|
|
29945
|
+
이제 포트원 V2를 통해 나이스정보통신 일반결제/정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다.
|
|
29681
29946
|
|
|
29682
|
-
|
|
29947
|
+
나이스정보통신에서 지원하는 결제수단 아래와 같습니다.
|
|
29683
29948
|
|
|
29684
29949
|
- 카드
|
|
29685
29950
|
|
|
@@ -29703,7 +29968,7 @@ writtenAt: 2024-01-08T00:00:00.000Z
|
|
|
29703
29968
|
|
|
29704
29969
|
이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 말소, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다.
|
|
29705
29970
|
|
|
29706
|
-
|
|
29971
|
+
나이스정보통신 연동에 대해 자세히 알고 싶다면 [→ 나이스정보통신 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/nice-v2?v=v2) 에서 확인하실 수 있습니다.
|
|
29707
29972
|
|
|
29708
29973
|
|
|
29709
29974
|
# https://developers.portone.io/release-notes/api-sdk/2024-01-11
|
|
@@ -30083,7 +30348,7 @@ writtenAt: 2024-06-03T00:00:00.000Z
|
|
|
30083
30348
|
|
|
30084
30349
|
**지원 결제대행사**
|
|
30085
30350
|
|
|
30086
|
-
-
|
|
30351
|
+
- 나이스정보통신
|
|
30087
30352
|
- KG이니시스
|
|
30088
30353
|
- 토스페이먼츠
|
|
30089
30354
|
- 스마트로
|
|
@@ -30291,7 +30556,6 @@ writtenAt: 2024-09-05T00:00:00.000Z
|
|
|
30291
30556
|
- 토스
|
|
30292
30557
|
- 카카오
|
|
30293
30558
|
- 네이버
|
|
30294
|
-
- 페이코
|
|
30295
30559
|
- 금융결제원
|
|
30296
30560
|
- KB국민은행
|
|
30297
30561
|
- 신한은행
|
|
@@ -30326,11 +30590,11 @@ writtenAt: 2024-09-30T00:00:00.000Z
|
|
|
30326
30590
|
PG 거래대사 내의 **거래 정산 내역** 메뉴에서 정산일 또는 거래일을 기준으로,
|
|
30327
30591
|
**거래 건별 조회** 메뉴에서는 정산일을 기준으로 최대 3개월 분량의 데이터를 엑셀로 다운로드할 수 있습니다.
|
|
30328
30592
|
|
|
30329
|
-
### **PG 거래대사**✔️ KSNET, KPN
|
|
30593
|
+
### **PG 거래대사**✔️ KSNET, KPN에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다.
|
|
30330
30594
|
|
|
30331
|
-
기존에 12개 PG사 (KCP, KG이니시스,
|
|
30332
|
-
토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN
|
|
30333
|
-
총
|
|
30595
|
+
기존에 12개 PG사 (KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠,
|
|
30596
|
+
토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN까지 확장하여
|
|
30597
|
+
총 14개 PG사 데이터에 한하여 제공됩니다.
|
|
30334
30598
|
|
|
30335
30599
|
(참고 : PG 거래대사 메뉴의 경우 클로즈 베타로 운영되고 있으며,
|
|
30336
30600
|
사용을 원하시는 고객께서는 [PG거래대사 베타서비스 신청 바로가기](https://forms.gle/cZAqJLGqovC1STrS8)에서 신청해 주시길 바랍니다.)
|
|
@@ -30782,6 +31046,57 @@ writtenAt: 2024-09-05T00:00:00.000Z
|
|
|
30782
31046
|
- 좌측 메뉴 영역 상단의 \[계정 정보]를 클릭한 후 \[로그아웃]을 클릭해 주세요.
|
|
30783
31047
|
|
|
30784
31048
|
|
|
31049
|
+
# https://developers.portone.io/release-notes/console/2025-10-17
|
|
31050
|
+
|
|
31051
|
+
---
|
|
31052
|
+
releasedAt: 2025-10-17T00:00:00.000Z
|
|
31053
|
+
writtenAt: 2025-10-17T00:00:00.000Z
|
|
31054
|
+
---
|
|
31055
|
+
|
|
31056
|
+
## 콘솔 일부 설정 업데이트 안내
|
|
31057
|
+
|
|
31058
|
+
안녕하세요, 포트원 입니다.
|
|
31059
|
+
|
|
31060
|
+
더욱 쾌적하고 편리한 서비스 이용을 위해, 콘솔 내의 일부 디자인 시스템이 변경되어 안내해 드립니다.
|
|
31061
|
+
|
|
31062
|
+
---
|
|
31063
|
+
|
|
31064
|
+
## 관리자 콘솔
|
|
31065
|
+
|
|
31066
|
+
### 표설정 기능 업데이트
|
|
31067
|
+
|
|
31068
|
+
기존에는 콘솔에서 확인할 수 있는 다양한 표 내부 컬럼의 순서를 변경할 수 없었습니다. 하지만 이번 업데이트를 통해 표설정 기능을 추가하여 드래그 방식으로 손쉽게 내부 컬럼의 순서를 변경하고, 유지할 수 있습니다. 표설정 기능을 활용하여 더 중요한 정보들을 앞으로 가져오는 등의 편리한 커스터마이징이 가능합니다.
|
|
31069
|
+
|
|
31070
|
+
파트너 정산 서비스 뿐만 아니라 포트원 전자결제를 함께 이용중이라면, 전자결제 서비스의 표 설정 또한 브라우저에 저장될 수 있습니다.
|
|
31071
|
+
|
|
31072
|
+
(이미지 첨부: 표 순서 변경 기능)
|
|
31073
|
+
|
|
31074
|
+
## 파트너 정산
|
|
31075
|
+
|
|
31076
|
+
### 보관함 설정 업데이트
|
|
31077
|
+
|
|
31078
|
+
기존 정산 정책 관리 및 파트너 관리 페이지에서 보관함 보기 토글을 이용하여 보관함을 조회한 후, 페이지를 새로고침하면 보관함이 아닌 일반 정책 목록이 조회되는 현상이 발생했습니다. 업데이트 후에는 보관함 보기 상태로 새로고침을 해도 해당 상태가 풀리지 않고 유지되어 사용 편의성이 높아집니다.
|
|
31079
|
+
|
|
31080
|
+
### 파트너 관리 UI 업데이트
|
|
31081
|
+
|
|
31082
|
+
기존 파트너 관리 페이지의 계약 일괄 변경 페이지에서는 변경할 신규 계약과 정산 시작일 기준 적용 시점만을 선택해야 했고, 계약 아이디로만 계약을 관리했기 때문에 실제 계약 정보 확인 없이 작업을 진행해야 하는 불편함이 있었습니다.
|
|
31083
|
+
|
|
31084
|
+
이제부터는 계약 이름으로 변경할 계약 정보를 직접 검색 및 조회할 수 있게 됩니다. 계약을 선택하면 중개 수수료율, 정산 보류일, 정산 주기와 같은 주요 정산 정보를 즉시 확인할 수 있어 더 정확한 계약 변경이 가능해집니다. 아울러, 정산 시작일 기준 적용 시점을 선택할 때 사용되는 달력 UI도 직관적으로 변경되어 적용 시점 설정이 더욱 쉬워졌습니다.
|
|
31085
|
+
|
|
31086
|
+
(이미지 첨부: 파트너 관리 UI 업데이트)
|
|
31087
|
+
|
|
31088
|
+
### 콘솔 표 설정 업데이트
|
|
31089
|
+
|
|
31090
|
+
정산 상세 조회, 정산 내역 관리, 일괄 지급 내역 관리, 지급 내역 관리, 이체 내역 관리, 일괄 이체 내역 관리, 세금계산서 작성 목록, 세금계산서 내역 관리, 일괄 세금계산서 내역 관리 페이지의 표 설정이 일괄 변경됩니다. 이제 해당 페이지들에서 표(테이블)의 필터 값을 설정한 후 페이지를 새로고침하더라도, 설정했던 필터 값이 초기화되지 않고 그대로 유지됩니다. 따라서 반복적으로 필터를 재설정할 필요 없이 더 빠르고 효율적으로 데이터를 조회할 수 있습니다.
|
|
31091
|
+
|
|
31092
|
+
---
|
|
31093
|
+
|
|
31094
|
+
작성일자: **2025년 10월 17일**
|
|
31095
|
+
|
|
31096
|
+
- 일반 문의: <cs@portone.io> / 채널톡
|
|
31097
|
+
- 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널
|
|
31098
|
+
|
|
31099
|
+
|
|
30785
31100
|
# https://developers.portone.io/release-notes/platform/2023-08-31
|
|
30786
31101
|
|
|
30787
31102
|
---
|
|
@@ -31990,7 +32305,7 @@ writtenAt: 2025-03-17T00:00:00.000Z
|
|
|
31990
32305
|
- 기존 파트너정산자동화 제품을 이용하고 계신 고객이더라도, 세금계산서 역발행 기능 사용을 위해서는 별도 문의가 필요합니다.
|
|
31991
32306
|
|
|
31992
32307
|
- 세금계산서 상태변화 웹훅 및 사업자번호 기업정보조회 API 연동이 필요하신 고객사는
|
|
31993
|
-
[📩 support
|
|
32308
|
+
[📩 tech.support@portone.io](mailto:tech.support@portone.io)로 문의해 주세요.
|
|
31994
32309
|
|
|
31995
32310
|
포트원의 전체 업데이트 소식은 [개발자센터 릴리즈노트](https://developers.portone.io/release-notes) 페이지에서 확인할 수 있습니다.
|
|
31996
32311
|
|
|
@@ -32431,7 +32746,465 @@ writtenAt: 2025-07-07T00:00:00.000Z
|
|
|
32431
32746
|
|
|
32432
32747
|
일반 문의 <cs@portone.io> / 채널톡
|
|
32433
32748
|
|
|
32434
|
-
기술지원 문의 <support@portone.io> / 파트너스 슬랙 채널
|
|
32749
|
+
기술지원 문의 <tech.support@portone.io> / 파트너스 슬랙 채널
|
|
32750
|
+
|
|
32751
|
+
|
|
32752
|
+
# https://developers.portone.io/release-notes/platform/2025-07-23
|
|
32753
|
+
|
|
32754
|
+
---
|
|
32755
|
+
releasedAt: 2025-07-23T00:00:00.000Z
|
|
32756
|
+
writtenAt: 2025-07-23T00:00:00.000Z
|
|
32757
|
+
---
|
|
32758
|
+
|
|
32759
|
+
안녕하세요, 파트너 정산 자동화 팀입니다.
|
|
32760
|
+
|
|
32761
|
+
2025년 7월 23일 업데이트 사항을 확인해 보세요.
|
|
32762
|
+
|
|
32763
|
+
|**업데이트 항목** |**변경 전** |**변경 후** |
|
|
32764
|
+
|:---------------------------------------|:---------------------------------------------------------|:-------------------------------------------------------|
|
|
32765
|
+
|**세금계산서 API 출시** |세금계산서 기능을 콘솔에서만 이용 |**API 제공으로 시스템 연동 및 자동화 가능** |
|
|
32766
|
+
|**세금계산서 정발행 기능 (API) 추가** |역발행만 가능 |**정발행 및 역발행 모두 지원 (API)** |
|
|
32767
|
+
|**정산 정책 관리 사용성 개선** |정책 수정사항 확인 불가 |**정책 수정 히스토리 조회 가능** |
|
|
32768
|
+
|**정산 상세 조회 내 필터 개선** |수기 정산 건 조회 어려움<br />새로고침 시 필터 조건 초기화|**정산일 기준으로 조회<br />새로고침 시 필터 조건 유지**|
|
|
32769
|
+
|**파트너 정산 자동화 제품 UI 색상 변경**|오렌지 컬러 |**블루 컬러** |
|
|
32770
|
+
|
|
32771
|
+
## API 출시 안내
|
|
32772
|
+
|
|
32773
|
+
## 세금계산서 API 출시
|
|
32774
|
+
|
|
32775
|
+
이제 파트너정산 세금계산서 기능을 **콘솔이 아닌 API**로도 이용하실 수 있습니다.
|
|
32776
|
+
|
|
32777
|
+
API를 활용하면 각 기업의 자체 서비스, 백오피스, 외부 시스템과의 연동을 통해 세금계산서 발행, 조회, 관리 등 다양한 업무를 **완전 자동화**할 수 있어, 반복적인 수기 업무의 부담을 크게 줄이고 효율적인 업무 처리가 가능합니다.
|
|
32778
|
+
|
|
32779
|
+
## 세금계산서 정발행 기능 (API) 추가
|
|
32780
|
+
|
|
32781
|
+
기존에는 ‘역발행’만 지원하였으나, 이번 업데이트로 **‘정발행’** 기능이 API에도 포함되었습니다.
|
|
32782
|
+
|
|
32783
|
+
기업간 거래 상황에 따라 어떤 발행 방식이든, 이제는 포트원 하나로 발행 및 관리가 모두 가능해집니다.
|
|
32784
|
+
정발행 기능의 콘솔 지원도 2025년 3분기 내 업데이트 예정이니 많은 기대 부탁드립니다.
|
|
32785
|
+
|
|
32786
|
+
**기술 변경 사항 안내**
|
|
32787
|
+
신규 세금계산서 API 카테고리 및 상세 문서가 [**개발자센터**](https://developers.portone.io/api/rest-v2/b2b.taxInvoice?v=v2) 에 추가되었습니다.
|
|
32788
|
+
기존 콘솔 UI 기반의 역발행 외에, 정발행 기능이 API로 제공됩니다.
|
|
32789
|
+
연동 개발 시 개발자센터의 세금계산서 관련 문서를 참고해주시기 바랍니다.
|
|
32790
|
+
|
|
32791
|
+
---
|
|
32792
|
+
|
|
32793
|
+
## 파트너 정산 자동화 제품 개선 안내
|
|
32794
|
+
|
|
32795
|
+
### 정산 정책 관리 사용성 개선
|
|
32796
|
+
|
|
32797
|
+
정산 정책 관리 페이지의 사용성이 개선되었습니다.
|
|
32798
|
+
|
|
32799
|
+
- 페이지 사용성 개선
|
|
32800
|
+
|
|
32801
|
+
계약 등록 및 상세 조회, 할인 분담 정책 등록 및 상세 조회, 추가 수수료 정책 등록 및 상세 조회 등 정산 정책 관리 내의 다양한 페이지의 사용성이 개선되었습니다.
|
|
32802
|
+
|
|
32803
|
+
- 계약 내용 수정 이력 조회 기능 추가
|
|
32804
|
+
|
|
32805
|
+
계약 관리 페이지에서 계약 내용 수정 시, 수정 사항을 확인할 수 있는 히스토리 조회 기능이 추가되었습니다.\
|
|
32806
|
+
이제 계약 상세 페이지에서 변경 이력을 확인할 수 있어 더 효율적이고 투명한 계약 관리가 가능합니다.
|
|
32807
|
+
|
|
32808
|
+
(관련 이미지 첨부)
|
|
32809
|
+
|
|
32810
|
+
### 정산 상세 조회 내 필터 개선
|
|
32811
|
+
|
|
32812
|
+
정산 상세 조회 페이지에서 더욱 편리하게 정산 내역을 확인하실 수 있도록 필터 기능이 개선되었습니다.
|
|
32813
|
+
|
|
32814
|
+
- 기본 조회 기준 변경
|
|
32815
|
+
|
|
32816
|
+
정산 건 조회 시 기본 조회 기준이 기존 '정산 기준일'에서 '정산일'로 변경되었습니다.
|
|
32817
|
+
정산 시작일이 설정되지 않은 수기 정산 건도 쉽게 조회할 수 있습니다.
|
|
32818
|
+
|
|
32819
|
+
- 기본 조회 기간 확대
|
|
32820
|
+
기존 30일 → 90일로 확대되어 더 넓은 범위의 데이터를 한 번에 확인하실 수 있습니다.
|
|
32821
|
+
|
|
32822
|
+
- 필터 조건 유지 및 버그 수정
|
|
32823
|
+
|
|
32824
|
+
정산 건을 검색할 때 미리 지정한 필터값이 해제되던 버그가 수정되었으며,
|
|
32825
|
+
이제 페이지를 새로 고침 시에도 이전에 설정한 필터 조건이 그대로 유지됩니다.
|
|
32826
|
+
|
|
32827
|
+
(관련 이미지 첨부)
|
|
32828
|
+
|
|
32829
|
+
### 파트너 정산 자동화 제품 사용자 인터페이스 색상 변경
|
|
32830
|
+
|
|
32831
|
+
파트너 정산 자동화 제품의 전반적인 사용자 인터페이스 색상이 기존 오렌지에서 블루로 변경되었습니다.
|
|
32832
|
+
|
|
32833
|
+
---
|
|
32834
|
+
|
|
32835
|
+
작성일자: **2025년 07월 23일**
|
|
32836
|
+
|
|
32837
|
+
- 일반 문의: <cs@portone.io> / 채널톡
|
|
32838
|
+
- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
|
|
32839
|
+
|
|
32840
|
+
|
|
32841
|
+
# https://developers.portone.io/release-notes/platform/2025-08-13
|
|
32842
|
+
|
|
32843
|
+
---
|
|
32844
|
+
releasedAt: 2025-08-13T00:00:00.000Z
|
|
32845
|
+
writtenAt: 2025-08-13T00:00:00.000Z
|
|
32846
|
+
---
|
|
32847
|
+
|
|
32848
|
+
안녕하세요, 파트너 정산 자동화 팀입니다.
|
|
32849
|
+
|
|
32850
|
+
2025년 8월 13일 업데이트 사항을 확인해 보세요.
|
|
32851
|
+
|
|
32852
|
+
---
|
|
32853
|
+
|
|
32854
|
+
## 정산 내역서 발송 기능 업데이트
|
|
32855
|
+
|
|
32856
|
+
이제, 파트너 정산 콘솔에서 생성된 정산 내역을 기반으로, 파트너에게 정산 내역서를 보낼 수 있습니다.
|
|
32857
|
+
|
|
32858
|
+
일괄지급 내역 상세 및 지급 내역 관리 페이지에서 원하는 정산 내역을 단건, 혹은 다건으로 선택하여 한 번에 정산내역서 이메일을 발송할 수 있습니다.
|
|
32859
|
+
|
|
32860
|
+
**발신자/수신자 설정**: 발신자 이메일 설정은 필수이며, 도메인 인증을 통해 도메인을 활용한 발신이 가능합니다. 인증 완료된 도메인이 없는 경우, 기본 메일 <no-reply@portone.io>로 정산내역서를 발송할 수 있습니다.
|
|
32861
|
+
|
|
32862
|
+
수신자 이메일은 등록해 둔 파트너의 담당자 이메일로 지정되고, 담당자 이메일을 수정하는 것으로 수신자 이메일을 수정할 수 있습니다. 모든 설정을 완료하고, '정산내역서 발송' 버튼을 클릭하면 선택된 지급 내역의 파트너 전체에게 이메일이 차례대로 발송됩니다.
|
|
32863
|
+
|
|
32864
|
+
(관련 이미지 첨부)
|
|
32865
|
+
|
|
32866
|
+
---
|
|
32867
|
+
|
|
32868
|
+
## 정산 내역서 템플릿 생성 및 수정
|
|
32869
|
+
|
|
32870
|
+
정산 내역서 템플릿을 자유롭게 생성하고, 수정할 수 있습니다.
|
|
32871
|
+
|
|
32872
|
+
정산내역서 템플릿 관리 페이지에서 템플릿을 다양하게 만들어 관리할 수 있습니다. 지급 내역 생성 여부와 관계없이 템플릿을 생성할 수 있으며, 템플릿 목록 조회, 신규 생성 및 수정, 보관, 복원이 가능합니다. 템플릿 구성 항목의 포함 여부(on/off)를 관리할 수 있고, 구성 항목은 다음과 같습니다.
|
|
32873
|
+
|
|
32874
|
+
(관련 이미지 첨부)
|
|
32875
|
+
|
|
32876
|
+
**발신자 정보**
|
|
32877
|
+
|
|
32878
|
+
- 우리 회사 상호
|
|
32879
|
+
|
|
32880
|
+
**수신자(파트너) 정보**
|
|
32881
|
+
|
|
32882
|
+
- 파트너 이름 및 법인명
|
|
32883
|
+
- 파트너 유형
|
|
32884
|
+
- 과세, 소득 유형
|
|
32885
|
+
- 예금주명
|
|
32886
|
+
- 은행정보 (계좌번호 및 은행명)
|
|
32887
|
+
|
|
32888
|
+
**정산 기본 정보**
|
|
32889
|
+
|
|
32890
|
+
- 정산 기간
|
|
32891
|
+
|
|
32892
|
+
**정산 금액 정보**
|
|
32893
|
+
|
|
32894
|
+
- 지급 금액 (필수값)
|
|
32895
|
+
- 원천징수세액 (소득세, 지방 소득세)
|
|
32896
|
+
- 정산 금액
|
|
32897
|
+
- 확정 공급가액
|
|
32898
|
+
- 확정 부가세액
|
|
32899
|
+
- 정산 면세액
|
|
32900
|
+
- 확정 면세액
|
|
32901
|
+
|
|
32902
|
+
---
|
|
32903
|
+
|
|
32904
|
+
## 지급 내역에서 정산 내역서의 상태를 확인
|
|
32905
|
+
|
|
32906
|
+
지급 내역 페이지에서 정산 내역서 상태 컬럼이 추가되어 발송 상태를 확인할 수 있습니다.
|
|
32907
|
+
|
|
32908
|
+
지급 내역 페이지에 `정산내역서 상태`, `정산내역서 ID`, `정산내역서 발송 일시` 컬럼이 추가됩니다. 정산 내역서의 상태는 정산내역서가 아직 생성 및 발송되지 않은 상태인 **미발송**, 이메일이 수신자에게 성공적으로 전달된 **발송 완료**, 이메일 발송을 시도했으나, 주소 오류 등의 이유로 실패한 상태인 **발송 실패** 총 3개의 상태가 존재합니다.
|
|
32909
|
+
|
|
32910
|
+
(관련 이미지 첨부)
|
|
32911
|
+
|
|
32912
|
+
---
|
|
32913
|
+
|
|
32914
|
+
## API 변경 안내
|
|
32915
|
+
|
|
32916
|
+
지급내역 `PlatformPayout` 에 정산내역서 요약 정보가 추가되었고, 지급내역 다건 조회 시 정산내역서 정보를 기준으로 필터링할 수 있습니다.
|
|
32917
|
+
|
|
32918
|
+
**지급 내역** `PlatformPayout` **필드 추가**
|
|
32919
|
+
|
|
32920
|
+
신규 필드: `settlementStatement`: `PlatformPayoutSettlementStatementSummary`
|
|
32921
|
+
|
|
32922
|
+
- `id` – 정산내역서 아이디
|
|
32923
|
+
- `status` – 정산내역서 상태
|
|
32924
|
+
- `issuedAt` – 정산내역서 발송 일시
|
|
32925
|
+
|
|
32926
|
+
**지급 내역 필터** `PlatformPayoutFilterInput` **옵션 추가**
|
|
32927
|
+
|
|
32928
|
+
- `settlementStatementStatuses`: 정산내역서 상태
|
|
32929
|
+
- `criteria.settlementStatementIssuedTimestampRange`: 정산내역서 발송 일시 범위
|
|
32930
|
+
- `criteria.settlementStatementId`: 정산내역서 아이디
|
|
32931
|
+
|
|
32932
|
+
---
|
|
32933
|
+
|
|
32934
|
+
작성일자: **2025년 08월 13일**
|
|
32935
|
+
|
|
32936
|
+
- 일반 문의: <cs@portone.io> / 채널톡
|
|
32937
|
+
- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
|
|
32938
|
+
|
|
32939
|
+
|
|
32940
|
+
# https://developers.portone.io/release-notes/platform/2025-08-21
|
|
32941
|
+
|
|
32942
|
+
---
|
|
32943
|
+
releasedAt: 2025-08-21T00:00:00.000Z
|
|
32944
|
+
writtenAt: 2025-08-21T00:00:00.000Z
|
|
32945
|
+
---
|
|
32946
|
+
|
|
32947
|
+
안녕하세요, 파트너 정산 자동화 팀입니다.
|
|
32948
|
+
|
|
32949
|
+
2025년 8월 21일 업데이트 사항을 확인해 보세요.
|
|
32950
|
+
|
|
32951
|
+
---
|
|
32952
|
+
|
|
32953
|
+
## 세금계산서 정발행 기능 출시
|
|
32954
|
+
|
|
32955
|
+
고객에게 발행하는 정발행 세금계산서를 발행하고 관리할 수 있습니다.
|
|
32956
|
+
|
|
32957
|
+
이제, 역발행 뿐 아니라 정발행 기능을 콘솔에서 사용할 수 있습니다. 단건 발행 및 일괄 발행으로 정발행 세금계산서를 발행할 수 있게 되어 정산뿐만 아니라 모든 거래에 대한 세금계산서 커버가 가능해집니다.
|
|
32958
|
+
|
|
32959
|
+
기존 역발행과 다르게 정발행은 파트너 등록 및 <strong>국세청 연동 없이</strong> 이용할 수 있으며, 파트너 등록을 하지 않더라도 정발행시 입력한 공급받는 자(거래처) 정보를 다시 불러와 사용할 수 있습니다.
|
|
32960
|
+
|
|
32961
|
+
(관련 이미지 첨부)
|
|
32962
|
+
|
|
32963
|
+
---
|
|
32964
|
+
|
|
32965
|
+
## 엑셀, CSV 일괄 정/역발행
|
|
32966
|
+
|
|
32967
|
+
기존 일괄 세금계산서 발행은 CSV 파일만 지원되었지만, 이번 업데이트를 통해 엑셀 파일 업로드도 가능해집니다. 제공되는 엑셀 및 CSV 파일 양식을 다운로드 받아 일괄적으로 세금계산서를 작성하여 업로드할 수 있습니다. 기존 역발행과 동일하게 미리보기 후 임시 저장하거나 즉시 발행할 수 있습니다.
|
|
32968
|
+
|
|
32969
|
+
(관련 이미지 첨부)
|
|
32970
|
+
|
|
32971
|
+
---
|
|
32972
|
+
|
|
32973
|
+
## 세금계산서 내역 관리
|
|
32974
|
+
|
|
32975
|
+
기존 역발행 건과 정발행 건의 자연스러운 통합을 위해 세금계산서 내역 관리 페이지에 발행 유형 필터가 추가됩니다. 세금계산서 내역 테이블 내 사업자 정보 컬럼이 기존 공급자 정보에서 거래처(공급자/공급받는자) 정보로 변경되어 역발행의 경우 공급자, 정발행의 경우 공급받는자 정보가 표기됩니다.
|
|
32976
|
+
|
|
32977
|
+
일괄 세금계산서 내역 관리 페이지에서 발행 대기 상태와 발행 실패 상태가 추가됩니다. 발행 대기 상태는 일괄 세금계산서 발행 처리 중 상태를 의미하며 발행 실패 상태는 시스템 처리 실패를 의미합니다. 또한 정발행과 역발행을 구분하는 발행 유형 정보 및 필터가 추가됩니다.
|
|
32978
|
+
|
|
32979
|
+
(관련 이미지 첨부)
|
|
32980
|
+
|
|
32981
|
+
---
|
|
32982
|
+
|
|
32983
|
+
## 세금계산서 안내 메일 발송
|
|
32984
|
+
|
|
32985
|
+
공급받는 자에게 이메일이 발송됩니다.
|
|
32986
|
+
|
|
32987
|
+
세금계산서를 발행하는 시점에 공급받는자 (고객) 에게 팝빌 (포트원과 연동된 세금계산서 서비스) 로부터 이메일이 발송됩니다. 공급자는 발행 주체이므로, 별도의 알림 이메일은 발송되지 않습니다.
|
|
32988
|
+
|
|
32989
|
+
---
|
|
32990
|
+
|
|
32991
|
+
작성일자: **2025년 08월 21일**
|
|
32992
|
+
|
|
32993
|
+
- 일반 문의: <cs@portone.io> / 채널톡
|
|
32994
|
+
- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
|
|
32995
|
+
|
|
32996
|
+
|
|
32997
|
+
# https://developers.portone.io/release-notes/platform/2025-08-28
|
|
32998
|
+
|
|
32999
|
+
---
|
|
33000
|
+
releasedAt: 2025-08-28T00:00:00.000Z
|
|
33001
|
+
writtenAt: 2025-08-28T00:00:00.000Z
|
|
33002
|
+
---
|
|
33003
|
+
|
|
33004
|
+
안녕하세요, 파트너 정산 자동화 팀입니다.
|
|
33005
|
+
|
|
33006
|
+
2025년 8월 28일 업데이트 사항을 확인해 보세요.
|
|
33007
|
+
|
|
33008
|
+
---
|
|
33009
|
+
|
|
33010
|
+
## 2단계 인증수단
|
|
33011
|
+
|
|
33012
|
+
### 2단계 인증수단이란?
|
|
33013
|
+
|
|
33014
|
+
관리자 계정 접근 및 이체 실행 시, 공동 인증서 외에 다른 방식의 인증 절차를 요구하여 보안을 유지하는 방식입니다. 포트원은 2단계 인증 수단으로 Google Authenticator (Google OTP) 를 사용합니다. 파트너 정산을 이용하시는 고객님의 빠르고 편리한 이체를 돕기 위해 관리자 콘솔에서 2단계 인증 수단을 이용할 수 있습니다.
|
|
33015
|
+
|
|
33016
|
+
---
|
|
33017
|
+
|
|
33018
|
+
## 이체 시 2단계 인증수단 업데이트
|
|
33019
|
+
|
|
33020
|
+
### 공동인증서 없이 2단계 인증수단 (OTP) 을 이용하여 쉽게 이체하세요.
|
|
33021
|
+
|
|
33022
|
+
이제, 공동인증서 없이 콘솔에서 2단계 인증수단을 이용하여 손쉽게 이체를 진행할 수 있습니다. 설정의 내 정보 관리탭에서 2차인증을 눌러 Google Authenticator 를 등록하여 2단계 인증 수단으로 설정할 수 있습니다. 등록이 완료되면 송금대행 일괄이체 실행 페이지의 최종 단계에서 전자서명 대신 2단계 인증번호를 입력할 수 있는 다이얼로그가 노출됩니다.
|
|
33023
|
+
|
|
33024
|
+
(이미지 첨부: 2단계 인증번호 입력 화면)
|
|
33025
|
+
|
|
33026
|
+
---
|
|
33027
|
+
|
|
33028
|
+
## 보안 관련 사항
|
|
33029
|
+
|
|
33030
|
+
### 2단계 인증수단 신청 방식
|
|
33031
|
+
|
|
33032
|
+
공동인증서 대신 2단계 인증수단 등록을 위해서는 포트원 세일즈/CS 팀으로 요청하셔야하며, <bd@portone.io> 를 통해 요청하실 수 있습니다. 요청이 완료되었더라도, 2단계 인증 설정이 완료된 Admin 계정의 유저만 사용이 가능합니다.
|
|
33033
|
+
|
|
33034
|
+
또한, 강력한 보안 조치를 위해 포트원 관리자 콘솔 세션 접근 시 인증을 진행하였더라도, 이체 시에 2단계 인증 수단을 통한 재인증이 요구됩니다.
|
|
33035
|
+
|
|
33036
|
+
---
|
|
33037
|
+
|
|
33038
|
+
## 가상계좌 과출금 방지 기능 업데이트
|
|
33039
|
+
|
|
33040
|
+
### 권장 출금 금액보다 많은 금액을 인출할 때 과출금 방지 경고를 받습니다.
|
|
33041
|
+
|
|
33042
|
+
실시간으로 안전한 출금을 지원하고, 과출금 리스크를 방지하기 위해 과출금 방지 기능이 업데이트 되었습니다. 권장 출금 금액 (계좌 잔액 - 예상 지급 금액) 을 자동 계산하여, 권장 출금 금액보다 많은 금액을 출금하려고 할 때 과출금 방지 경고를 받을 수 있습니다. 예상 지급 금액은 정산내역과 지급내역을 통해 계산되며, 가상계좌 출금 페이지에서 예상 지급 금액 정보를 바로 확인할 수 있습니다.
|
|
33043
|
+
|
|
33044
|
+
(이미지 첨부: 과출금 방지 화면)
|
|
33045
|
+
|
|
33046
|
+
---
|
|
33047
|
+
|
|
33048
|
+
작성일자: **2025년 08월 28일**
|
|
33049
|
+
|
|
33050
|
+
- 일반 문의: <cs@portone.io> / 채널톡
|
|
33051
|
+
- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
|
|
33052
|
+
|
|
33053
|
+
|
|
33054
|
+
# https://developers.portone.io/release-notes/platform/2025-10-02
|
|
33055
|
+
|
|
33056
|
+
---
|
|
33057
|
+
releasedAt: 2025-10-02T00:00:00.000Z
|
|
33058
|
+
writtenAt: 2025-10-02T00:00:00.000Z
|
|
33059
|
+
---
|
|
33060
|
+
|
|
33061
|
+
안녕하세요, 파트너 정산 자동화 팀입니다.
|
|
33062
|
+
|
|
33063
|
+
파트너 정산 자동화 제품의 테스트 환경 확장에 따른 API 변경 사항을 안내드립니다.
|
|
33064
|
+
|
|
33065
|
+
---
|
|
33066
|
+
|
|
33067
|
+
## \[파트너 정산 자동화] 테스트 환경 분리 및 API 변경 사전 안내
|
|
33068
|
+
|
|
33069
|
+
이번 업데이트로 운영 환경과 테스트 환경이 완전히 분리되어, 설정·정산 정책·내역서 템플릿 등을 독립적으로 관리하실 수 있습니다.
|
|
33070
|
+
|
|
33071
|
+
## 주요 변경 사항
|
|
33072
|
+
|
|
33073
|
+
- 신규 쿼리 파라미터: test: Boolean (선택값)
|
|
33074
|
+
|
|
33075
|
+
- 적용 대상: 모든 파트너 정산 REST API
|
|
33076
|
+
|
|
33077
|
+
- 적용 예정 일자: 2025년 11월 중 (정확한 일자는 추후 별도 안내 예정)
|
|
33078
|
+
|
|
33079
|
+
- 기본값: false
|
|
33080
|
+
|
|
33081
|
+
- 연동 환경 별 설정
|
|
33082
|
+
- 라이브: 하위호환성이 보장되어 영향이 없습니다.
|
|
33083
|
+
- 테스트: test=true 쿼리 파라미터 추가 설정이 필요합니다.
|
|
33084
|
+
|
|
33085
|
+
(이미지 첨부: as is - to be)
|
|
33086
|
+
|
|
33087
|
+
이번 변경으로 라이브/테스트 환경이 완전히 분리되어 더욱 자유로운 테스트가 가능해집니다.\
|
|
33088
|
+
_기존 데이터는 테스트 및 라이브 환경에 복제되어 기존 그대로 활용하실 수 있습니다._
|
|
33089
|
+
|
|
33090
|
+
---
|
|
33091
|
+
|
|
33092
|
+
## 개선 사항
|
|
33093
|
+
|
|
33094
|
+
### 1. 정산 정책 및 수식 테스트 환경 분리
|
|
33095
|
+
|
|
33096
|
+
기존에는 정산 정책 및 정산 수식을 변경할 때 별도의 테스트 환경이 없어 운영에 영향을 줄 우려가 있었습니다.\
|
|
33097
|
+
이번 개선으로 라이브 환경과 완전히 분리된 테스트 환경을 제공하여, 정산 정책 및 수식을 실제 운영에 영향 없이 안전하게 테스트할 수 있습니다.
|
|
33098
|
+
|
|
33099
|
+
### 2. 파트너 데이터 환경 분리
|
|
33100
|
+
|
|
33101
|
+
테스트를 위해 등록한 파트너가 라이브 데이터에 그대로 남아 실제 파트너와 함께 조회되는 불편함이 있었습니다.\
|
|
33102
|
+
테스트용 파트너는 테스트 환경에 별도로 등록하여, 실제 파트너 데이터와 분리하여 관리할 수 있습니다.
|
|
33103
|
+
|
|
33104
|
+
### 3. 국세청 연동 환경 분리
|
|
33105
|
+
|
|
33106
|
+
국세청 연동 시 라이브와 테스트 환경에 동시에 연동되어 불필요한 연동 안내 메일을 중복으로 받는 문제가 있었습니다.\
|
|
33107
|
+
환경별로 독립적인 국세청 연동이 가능해져 필요한 환경에서만 선택적으로 연동할 수 있습니다.
|
|
33108
|
+
|
|
33109
|
+
---
|
|
33110
|
+
|
|
33111
|
+
## 세부 변경 사항
|
|
33112
|
+
|
|
33113
|
+
### 1. 기존 요청 본문에서 테스트 환경 구분이 가능한 API
|
|
33114
|
+
|
|
33115
|
+
요청 본문(body)의 `isForTest` 파라미터로 환경을 지정하던 방식은 deprecated 되었습니다.\
|
|
33116
|
+
쿼리 파라미터 `test`로 대체 해 주시기 바랍니다. deprecated 필드는 2026년 이후 별도 공지와 함께 지원이 중단될 예정입니다.
|
|
33117
|
+
|
|
33118
|
+
```http
|
|
33119
|
+
#Query Parameter가 우선 적용
|
|
33120
|
+
POST /platform/transfers/order?test=true
|
|
33121
|
+
{
|
|
33122
|
+
"isForTest": false, // 무시됨, Query Parameter의 true가 적용
|
|
33123
|
+
...
|
|
33124
|
+
}
|
|
33125
|
+
|
|
33126
|
+
#Query Parameter 가 없으면 Request Body 값 사용
|
|
33127
|
+
POST /platform/transfers/order
|
|
33128
|
+
{
|
|
33129
|
+
"isForTest": true, // 이 값이 적용
|
|
33130
|
+
...
|
|
33131
|
+
}
|
|
33132
|
+
```
|
|
33133
|
+
|
|
33134
|
+
우선순위는 아래와 같습니다.
|
|
33135
|
+
|
|
33136
|
+
1. Query Parameter 의미 `test` (최우선)
|
|
33137
|
+
2. Request Body 의 `isForTest` (Query Parameter 없을 때)
|
|
33138
|
+
3. 기본값 `false` (둘 다 없을 때)
|
|
33139
|
+
|
|
33140
|
+
영향 받는 API는 다음과 같습니다.
|
|
33141
|
+
|
|
33142
|
+
- 정산 상세 내역 다운로드 `GET /platform/transfer-summaries/sheet-file`
|
|
33143
|
+
- 정산건 다건 조회 `GET /platform/transfer-summaries`
|
|
33144
|
+
- 수기 정산건 생성 `POST /platform/transfers/manual`
|
|
33145
|
+
- 주문 정산건 생성 `POST /platform/transfers/order`
|
|
33146
|
+
- 주문 취소 정산건 생성 `POST /platform/transfers/order-cancel`
|
|
33147
|
+
- 정산 내역 다건 조회 `GET /platform/partner-settlements`
|
|
33148
|
+
- 지급 내역 다건 조회 `GET /platform/payouts`
|
|
33149
|
+
- 일괄 지급 내역 다건 조회 `GET /platform/bulk-payouts`
|
|
33150
|
+
- 이체 내역 다건 조회 `GET /platform/account-transfers`
|
|
33151
|
+
- 일괄 이체 내역 다건 조회 `GET /platform/bulk-account-transfers`
|
|
33152
|
+
|
|
33153
|
+
### 2. 테스트 환경 지정이 필요한 API
|
|
33154
|
+
|
|
33155
|
+
테스트 환경 지정을 위해 쿼리 파라미터 `test`가 추가되었습니다.\
|
|
33156
|
+
해당 파라미터는 선택 값이며 기본값은 `false`입니다.
|
|
33157
|
+
|
|
33158
|
+
```http
|
|
33159
|
+
#라이브 환경 데이터만 조회 (기본값)
|
|
33160
|
+
GET /platform/transfers/{id}
|
|
33161
|
+
|
|
33162
|
+
#테스트 환경 데이터만 조회
|
|
33163
|
+
GET /platform/transfers/{id}?test=true
|
|
33164
|
+
```
|
|
33165
|
+
|
|
33166
|
+
영향 받는 API는 다음과 같습니다.
|
|
33167
|
+
|
|
33168
|
+
- 정산건 조회 `GET /platform/transfers/{id}`
|
|
33169
|
+
- 정산건 삭제 `DELETE /platform/transfers/{id}`
|
|
33170
|
+
- 추가 수수료 정책 다건 조회 `GET /platform/additional-fee-policies`
|
|
33171
|
+
- 추가 수수료 정책 생성 `POST /platform/additional-fee-policies`
|
|
33172
|
+
- 추가 수수료 정책 조회 `GET /platform/additional-fee-policies/{id}`
|
|
33173
|
+
- 추가 수수료 정책 수정 `PATCH /platform/additional-fee-policies/{id}`
|
|
33174
|
+
- 추가 수수료 정책 보관 `POST /platform/additional-fee-policies/{id}/archive`
|
|
33175
|
+
- 추가 수수료 정책 복원 `POST /platform/additional-fee-policies/{id}/recover`
|
|
33176
|
+
- 계약 다건 조회 `GET /platform/contracts`
|
|
33177
|
+
- 계약 생성 `POST /platform/contracts`
|
|
33178
|
+
- 계약 조회 `GET /platform/contracts/{id}`
|
|
33179
|
+
- 계약 수정 `PATCH /platform/contracts/{id}`
|
|
33180
|
+
- 계약 보관 `POST /platform/contracts/{id}/archive`
|
|
33181
|
+
- 계약 복원 `POST /platform/contracts/{id}/recover`
|
|
33182
|
+
- 할인 분담 정책 다건 조회 `GET /platform/discount-share-policies`
|
|
33183
|
+
- 할인 분담 정책 생성 `POST /platform/discount-share-policies`
|
|
33184
|
+
- 할인 분담 정책 조회 `GET /platform/discount-share-policies/{id}`
|
|
33185
|
+
- 할인 분담 정책 수정 `PATCH /platform/discount-share-policies/{id}`
|
|
33186
|
+
- 할인 분담 정책 보관 `POST /platform/discount-share-policies/{id}/archive`
|
|
33187
|
+
- 할인 분담 정책 복원 `POST /platform/discount-share-policies/{id}/recover`
|
|
33188
|
+
- 파트너 다건 조회 `GET /platform/partners`
|
|
33189
|
+
- 파트너 생성 `POST /platform/partners`
|
|
33190
|
+
- 파트너 다건 생성 `POST /platform/partners/batch`
|
|
33191
|
+
- 파트너 일괄 국세청 연동 `POST /platform/partners/member-company-connect`
|
|
33192
|
+
- 파트너 국세청 연동 `POST /platform/partners/member-company-connect/{id}`
|
|
33193
|
+
- 파트너 일괄 국세청 연동 해제 `POST /platform/partners/member-company-disconnect`
|
|
33194
|
+
- 파트너 국세청 연동 해제 `POST /platform/partners/member-company-disconnect/{id}`
|
|
33195
|
+
- 파트너 조회 `GET /platform/partners/{id}`
|
|
33196
|
+
- 파트너 수정 `PATCH /platform/partners/{id}`
|
|
33197
|
+
- 파트너 보관 `POST /platform/partners/{id}/archive`
|
|
33198
|
+
- 파트너 복원 `POST /platform/partners/{id}/recover`
|
|
33199
|
+
- 예금주 조회 `GET /platform/bank-accounts/{bank}/{accountNumber}/holder`
|
|
33200
|
+
- 사업자 조회 `GET /platform/companies/{businessRegistrationNumber}/state`
|
|
33201
|
+
|
|
33202
|
+
---
|
|
33203
|
+
|
|
33204
|
+
작성일자: **2025년 10월 02일**
|
|
33205
|
+
|
|
33206
|
+
- 일반 문의: <cs@portone.io> / 채널톡
|
|
33207
|
+
- 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널
|
|
32435
33208
|
|
|
32436
33209
|
|
|
32437
33210
|
# https://developers.portone.io/blog/posts/2024-02/v2-oom
|