├── .github └── workflows │ ├── cd.yml │ └── ci.yml ├── .gitignore ├── .python-version ├── CLAUDE.md ├── LICENSE ├── README.md ├── pyproject.toml ├── src └── portone_mcp_server │ ├── __init__.py │ ├── loader │ ├── __init__.py │ ├── markdown.py │ └── schema.py │ ├── resources │ ├── docs │ │ ├── README.md │ │ ├── api │ │ │ └── backward-compatibility.md │ │ ├── blog │ │ │ └── posts │ │ │ │ ├── 2024-02 │ │ │ │ ├── v2-oom.md │ │ │ │ ├── v2-webhook.md │ │ │ │ └── v2-zio.md │ │ │ │ ├── 2024-03 │ │ │ │ └── tgs.md │ │ │ │ ├── 2024-04 │ │ │ │ ├── gcp-datastream.md │ │ │ │ └── solid.md │ │ │ │ └── 2024-07 │ │ │ │ └── v2-event-sourcing-basic.md │ │ ├── help │ │ │ ├── admin-console │ │ │ │ ├── analytics │ │ │ │ │ └── content32.md │ │ │ │ ├── console-account │ │ │ │ │ └── content31.md │ │ │ │ ├── console_home │ │ │ │ │ └── content34.md │ │ │ │ ├── integration │ │ │ │ │ └── content28.md │ │ │ │ ├── payment-service │ │ │ │ │ └── content29.md │ │ │ │ ├── pg-settlement │ │ │ │ │ └── content30.md │ │ │ │ └── platform-settlement │ │ │ │ │ └── content33.md │ │ │ ├── api-sdk-2024-12-19.md │ │ │ ├── applepay.md │ │ │ ├── content100000.md │ │ │ ├── content100002.md │ │ │ ├── content100004.md │ │ │ ├── content100014.md │ │ │ ├── content100015.md │ │ │ ├── content100016.md │ │ │ ├── content100020.md │ │ │ ├── content100022.md │ │ │ ├── content100023.md │ │ │ ├── content100024.md │ │ │ ├── content100025.md │ │ │ ├── content100026.md │ │ │ ├── content100027.md │ │ │ ├── content100029.md │ │ │ ├── content100030.md │ │ │ ├── content100033.md │ │ │ ├── content100035.md │ │ │ ├── content100036.md │ │ │ ├── content100037.md │ │ │ ├── content100038.md │ │ │ ├── content100039.md │ │ │ ├── content100040.md │ │ │ ├── content100041.md │ │ │ ├── content100044.md │ │ │ ├── content100045.md │ │ │ ├── content100046.md │ │ │ ├── content100047.md │ │ │ ├── content100048.md │ │ │ ├── content100049.md │ │ │ ├── content100052.md │ │ │ ├── content100053.md │ │ │ ├── content100054.md │ │ │ ├── content100055.md │ │ │ ├── content100056.md │ │ │ ├── content100057.md │ │ │ ├── content100058.md │ │ │ ├── content100059.md │ │ │ ├── content100060.md │ │ │ ├── content200001.md │ │ │ ├── content200002.md │ │ │ ├── content200005.md │ │ │ ├── content200012.md │ │ │ ├── content200013.md │ │ │ ├── content200015.md │ │ │ ├── content200016.md │ │ │ ├── content200017.md │ │ │ ├── content200018.md │ │ │ ├── content200019.md │ │ │ ├── content200020.md │ │ │ ├── content200023.md │ │ │ ├── content200024.md │ │ │ ├── content200025.md │ │ │ ├── content200027.md │ │ │ ├── content200028.md │ │ │ ├── content200029.md │ │ │ ├── content200030.md │ │ │ ├── content200032.md │ │ │ ├── content200033.md │ │ │ ├── content200034.md │ │ │ ├── content200037.md │ │ │ ├── content200038.md │ │ │ ├── content200039.md │ │ │ ├── content200040.md │ │ │ ├── content200043.md │ │ │ ├── content200044.md │ │ │ ├── content200045.md │ │ │ ├── content200046.md │ │ │ ├── content200048.md │ │ │ ├── content200049.md │ │ │ ├── content200050.md │ │ │ ├── content200051.md │ │ │ ├── content51.md │ │ │ ├── content61.md │ │ │ ├── core-service │ │ │ │ ├── channel-setting │ │ │ │ │ ├── danal.md │ │ │ │ │ ├── daou.md │ │ │ │ │ ├── eximbay.md │ │ │ │ │ ├── inicis.md │ │ │ │ │ ├── kakaopay.md │ │ │ │ │ ├── kcp_channel.md │ │ │ │ │ ├── kicc.md │ │ │ │ │ ├── kpn.md │ │ │ │ │ ├── ksnet.md │ │ │ │ │ ├── mobilians.md │ │ │ │ │ ├── naverpay.md │ │ │ │ │ ├── nice.md │ │ │ │ │ ├── payco.md │ │ │ │ │ ├── paymentwall.md │ │ │ │ │ ├── paypal.md │ │ │ │ │ ├── settle.md │ │ │ │ │ ├── smartro.md │ │ │ │ │ ├── smilepay.md │ │ │ │ │ ├── tosspay.md │ │ │ │ │ ├── tosspayments.md │ │ │ │ │ └── welcome.md │ │ │ │ ├── how-to-use │ │ │ │ │ ├── additional-danal.md │ │ │ │ │ ├── additional-daou.md │ │ │ │ │ ├── additional-eximbay.md │ │ │ │ │ ├── additional-inicis.md │ │ │ │ │ ├── additional-kakaopay.md │ │ │ │ │ ├── additional-kcp.md │ │ │ │ │ ├── additional-kicc.md │ │ │ │ │ ├── additional-ksnet.md │ │ │ │ │ ├── additional-mobilians.md │ │ │ │ │ ├── additional-naverpay-order.md │ │ │ │ │ ├── additional-naverpay.md │ │ │ │ │ ├── additional-nice.md │ │ │ │ │ ├── additional-payco.md │ │ │ │ │ ├── additional-settle.md │ │ │ │ │ ├── additional-smartro.md │ │ │ │ │ ├── additional-tosspay.md │ │ │ │ │ ├── additional-tosspayments.md │ │ │ │ │ ├── additional-welcome.md │ │ │ │ │ ├── cancel-deadline-by-paymethod.md │ │ │ │ │ ├── cancel-guide-using-admin-console.md │ │ │ │ │ ├── cancel-reversal.md │ │ │ │ │ ├── cellphone-identity-verification.md │ │ │ │ │ ├── content200000.md │ │ │ │ │ ├── content200009.md │ │ │ │ │ ├── danal-contract.md │ │ │ │ │ ├── daou-contract.md │ │ │ │ │ ├── eximbay-contract.md │ │ │ │ │ ├── high-risk-industry.md │ │ │ │ │ ├── identity-verification-value.md │ │ │ │ │ ├── impossible-partial-cancel.md │ │ │ │ │ ├── information-pg.md │ │ │ │ │ ├── inicis-contract.md │ │ │ │ │ ├── inicis-vat.md │ │ │ │ │ ├── inicis-vbank-refund.md │ │ │ │ │ ├── kakao-contract.md │ │ │ │ │ ├── kakaopay-contract.md │ │ │ │ │ ├── kcp-contract.md │ │ │ │ │ ├── kcp-vat.md │ │ │ │ │ ├── kcp-vbank-refund.md │ │ │ │ │ ├── kicc-contract.md │ │ │ │ │ ├── ksnet-contract.md │ │ │ │ │ ├── mobilians-contract.md │ │ │ │ │ ├── naverpay-contract.md │ │ │ │ │ ├── naverpay-order-1.md │ │ │ │ │ ├── naverpay-order-contract.md │ │ │ │ │ ├── naverpay-order-diff.md │ │ │ │ │ ├── naverpay-order-review-items.md │ │ │ │ │ ├── naverpay-review-items.md │ │ │ │ │ ├── nice-contract.md │ │ │ │ │ ├── open-immediately.md │ │ │ │ │ ├── other-hosting-company.md │ │ │ │ │ ├── payco-contract.md │ │ │ │ │ ├── payment-settlement-method.md │ │ │ │ │ ├── paymentwall-contract.md │ │ │ │ │ ├── paypal-contract.md │ │ │ │ │ ├── point-service.md │ │ │ │ │ ├── refund-date.md │ │ │ │ │ ├── requirements.md │ │ │ │ │ ├── settle-contract.md │ │ │ │ │ ├── shopify-available-list.md │ │ │ │ │ ├── shopify-guide.md │ │ │ │ │ ├── small-business-commission-fee.md │ │ │ │ │ ├── smartro-contract.md │ │ │ │ │ ├── test-mode-cancel.md │ │ │ │ │ ├── tosspay-contract.md │ │ │ │ │ ├── tosspayments-contract.md │ │ │ │ │ ├── welcome-contract.md │ │ │ │ │ ├── withsoft-guide.md │ │ │ │ │ ├── wordpress-available-pg.md │ │ │ │ │ └── wordpress-setting.md │ │ │ │ └── payment-type │ │ │ │ │ ├── billing-key.md │ │ │ │ │ ├── content200003.md │ │ │ │ │ ├── content200007.md │ │ │ │ │ ├── content200036.md │ │ │ │ │ ├── content200042.md │ │ │ │ │ ├── content200047.md │ │ │ │ │ ├── content200052.md │ │ │ │ │ ├── content200053.md │ │ │ │ │ ├── crossborder.md │ │ │ │ │ ├── eximbay-international.md │ │ │ │ │ ├── hub-service-fee.md │ │ │ │ │ ├── inicis-easypay-hub-fee.md │ │ │ │ │ ├── inicis-international.md │ │ │ │ │ ├── internationl-high-risk-industry.md │ │ │ │ │ ├── internationl-pg.md │ │ │ │ │ ├── kcp-easypay-hub-apply.md │ │ │ │ │ ├── kcp-international.md │ │ │ │ │ ├── nice-easypay-hub-fee.md │ │ │ │ │ ├── nice-international.md │ │ │ │ │ ├── paymentwall-international.md │ │ │ │ │ ├── paypal-international.md │ │ │ │ │ ├── paypal-payment-status.md │ │ │ │ │ ├── schedule-logic-guide.md │ │ │ │ │ ├── schedule-requirement.md │ │ │ │ │ ├── schedule-validity-guide.md │ │ │ │ │ ├── tosspayment-international.md │ │ │ │ │ ├── tosspayments-easypay-hub-fee.md │ │ │ │ │ └── webhook-re-send.md │ │ │ ├── faq │ │ │ │ ├── console-faq │ │ │ │ │ ├── 2-depth-auth.md │ │ │ │ │ ├── add-admin-account.md │ │ │ │ │ ├── change-console-url.md │ │ │ │ │ ├── impossible-login.md │ │ │ │ │ ├── payment-list.md │ │ │ │ │ └── sub-store-mgnt.md │ │ │ │ ├── general-inquiry │ │ │ │ │ ├── change-business-number.md │ │ │ │ │ ├── confirm-process.md │ │ │ │ │ ├── content200004.md │ │ │ │ │ ├── content200006.md │ │ │ │ │ ├── content200011.md │ │ │ │ │ ├── content200031.md │ │ │ │ │ ├── content200041.md │ │ │ │ │ ├── contract-checkpoint.md │ │ │ │ │ ├── main-user.md │ │ │ │ │ ├── platform-contract-method.md │ │ │ │ │ ├── portone-advantages.md │ │ │ │ │ ├── real-channel-info.md │ │ │ │ │ └── what-is-the-small-business-fee.md │ │ │ │ ├── payment-faq │ │ │ │ │ ├── business-card-available.md │ │ │ │ │ ├── business-info-change.md │ │ │ │ │ ├── cancel-deadline.md │ │ │ │ │ ├── cancel-guide.md │ │ │ │ │ ├── cash-receipt-guide.md │ │ │ │ │ ├── content200022.md │ │ │ │ │ ├── pg-max-min-amount.md │ │ │ │ │ ├── receipt-guide.md │ │ │ │ │ ├── tosspayments-cash-receipt.md │ │ │ │ │ ├── vbank-info.md │ │ │ │ │ ├── vbank-service-detail.md │ │ │ │ │ └── vbank-test-guide.md │ │ │ │ └── platform-faq │ │ │ │ │ ├── platform_function_partnerbulkupload.md │ │ │ │ │ ├── platform_infosec.md │ │ │ │ │ ├── platform_nocode_guide.md │ │ │ │ │ ├── platform_payout_guide.md │ │ │ │ │ ├── platform_policymanagement_calculator.md │ │ │ │ │ ├── platform_settlmentandpayout_guide.md │ │ │ │ │ ├── platform_tax_setting_guide.md │ │ │ │ │ ├── taxinvoice_guide.md │ │ │ │ │ └── taxinvoice_signupemail.md │ │ │ ├── holidays.md │ │ │ ├── platform-2024-11-07.md │ │ │ ├── platform-2024-11-25.md │ │ │ ├── platform-2024-12-10.md │ │ │ ├── portone-service │ │ │ │ └── portone-service │ │ │ │ │ └── content50.md │ │ │ ├── pricing │ │ │ │ ├── pg │ │ │ │ │ └── domestic-and-oversea-fees.md │ │ │ │ └── portone │ │ │ │ │ └── portone-pricing.md │ │ │ ├── procedure │ │ │ │ ├── payment-integration │ │ │ │ │ ├── real-integration.md │ │ │ │ │ └── test-integration.md │ │ │ │ ├── pg-application │ │ │ │ │ ├── content53.md │ │ │ │ │ ├── content54.md │ │ │ │ │ ├── content59.md │ │ │ │ │ └── start.md │ │ │ │ ├── recommendation │ │ │ │ │ └── package.md │ │ │ │ └── service-addition │ │ │ │ │ └── add-service.md │ │ │ ├── recon_issue1.md │ │ │ ├── recon_issue2.md │ │ │ └── service │ │ │ │ ├── identity-verification │ │ │ │ └── identity-verification.md │ │ │ │ ├── integration-type │ │ │ │ └── integration-type.md │ │ │ │ ├── payment-type │ │ │ │ └── payment-type.md │ │ │ │ ├── paymethod │ │ │ │ └── paymethod.md │ │ │ │ ├── pg │ │ │ │ └── pg-service-list.md │ │ │ │ └── version │ │ │ │ └── portone-version.md │ │ ├── opi │ │ │ └── ko │ │ │ │ ├── console │ │ │ │ ├── guide │ │ │ │ │ ├── account.md │ │ │ │ │ ├── api-keys.md │ │ │ │ │ ├── billing-payments.md │ │ │ │ │ ├── channel-manage.md │ │ │ │ │ ├── connect.md │ │ │ │ │ ├── home.md │ │ │ │ │ ├── integration.md │ │ │ │ │ ├── list.md │ │ │ │ │ ├── pay.md │ │ │ │ │ ├── payments.md │ │ │ │ │ ├── promotion.md │ │ │ │ │ ├── readme.md │ │ │ │ │ ├── reg.md │ │ │ │ │ └── smartrouting.md │ │ │ │ └── pg.md │ │ │ │ ├── etc │ │ │ │ └── recon.md │ │ │ │ ├── extra │ │ │ │ ├── confirm-process │ │ │ │ │ ├── readme-v1.md │ │ │ │ │ └── readme-v2.md │ │ │ │ ├── identity-verification │ │ │ │ │ ├── readme-v2.md │ │ │ │ │ └── v1 │ │ │ │ │ │ ├── all │ │ │ │ │ │ ├── 0.md │ │ │ │ │ │ ├── 1.md │ │ │ │ │ │ ├── 2.md │ │ │ │ │ │ ├── 3.md │ │ │ │ │ │ └── readme.md │ │ │ │ │ │ ├── credit-auth │ │ │ │ │ │ ├── 1.md │ │ │ │ │ │ ├── 2.md │ │ │ │ │ │ ├── 3.md │ │ │ │ │ │ ├── 4.md │ │ │ │ │ │ └── readme.md │ │ │ │ │ │ ├── phone │ │ │ │ │ │ ├── 1.md │ │ │ │ │ │ ├── 2.md │ │ │ │ │ │ ├── 3.md │ │ │ │ │ │ ├── 4.md │ │ │ │ │ │ └── readme.md │ │ │ │ │ │ └── readme.md │ │ │ │ ├── link-pay │ │ │ │ │ └── readme-v1.md │ │ │ │ ├── plugins │ │ │ │ │ ├── readme-v1.md │ │ │ │ │ ├── shopify │ │ │ │ │ │ ├── readme-v1.md │ │ │ │ │ │ └── shopify │ │ │ │ │ │ │ ├── shopify-1.md │ │ │ │ │ │ │ ├── shopify-2.md │ │ │ │ │ │ │ ├── shopify-3.md │ │ │ │ │ │ │ ├── shopify-4.md │ │ │ │ │ │ │ └── shopify-5.md │ │ │ │ │ └── wordpress │ │ │ │ │ │ ├── button.md │ │ │ │ │ │ ├── edd.md │ │ │ │ │ │ ├── readme-v1.md │ │ │ │ │ │ └── woocommerce │ │ │ │ │ │ ├── payment.md │ │ │ │ │ │ ├── readme.md │ │ │ │ │ │ ├── subscription.md │ │ │ │ │ │ └── vbank.md │ │ │ │ ├── promotion │ │ │ │ │ ├── console-guide.md │ │ │ │ │ ├── integration.md │ │ │ │ │ ├── intro.md │ │ │ │ │ └── refund.md │ │ │ │ └── smart-routing │ │ │ │ │ ├── console-guide.md │ │ │ │ │ ├── integration.md │ │ │ │ │ └── intro.md │ │ │ │ ├── integration │ │ │ │ ├── cancel │ │ │ │ │ └── v1 │ │ │ │ │ │ ├── basic.md │ │ │ │ │ │ └── virtual-account.md │ │ │ │ ├── checklist │ │ │ │ │ └── readme-v1.md │ │ │ │ ├── pg │ │ │ │ │ ├── v1 │ │ │ │ │ │ ├── blue.md │ │ │ │ │ │ ├── danal.md │ │ │ │ │ │ ├── daou │ │ │ │ │ │ │ ├── readme.md │ │ │ │ │ │ │ └── undefined.md │ │ │ │ │ │ ├── eximbay.md │ │ │ │ │ │ ├── hyphen.md │ │ │ │ │ │ ├── inicis.md │ │ │ │ │ │ ├── kakaopay.md │ │ │ │ │ │ ├── kcp-v2-identity-verification.md │ │ │ │ │ │ ├── kg.md │ │ │ │ │ │ ├── kicc.md │ │ │ │ │ │ ├── ksnet │ │ │ │ │ │ │ ├── readme.md │ │ │ │ │ │ │ └── warning.md │ │ │ │ │ │ ├── naver.md │ │ │ │ │ │ ├── newtoss │ │ │ │ │ │ │ ├── readme.md │ │ │ │ │ │ │ └── warning.md │ │ │ │ │ │ ├── nhn-kcp.md │ │ │ │ │ │ ├── nice-v2 │ │ │ │ │ │ │ ├── billing-api-caution.md │ │ │ │ │ │ │ ├── payment-caution.md │ │ │ │ │ │ │ └── readme.md │ │ │ │ │ │ ├── nice.md │ │ │ │ │ │ ├── payco.md │ │ │ │ │ │ ├── paymentwall.md │ │ │ │ │ │ ├── paypal.md │ │ │ │ │ │ ├── readme.md │ │ │ │ │ │ ├── rt │ │ │ │ │ │ │ ├── readme.md │ │ │ │ │ │ │ └── warning.md │ │ │ │ │ │ ├── settle │ │ │ │ │ │ │ ├── mybank.md │ │ │ │ │ │ │ └── readme.md │ │ │ │ │ │ ├── smartro-v2 │ │ │ │ │ │ │ ├── api.md │ │ │ │ │ │ │ ├── caution.md │ │ │ │ │ │ │ └── readme.md │ │ │ │ │ │ ├── smartro.md │ │ │ │ │ │ ├── smilepay.md │ │ │ │ │ │ ├── spb │ │ │ │ │ │ │ ├── readme.md │ │ │ │ │ │ │ ├── stc.md │ │ │ │ │ │ │ └── warning.md │ │ │ │ │ │ ├── toss-brandpay │ │ │ │ │ │ │ ├── module.md │ │ │ │ │ │ │ ├── readme.md │ │ │ │ │ │ │ ├── warning.md │ │ │ │ │ │ │ └── widget.md │ │ │ │ │ │ ├── toss.md │ │ │ │ │ │ ├── tosspay-v2 │ │ │ │ │ │ │ ├── caution.md │ │ │ │ │ │ │ └── readme.md │ │ │ │ │ │ ├── tosspay.md │ │ │ │ │ │ └── welcome │ │ │ │ │ │ │ ├── api.md │ │ │ │ │ │ │ ├── caution.md │ │ │ │ │ │ │ └── readme.md │ │ │ │ │ └── v2 │ │ │ │ │ │ ├── danal-identity-verification.md │ │ │ │ │ │ ├── eximbay-v2.md │ │ │ │ │ │ ├── hyphen.md │ │ │ │ │ │ ├── inicis-jp.md │ │ │ │ │ │ ├── inicis-unified-identity-verification.md │ │ │ │ │ │ ├── inicis-v2.md │ │ │ │ │ │ ├── kakaopay.md │ │ │ │ │ │ ├── kcp-v2-identity-verification.md │ │ │ │ │ │ ├── kcp-v2.md │ │ │ │ │ │ ├── kpn.md │ │ │ │ │ │ ├── ksnet.md │ │ │ │ │ │ ├── naverpay.md │ │ │ │ │ │ ├── nice-v2.md │ │ │ │ │ │ ├── payletter-global.md │ │ │ │ │ │ ├── paypal-v2.md │ │ │ │ │ │ ├── readme.md │ │ │ │ │ │ ├── smartro-v2.md │ │ │ │ │ │ ├── tosspay-v2.md │ │ │ │ │ │ ├── tosspayments.md │ │ │ │ │ │ └── welcome.md │ │ │ │ ├── ready │ │ │ │ │ └── readme.md │ │ │ │ ├── start │ │ │ │ │ ├── v1 │ │ │ │ │ │ ├── auth.md │ │ │ │ │ │ ├── non-auth.md │ │ │ │ │ │ └── readme.md │ │ │ │ │ └── v2 │ │ │ │ │ │ ├── billing │ │ │ │ │ │ ├── issue.md │ │ │ │ │ │ ├── payment.md │ │ │ │ │ │ ├── readme.md │ │ │ │ │ │ └── schedule.md │ │ │ │ │ │ ├── checkout.md │ │ │ │ │ │ ├── keyin.md │ │ │ │ │ │ └── readme.md │ │ │ │ ├── using-ai-tools.md │ │ │ │ ├── virtual-account │ │ │ │ │ └── readme.md │ │ │ │ └── webhook │ │ │ │ │ ├── readme-v1.md │ │ │ │ │ └── readme-v2.md │ │ │ │ ├── quick-guide │ │ │ │ └── payment.md │ │ │ │ ├── readme.md │ │ │ │ └── support │ │ │ │ ├── agency-and-tier.md │ │ │ │ ├── code-info │ │ │ │ ├── card-code.md │ │ │ │ ├── code.md │ │ │ │ ├── pg-1.md │ │ │ │ ├── pg-2.md │ │ │ │ ├── pg-3.md │ │ │ │ ├── pg.md │ │ │ │ ├── portone-code.md │ │ │ │ └── readme.md │ │ │ │ ├── contact.md │ │ │ │ ├── faq │ │ │ │ └── undefined.md │ │ │ │ ├── flow.md │ │ │ │ ├── redirect.md │ │ │ │ ├── tax.md │ │ │ │ └── tls-support.md │ │ ├── platform │ │ │ └── ko │ │ │ │ ├── guides │ │ │ │ ├── dictionary.md │ │ │ │ ├── process.md │ │ │ │ └── webhook.md │ │ │ │ ├── readme.md │ │ │ │ ├── usages │ │ │ │ ├── client.md │ │ │ │ ├── contract.md │ │ │ │ ├── discount.md │ │ │ │ ├── fee.md │ │ │ │ ├── order.md │ │ │ │ └── partner.md │ │ │ │ └── using-ai-tools.md │ │ ├── release-notes │ │ │ ├── api-sdk │ │ │ │ ├── 2023-04-24.md │ │ │ │ ├── 2023-05-08.md │ │ │ │ ├── 2023-05-12.md │ │ │ │ ├── 2023-05-22.md │ │ │ │ ├── 2023-05-25.md │ │ │ │ ├── 2023-06-19.md │ │ │ │ ├── 2023-07-03.md │ │ │ │ ├── 2023-07-10.md │ │ │ │ ├── 2023-07-17.md │ │ │ │ ├── 2023-07-31.md │ │ │ │ ├── 2023-08-31.md │ │ │ │ ├── 2023-12-15.md │ │ │ │ ├── 2024-01-08.md │ │ │ │ ├── 2024-01-11.md │ │ │ │ ├── 2024-01-25.md │ │ │ │ ├── 2024-01-30.md │ │ │ │ ├── 2024-02-23.md │ │ │ │ ├── 2024-03-08.md │ │ │ │ ├── 2024-03-15.md │ │ │ │ ├── 2024-03-25.md │ │ │ │ ├── 2024-04-01.md │ │ │ │ ├── 2024-04-05.md │ │ │ │ ├── 2024-04-12.md │ │ │ │ ├── 2024-05-08.md │ │ │ │ ├── 2024-05-14.md │ │ │ │ ├── 2024-06-03.md │ │ │ │ ├── 2024-06-17.md │ │ │ │ ├── 2024-06-19.md │ │ │ │ ├── 2024-06-20.md │ │ │ │ ├── 2024-07-04.md │ │ │ │ ├── 2024-07-11.md │ │ │ │ ├── 2024-09-05.md │ │ │ │ ├── 2024-09-27.md │ │ │ │ ├── 2024-12-19.md │ │ │ │ ├── 2025-01-15.md │ │ │ │ └── 2025-05-19.md │ │ │ ├── console │ │ │ │ ├── 2023-04-24.md │ │ │ │ ├── 2023-05-08.md │ │ │ │ ├── 2023-05-22.md │ │ │ │ ├── 2023-07-05.md │ │ │ │ ├── 2023-07-07.md │ │ │ │ ├── 2023-07-17.md │ │ │ │ ├── 2023-08-23.md │ │ │ │ ├── 2023-09-12.md │ │ │ │ ├── 2023-12-27.md │ │ │ │ └── 2024-09-05.md │ │ │ └── platform │ │ │ │ ├── 2023-08-31.md │ │ │ │ ├── 2023-11-08.md │ │ │ │ ├── 2023-11-14.md │ │ │ │ ├── 2023-12-15.md │ │ │ │ ├── 2024-05-20.md │ │ │ │ ├── 2024-05-29.md │ │ │ │ ├── 2024-06-05.md │ │ │ │ ├── 2024-07-05.md │ │ │ │ ├── 2024-07-11.md │ │ │ │ ├── 2024-07-30.md │ │ │ │ ├── 2024-08-07.md │ │ │ │ ├── 2024-08-22.md │ │ │ │ ├── 2024-10-21.md │ │ │ │ ├── 2024-11-07.md │ │ │ │ ├── 2024-11-25.md │ │ │ │ ├── 2024-12-10.md │ │ │ │ ├── 2025-01-16.md │ │ │ │ ├── 2025-02-10.md │ │ │ │ ├── 2025-02-13.md │ │ │ │ ├── 2025-03-04.md │ │ │ │ ├── 2025-03-17.md │ │ │ │ ├── 2025-04-03.md │ │ │ │ ├── 2025-04-08.md │ │ │ │ └── 2025-05-14.md │ │ ├── schema │ │ │ ├── browser-sdk.schema.json │ │ │ ├── browser-sdk.yml │ │ │ ├── v1.openapi.json │ │ │ ├── v1.openapi.yml │ │ │ ├── v2.graphql │ │ │ ├── v2.openapi.json │ │ │ └── v2.openapi.yml │ │ ├── sdk │ │ │ └── ko │ │ │ │ ├── readme.md │ │ │ │ ├── v1-mobile-sdk │ │ │ │ └── readme.md │ │ │ │ ├── v1-sdk │ │ │ │ ├── javascript-sdk-old │ │ │ │ │ └── readme.md │ │ │ │ └── javascript-sdk │ │ │ │ │ ├── cft-rt.md │ │ │ │ │ ├── cft.md │ │ │ │ │ ├── load-module-rt.md │ │ │ │ │ ├── load-module.md │ │ │ │ │ ├── payrq.md │ │ │ │ │ ├── payrt.md │ │ │ │ │ └── readme.md │ │ │ │ ├── v2-mobile-sdk │ │ │ │ ├── android.md │ │ │ │ ├── react-native.md │ │ │ │ └── readme.md │ │ │ │ ├── v2-sdk │ │ │ │ ├── billing-key-and-pay-request.md │ │ │ │ ├── billing-key-and-pay-response.md │ │ │ │ ├── billing-key-request.md │ │ │ │ ├── billing-key-response.md │ │ │ │ ├── changelog.md │ │ │ │ ├── identity-verification-request.md │ │ │ │ ├── identity-verification-response.md │ │ │ │ ├── load-issue-billing-key-ui-request.md │ │ │ │ ├── load-issue-billing-key-ui-response.md │ │ │ │ ├── load-payment-ui-request.md │ │ │ │ ├── load-payment-ui-response.md │ │ │ │ ├── payment-request.md │ │ │ │ ├── payment-response.md │ │ │ │ ├── readme.md │ │ │ │ ├── update-load-issue-billing-key-ui-request.md │ │ │ │ └── update-load-payment-ui-request.md │ │ │ │ └── v2-server-sdk │ │ │ │ ├── javascript.md │ │ │ │ ├── jvm.md │ │ │ │ ├── python.md │ │ │ │ └── readme.md │ │ ├── v1-docs-full.md │ │ ├── v2-docs-full.md │ │ └── website-links.md │ └── instructions.md │ ├── server.py │ └── tools │ ├── list_docs.py │ ├── read_doc.py │ ├── read_doc_metadata.py │ ├── read_openapi_schema.py │ ├── read_openapi_schema_summary.py │ ├── read_v2_backend_code.py │ ├── read_v2_frontend_code.py │ ├── regex_search.py │ └── utils │ ├── bm25.py │ ├── markdown.py │ └── yaml.py ├── tests ├── __init__.py ├── test_bm25.py └── test_loader.py ├── update_docs.py └── uv.lock /.github/workflows/cd.yml: -------------------------------------------------------------------------------- 1 | name: CD 2 | 3 | on: 4 | push: 5 | tags: 6 | - 'v*.*.*' 7 | 8 | jobs: 9 | publish: 10 | if: github.ref_type == 'tag' && startsWith(github.ref_name, 'v') 11 | runs-on: ubuntu-latest 12 | 13 | steps: 14 | - uses: actions/checkout@v4 15 | 16 | - name: Install uv 17 | uses: astral-sh/setup-uv@v4 18 | with: 19 | enable-cache: true 20 | cache-dependency-glob: "uv.lock" 21 | 22 | - name: Set up Python 23 | run: uv python install 3.12 24 | 25 | - name: Install dependencies 26 | run: uv sync 27 | 28 | - name: Build package 29 | run: uv build 30 | 31 | - name: Publish to PyPI 32 | env: 33 | UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }} 34 | run: uv publish 35 | -------------------------------------------------------------------------------- /.github/workflows/ci.yml: -------------------------------------------------------------------------------- 1 | name: CI 2 | 3 | on: 4 | push: 5 | branches: [main] 6 | pull_request: 7 | 8 | jobs: 9 | test: 10 | runs-on: ubuntu-latest 11 | strategy: 12 | matrix: 13 | python-version: ["3.12"] 14 | 15 | steps: 16 | - uses: actions/checkout@v4 17 | 18 | - name: Install uv 19 | uses: astral-sh/setup-uv@v4 20 | with: 21 | enable-cache: true 22 | cache-dependency-glob: "uv.lock" 23 | 24 | - name: Set up Python ${{ matrix.python-version }} 25 | run: uv python install ${{ matrix.python-version }} 26 | 27 | - name: Install dependencies 28 | run: uv sync 29 | 30 | - name: Lint with ruff 31 | run: | 32 | uv run ruff check . 33 | uv run ruff format --check . 34 | 35 | - name: Run tests 36 | run: uv run pytest 37 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | .venv 2 | __pycache__ 3 | -------------------------------------------------------------------------------- /.python-version: -------------------------------------------------------------------------------- 1 | 3.12 2 | -------------------------------------------------------------------------------- /pyproject.toml: -------------------------------------------------------------------------------- 1 | [project] 2 | name = "portone-mcp-server" 3 | version = "0.11.1" 4 | description = "포트원 사용자를 위한 MCP (Model Context Protocol) 서버입니다. 포트원 개발자센터, 헬프센터 등 공식 문서 내용을 LLM(Large Language Model)에 제공해 정확한 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다." 5 | readme = "README.md" 6 | requires-python = ">=3.12" 7 | dependencies = [ 8 | "mcp[cli]>=1.4.1", 9 | "pyyaml>=6.0.2", 10 | "requests>=2.32.3", 11 | ] 12 | authors = [ 13 | {name = "PortOne", email = "tech.support@portone.io"} 14 | ] 15 | 16 | [dependency-groups] 17 | dev = [ 18 | "pytest>=8.3.5", 19 | "ruff>=0.11.0", 20 | ] 21 | 22 | [project.scripts] 23 | portone-mcp-server = "portone_mcp_server:main" 24 | 25 | [build-system] 26 | requires = ["hatchling"] 27 | build-backend = "hatchling.build" 28 | 29 | [tool.hatch.build] 30 | only-packages = false 31 | 32 | [tool.hatch.build.targets.wheel] 33 | packages = ["src/portone_mcp_server"] 34 | 35 | [tool.hatch.build.targets.wheel.sources] 36 | "src" = "" 37 | 38 | [tool.pyright] 39 | venvPath = "." 40 | venv = ".venv" 41 | 42 | [tool.ruff] 43 | target-version = "py312" 44 | line-length = 160 45 | lint.select = ["E", "F", "I"] 46 | -------------------------------------------------------------------------------- /src/portone_mcp_server/__init__.py: -------------------------------------------------------------------------------- 1 | # PortOne MCP Server package 2 | import importlib.metadata 3 | 4 | from .server import run_server 5 | 6 | __version__ = importlib.metadata.version("portone-mcp-server") 7 | 8 | 9 | def main(): 10 | run_server() 11 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/README.md: -------------------------------------------------------------------------------- 1 | # 포트원 개발자센터 문서 2 | 3 | > 포트원(PortOne)은 온라인 결제, 본인인증, 파트너 정산 자동화 및 재무/회계 업무를 위한 API와 SDK를 제공하는 서비스입니다. 4 | 5 | 1. 포트원 개발자센터 개별 문서 파일은 각각 경로(pathname), 제목(title), 설명(description)을 가지며, 이를 통해 해당 문서의 내용을 유추할 수 있습니다. 6 | 7 | - `opi/`: 원 페이먼트 인프라(결제, 본인인증) 관련 문서 8 | - `platform/`: 파트너정산 자동화 관련 문서 9 | - `api/`: 포트원이 제공하는 API 관련 문서 10 | - `sdk/`: 포트원이 제공하는 SDK 관련 문서 11 | - `schema/`: 포트원 API, SDK 스키마 파일 12 | - `blog/posts/`: 블로그 포스트 13 | - `release-notes/`: 릴리즈노트 14 | 15 | 2. 온라인 결제 및 본인인증에 관련해서는 버전(V1, V2)을 올바르게 파악하는 것이 아주 중요합니다. 사용자 질의에 관련된 섹션(V1, V2, 공통 등)을 확실하게 파악한 후 해당 버전의 문서와 공통 문서 내용을 제공 및 활용하세요. 16 | 17 | - 버전이 파악되지 않은 경우 사용자에게 질의하여 버전을 먼저 확인하고, 그럴 수 없는 불가피한 경우 공통 문서 또는 최신 버전인 V2 문서를 우선적으로 활용하세요. 18 | 19 | 3. API 및 SDK 스키마를 조회하고 싶은 경우 해당 버전의 스키마 파일에서 YAML, JSON, GraphQL SDL 형식으로 정확하게 확인할 수 있습니다. 20 | 21 | 4. 사용자에게 문서 레퍼런스를 URL로 제공할 때는 마크다운 파일 링크가 아닌, 개발자센터 웹사이트 URL을 사용하세요. 22 | 23 | - `.md`로 끝나는 URL은 마크다운 파일 링크입니다. 마크다운 파일 링크에서 마지막 `.md`를 제거하면 웹사이트 URL로 사용할 수 있습니다. 24 | - 사용자가 원하는 버전(V1, V2)이 특정되었다면 `?v=v2`, `?v=v1` 쿼리 파라미터를 추가하여 URL로 제공하세요. 25 | - hostname이 누락된 URL의 경우 `https://developers.portone.io`를 추가하여 공유하세요. 26 | 27 | 5. 이미지, 파일 다운로드 링크 등이 마크다운 문서에서는 대부분 누락됩니다. 해당 내용을 조회해야 하는 경우 개발자센터 웹사이트에서 확인해야 합니다. 28 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/api/backward-compatibility.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: API 하위호환성 지원 3 | description: 포트원이 보장하는 V1, V2 API 하위호환성에 대한 내용입니다. 4 | targetVersions: 5 | - v1 6 | - v2 7 | --- 8 | 9 | ### 하위호환성 10 | 11 | 포트원이 제공하는 모든 Stable API에 대해 아래와 같은 하위호환성이 보장됩니다. 12 | 13 | 1. 현재 사용 가능한 입력 형식은 앞으로도 사용할 수 있습니다. 14 | - 입력 형식 내 필드 정의가 삭제되지 않습니다. 15 | 16 | - 필수 입력 정보가 추가되거나, 선택 입력 정보가 필수로 변경되지 않습니다. 17 | - 오로지 선택 입력 정보만 추가될 수 있습니다. 18 | 19 | - 하위 필드의 형식(타입) 또한 위 규칙을 지키며 변경됩니다. 20 | 21 | - enum 타입의 값이 삭제되지 않습니다. 22 | 23 | 2. 출력 형식이 확장될 수 있지만, 축소되지 않습니다. 24 | - 출력 형식 내 필드 정의가 삭제되지 않습니다. 25 | 26 | - 사용 중인 필수 출력 정보가 선택사항으로 변경되거나 출력 시 누락되지 않습니다. 27 | - 이미 존재하는 용례 내에서는 필수 출력 정보가 언제나 유지됩니다. 28 | - 단, **기능이 추가 및 확장되는 등 새로운 용례로 사용될 때의 출력 정보에 한하여 선택사항으로 변경될 수 있습니다.** 29 | 30 | - 하위 필드의 형식(타입) 또한 위 규칙을 지키며 변경됩니다. 31 | 32 | - 단, **새로운 필드 또는 enum 값, oneOf 케이스가 추가될 수 있습니다.** 33 | - 알지 못하는 필드 및 값이 주어지더라도 crash가 발생하지 않도록 유의하여 개발해주세요. 34 | 35 | 36 | - 새로운 필드 및 값이 추가되는 경우 사전 공지를 통해 안내드립니다. 37 | 38 | 39 | 40 | `UNSTABLE`이 표기된 일부 API의 경우, 위 하위호환성 정책과 무관하게 변경 및 지원 종료될 수 있으니 이용에 유의하세요. 41 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/applepay.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Apple Pay로 간편하게 결제하세요! ' 3 | category: 업데이트 4 | seo: 5 | title: Apple Pay로 간편하게 결제하세요! 6 | description: |- 7 | 이제 포트원을 통해서도 애플페이 결제를 이용하실 수 있습니다. 8 | 포트원을 통해 KCP, 토스페이먼츠, KG이니시스에서 제공하는 Apple pay를 바로 경험해보세요! 9 | tags: 10 | - 업데이트 11 | searchTags: 12 | - 간편결제 13 | - 애플 14 | - 애플페이 15 | - Apple pay 16 | datetime: 2023-04-03T15:00:00.000Z 17 | --- 18 | 19 | 20 | 21 | ### **이제 포트원을 통해 Apple pay 이용이 가능합니다** 22 | 23 | 25 | 26 | ### **\[지원 가능한 조건]** 27 | 28 | - 지원PG사 : KCP , (구)토스페이먼츠 , (신)토스페이먼츠, KG이니시스, (신)나이스페이먼츠 29 | - 카드 : 현대카드 (그외 국내 발행 카드사 및 해외 발행카드 미지원) 30 | - 결제방식 : 일반결제 (정기결제 미지원) 31 | 32 | ### **\[수수료 안내]** 33 | 34 | - Apple pay 결제 시 추가로 부과되는 수수료는 없으며, 신용카드 결제 수수료율과 동일하게 적용 됩니다. (기존 고객사의 경우에도 카드결제 수수료율과 동일하게 적용) 35 | 36 | ### **\[신청방법 안내]** 37 | 38 | - 신규 고객사 : PG 서비스 가입 신청 시, 간편결제를 포함하여 신청 39 | - 기존 고개사 : 상점관리자(신용카드사 셋팅된 MID 기준) > 이용정보 > 결제⋅부가서비스 > 이용서비스, 간편결제 변경하기를 통해 신청 40 | 41 | ### **\[Apple pay 관련 안내 사항]** 42 | 43 | - Apple Pay는 현대 카드로만 결제 가능 44 | - Apple Pay 결제를 지원하는 디바이스와 IOS 버전에서만 결제창에 노출됨 45 | 46 | ### 47 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100000.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[2024년 02월] 개인정보처리방침 개정 변경 안내' 3 | category: 공지사항 4 | seo: 5 | title: '[2024년02월]개인정보처리방침 개정 변경 안내' 6 | description: | 7 | 항상 포트원을 이용해주시는 고객 여러분께 진심으로 감사드립니다. 8 | 2024년 02월 21일 아래와 같이 개인정보처리방침이 변경됨을 사전 안내 드립니다. 9 | 공고일 : 2024.02.14(수) 10 | 시행일 : 2024.02.21(수) 11 | keywords: 12 | - 개인정보처리방침 13 | - 공지사항 14 | tags: 15 | - 공통 16 | - 공지사항 17 | pgCompanies: 18 | - null 19 | searchTags: 20 | - 개인정보처리방침 21 | - 개인정보 22 | - 공지 23 | datetime: 2024-02-26T15:00:00.000Z 24 | --- 25 | 26 | 안녕하세요. 27 | 28 | 포트원입니다. 항상 포트원을 이용해 주시는 고객 여러분께 진심으로 감사드립니다. 29 | 30 | 2024년 02월 21일 아래와 같이 개인정보처리방침이 변경됨을 사전 안내드립니다. 31 | 32 | - 공고일 : 2024.02.14(수) 33 | - 시행일 : 2024.02.21(수) 34 | 35 | ### 변경 내용 36 | 37 | - 수집하는 개인정보의 항목 내용 수정 및 추가 38 | 39 | 40 | 41 | - 개인정보 처리의 위탁업무내용 및 수탁업체 추가 42 | 43 | 44 | 45 | - 개인정보 처리의 위탁내용 추가 46 | 47 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100002.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: API Response 필드 추가 배포예정 3 | category: 업데이트 4 | tags: 5 | - 업데이트 6 | datetime: 2021-08-02T15:00:00.000Z 7 | --- 8 | 9 | 안녕하세요. 포트원입니다. 10 | 11 | 포트원을 이용해주시는 고객 여러분께 진심으로 감사드립니다. 12 | 13 | 아래와 같이 **포트원 API Response** 필드 추가 관련 배포 내용 및 운영 정책을 공유하여 드리오니, 운영하시는 서비스에 영향이 없을지 꼭 확인하시길 바랍니다. 14 | 15 | 향후에도 포트원 서비스 성능 개선을 위해 API Response 필드 추가 작업은 상시 발생할 수 있으며 고객사에서 서비스 영향 여부 확인이 필요하다고 판단될 경우, 포트원 관리자 콘솔 및 홈페이지 공지사항을 통하여 공유 드릴 수 있도록 하겠습니다. 16 | 17 | 아래 API Response 필드 추가 내용 꼭 확인 부탁드립니다. 18 | 19 | ### **일정 및 내용** 20 | 21 | - 배포 일정 : 2021-08-04(수) 15:00 \~ 15:30 22 | - 목적 : 포트원 API Response 필드 추가 23 | - 상세내용 24 | - emb\_pg\_provider : 허브형 결제 PG사 정보 25 | - ex) \ 26 | 카카오페이 : kakaopay\ 27 | 네이버페이 : naverpay\ 28 | 페이코 : payco \ 29 | 삼성페이 : samsung\ 30 | Lpay : lpay\ 31 | KPay : kpay 32 | 33 | \[예시] GET /payments/`{imp_uid}` 34 | 35 | ```javascript 36 | { 37 | "code": 0, 38 | "message": "string", 39 | "response": { 40 | "imp_uid": "string", 41 | "merchant_uid": "string", 42 | "pay_method": "string", 43 | ...... 44 | "emb_pg_provider" : "string" 45 | ...... 46 | } 47 | } 48 | ``` 49 | 50 | 항상 포트원을 이용해 주시는 고객 여러분께 안전하고 보다 나은 서비스를 제공하도록 최선을 다하겠습니다. 51 | 52 | 감사합니다. 53 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100004.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[중요/공지] 주요 웹 브라우저의 TLS1.0 및 TLS1.1 지원 종료 안내 ' 3 | category: 공지사항 4 | tags: 5 | - 공통 6 | - 공지사항 7 | datetime: 2021-11-02T15:00:00.000Z 8 | --- 9 | 10 | 안녕하세요! 포트원 입니다. 11 | 12 | 주요 웹 브라우저의 TLS1.0 및 TLS1.1 지원이 중단 될 예정으로 작업 내용 과 일정을 안내 드립니다. 13 | 14 | 현재 사용 가능한 TLS 버젼 중 **TLS 1.0 및 TLS 1.1 구 버젼 사용은 비활성화 하고 기본 설정이 TLS 1.2 이상 사용 되도록 프로토콜 변경 작업**이 아래와 같이 예정 되어 있음을 안내 드립니다. 15 | 16 | ※ TLS(Transport Layer Security)는SSLv3.0을 참고하여 RFC2246('1999)으로 표준화 된 통신용 암호화 프로토콜 17 | 18 | 30 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100015.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 결제내역 업데이트 오류 조치완료' 3 | category: 공지사항 4 | tags: 5 | - 공통 6 | - 공지사항 7 | datetime: 2024-03-18T10:02:37.923Z 8 | --- 9 | 10 | 안녕하세요, 포트원 고객지원팀입니다. 11 | 12 | 금일 결제내역이 업데이트가 지연되는 이슈가 발생되었으며, 조치완료되어 안내드립니다. 13 | 14 | - 이슈 발생시각 : 02/13 09시 02분\~ 12시15분 (조치완료) 15 | - 현상 : 포트원 결제내역 내 거래조회(노출)되지 않음 16 | - 참고사항 : 결제/취소 처리는 정상으로 이슈는 없었음. 17 | 18 | 이용에 불편을 드려 대단히 죄송합니다. 19 | 20 | 감사합니다. 21 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100016.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 토스페이먼츠 IE 브라우저 지원종료 안내' 3 | category: 공지사항 4 | tags: 5 | - 토스페이먼츠 6 | - 공지사항 7 | pgCompanies: 8 | - 토스페이먼츠 9 | datetime: 2024-03-18T10:02:37.923Z 10 | --- 11 | 12 | 토스페이먼츠 Internet Explorer 브라우저에 대한 지원을 종료할 예정인 것으로 공지되어 안내드립니다. \ 13 | 관련하여 보다 자세한 내용은 아래 본문 혹은 토스페이먼츠를 통해 확인하여주시기 바랍니다. 14 | 15 | 29 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100020.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: PayPal(페이팔) Standard checkout(SPB) 서비스 오픈 3 | category: 공지사항 4 | tags: 5 | - 페이팔 6 | - 공지사항 7 | pgCompanies: 8 | - 페이팔 9 | datetime: 2024-03-18T10:02:37.923Z 10 | --- 11 | 12 | 15 | 16 | ### 페이팔 SPB 버튼 렌더링 17 | 18 | - 페이팔 SPB 일반결제는 고객사 주문 페이지에 페이팔 SPB 버튼(아래 이미지 참고)을 렌더링 한 후, 이 SPB 버튼을 클릭해 페이팔 결제창을 호출하는 방식입니다. 19 | 20 | ![](/uploads/페이팔.png) 21 | 22 | ※ 기존에 제공되던 Paypal Express checkout 신규 신청 및 신규 연동이 불가 합니다.신규 연동 필요 시 아래 가이드 참고 부탁드립니다. 23 | 24 | <연동가이드> 25 | 26 | ☞ [페이팔 SPB(Smart Payment Buttons) 연동 방법 보러가기 ↗](https://developers.portone.io/opi/ko/integration/pg/v1/spb/readme?v=v1) 27 | 28 | ☞ [페이팔(paypal) 결제 특징 보러가기 ↗ ](https://guide.portone.io/bc611220-a885-485a-b4ee-184a4e73c99b) 29 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100022.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2023-12-27 업데이트' 3 | category: 업데이트 4 | tags: 5 | - 관리자콘솔 6 | - 업데이트 7 | searchTags: 8 | - 정산통합조회 9 | - 핵토파이낸셜 정산내역 10 | - 릴리즈노트 11 | datetime: 2024-03-18T10:02:37.923Z 12 | --- 13 | 14 | 15 | 16 | 17 | 18 | ### **주요 업데이트 사항** 19 | 20 | 21 | 22 | ✔️ **핵토파이낸셜의 정산내역을 확인할 수 있습니다.** 23 | 24 | 이번 업데이트를 통해 헥토파이낸셜을 포함한 11개 PG사와 간편결제사의 정산 내역을 조회할 수 있습니다. 관리자콘솔 메뉴 \[결제사 정산] - \[통합 내역 조회]에서 정산 내역을 조회할 수 있으며, 헥토파이낸셜의 경우 8월 1일 결제건부터 조회가 가능하오니 이용에 참고하시기 바랍니다. 25 | 26 | 📍 정산 통합 조회 서비스의 기능이 궁금하다면 [→ 서비스 소개 보기](https://guide.portone.io/a89f61e5-4545-41ae-9b72-14f506adcac6) 27 | 28 | 📍 이용 중인 결제대행사(PG사)도 정산 내역 조회가 가능한지 궁금하다면 [→ 지원 결제대행사(PG)사 확인하기](https://guide.portone.io/a89f61e5-4545-41ae-9b72-14f506adcac6) 29 | 30 | 📍 정산 통합 조회 서비스의 이용 방법이 궁금하다면 [→ 이용 방법 보기](https://guide.portone.io/92af7604-5813-48fa-a186-82e8e7356a3e) 31 | 32 | ### 기타 수정사항 33 | 34 | 35 | 36 | ✔️ **KG이니시스 결제 시 결제 통화 위/변조 검사가 추가되었습니다**. 37 | 38 | PC 환경에서 KG이니시스의 승인 요청시 결제 통화 및 결제 금액 위/변조 검사를 진행합니다. 39 | 40 | #### **[\[관리자콘솔 릴리즈노트\] 2023-12-27 업데이트 보러가기↗](https://developers.portone.io/release-notes/console/2023-12-27?v=v2)** 41 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100023.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[오픈공지] Port Letter(포트레터) 채널 오픈' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2024-03-18T10:02:37.923Z 7 | --- 8 | 9 | ### **Port Letter 채널이 OPEN 되었습니다!** 10 | 11 | 12 | 13 | #### **포트원에게 해주고 싶으셨던 이야기가 있으신가요?** 14 | 15 | 포트원으로 자유롭게 편지를 보내실 수 있는 Port Letter 채널이 신규 개설되었습니다. 16 | 포트원을 사랑해 주시는 여러분의 소중한 의견을 기다리고 있으니 많은 성원 부탁드리며, 17 | 진심을 담아 보내주신 이야기들은 꼼꼼히 읽고 더 멋진 서비스로 보답 드리겠습니다! 18 | 19 | 포트원 일동 드림 20 | 21 | 22 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100024.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[점검] 네이버페이 서비스 일시중단 (시스템점검)' 3 | category: 공지사항 4 | tags: 5 | - 네이버페이(결제형) 6 | - 네이버페이(주문형) 7 | - 공지사항 8 | datetime: 2023-06-20T15:00:00.000Z 9 | --- 10 | 11 | 안녕하세요\~! 포트원 입니다. 12 | 13 | 아래와 같이 네이버페이에서 비상대응훈련 진행으로 \[네이버페이 전체 서비스가 일시적으로 중단 ] 될 예정인 점 참고하셔서 서비스 이용에 불편 없으시길 바랍니다. 14 | 15 | ■ 시스템 점검 시간 : 2023년 7월 8일(토) 02:00 \~ 06:00 (약 4시간) 16 | 17 | ■ 시스템 영향 범위 : 네이버페이 전체 서비스 및 주문 API, 문의 API 영역 18 | 19 | ■ 시스템 영향 내용 : 네이버페이 주문API / 문의 API 중단 및 네이버페이 전체 서비스 중단 20 | 21 | 서비스 이용에 불편을 드려 죄송합니다. 22 | 23 | 더욱 안정적인 서비스 제공으로 보답하는 네이버페이가 되겠습니다. 24 | 25 | 감사합니다. 26 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100025.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 인증결제 오류 조치 완료 공지' 3 | category: 공지사항 4 | tags: 5 | - 공통 6 | - 공지사항 7 | datetime: 2023-07-13T15:00:00.000Z 8 | --- 9 | 10 | 안녕하세요, 11 | 12 | 포트원 고객지원팀입니다. 13 | 14 | 금일 (2023-07-14) 결제창 방식의 인증결제를 이용하시는 경우 15 | 16 | 결제창이 호출되지 않고 오류가 발생되는 이슈가 있어 긴급 확인 후 조치 완료 되었음을 안내드립니다. 17 | 18 | 자세한 사항은 아래 상세 내용을 참고 부탁드리겠습니다. 19 | 20 | ### **상세** 21 | 22 | - 이슈 발생시각 : 2023년 07월 14일 19:00\~19:32 (28분) - 조치완료 23 | - 2023년 07월 14일 19:04 : 인증결제창 호출 불가 상태 시작 24 | - 2022년 07월 14일 19:05 : PortOne 장애 인지 25 | - 2023년 07월 14일 19:06 : 서버 증설 작업 시작(평소 대비 2배 자원 할당) 26 | - 2023년 07월 14일 19:32 : 서비스 정상화 27 | 28 | * 현상 : (결제창을 띄우는 방식의 인증결제) 결제창 호출시 오류 발생 29 | 30 | - 발생 원인 : 인증결제 요청 트래픽이 평소 대비 5배 이상 급등 하면서 해당 트래픽을 PortOne 서버가 처리하지 못하여 결제 이슈 발생. 31 | 32 | * 재발방지 안 33 | - 일시적으로 비 활성화되어있던 오토스케일링 2023년 7월 14일 재 활성화 완료 34 | - 서버의 평상시 리소스를 평균 트래픽 대비 최소 3.5배수 이상 유휴 리소스 증설 35 | 36 | 서비스 이용에 불편을 드려 너무나도 죄송합니다. 37 | 38 | 앞으로 더욱더 서비스 안정성을 위해 최선을 다해 노력하는 포트원(PortOne)이 되겠습니다. 39 | 40 | 감사합니다. 41 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100026.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[2023년 07월] 서비스이용약관 개정 변경안내' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2023-07-16T15:00:00.000Z 7 | --- 8 | 9 | 안녕하세요\~! 포트원 입니다. 10 | 11 | 항상 포트원을 이용해주시는 고객 여러분께 진심으로 감사드립니다. 12 | 13 | 2023년 07월 26일 아래와 같이 서비스 이용약관이 변경됨을 사전 안내 드립니다. 14 | 15 | - 공고일 : 2023.07.17(월) 16 | - 시행일 : 2023.07.26(수) 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100027.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 관리자콘솔 결제내역 이슈 조치완료' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2023-07-24T15:00:00.000Z 7 | --- 8 | 9 | 안녕하세요. 포트원 고객지원팀입니다. 10 | 11 | 현재 당사 관리자콘솔 조회가 느려지는 현상이 있었으며 긴급 조치하여 현재 이슈 해결완료되었습니다. 12 | 13 | 다시 한번 서비스 이용에 불편을 드려 죄송합니다. 14 | 15 | **상세** 16 | 17 | 1. 장애 현상 : 포트원 관리자콘솔 상세내역조회시 정상적으로 조회가 이루어지지 않음 18 | 2. 장애 대상 : 관리자콘솔 결제내역 조회 및 관리자콘솔 내 취소 19 | 20 | - 결제, 본인인증, API 취소시에는 이슈 없음 21 | 22 | 3\. 발생 시간 : 2023-07-25 13:00\~ 14:53 (조치완료) 23 | 24 | 감사합니다. 25 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100029.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 나이스페이 자체 장애 대응 완료(종결)' 3 | category: 공지사항 4 | tags: 5 | - 나이스페이먼츠 6 | - 공지사항 7 | pgCompanies: 8 | - null 9 | datetime: 2023-09-06T15:00:00.000Z 10 | --- 11 | 12 | 안녕하세요, 포트원 고객지원팀입니다. 13 | 14 | 금일 (2023-09-07) 발생되었던 나이스페이 PG사측의 장애가 종결(포트원 대응완료)되어 공지드립니다. 15 | 16 | 자세한 사항은 아래 상세 내용을 참고 부탁드리겠습니다. 17 | 18 | **상세내용** 19 | 20 | - 영향 : (신)나이스페이 이용 고객사 21 | - 원인: (신)나이스페이 PG사에서 페이코 '잔액 부족' 응답 메세지에 대한 메시지 형식이 올바르지 않아 처리 과정 중 오류 발생 22 | - 영향 내용: 실제 고객은 결제 됐는데 포트원에 결제 실패로 기록됨 23 | - 대응 : (신)나이스페이 장애 대응을 위한 포트원 작업 진행 및 대응완료 24 | 25 | 해당 이슈는 나이스페이측에서 대응이 어려운 것으로 확인되어 당사에서 긴급 조치 및 대응 완료되어 이슈 해결되었습니다. 26 | 27 | 감사합니다. 28 | 29 | 포트원(PortOne) 드림 30 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100033.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 네이버페이 서비스 점검 공지' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2023-10-16T15:00:00.000Z 7 | --- 8 | 9 | 안녕하세요, 포트원 고객지원팀입니다. 10 | 11 | 2023년 10월 21일 02:00 \~ 06:00 일자에 네이버페이 내부적으로 시스템 점검 일정이 예정되어있어 미리 공지· 공유드립니다. 12 | 13 | 아래 내용 참고하시어 운영간 차질 없으시기 바랍니다. 14 | 15 | 감사합니다. 16 | 17 | --- 18 | 19 | 안녕하세요. 네이버페이입니다. 20 | 21 | 네이버페이 전체 서비스 점검이 예정되어 있어 안내드립니다. 22 | 23 | 아래 안내 사항 확인하시어 운영 시 참고 부탁드립니다. 24 | 25 | - 점검 기간 : 2023년 10월 21일 02:00 \~ 06:00 26 | - 점검 영향 : 네이버페이 전체 서비스 일시 중단 27 | - 네이버페이 이용 고객사(간편결제, 정기/반복결제, 인증형결제)에 제공되는 모든 API에 대해 점검 시간 중 사용이 불가합니다. 28 | - 요청 시 실패 응답을 받게 되며 호출 실패한 건은 점검 시간 이후 고객사측에서 재호출을 해야 합니다. \ 29 | 취소 API 또한 점검 시간 종료 후 재호출이 필요합니다. 30 | - 실패 응답으로는 아래의 내용이 전달될 예정입니다. (message 내용은 변경될 수 있습니다.) 31 | - "code" : "MaintenanceOngoing" 32 | - "message" : "시스템 점검 중입니다. (2023-10-21T02:00+09:00 \~ 2023-10-21T06:00+09:00) 33 | 34 | 점검 시간 전에 요청된 정산/적립건에 대해서는 정상적으로 정산/적립 처리됩니다. 35 | 36 | 점검 시간 중의 정산 적립 API 요청은 실패하기에 점검 종료 후 재호출이 필요합니다. 37 | 38 | 점검 시간 중 결제창 접속 및 js sdk 요청 시 시스템 점검 안내가 사용자에게 표시됩니다. 39 | 40 | 서비스 이용에 불편을 드려 죄송합니다. 41 | 42 | 더욱 안정적인 서비스 제공으로 보답하는 네이버페이가 되겠습니다. 43 | 44 | 감사합니다. 45 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100035.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 페이코 결제 장애 종결(정상화)' 3 | category: 공지사항 4 | tags: 5 | - 페이코 6 | - 공지사항 7 | datetime: 2023-10-23T15:00:00.000Z 8 | --- 9 | 10 | 안녕하세요, 포트원 고객지원팀입니다. 11 | 12 | 2023년 10월 24일(금일) 오전 9시부터 페이코 내부적으로 장애가 발생된 것으로 전달받아 참고차 공유/안내드립니다. 13 | 14 | 아래 내용 참고하시어 운영간 차질 없으시기 바랍니다.감사합니다. 15 | 16 | --- 17 | 18 | #### 페이코 추가 공지사항 19 | 20 | 금일 발생된 페이코 장애는 10시 33분 부로 정상화 반영 되어 내용 공유 드립니다. 21 | 22 | ■ 장애 시각 : 10/24 09:02\~10:33 (1시간 31분) 23 | 24 | ■ 장애 영향 : 페이코 신용카드 결제 간헐적 실패 발생 25 | 26 | ■ 처리 현황 : 배포 및 정상화 완료 27 | 28 | ■ 향후 방안 : 제휴사에 영향 없도록 모니터링 강화서비스 이용에 불편을 드려 죄송합니다.앞으로 모니터링 강화를 통해 동일한 이슈 없도록 대응하겠습니다.페이코 드림 29 | 30 | 앞으로 모니터링 강화를 통해 동일한 이슈 없도록 대응하겠습니다. 31 | 32 | 페이코 드림 33 | 34 | --- 35 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100036.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[2023년 10월] 개인정보처리방침 개정 변경 안내' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2023-10-29T15:00:00.000Z 7 | --- 8 | 9 | 안녕하세요\~! 포트원 입니다.항상 포트원을 이용해주시는 고객 여러분께 진심으로 감사드립니다. 10 | 11 | 2023년 11월 30일 아래와 같이 개인정보처리방침이 변경됨을 사전 안내 드립니다. 12 | 13 | - 공고일 : 2023.10.30(월) 14 | - 시행일 : 2023.11.30(목) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100037.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[2023년 12월] 서비스이용약관 개정 변경안내' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2023-11-23T15:00:00.000Z 7 | --- 8 | 9 | 안녕하세요\~! 포트원 입니다. 10 | 11 | 항상 포트원을 이용해주시는 고객 여러분께 진심으로 감사드립니다. 12 | 13 | 2023년 12월 01일 아래와 같이 서비스 이용약관이 변경됨을 사전 안내 드립니다. 14 | 15 | - 공고일 : 2023.11.24(금) 16 | - 시행일 : 2023.12.01(금) 17 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100038.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 포트원 관리자콘솔 간헐적 로딩오류 공지(조치완료)' 3 | category: 공지사항 4 | tags: 5 | - 공통 6 | - 공지사항 7 | datetime: 2023-11-19T15:00:00.000Z 8 | --- 9 | 10 | 안녕하세요, 포트원 고객지원팀입니다. 11 | 12 | 금일(2023-11-21) 포트원 관리자콘솔의 홈 화면과 애널리틱스 화면이 일시적으로 보이지 않는 오류가 있었으며,당사에서 긴급 확인 후 조치완료되어 공지드립니다. 13 | 14 | (본 이슈는 포트원의 결제와는 무관한 이슈로 결제서비스에는 영향이 없습니다) 15 | 16 | 이용에 불편을 드리게 되어 대단히 죄송합니다. 17 | 18 | 원활한 서비스 제공을 위해 최선을 다하도록 하겠습니다. 19 | 20 | --- 21 | 22 | #### 상세 23 | 24 | - 영향: 관리자콘솔 간헐적 로딩 오류 25 | - 장애시각: 2023.11.21(화) 08:08 \~ 10:26 26 | - 대응 : 긴급 조치완료 27 | 28 | --- 29 | 30 | 감사합니다. 31 | 32 | 포트원(PortOne) 드림 33 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100039.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 포트원 애널리틱스 이슈 공지(조치완료)' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2023-12-11T15:00:00.000Z 7 | --- 8 | 9 | 안녕하세요. 포트원 고객지원팀입니다. 10 | 11 | 현재 당사 애널리틱스 서비스 데이터가 정상적으로 업데이트 되지 않는 이슈가 발견되어 현재 이슈 **조지완료** 되었음을 공지드립니다. 12 | 13 | 다시 한번 서비스 이용에 불편을 드려 죄송합니다. 14 | 15 | 상세 16 | 17 | --- 18 | 19 | 1. 장애 현상 : 포트원 관리자콘솔 애널리틱스 내 데이터가 정상적으로 업데이트 되지 않음 20 | 2. 장애 대상 : 포트원 관리자콘솔 > 애널리틱스 21 | 22 | - 결제, 본인인증, API 등 결제에는 영향없음 23 | 24 | 3\. 영향시간 : 2023-12-11 21:05 \~ 13:29 (조치완료) 25 | 26 | --- 27 | 28 | 감사합니다. 29 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100040.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 엑심베이 Molpay 서비스 중단 안내' 3 | category: 공지사항 4 | tags: 5 | - 엑심베이 6 | - 공지사항 7 | datetime: 2023-11-29T15:00:00.000Z 8 | --- 9 | 10 | 안녕하세요, 포트원 고객지원팀입니다. 11 | 12 | ‘엑심베이’ 결제대행사 서비스 중 Molpay 가 11월 24일부로 서비스 중단될 예정이며,자세한 사항은 아래 엑심베이 공지사항을 참고하시어 서비스 운영간 차질이 없으시길 바랍니다. 13 | 14 | 감사합니다. 15 | 16 | --- 17 | 18 | 안녕하세요, Eximbay 입니다.항상 저희 엑심베이 결제 서비스를 이용해 주셔서 감사합니다. 19 | 20 | 말레이시아 고객 타겟의 간편결제수단인 "Razer Merchant Services(구 Molpay)"가 결제사 정책으로 인해 23.11.24일부로 영구 중단되오니, 각 사업장주 및 실무자 분들은 업무에 참고하여 주시기 바랍니다. 21 | 22 | - 중단 결제수단: Razer Merchant Services(구 Molpay) 23 | - 중단 시점: 2023.11.24(금) 14:00 \~ 24 | 25 | 엑심베이 통합결제창을 이용하시는 사업장일 경우, 위 시간부로 엑심베이 결제창에 해당 결제수단이 노출되지 않게 되오니 별도로 작업해 주실 사항은 없습니다. 26 | 27 | 다만 결제수단을 별도로 호출하고 계신 사업장일 경우, 위 중단 시점 이후로는 해당 결제수단이 노출되지 않도록 사전 작업을 요청 드립니다. 28 | 29 | - 중단 시점 이후에는 Razer Merchant Services의 Paymethod("P171")를 호출하지 않도록 작업하여 주시기 바랍니다 30 | 31 | --- 32 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100041.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[2024년04월]서비스 이용약관 개정 변경안내 ' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2024-03-31T15:00:00.000Z 7 | --- 8 | 9 | 안녕하세요\~! 포트원 입니다. 10 | 11 | 항상 포트원을 이용해주시는 고객 여러분께 진심으로 감사드립니다.\ 12 | 2024년 04월 15일 아래와 같이 서비스 이용약관이 변경됨을 사전 안내 드립니다. 13 | 14 | - 공고일 : 2024.04.08(월) 15 | - 시행일 : 2024.04.15(월) 16 | 17 | 18 | 19 | 22 | 23 | 26 | 27 | 30 | 31 | 34 | 35 | 38 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100044.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 포트원 문자 오발송 안내 공지' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2024-03-06T15:00:00.000Z 7 | --- 8 | 9 | 현재 포트원 고객센터에서 문자가 오발송 되어 공지 안내드립니다. 10 | 11 | 당사 유선 연락처는 맞으나 내부 고객공지를 위한 시스템 구축 준비과정에서 문자가 오발송 된 건으로 현재 조치완료 되었습니다. 12 | 13 | 불편드려 죄송합니다. 14 | 15 | 참고로 당사 결제시스템에는 영향이 없으니 참고부탁드립니다. 16 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100045.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Lpay&Lpoint 스키마 추가/변경 3 | category: 업데이트 4 | tags: 5 | - 업데이트 6 | datetime: 2021-06-03T15:00:00.000Z 7 | --- 8 | 9 | **포트원 SDK를 사용하는 경우** 10 | 11 | - 안드로이드 SDK는 특정 패키지에 의존하는 부분이 없어서 변경될 사항이 없으며, 12 | IOS는 포트원SDK 예제 및 로직 관련 일부 수정처리가 완료되었습니다. 13 | - info.plist 에 Lpay\&Lpoint 스키마 추가(lmslpay) 및 SDK 버전 업데이트를 진행해주시면 됩니다 14 | 15 | **자체개발하시는 경우** 16 | 17 | - `IOS` : 웹뷰 자체 구현 고객 → info.plist 추가 및 (옵션사항) SDK 미설치 이동 로직 수정 18 | - `Android` : 기본적으로 수정되어야 할 내용 없으나, 안드로이드 11(api 30) 의 경우 Andorid 11 보안 정책 변경에 따라 패키지명 명시가 필요할 경우 AndroidManifest.xml  내에 해당 패지키 추가 부탁드립니다.\ 19 | \ \\ 20 | 아래 링크의 규칙을 따라서 구현해주시면 됩니다.\ 21 | (참고 : ) 22 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100046.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: KB국민카드 결제창 내 리브페이(liivbank) 추가에 따른 앱스킴 추가 3 | category: 업데이트 4 | tags: 5 | - 업데이트 6 | datetime: 2024-03-18T10:02:37.923Z 7 | --- 8 | 9 | 13 | 14 | #### **`해당고객`** 15 | 16 | - webview 를 통해 아임포트 js sdk 를 연동하여 iOS 앱을 서비스하시면서, 내부에 UIApplication.shared.canOpenURL() 를 쓰시는 경우 17 | - iamport react-native, flutter, cordova, capacitor 등의 플러그인을 통해 iOS 앱을 서비스하시는 경우 18 | - iamport-ios sdk를통해 iOS앱을 서비스하시는 경우(iamport-ios v1.0.0-dev.11부터는 필요치 않으나 권장) 19 | 20 | #### **`미해당고객`** 21 | 22 | - iOS 모바일 앱 없이 웹 브라우저를 통한 서비스만 하시는 경우 (워드프레스 플러그인 등) 23 | 24 | ### **반영 방법** 25 | 26 | **어플리케이션 단에서 수정가능한 사항이므로 고객님의 앱에서 수정을 해주셔야 합니다.** 27 | 28 | 1. \[프로젝트 폴더]/ios/\[프로젝트 이름]/info.plist 파일을 오픈합니다. 29 | 2. LSApplicationQueriesSchemes 속성에 liivbank 외부 앱 리스트를 항목을 추가합니다. 30 | 31 | 자세한 사항은 아래 링크 참고 부탁드립니다. 32 | 33 | - [iamport-ios sdk 예시 ↗](https://github.com/iamport/iamport-ios/blob/e070cd4ce932660349cbfeb99e309004fc7fc392/Example/iamport-ios/Info.plist#L66) 34 | - [관련 참고내용 ↗](https://developer.apple.com/documentation/uikit/uiapplication/1622952-canopenurl) 35 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100047.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 하나카드 토스뱅크 앱스킴 추가 3 | category: 업데이트 4 | tags: 5 | - 업데이트 6 | datetime: 2021-08-01T15:00:00.000Z 7 | --- 8 | 9 | 12 | 13 | #### **`해당고객`** 14 | 15 | - webview 를 통해 아임포트 js sdk 를 연동하여 iOS 앱을 서비스하시면서, 내부에 UIApplication.shared.canOpenURL() 를 쓰시는 경우 16 | - iamport react-native, flutter, cordova, capacitor 등의 플러그인을 통해 iOS 앱을 서비스하시는 경우 17 | - iamport-ios sdk 를통해 iOS 앱을 서비스하시는 경우 (iamport-ios v1.0.0-dev.11 부터는 필요치 않으나 권장) 18 | 19 | #### **`미해당고객`** 20 | 21 | - iOS 모바일 앱 없이 웹 브라우저를 통한 서비스만 하시는 경우 (워드프레스 플러그인 등) 22 | 23 | #### **반영 방법** 24 | 25 | 어플리케이션 단에서 수정가능한 사항이므로 고객님의 앱에서 수정을 해주셔야 합니다. 26 | 27 | 1. \[프로젝트 폴더]/ios/\[프로젝트 이름]/info.plist 파일을 오픈합니다. 28 | 2. LSApplicationQueriesSchemes 속성에 supertoss\:// 외부 앱 리스트를 항목을 추가합니다. 29 | 30 | 자세한 사항은 아래 링크 참고 부탁드립니다. 31 | 32 | - [iamport-ios sdk 예시 보러가기 ↗](https://github.com/iamport/iamport-ios/blob/c50900cfb876d7c19f276a43aea740bd206e17e2/Example/iamport-ios/Info.plist#L67) 33 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100048.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 우리WON뱅킹 앱스킴 추가 3 | category: 업데이트 4 | tags: 5 | - 공통 6 | - 업데이트 7 | datetime: 2021-09-07T15:00:00.000Z 8 | --- 9 | 10 | 11 | 12 | **포트원 SDK를 사용하는 경우** 13 | 14 | 안드로이드 SDK는 특정 패키지에 의존하는 부분이 없어서 변경될 사항이 없으며,IOS는 포트원 SDK 예제 및 로직 관련 일부 수정 처리가 완료되었습니다. 15 | 16 | - info.plist 에 우리WON뱅킹 스키마 추가 및 SDK 버전 업데이트를 진행해주시면 됩니다. 17 | 18 | **자체개발하시는 경우** 19 | 20 | `IOS` : 웹뷰 자체 구현 고객 → info.plist 추가 및 (옵션사항) SDK미설치 이동 로직 수정 21 | 22 | - [iamport-ios sdk 예시](https://github.com/iamport/iamport-ios/blob/e070cd4ce932660349cbfeb99e309004fc7fc392/Example/iamport-ios/Info.plist#L66)[관련 참고내용 ↗](https://developer.apple.com/documentation/uikit/uiapplication/1622952-canopenurl) 23 | 24 | `Android` : 기본적으로 수정되어야 할 내용 없으나, 안드로이드 11(api 30) 의 경우 Andorid 11 보안 정책 변경에 따라 패키지명 명시가 필요할 경우 AndroidManifest.xml  내에 해당 패지키 추가 부탁드립니다.\ 25 | (참고 : ) 26 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100049.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Release Iamport-cordova v0.9.9 3 | category: 업데이트 4 | tags: 5 | - 업데이트 6 | datetime: 2021-10-28T15:00:00.000Z 7 | --- 8 | 9 | 안녕하세요. 포트원 기술지원팀 입니다. 10 | 11 | 포트원 코르도바 v0.9.9 가 배포되었습니다. 12 | 13 | - iOS15 에서 문제가 되었던 navigation bar 투명 이슈를 수정하였습니다. 14 | - 내장된 포트원 JS SDK 가 1.2.0 으로 업데이트 되었습니다.자세한 내용 및 반영사항은 아래 링크 참고 부탁 드립니다. 15 | 16 | 자세한 내용 및 반영사항은 아래 링크 참고 부탁 드립니다. 17 | 18 | - [github 보러가기 ↗](https://github.com/iamport/iamport-cordova) 19 | - [버전정보 보러가기 ↗](https://github.com/iamport/iamport-cordova/blob/master/manuals/VERSION.md) 20 | - [npm 보러가기 ↗](https://www.npmjs.com/package/iamport-cordova) 21 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100054.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 다날 본인인증 인증서 교체 관련 조치 일정 안내' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2024-04-09T06:47:10.391Z 7 | --- 8 | 9 | 안녕하세요, 포트원 고객지원팀입니다. 10 | 11 | 3/25일자에 진행된 다날 PG사의 인증서 교체작업으로 인하여 특정 기기에서 본인인증이 불가합니다. \ 12 | 현상이 발생되어 다날 측 조치 예정으로 확인되었습니다.서비스 운영간 참고부탁드립니다. 13 | 14 | #### **다날 인증서 교체로 발생된 이슈 조치 일정안내** 15 | 16 | - 이슈상황 : 안드로이드 OS버전 9버전 이하 기기에서 본인인증 오류 발생 17 | - 작업 내용 : 최신 루트 인증서가 없는 경우 사용자가 가지고 있는 이전 버전 인증서로 handshake 될수 있도록 하는 인증서 추가 18 | - 작업 일시 : 2024년 4월 2일(화요일) 오전 중 19 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100056.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] KG이니시스 “삼성monimo” 앱 스킴 등록 안내' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2024-04-09T06:47:10.391Z 7 | --- 8 | 9 | 안녕하세요, 포트원 고객지원팀입니다. 10 | 11 | KG이니시스 앱 스킴 추가 등록 관련하여 하기 내용 참고 부탁드립니다. 12 | 13 | 감사합니다. 14 | 15 | ![](/uploads/포트원소식/앰스킴등록.png) 16 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100057.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-01-24 업데이트' 3 | category: 업데이트 4 | tags: 5 | - 관리자콘솔 6 | - 업데이트 7 | searchTags: 8 | - 가상계좌 발급취소 9 | - 릴리즈노트 10 | - 업데이트 11 | datetime: 2024-04-16T07:11:17.699Z 12 | --- 13 | 14 | 15 | 16 | 17 | 18 | ### **주요 업데이트 사항** 19 | 20 | ✔️ 가상계좌 발급취소/말소 API를 이용하여 가상계좌를 말소한 경우 결제실패로 분류되어 표시됩니다. 21 | 22 | 가상계좌 발급 후 입금 전에 API를 이용해 가상계좌를 말소한 경우, 관리자콘솔 \[결제 상세 내역 조회]에서 결제실패로 분류됩니다. 가상계좌 말소 건은 엑셀 다운로드시 실패 상세 항목에 계좌말소로 표시되어 구분할 수 있습니다. 23 | 24 | ✔️ 엑셀 내의 PG계정 컬럼명이 PG상점아이디(MID) 로 변경되었습니다. 25 | 26 | \[결제 상세 내역 조회]에서 엑셀 다운로드시 기존에 PG계정으로 표시되던 컬럼명이 PG상점아이디(MID) 로 표시됩니다. 27 | 28 | #### [\[관리자콘솔 릴리즈노트\] 2024-01-24 업데이트 보러가기↗](https://developers.portone.io/release-notes/console/2024-01-25?v=v1) 29 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100058.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-03-25 업데이트' 3 | category: 업데이트 4 | tags: 5 | - 관리자콘솔 6 | - 업데이트 7 | searchTags: 8 | - 업데이트 9 | - 릴리즈노트 10 | datetime: 2024-04-16T07:11:17.699Z 11 | --- 12 | 13 | 14 | 15 | 16 | 17 | ### **주요 업데이트 사항** 18 | 19 | ✔️ 결제 연동 페이지가 새롭게 단장했습니다. 20 | 21 | \[채널 관리] 22 | 23 | - 기존 연동 관리와 달리 채널 추가 시 결제 모듈 별 지원되는 기능 및 결제 수단 정보를 쉽게 확인할 수 있습니다. 24 | - 자세한 채널 추가 방법은 가이드를 참고해 주세요. [포트원 V1 채널 연동 가이드 보러가기 ↗](https://developers.portone.io/opi/ko/integration/ready/readme) 25 | 26 | \[식별코드·API Keys] 27 | 28 | - V2 API Secret을 발급할 수 있습니다. 29 | - V2 API Secret의 경우 유효기간에 따라 갯수에 제한없이 발급이 가능합니다. 30 | 31 | \[결제알림(Webhook) 관리] 32 | 33 | - 포트원 V2 결제모듈에서 사용하는 웹훅 데이터 형식으로도 테스트할 수 있습니다. 34 | - 포트원 V1/V2 결제 모듈 모두 테스트/실환경에 대해 웹훅을 각각 설정할 수 있습니다. 35 | 36 | #### [\[관리자콘솔 릴리즈노트\] 2024-03-25 업데이트 보러가기↗](https://developers.portone.io/release-notes/console/2024-03-25?v=v1) 37 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100059.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트]2024-04-03 업데이트' 3 | category: 업데이트 4 | tags: 5 | - 관리자콘솔 6 | - 업데이트 7 | searchTags: 8 | - 업데이트 9 | - 릴리즈노트 10 | datetime: 2024-04-16T07:11:17.699Z 11 | --- 12 | 13 | 14 | 15 | 16 | 17 | ### 기타 수정사항 18 | 19 | ✔️ 결제 내역 엑셀 내의 카드유형 정보가 추가되었습니다. 20 | 21 | \[결제 상세 내역 조회]에서 엑셀 다운로드시 신용카드, 체크카드, 기프트카드에 대한 정보가 표시됩니다. 22 | 23 | #### **[\[관리자콘솔 릴리즈노트\] 2024-04-03 업데이트 보러가기↗](https://developers.portone.io/release-notes/console/2024-04-05?v=v1)** 24 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content100060.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-04-12 업데이트' 3 | category: 업데이트 4 | tags: 5 | - API / SDK 6 | - 업데이트 7 | searchTags: 8 | - 한국결제네트웍스 9 | - KPN 10 | - V2 신모듈 11 | - 업데이트 12 | - 릴리즈노트 13 | datetime: 2024-04-16T07:55:25.448Z 14 | --- 15 | 16 | 17 | 18 | 19 | 20 | ### **주요 업데이트 사항** 21 | 22 | ✔️ 포트원 V2 신모듈에서 한국결제네트웍스(KPN) 결제를 지원합니다. 23 | 24 | 이제 포트원 V2를 통해 한국결제네트웍스 일반결제 및 정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 일부 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다. 25 | 26 | 한국결제네트웍스에서 지원하는 결제수단은 아래와 같습니다. 27 | 28 | - 카드 29 | - 실시간 계좌이체 30 | - 가상계좌 (회전식) 31 | - 휴대폰 소액결제 32 | - 간편결제 (허브형/다이렉트) 33 | - 카카오페이 34 | - 네이버페이 (다이렉트 호출 불가) 35 | - 페이코 36 | - 삼성페이 37 | - 토스페이 38 | 39 | 이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 말소, 면세 금액 지정, 상점분담무이자 등의 기능을 지원합니다. 40 | 41 | 한국결제네트웍스 연동에 대해 자세히 알고 싶다면 [한국결제네트웍스 연동가이드↗](https://developers.portone.io/opi/ko/integration/pg/v2/kpn?v=v2)에서 확인하실 수 있습니다. 42 | 43 | [\[API/SDK 릴리즈노트\] 2024-04-12 업데이트 보러가기↗](https://developers.portone.io/release-notes/api-sdk/2024-04-12?v=v2) 44 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200001.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] PortOne(포트원)을 사칭한 문자 메세지 주의 안내' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | searchTags: 7 | - 코인 8 | - 로또 9 | - 사칭 10 | datetime: 2024-04-30T07:22:27.400Z 11 | --- 12 | 13 | 안녕하세요. 포트원 고객지원팀입니다. 14 | 15 | 최근 포트원을 사칭하여 로또/코인 보상 관련으로 유선 및 문자메세지가 발송된 사례가 있어 안내해 드립니다. 16 | 17 | 메세지에 포함된 부탁드립니다. 18 | 19 | 포트원에서는 위와 같은 내용으로 문자메세지를 발송하지 않습니다. 20 | 21 | 감사합니다. 22 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200002.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-05-08 업데이트' 3 | category: 업데이트 4 | tags: 5 | - 관리자콘솔 6 | - 업데이트 7 | searchTags: 8 | - 빌링결제 내역조회 9 | - 빌링결제 캘린더 10 | - 빌링결제 11 | - 릴리즈노트 12 | datetime: 2024-05-08T15:00:00.000Z 13 | --- 14 | 15 | 16 | 17 | 18 | 19 | ### **주요 업데이트 사항** 20 | 21 | ✔️ 빌링결제 내역조회 페이지가 새롭게 오픈했습니다. 22 | 23 | 새로운 빌링결제 내역 조회 페이지에서는 빌링키 결제 및 결제 예약건에 대해 한 번에 조회 및 관리할 수 있습니다. 24 | 25 | **\[상세 내역 조회]** 26 | 27 | - 빌링키 결제 내역을 상태별로 조회할 수 있습니다. 28 | - 콘솔 화면에서 결제 예약일 변경, 예약 해지, 결제 즉시 재시도, 결제 재예약을 할 수 있습니다. 29 | - 리커버리 기능을 설정하여 결제 실패 건에 대한 일괄 재시도를 자동화할 수 있습니다. 30 | - 포트원 V1 결제 서비스의 경우 결제예약 API(Schedule API)를 이용한 결제 예약 건 중 결제 실패 상태인 거래 건에 한하여 리커버리 기능을 사용할 수 있습니다. 비 인증 결제(빌링키) API(Again API) 건에 대한 리커버리 기능은 상반기 내로 업데이트될 예정입니다. 31 | - 포트원 V2 결제 서비스의 경우 빌링키 결제 API 및 결제 예약 API를 이용한 결제 건 중 결제 실패 상태인 거래 건에 한하여 리커버리 기능을 사용할 수 있습니다. 32 | 33 | \[빌링결제 캘린더] 34 | 35 | - 빌링결제 건에 대한 월간/일간 데이터를 확인할 수 있습니다. 36 | - [포트원 빌링결제 내역 가이드 보러가기↗](https://developers.portone.io/opi/ko/console/guide/billing-payments?v=v2) 37 | 38 | [\[관리자콘솔 릴리즈노트\] 2024-05-08 업데이트 보러가기↗](https://developers.portone.io/release-notes/console/2024-05-08) 39 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200005.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] PG가입비 무료 프로모션 종료 안내 ' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | - 가입비 7 | pgCompanies: 8 | - 공통 9 | searchTags: 10 | - Pg가입비 11 | - 유료 12 | - 무료 13 | - 이용요금 14 | - 가입비 15 | datetime: 2024-06-10T15:00:00.000Z 16 | --- 17 | 18 | 안녕하세요. PortOne 팀 입니다. 😊 19 | 20 | 오랜 기간 진행 되었던 **PG가입비 무료 프로모션 종료**에 대한 공지 입니다. 21 | 22 | 현재까지 포트원과 제휴된 모든 PG사 대상으로 가입비 무료 프로모션을 제공하였으나, PG사 가입비 정책 변경으로 아래와 같이 무료 혜택 적용이 종료 될 예정입니다. 서비스 이용에 불편함 없으시도록 참고 부탁드립니다. 23 | 24 | - 가입비 무료 프로모션 종료 일자 : 2024년 06월 30일 (해당 일자 신청 건 까지 프로모션 적용) 25 | 26 | 앞으로도 더 좋은 경험과 서비스를 제공해 드리기 위해 노력하겠습니다. 27 | 28 | 감사합니다. 29 | 30 | 31 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200015.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 결제사 정산 서비스 지원 중단 및 신규 서비스 안내' 3 | category: 공지사항 4 | tags: 5 | - 공통 6 | - 공지사항 7 | searchTags: 8 | - 정산 서비스 9 | - 거래대사 정산 서비스 10 | - 거래대사 11 | - 결제사정산 12 | datetime: 2024-07-08T05:47:06.710Z 13 | --- 14 | 15 | 안녕하세요. PortOne팀입니다. 16 | 17 | 항상 저희 포트원을 이용해 주셔서 감사드립니다. 18 | 19 | 포트원의 "결제사 정산" 서비스에 깊은 관심과 경험을 통한 여러 피드백을 기반으로 기존의 거래 마감 데이터가 아닌 PG사의 정산 데이터를 사용하여 데이터 정합성이 높은 "PG 거래대사" 서비스를 오픈 예정입니다. 20 | 21 | 아래 안내사항 참고하셔서 서비스 이용에 불편함이 없으시도록 참고 부탁드립니다. 22 | 23 | 40 | 41 | - [PG거래대사 클로즈베타 서비스 신청하러 가기↗ (클릭)](https://docs.google.com/forms/d/e/1FAIpQLSeTscoLKYvddYP-V3xkFCO3LwjmDjhsgrXkJZIM98sbbkb62A/viewform) 42 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200016.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-05-14 업데이트' 3 | category: 업데이트 4 | tags: 5 | - API / SDK 6 | - 업데이트 7 | searchTags: 8 | - Ksnet 9 | - 다이렉트기능 10 | - 릴리즈노트 11 | datetime: 2024-05-13T15:00:00.000Z 12 | --- 13 | 14 | 15 | 16 | 17 | 18 | ### **주요 업데이트 사항** 19 | 20 | 21 | 22 | ✔️ KSNET을 통한 카드사 다이렉트 기능을 지원합니다. 23 | 24 | 이제 포트원 V1의 KSNET을 통해 카드사 다이렉트 결제가 가능합니다. 이번 업데이트를 통해 카드사 결제창을 바로 호출하여 사용하세요. 25 | 26 | KSNET 카드사 다이렉트 연동에 대해 자세히 알고 싶다면[→ KSNET 연동가이드](https://developers.portone.io/opi/ko/integration/pg/v1/ksnet/readme?v=v1#카드사-다이렉트-호출)에서 확인하실 수 있습니다. 27 | 28 | (\* 포트원 V2 결제 모듈의 경우 추후에 KSNET을 통한 카드사 다이렉트 기능이 지원될 예정입니다.) 29 | 30 | [\[API/SDK 릴리즈노트\] 2024-05-14 업데이트 보러가기↗](https://developers.portone.io/release-notes/api-sdk/2024-05-14) 31 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200017.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-05-20 업데이트' 3 | category: 업데이트 4 | tags: 5 | - 파트너정산 6 | - 업데이트 7 | searchTags: 8 | - 파트너관리 9 | - 파트너정산 10 | - 릴리즈노트 11 | datetime: 2024-05-19T15:00:00.000Z 12 | --- 13 | 14 | 15 | 16 | 17 | 18 | ## 주요 업데이트 사항 19 | 20 | ✔️ 상세 내역 다운로드 API가 추가되었습니다. 21 | 22 | - \[상세 내역 조회] 페이지에서 정산 상세 내역을 CSV 파일로 다운로드할 수 있습니다. 23 | - 파일 다운로드 후 상세 내역을 확인하고 정산 명세서를 손쉽게 정리해보세요. 24 | 25 | 26 | 27 | ✔️ 예금주 조회 API 응답 본문이 변경되었습니다. 28 | 29 | - 예금주 조회 API 요청 후 정상 인증 완료 시 응답 본문에 accountVerificationId가 추가되었습니다. 30 | 31 | ✔️ 파트너 관리 API 요청/응답 본문이 일부 변경되었습니다. 32 | 33 | - 파트너 생성/다건 생성/수정 API 요청 시 파트너 유형이 비사업자 (원천징수납세자)인 경우, 생년월일을 선택적으로 등록할 수 있습니다. 34 | - 생년월일을 입력할 경우, 8자리로 입력 가능합니다. ex. (YYYYMMDD/YYYY-MM-DD)로 입력 가능 35 | - 파트너 조회/다건 조회/생성/다건 생성/수정/보관/복원 API 응답 시 파트너 사업자 상태 필드(businessStatus)가 추가되었습니다. 사업자등록번호(businessRegistrationNumber)가 변경되거나 기입하여 생성한 경우에 사업자 상태가 업데이트 됩니다. 36 | - 파트너 생성/수정 API 요청 시 예금주 계좌조회에 실패하더라도 파트너를 등록할 수 있습니다. 계좌조회가 어려운 경우 고객사가 직접 계좌 정보를 입력할 수 있습니다. 37 | - 예금주 조회에서 발급받은 accountVerificationId를 사용하여 추가적인 계좌 인증을 생략할 수 있습니다. 38 | 39 | [\[파트너정산 자동화 릴리즈노트\] 2024-05-20 업데이트 보러가기↗](https://developers.portone.io/release-notes/platform/2024-05-20) 40 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200019.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-06-03 업데이트' 3 | category: 업데이트 4 | tags: 5 | - API / SDK 6 | - 업데이트 7 | searchTags: 8 | - 스마트 라우팅 9 | - 업데이트 10 | - 릴리즈노트 11 | datetime: 2024-06-02T15:00:00.000Z 12 | --- 13 | 14 | 15 | 16 | 17 | 18 | ## 주요 업데이트 사항 19 | 20 | 21 | 22 | ✔️ **스**마트 라우팅 기능이 새롭게 출시되었습니다. 23 | 24 | 포트원 V2에서 스마트 라우팅 기능을 제공합니다. 25 | 26 | 27 | 28 | ### 스마트 라우팅이란? 29 | 30 | 스마트 라우팅은 원클릭 결제 트래픽 자동 분산 서비스로 최초 연동 이후 포트원 관리자콘솔 내에서 결제대행사 추가/삭제 및 결제대행사 별 결제 요청 비율을 설정할 수 있습니다. 노코드 방식으로 고객사에서 멀티 PG 인프라를 구성하는데 필요한 개발 리소스를 확 줄였습니다. 31 | 32 | 지원 범위 33 | 34 | - 결제창(SDK) 인증결제 35 | - API 수기(키인) 결제 36 | - API 빌링키 발급 및 빌링키결제/예약결제 37 | 38 | 지원 기능 39 | 40 | 1. 스마트 라우팅 그룹 설정에 따른 결제 트래픽 분산 자동화 41 | 2. 슈퍼빌링키 발급 42 | 43 | - 스마트 라우팅 그룹 내 모든 결제대행사에 대해 빌링키 발급 요청 및 저장 44 | 45 | 지원 결제대행사 46 | 47 | - 나이스페이먼츠 48 | - KG이니시스 49 | - 토스페이먼츠 50 | - 스마트로 51 | - KSNET 52 | - KPN 53 | - NHN KCP (6월 중 제공 예정) 54 | 55 | 이번 업데이트를 통해 스마트 라우팅 그룹을 생성하고 자동화된 결제 트래픽 분산 서비스를 경험해보세요 56 | 57 | 스마트 라우팅에 대해 자세히 알고 싶다면[→ 스마트 라우팅 소개(클릭)](https://developers.portone.io/opi/ko/extra/smart-routing/intro?v=v2) 문서에서 확인하실 수 있습니다. 58 | 59 | #### [\[API/SDK 릴리즈노트\] 2024-06-03 업데이트 보러가기↗](https://developers.portone.io/release-notes/api-sdk/2024-06-03) 60 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200020.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-06-05 업데이트' 3 | category: 업데이트 4 | tags: 5 | - 파트너정산 6 | - 업데이트 7 | searchTags: 8 | - 업데이트 9 | - 파트너관리 10 | - 파트너정산 11 | - 릴리즈노트 12 | datetime: 2024-06-02T15:00:00.000Z 13 | --- 14 | 15 | 16 | 17 | 18 | 19 | ## 주요 업데이트 사항 20 | 21 | ✔️ 파트너 관리 기능 업데이트 22 | 23 | 24 | 25 | - 과세 유형 등록 기능 업데이트 26 | - 파트너가 사업자인 경우, 과세 유형을 등록하고 수정할 수 있습니다. 27 | - 일반 과세 사업자, 간이 과세 사업자 - 세금계산서 발행 유형, 간이 과세 사업자 - 세금계산서 미발행 유형, 면세 사업자를 구분하여 저장할 수 있습니다. 28 | - 등록한 과세 유형은 파트너 관리 테이블에서 확인할 수 있습니다. 29 | - 파트너 관리 테이블 업데이트 30 | - 파트너별 과세 유형을 파트너 관리 테이블에서 확인할 수 있습니다. 31 | - 담당자 연락처 선택값으로 변경 32 | - 파트너 등록/수정 시 필수적으로 입력해야했던 담당자 정보 (휴대폰 번호)를 선택값으로 변경하였습니다. 33 | - 파트너의 휴대폰 번호가 없을 경우, 공란으로 등록/수정할 수 있습니다 34 | 35 | ✔️ API 업데이트 36 | 37 | - 파트너 생성/조회/수정 API 38 | - 사업자 유형에 과세 유형(taxationType)이 추가되었습니다. 39 | - 파트너 생성 API 40 | - 담당자 정보의 휴대폰 번호(phoneNumber)가 선택 값으로 변경되었습니다. 41 | 42 | #### [\[파트너 정산 릴리즈노트\] 2024-06-05 업데이트 보러가기↗](https://developers.portone.io/release-notes/platform/2024-06-05) 43 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200023.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-06-17 업데이트' 3 | category: 업데이트 4 | tags: 5 | - API / SDK 6 | - 업데이트 7 | searchTags: 8 | - 결제서비스 V2 9 | - 'KCP결제모듈 ' 10 | - v2 11 | - 포트원 v2 12 | - 업데이트 13 | datetime: 2024-06-16T15:00:00.000Z 14 | --- 15 | 16 | 17 | 18 | 19 | 20 | ## 주요 업데이트 사항 21 | 22 | 23 | 24 | ✔️ 포트원 V2 결제모듈에서 NHN KCP 결제를 지원합니다. 25 | 26 | 이제 포트원 V2를 통해 NHN KCP 일반결제 및 정기결제가 가능합니다. \ 27 | 이번 업데이트를 통해 다양한 결제수단을 제공하며, 일부 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다. 28 | 29 | NHN KCP에서 지원하는 결제수단은 아래와 같습니다. 30 | 31 | - 실시간 계좌이체 32 | - 가상계좌 33 | - 휴대폰 소액결제 34 | - 상품권 결제(컬쳐랜드/도서문화상품권) 35 | - 간편결제 (허브형/다이렉트) 36 | 37 | 38 | 39 | - 카카오페이 40 | - 네이버페이 41 | - 페이코 42 | - SSG페이 43 | - L페이 44 | - 삼성페이 45 | - 애플페이 46 | - 토스페이 47 | 48 | 49 | 50 | 이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급, 면세 금액 지정, 상점분담무이자 등의 기능을 지원합니다. 51 | 52 | NHN KCP 연동에 대해 자세히 알고 싶다면 [→ NHN KCP 연동가이드](https://developers.portone.io/opi/ko/integration/pg/v2/kcp-v2?v=v2)에서 확인하실 수 있습니다. 53 | 54 | ##### [\[API / SDK 릴리즈노트\] 2024-06-17 업데이트 보러가기↗](https://developers.portone.io/release-notes/api-sdk/2024-06-17) 55 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200024.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-07-05 업데이트' 3 | category: 업데이트 4 | tags: 5 | - 파트너정산 6 | - 업데이트 7 | searchTags: 8 | - 과세유형 9 | - 파트너 과세 10 | - '파트너정산 기능 ' 11 | - 권한별 기능 12 | - 파트너정산 13 | - 릴리즈노트 14 | - 업데이트 15 | datetime: 2024-07-04T15:00:00.000Z 16 | --- 17 | 18 | 19 | 20 | 21 | 22 | 26 | 27 | ## **주요 업데이트 사항** 28 | 29 | ✔️ 권한별 기능 제한 안내 30 | 31 | 32 | 33 | - 안전한 정산 데이터 관리를 위한 역할별 권한 관리 체계 신설 34 | - Owner 혹은 Admin 계정에 한해 데이터 편집 권한이 부여, 그 외의 계정은 데이터 조회 권한 부여 35 | - 사용자 별 권한 부여 및 수정은 \[상점계정관리 페이지> 관리자권한 관리 탭] 에서 Owner 혹은 Admin 계정이 직접 관리 가능 36 | - 상세 내용은 업데이트 페이지에서 확인 가능 37 | 38 | ## 개선 사항 39 | 40 | ✔️ 파트너 업데이트 API - 과세 유형 기본값 적용 41 | 42 | - 파트너 수정 API에서 파트너의 사업 유형 변경 시(비사업자 → 사업자)에 과세 유형이 필수값에서 선택값으로 변경 43 | - 에러 유형이 더욱 상세하게 반환되도록 수정 44 | 45 | ✔️ 정산 내역 관리 - 엑셀 다운로드 시 파트너 과세 유형 지원 46 | 47 | 48 | 49 | ##### [\[파트너정산 릴리즈노트\] 2024-07-05 업데이트 보러가기↗](https://developers.portone.io/release-notes/platform/2024-07-05) 50 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200027.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-07-05 업데이트' 3 | category: 업데이트 4 | tags: 5 | - API / SDK 6 | - 업데이트 7 | searchTags: 8 | - Econtext 9 | - 위변조 10 | - 엑심베이 11 | - 업데이트 12 | - 릴리즈노트 13 | datetime: 2024-07-07T15:00:00.000Z 14 | --- 15 | 16 | 17 | 18 | 19 | 20 | ## **기타 업데이트 사항** 21 | 22 | 23 | 24 | ✔️ 엑심베이 Econtext 결제 시 일부 건에 대한 결제 상태 처리 로직이 변경되었습니다. 25 | 26 | 결제 승인이 완료된 경우 브라우저 새로고침 등의 이유로 결제 프로세스가 비정상적으로 종료된 경우에도 결제 상태가 결제 완료로 유지됩니다. 27 | 28 | 29 | 30 | ✔️ 엑심베이 결제 시 금액 위변조가 발생하는 경우 결제 취소 처리되도록 변경되었습니다. 31 | 32 | 승인 결과 처리 단계에서 결제 요청 당시 결제 금액과 승인 결제 금액이 다른 경우 자동으로 결제 취소 됩니다. 33 | 34 | [\[API/SDK 릴리즈노트\] 2024-07-05 업데이트 보러가기↗](https://developers.portone.io/release-notes/api-sdk/2024-07-04) 35 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200032.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 네이버페이 결제 오류' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | searchTags: 7 | - 네이버페이 오류 8 | - 결제오류 9 | - 오류 10 | - '네이버페이 ' 11 | datetime: 2024-08-15T14:00:34.634Z 12 | --- 13 | 14 | **안녕하세요, 포트원 고객지원팀입니다.** 15 | 16 | **2024년 08월 15일 21시 52분 부터 23시 59분 까지 네이버페이 내부적으로 오류가 발생된 것으로 전달 받아 공유/안내드립니다.** 17 | 18 | **아래 내용 참고부탁드립니다.** 19 | 20 | --- 21 | 22 | 안녕하세요, 네이버페이입니다. 23 | 24 | 아래와 같은 오류 현상이 발생하여 긴급 복구되었습니다. 25 | 26 | 서비스 이용에 불편을 드려 대단히 죄송합니다. 27 | 28 | **\[오류 현상]** **네이버페이 결제 시 결제 오류** 29 | 30 | \[발생 시간] 2024년 8월 15일 21시 52분 \~ 23시 59분 31 | 32 | 보다 안정적인 서비스 체공을 위해 더욱 노력하겠습니다. 33 | 34 | 관련하여 추가적인 문의는 네이버페이 [일대일문의](https://help.admin.pay.naver.com/mail/form.help)로 문의 부탁 드립니다. 35 | 감사합니다. 36 | 37 | \[최초 오류 공지 등록 시간 : 2024년 8월 15일 22시 19분]. 38 | 39 | **[네이버페이 공지사항 보러가기 ↗](https://admin.pay.naver.com/notice/view?id=200018982)** 40 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200033.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 2024.08.17 네이버페이 결제 장애 ' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2024-08-17T09:57:59.786Z 7 | --- 8 | 9 | 안녕하세요, 포트원 고객지원팀입니다. 10 | 11 | 네이버페이 내부적으로 오류가 발생된 것으로 전달받아 안내해 드립니다. 12 | 13 | 현재 조치 완료되었으며, 상세 내용은 아래 참고 부탁드립니다. 참고 부탁드립니다. 14 | 15 | 감사합니다. 16 | 17 | --- 18 | 19 | - 관련 서비스 : 신용카드, 체크카드 20 | - 장애원인 : 네이버 IDC 장애 21 | - 장애 발생 시각 : 2024년 08월 17일 17시31분 \~ 19시 경 22 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200034.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 도메인 만료로 인한 결제 장애 (조치 완료)' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | - 공통 7 | searchTags: 8 | - 도메인 만료 9 | - 오류 10 | datetime: 2024-08-21T07:08:21.703Z 11 | --- 12 | 13 | 안녕하세요. 포트원 고객지원팀입니다. 14 | 15 | 8월 13일 새벽 시간대에 저희 서비스 도메인(iamport.kr)이 만료되어 IP Resolve가 되지 않는 문제가 발생하였습니다. 16 | 대부분의 클라이언트가 IP를 캐싱하고 있었고, 빠른 대처로 전체 장애로 이어지진 않았지만 일부 고객사에서 요청 실패를 경험하게 되었습니다. 17 | 18 | 해당 장애의 세부 맥락은 다음과 같습니다. 19 | 20 | 21 | 22 | 1. 도메인 만료로 장애가 발생한 iamport.kr 은 외부 도메인 등록 대행 서비스에서 관리되는 도메인으로, \ 23 | 2024-08-13 에 자동 갱신될 예정이었습니다. 24 | 2. 해당 서비스에서 사전에 도메인 자동 갱신 예정 이메일을 발송했으며, 포트원 팀 또한 해당 메일을 통해 갱신에 문제가 없을 것으로 인지하고 있었습니다. 25 | 3. 그러나 2024-08-13 갱신예정시점에 도메인 연장 결제가 일어나지 않은 채로 도메인이 만료되었고, 도메인 만료에 대한 알림 또한 받지 못했습니다. 26 | 4. 도메인 갱신을 위해 등록된 결제수단에도 문제가 없음을 확인하였고, 도메인을 수동으로 결제 및 갱신함으로써 장애 상황이 종료되었습니다. 이에 대해서는 장애 당일 해당 외부 서비스에 문의 및 클레임을 넣어둔 상황입니다. 27 | 5. 포트원 팀에서는 이와 같은 문제를 원천 방지하기 위해 iamport.kr 의 도메인을 타 서비스로 이관하고, 도메인 만료일자 관리 및 모니터링을 통한 수동 갱신 대응 프로세스 또한 준비할 예정입니다. 28 | 29 | 30 | 31 | 불편함을 드려 다시 한번 죄송하다는 말씀드립니다.\ 32 | 앞으로 서비스 안정성을 위해 더욱 더 최선을 다하는 포트원이 되겠습니다. 33 | 34 | 감사합니다. 35 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200037.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[2024년 11월] 서비스 이용약관 개정 변경 안내' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | searchTags: 7 | - 서비스이용약관 8 | - 이용약관 9 | datetime: 2024-11-04T03:44:53.773Z 10 | --- 11 | 12 | 안녕하세요\~! 포트원 입니다. 13 | 14 | 항상 포트원을 이용해주시는 고객 여러분께 진심으로 감사드립니다.\ 15 | 2024년 11월 11일 아래와 같이 서비스 이용약관이 변경됨을 사전 안내 드립니다. 16 | 17 | - 공고일 : 2024.11.04(월) 18 | - 시행일 : 2024.11.11(월) 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | > 현재 버전 보러 가기 37 | 38 | [코리아포트원 서비스이용약관(개정일:2024.09.02)](https://terms.portone.io/?_gl=1*17qk47v*_gcl_au*NDcyNjE2NTQ0LjE3MjkwNDY3Nzg.*_ga*MTQzNTc5MTIyMi4xNzIxMTg2MTIx*_ga_PD0FDL16NZ*MTczMDY5OTQ5NC4xMzkuMS4xNzMwNzAwMDAwLjYwLjAuMA..) 39 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200038.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-07-30 업데이트' 3 | category: 업데이트 4 | tags: 5 | - 업데이트 6 | - 파트너정산 7 | searchTags: 8 | - 정산 상세 조회 9 | - 파트너 관리 10 | - 파트너 정산 11 | datetime: 2024-11-04T06:49:52.174Z 12 | --- 13 | 14 | 15 | 16 | 17 | 18 | 21 | 22 | ## **주요 업데이트 사항** 23 | 24 | ✔️ 파트너 사용자 정의 속성 25 | 26 | 27 | 28 | - 파트너 관리 페이지에서 파트너 사용자 정의 속성을 등록할 수 있으며 최대 10개까지 추가 가능합니다. 29 | - 속성 이름은 등록 후에도 수정 가능합니다. 30 | - 보안에 민감한 정보도 관리할 수 있도록 각각의 속성 값의 조회 권한을 설정할 수 있습니다. 31 | - 등록된 값은 \[파트너 관리] 페이지와 \[정산 상세 조회] 페이지에서 확인 가능합니다. 32 | 33 | 34 | 35 | - 파트너 정보 등록 / 파트너 정보 수정 시 속성 값을 지정할 수 있습니다. 36 | 37 | ✔️ 정산 사용자 정의 속성 38 | 39 | 40 | 41 | - 정산 상세 조회 페이지에서 정산 사용자 정의 속성을 등록할 수 있으며 최대 10개까지 추가 가능합니다. 42 | - 속성 이름은 등록 후에도 수정 가능합니다. 43 | - 보안에 민감한 정보도 관리할 수 있도록 각 속성 값의 조회 권한을 설정할 수 있습니다. 44 | 45 | 46 | 47 | - 파트너 사용자 정의 속성값과 정산 사용자 정의 속성 값은 \[정산 상세 조회] 페이지에서 확인할 수 있습니다. 48 | - 관리자만 조회 가능할 수 있는 속성 칼럼은 비관리자가 조회 시 노출되지 않습니다. 49 | 50 | ##### [\[파트너정산 릴리즈노트\] 2024-07-30 업데이트 보러가기↗](https://developers.portone.io/release-notes/platform/2024-07-30) 51 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200039.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-08-07 업데이트' 3 | category: 업데이트 4 | tags: 5 | - 파트너정산 6 | - 업데이트 7 | searchTags: 8 | - 지급 및 정산 내역의 다건 조회를 위한 API 9 | - 다건 조회 10 | - 업데이트 11 | - 릴리즈노트 12 | datetime: 2024-11-05T05:35:58.442Z 13 | --- 14 | 15 | 16 | 17 | 18 | 19 | 23 | 24 | ## **주요 업데이트 사항** 25 | 26 | ✔️ 지급/정산 내역 조회 API 지원 27 | 28 | 29 | 30 | - 정산내역 다건 조회 API가 추가되었습니다. 31 | 32 | 33 | 34 | - 지급 내역 다건 조회 API가 추가되었습니다. 35 | 36 | 37 | 38 | - 일괄 지급 내역 다건 조회 API가 추가되었습니다. 39 | 40 | ✔️ 수기 정산 건 임의 정산일 지원 41 | 42 | - 임의의 정산일을 지정해 수기 정산건을 등록할 수 있도록 변경되었습니다. 43 | - 모든 정산일을 지원함에 따라 PlatformUnavailableSettlementDateError 에러가 삭제되었습니다. 44 | 45 | ##### [\[파트너정산 릴리즈노트\] 2024-08-07 업데이트 보러가기↗](https://developers.portone.io/release-notes/platform/2024-08-07) 46 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200040.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] KSNET 장애로 인한 간헐적 timeout 이슈 (조치완료)' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2024-11-09T04:30:51.861Z 7 | --- 8 | 9 | 안녕하세요. 포트원 고객지원팀입니다. 10 | 11 | 2024년 11월 09일 11시 38분부터 12시 38분까지 KSNET의 내부 오류로 결제가 정상 처리되지 않는 이슈가 있어 안내해 드리니 참고 부탁드립니다. 12 | 13 | - **KSNET 장애로 인한 간헐적 timeout 이슈** 14 | - **KSNET 을 사용한 결제가 정상적으로 진행되지 않을 수 있습니다.** 15 | - **시간 : 2024.11.09 11:38\~12:38** 16 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200043.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 포트원을 사칭한 문자 메세지 주의 안내 ' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | searchTags: 7 | - 소비자보호원 8 | - 코인 9 | - 로또보상 10 | - 사칭 11 | datetime: 2024-12-04T01:47:51.218Z 12 | --- 13 | 14 | 안녕하세요. \ 15 | 포트원 고객지원팀입니다. 16 | 17 | 최근 포트원을 사칭하여 로또/코인 보상 관련으로 유선 및 문자 메세지가 발송된 사례가 있어 안내해 드립니다. 18 | 19 | 메세지에 포함된 부탁드립니다. 20 | 21 | 포트원에서는 위와 같은 내용으로 문자메세지를 절대 발송하지 않습니다. 22 | 23 | 감사합니다. 24 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200044.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] [웰컴페이먼츠] 광주/우리/하나은행 가상계좌 서비스 종료 안내' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | pgCompanies: 7 | - 웰컴페이먼츠 8 | searchTags: 9 | - 서비스 종료 10 | - 하나 11 | - 우리 12 | - 광주 13 | - 가상계좌 종료 14 | - 가상계좌 서비스 종료 15 | - 웰컴 16 | datetime: 2024-12-26T06:40:36.121Z 17 | --- 18 | 19 | 웰컴페이먼츠>광주/우리/하나은행 가상계좌 서비스가 종료 예정인 것으로 공지되어 안내 드립니다. \ 20 | 관련하여 보다 자세한 내용은 아래 본문 혹은 웰컴페이먼츠를 통해 확인하여주시기 바랍니다. 21 | 22 | 34 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200045.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[2025년 1월] 서비스 이용약관 개정 변경 안내' 3 | category: 공지사항 4 | searchTags: 5 | - 서비스유료화 6 | - 개정변경 7 | - 이용약관 8 | datetime: 2024-12-30T03:32:57.425Z 9 | --- 10 | 11 | 안녕하세요\~! 포트원 입니다. 12 | 13 | 항상 포트원을 이용해주시는 고객 여러분께 진심으로 감사드립니다.\ 14 | 2025년 1월 31일 아래와 같이 서비스 이용약관이 변경됨을 사전 안내 드립니다. 15 | 16 | - 공고일 : 2024.12.30(월) 17 | - 시행일 : 2025.1.31(목) 18 | 19 | 20 | 21 | 22 | 23 | > 현재 버전 보러 가기 24 | 25 | [코리아포트원 서비스이용약관(개정일:2024.11.11)](https://terms.portone.io/?_gl=1*171hbom*_gcl_au*NDcyNjE2NTQ0LjE3MjkwNDY3Nzg.*_ga*MTQzNTc5MTIyMi4xNzIxMTg2MTIx*_ga_PD0FDL16NZ*MTczNTUzNDk4MS4yMDMuMC4xNzM1NTM0OTg2LjU1LjAuMA..) 26 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200048.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-09-05 관리자콘솔 업데이트' 3 | category: 업데이트 4 | tags: 5 | - 관리자콘솔 6 | - 업데이트 7 | searchTags: 8 | - 계정정보 9 | - 로그아웃 10 | - 메뉴변경 11 | - 업데이트 12 | - 관리자콘솔 13 | datetime: 2025-02-13T06:02:32.259Z 14 | --- 15 | 16 | 17 | 18 | 19 | 20 | ### **주요 업데이트 사항** 21 | 22 | ✔️ 좌측 메뉴 영역이 새롭게 변경되었습니다. 23 | 24 | 25 | 26 | - \[메뉴 접기] 27 | - 메뉴 접기 아이콘을 클릭하여 좌측 메뉴 영역을 접을 수 있습니다. 28 | - 메뉴가 접힌 상태에서 한번 더 클릭하는 경우 다시 메뉴를 펼칠 수 있습니다. 29 | - \[전자결제 신청] 30 | - 전자결제 신청을 원하시는 경우 좌측 메뉴 영역 하단의 \[전자결제 신청]을 클릭해 주세요. 31 | - \[로그아웃] 32 | - 좌측 메뉴 영역 상단의 \[계정 정보]를 클릭한 후 \[로그아웃]을 클릭해 주세요. 33 | 34 | #### [\[관리자콘솔 릴리즈노트\] 2025-09-05 업데이트 보러가기↗](https://developers.portone.io/release-notes/console/2024-09-05) 35 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200049.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-09-05 원 페이먼트 인프라 업데이트' 3 | category: 업데이트 4 | tags: 5 | - OPI 6 | - 업데이트 7 | searchTags: 8 | - 다이렉트 호출 9 | - KCP 간편결제 10 | - 결제모듈 V2 11 | - KG이니시스 통합인증 12 | - V2 통합인증 13 | - 업데이트 14 | datetime: 2025-02-13T06:02:32.259Z 15 | --- 16 | 17 | 18 | 19 | 20 | 21 | ## **주요 업데이트 사항** 22 | 23 | 24 | 25 | ✔️ 포트원 V2 결제모듈에서 KG이니시스 통합인증을 지원합니다. 26 | 27 | 이제 포트원 V2를 통해 KG이니시스 통합인증이 가능합니다. 이번 업데이트를 통해 통신사PASS, 토스 인증서, 카카오 인증서, 네이버 인증서 등 민간인증서를 이용하여 본인인증을 진행할 수 있습니다. 28 | 29 | 통합인증에서 지원하는 인증수단은 아래와 같습니다. 30 | 31 | - 통신사PASS 32 | - 토스 33 | - 카카오 34 | - 네이버 35 | - 페이코 36 | - 금융결제원 37 | - KB국민은행 38 | - 신한은행 39 | - 하나은행 40 | - 우리은행 41 | - IBK기업은행 42 | - NH농협은행 43 | - 카카오뱅크 44 | - 삼성패스 45 | 46 | KG이니시스 통합인증 연동에 대해 자세히 알고 싶다면 [KG이니시스 통합인증 연동가이드 ↗](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-unified-identity-verification?v=v2) 에서 확인하실 수 있습니다. 47 | 48 | 49 | 50 | ✔️ 포트원 V1 결제모듈에서 KCP 간편결제 다이렉트 호출 결제 이용시 해당 거래건에 결제수단 정보를 표시하는 방식이 일부 변경되었습니다. 51 | 52 | KCP 간편결제 다이렉트 호출 결제의 경우 기존에 결제수단(pay\_method)이 naverpay, payco, kakaopay와 같은 간편결제사로 분류하는 코드였으나 9월 2일 거래건부터 결제 승인 시 결제수단에 따라 point 혹은 card로 표시되도록 변경되었습니다. 53 | 54 | [\[원 페이먼트 인프라 릴리즈노트\] 2024-09-05 업데이트 보러가기](https://developers.portone.io/release-notes/api-sdk/2024-09-05)↗ 55 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content200050.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[릴리즈노트] 2024-09-27 원 페이먼트 인프라 업데이트' 3 | category: 업데이트 4 | tags: 5 | - OPI 6 | - 업데이트 7 | searchTags: 8 | - 위변조 확인 9 | - 거래대사 10 | - 원 페이먼트 인프라 11 | - 업데이트 12 | datetime: 2025-02-13T06:02:32.259Z 13 | --- 14 | 15 | 16 | 17 | 18 | 19 | ## **주요 업데이트 사항** 20 | 21 | 22 | 23 | ✔️ 이제 콘솔 내 PG 거래대사에서 조회한 데이터를 엑셀로 다운로드하여 사용해 보세요. 24 | 25 | 26 | 27 | PG 거래대사 내의 거래 정산 내역 메뉴에서 정산일 또는 거래일을 기준으로, 거래 건별 조회 메뉴에서는 정산일을 기준으로 최대 3개월 분량의 데이터를 엑셀로 다운로드할 수 있습니다. 28 | 29 | 30 | 31 | ✔️ KSNET, KPN, 하이픈에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다. 32 | 33 | 기존에 12개 PG사 (KCP, KG이니시스, 나이스페이먼츠, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 PG 거래대사가 KSNET, KPN, 하이픈까지 확장하여 총 15개 PG사 데이터에 한하여 제공됩니다. 34 | 35 | (참고 : PG 거래대사 메뉴의 경우 클로즈 베타로 운영되고 있으며, 사용을 원하시는 고객께서는 [PG거래대사 베타서비스 신청 바로가기 ↗](https://forms.gle/cZAqJLGqovC1STrS8)에서 신청해 주시길 바랍니다.) 36 | 37 | 38 | 39 | ✔️ 엑심베이 결제시 결제 금액 위변조 확인이 강화됩니다. 40 | 41 | 기존에는 엑심베이로부터 전달받은 값 자체에 위변조 내용이 있는지 hash만 검증했으나 앞으로는 hash 검증에 추가로 실제 결제금액까지 비교하여 금액을 위변조하여 결제가 승인되지 않도록 로직을 추가하였습니다. 42 | 43 | [\[원 페이먼트 인프라 릴리즈노트\] 2024-09-27 업데이트 보러가기↗](https://developers.portone.io/release-notes/api-sdk/2024-09-27) 44 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/content51.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지]신한카드 통합앱 패키지 이름 추가 안내' 3 | category: 공지사항 4 | seo: 5 | title: 신한카드 통합앱 패키지 이름 추가 안내 6 | description: 포트원 고객지원팀이 제공하는 신한카드 통합앱 패키지 이름 추가 안내입니다. 관련 가이드를 통해 상세정보를 확인하세요. 7 | keywords: null 8 | tags: 9 | - 공지사항 10 | datetime: 2024-01-25T15:00:00.000Z 11 | --- 12 | 13 | 안녕하세요, 포트원 고객지원팀입니다. 14 | 15 | 신한카드 그룹 통합앱인 “신한 통합SOL”이 출시됨에 따라 앱 패키지명을 추가해주셔야 함을 안내드립니다. 16 | 17 | 안드로이드로 연동하시는 경우 '[해당 가이드 ↗](https://guide.portone.io/28c179a7-1dae-475e-8e23-84b8c427be19#28c179a7-1dae-475e-8e23-84b8c427be19)'를 참고하시어 앱패키지명에 AndroidManifest.xml에 신한슈퍼솔 앱을 추가하여주시기 바랍니다. 18 | 19 | 37 | 38 | 감사합니다. 39 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/how-to-use/additional-tosspayments.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 토스페이먼츠 상점아이디 추가 절차 3 | category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 서비스 추가/변경 4 | tags: 5 | - 토스페이먼츠 6 | - 서비스추가/변경 7 | pgCompanies: 8 | - 토스페이먼츠 9 | searchTags: 10 | - 토스페이먼츠 MID 11 | - 토스 상점아이디 12 | - 토스 상점아이디 추가 13 | - 토스 서비스 추가 14 | - 토스페이먼츠 서비스 추가 15 | - 토스페이먼츠 상점아이디 추가 16 | - 사이트 추가 17 | - 서비스 추가 18 | - MID 추가 19 | - 상점아이디 추가 20 | - 상점아이디추가 21 | - 토스 22 | - 'MID추가 ' 23 | datetime: 2024-01-25T15:00:00.000Z 24 | --- 25 | 26 | 27 | 28 | 29 | 30 | ### **상점아이디 추가 케이스** 31 | 32 | 34 | 35 | - 이미 토스페이먼츠와 직접 계약이 되어있다가 포트원으로 연동하고자 하시는 경우 36 | - 다른 호스팅사를 통해 토스페이먼츠와 계약 되어있다가 포트원으로 연동하시는 경우 37 | - 새로운 서비스가 추가되는 경우 (=심사를 다시 받아야 하는 경우) 38 | - 기존 서비스와 결제/정산을 분리하고자 하시는 경우 39 | - 심사받은 적 없는 연동방식을 추가하시는 경우 (ex. 일반결제 사용중에 간편/정기결제 추가시) 40 | 41 | ### **신청방법** 42 | 43 | #### **신청 경로** 44 | 45 | - [포트원 관리자콘솔↗ ](https://admin.portone.io/) 회원가입 및 로그인 > 좌측 상단 \[전자결제 신청] 버튼 클릭 > 사업자등록증 업로드(이미 진행했을시 생략) 및 결제수단 담기 > 접수완료 46 | 47 | 48 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/how-to-use/inicis-vbank-refund.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: KG이니시스 가상계좌 환불 특약 방법 3 | category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 결제취소/환불 4 | seo: 5 | title: KG이니시스 가상계좌 환불 특약 방법 6 | description: >- 7 | KG이니시스를 통해 가상계좌 서비스를 이용하실 경우 관련된 이용 특약에 대한 정보를 안내드립니다. 가상계좌 환불 비용 및 환불특약 8 | 신청방법까지 확인해보세요. 9 | tags: 10 | - KG이니시스 11 | - 가상계좌 12 | - 결제취소-환불 13 | pgCompanies: 14 | - KG이니시스 15 | searchTags: 16 | - 가상계좌 특약 17 | - 환불불가 18 | - 환불불가오류 19 | - kg이니시스가상계좌 20 | - 이니시스가상계좌 21 | - 이니시스환불 22 | datetime: 2024-01-25T15:00:00.000Z 23 | --- 24 | 25 | 29 | 30 | ### **가상계좌 환불 비용** 31 | 32 | 가상계좌의 경우 계좌 채번 시 건당 300원씩(VAT 별도)발생되며, 계약 시 설정한 정산 주기에 맞추어 결제수수료를 제외한 금액이 정산되는 형식입니다. 33 | 34 | 결제대행사에서 고객사와 가상계좌 환불 특약을 맺어 처리되며, 부과되는 환불 수수료 적용 기준은 PG사 시스템을 이용하여 수기로 처리되는 사용료 개념의 수수료라고 생각하시면 될 것 같습니다. 35 | 36 | ### **가상계좌 환불특약 신청방법** 37 | 38 | - [KG이니시스 상점관리자페이지↗](https://iniweb.inicis.com/security/login.do) 접속 > 변경/추가 > 정보 변경 및 서비스 추가 39 | - 1\. 서비스 추가 및 변경 > 1.2 지불수단추가 및 변경 > 1.2.1 지불수단 추가 및 변경 40 | - 가상계좌 선택 후 환불서비스(부분취소포함) 사용 선택하여 신청하기 클릭 41 | 42 | 환불 서비스 이용은 KG이니시스에서 시스템 적용 이후 가능하며 적용 여부는 KG이니시스 계약부서를 통해 정확한 확인이 가능합니다. 43 | 44 | - KG이니시스 고객센터 : 1588-4954 45 | 46 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/how-to-use/kcp-vat.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: NHN KCP 부가세 설정방법 3 | category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 부가세 4 | seo: 5 | title: KCP 부가세 설정방법 6 | description: >- 7 | KCP는 계약 시 상점아이디(사이트코드)별 부가세 설정이 가능합니다. 사이트코드 과세 설정에 따라서 처리되는 과세/비과세 처리 부분을 8 | 확인하시기 바랍니다. 9 | keywords: 10 | - 부가세 11 | tags: 12 | - NHN KCP 13 | - 부가세 14 | pgCompanies: 15 | - NHN KCP 16 | searchTags: 17 | - KCP 18 | - NHNKCP 19 | - 복합과세 20 | - 면세 21 | - 비과세 22 | - 과세 23 | - 부가세 24 | - kcp 부가세 25 | datetime: 2024-01-25T15:00:00.000Z 26 | --- 27 | 28 | 30 | 31 | #### 1. 상점아이디(사이트코드)를 ‘면세’로 설정 > 거래 일괄 면세 32 | 33 | 면세로 설정된 MID로 결제를 하는 경우 지정하시는 파라미터(tax\_free)와 관계없이 KG이니시스 내부적으로 일괄 면세로 처리합니다. 34 | 35 | #### 2. 상점아이디(사이트코드)를 ‘복합과세’로 설정 > 파라미터 값에 따라 처리 36 | 37 | - 복합과세용 사이트코드 : 면세와과세 금액 결제를 동시에 진행할 수 있는 상점아이디로, \ 38 | 결제요청시마다 tax\_free 파라미터로 원하는만큼의 면세금액을 지정해서 보낼 수 있습니다. 39 | - tax\_free 파라미터가 지정되지 않을 경우, 거래건 전액 ‘**과세**’로 반영됩니다. 40 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/how-to-use/kcp-vbank-refund.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: NHN KCP 가상계좌 환급시 입금자명 변경방법 3 | category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 결제취소/환불 4 | seo: 5 | title: KCP 가상계좌 환급시 통장내역의 입금자명 변경방법 6 | description: >- 7 | KCP 입금자명 변경 방법에 대한 안내입니다. 가상계좌 거래 환불은 환불요청 이후 익영업일 내 고객의 계좌에 환급이 이루어집니다. 환급 8 | 시 고객 통장 거래내역에 표기되는 입금자 명을 변경하고자 하실 경우, 포트원 가이드를 참고 바랍니다. 9 | keywords: 10 | - 가상계좌 11 | tags: 12 | - NHN KCP 13 | - 가상계좌 14 | - 결제취소-환불 15 | pgCompanies: 16 | - NHN KCP 17 | searchTags: 18 | - KCP입금자명 19 | - 통장인자명 20 | - 입금자명 21 | - 입금자명 변경 22 | - kcp가상계좌 23 | datetime: 2024-01-25T15:00:00.000Z 24 | --- 25 | 26 | 27 | 28 | 33 | 34 | ### **통장인자명 변경 요청방법** 35 | 36 | - [NHN KCP 어드민페이지↗](https://partner.kcp.co.kr/auth/login) 로그인 > 고객센터 > 질문하기 > 기타문의 37 | - 문의내용 38 | - (예시) 가상계좌 환급시 통장거래내역의 입금자명(통장인자명) 변경을 요청드립니다. \ 39 | \- KCP 사이트코드 (상점아이디) :\ 40 | \- 변경요청하는 통장인자명 : 41 | 42 | 43 | 44 | 47 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/how-to-use/naverpay-order-1.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 네이버페이(주문형) 빠른 정산 이용안내 3 | category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 결제대행사 계약 4 | seo: 5 | title: 네이버페이(주문형) 빠른 정산 이용안내 6 | description: >- 7 | 빠른 정산은 구매확정까지 기다림 없이 집화 처리 다음날 100% 지급되는 무료로 이용 가능한 정산 서비스입니다. 기존의 네이버페이 주문형 8 | 이용 가맹점이나 유지 기준을 충족하시면 빠른 정산의 지속 적용이 가능합니다. 9 | keywords: 10 | - 네이버페이(주문형) 11 | tags: 12 | - 네이버페이(주문형) 13 | - 결제대행사 계약 14 | pgCompanies: 15 | - 네이버페이(주문형) 16 | searchTags: 17 | - 주문형 18 | - 주문형 빠른정산 19 | - 네이버페이주문형 20 | - 네이버페이정산 21 | - 빠른정산 22 | datetime: 2024-01-25T15:00:00.000Z 23 | --- 24 | 25 | 27 | 28 | ### **신청 기준** 29 | 30 | - 네이버페이 주문형 이용 사업자 31 | - 신청 기준을 충족한 사업자가 1회 신청 하게 되면, 그 이후부터는 유지 조건이 충족되는 한 빠른 정산 지속 적용 32 | - 네이버페이 주문형을 미사용하는 사업자는 주문형 가입 후 신청 조건이 되었을 때 신청 가능합니다. 33 | 34 | 35 | 36 | 37 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/how-to-use/other-hosting-company.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 타 호스팅사 이용 시 포트원 사용방법 3 | category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 호스팅 제휴 4 | seo: 5 | title: 타 호스팅사 이용 시 포트원 사용방법 6 | description: >- 7 | 호스팅사 정책상 해당 호스팅사를 통해 PG사 계약을 맺어야만 하는 경우, 포트원 연동 서비스(API) 이용 방법 안내를 드립니다. 반드시 8 | 포트원을 통해 계약을 맺어야 하며, 기존 호스팅사 서비스 이용 중이라면 정책 충돌을 방지하기 위해 포트원의 가이드를 체크해 주시기 9 | 바랍니다. 10 | pgCompanies: 11 | - 공통 12 | searchTags: 13 | - 호스팅제휴 14 | - 호스팅사 15 | datetime: 2024-01-25T15:00:00.000Z 16 | --- 17 | 18 | 21 | 22 | ### **이용하는 서비스 파악하기** 23 | 24 | **이용중인 호스팅사를 통해 이용하는 서비스 파악이 필요합니다.**\ 25 | 호스팅사에서 제공되는 서비스별로 적용되는 정책의 범위가 다를 수 있으니 어떤 서비스를 이용 중이신지 먼저 체크 바랍니다. 26 | 27 | 이용 중인 호스팅사로 포트원을 통해 PG 계약 및 서비스 이용이 가능할지 확인해 주시면 정확합니다. 28 | 29 | - 서버만 이용하는 경우 → 반드시 해당 해당 호스팅사를 통해 PG 계약을 맺을 필요가 없음 30 | - 홈페이지 자체를 호스팅사 통해 구축한 경우 → 반드시 해당 호스팅사를 통해 PG 계약을 맺어야 함 31 | 32 | ### **홈페이지 자체 개발 예정인 경우** 33 | 34 | 기존에는 호스팅사의 서비스 사용 중이지만 추후 홈페이지를 직접 개발하실 예정이라면 포트원 연동이 가능합니다. 35 | 36 | 물론 포트원 정책상 포트원용 상점 아이디를 하나 더 발급받으셔야 하며, 포트원 도입 후에는 그전까지 이용하시던 상점 아이디 이용이 불가한다는 점 유의 바랍니다. 37 | 38 | 39 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/how-to-use/payment-settlement-method.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 결제대행사 정산 방법 3 | category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 결제대행사 계약 4 | seo: 5 | title: 결제대행사 정산 방법 6 | description: >- 7 | 정산은 계약을 맺은 PG사에서 고객사로 직접 이뤄집니다. 서비스 업종/유형 등에 따라 PG사와 계약 시 정산 일자, 정산한도금액 등이 8 | 결정됩니다. PG사 관리자 페이지에서 자세한 상점 정보를 확인하세요. 9 | keywords: 10 | - 정산 11 | tags: 12 | - 공통 13 | - 결제대행사 계약 14 | pgCompanies: 15 | - 공통 16 | searchTags: 17 | - 정산한도 18 | - 정산주기 19 | - 정산방법 20 | datetime: 2024-01-25T15:00:00.000Z 21 | --- 22 | 23 | 24 | 25 | PG사와 계약을 맺으실 때 서비스 업종/유형 등에 따라  정산 일자, 정산한 도금액 등이 결정됩니다. 26 | 27 | 이미 PG사와 계약을 맺으셨다면, \ 28 | PG사의 관리자 페이지에서 자세한 상점 정보(결제수단, 수수료율, 정산 정보 등)을 확인하실 수 있습니다. 29 | 30 | PG사와 계약 시 결정된 정보이기 때문에 포트원에서는 정산 정보를 알 수 없으며 임의로 변경하는 것도 불가합니다. 31 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/how-to-use/small-business-commission-fee.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 영중소 수수료율 기준 3 | category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 결제대행사 계약 4 | seo: 5 | title: 영중소 수수료율 기준 6 | description: >- 7 | PG사 수수료율은 2019년 1월 31일부터 정부 정책에 따라 매출 규모에 따라 영세, 중소 사업자에 대한 우대수수료율이 적용됩니다. 8 | 신규 서비스(매출이 발생되지 않은 사업자)는 첫 세금 신고 전까지 '일반사업자'로 적용됩니다. 9 | keywords: 10 | - 공통 11 | - PG사 요금 12 | tags: 13 | - 공통 14 | - 결제대행사 계약 15 | - 수수료 16 | pgCompanies: 17 | - 공통 18 | searchTags: 19 | - PG사 수수료 20 | - PG수수료 21 | - PG 수수료 22 | - PG 요금 23 | - PG사 요금 24 | - PG사요금 25 | - PG요금 26 | - 결제 요금 27 | - 결제요금 28 | - 수수료 기준 29 | - 수수료기준 30 | - 영세 사업자 31 | - 중소 사업자 32 | - 영세사업자 33 | - 중소사업자 34 | - 영중소수수료 35 | - 매출 36 | - 수수료율 37 | - 중소 38 | - 영세 39 | - 영중소 수수료 40 | - 수수료 41 | datetime: 2024-01-25T15:00:00.000Z 42 | --- 43 | 44 | 46 | 47 | - 적용 시점 : 매년 반기별(1월/7월) 적용 48 | - 적용 방법 : 국세청으로부터 영세/중소 신용카드 사업장의 사업자 명단을 PG사로 전달하고, PG사에서는 해당 매출액을 기준으로 수수료율 자동 적용 (PG사별 어드민 페이지 및 공지사항 참조)됩니다. 49 | - 참고 : 신규 서비스(매출이 발생되지 않은 사업자)는 첫 세금 신고 전까지 **`"일반사업자"`** 로 적용됩니다. 50 | 51 | 56 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/how-to-use/wordpress-available-pg.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 워드프레스 지원 결제대행사 3 | category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 플러그인 4 | seo: 5 | title: 워드프레스 지원 결제대행사 6 | description: >- 7 | 우커머스 플러그인으로 웹사이트 구축 시 이용 가능한 PG사 및 연동방식 참고를 위한 정보입니다. 포트원에서 지원하고 있는 워드프레스 8 | 결제대행사 내용을 확인하세요. 9 | keywords: 10 | - 워드프레스 11 | tags: 12 | - 공통 13 | - 플러그인 14 | - 워드프레스 15 | pgCompanies: 16 | - 공통 17 | searchTags: 18 | - 단비스토어 19 | - 코스모스팜 20 | - 워드프레스 21 | - 플러그인 22 | - 우커머스 23 | datetime: 2024-01-25T15:00:00.000Z 24 | --- 25 | 26 | 29 | 30 | 포트원에서 현재 지원이 가능한 결제플러그인은 우커머스 플러그인입니다. 31 | 32 | #### **정기결제 이용시 참고사항** 33 | 34 | 정기결제는 [우커머스 서브스크립션(subscription) 플러그인↗](https://woo.com/products/woocommerce-subscriptions/) 을 기반으로 서비스를 제공드리고 있어 우커머스에서 제공하는 WooCommerce Subscriptions 플러그인(유료, $199)이 반드시 설치되어 있어야 합니다. 35 | 36 | #### **본인인증 이용시 참고사항** 37 | 38 | 워드프레스로 구축된 사이트의 본인인증서비스는 ‘포트원’에서 지원되지 않아 포트원 기반의 본인인증 서비스를 지원하는 타사 플러그인을 이용해주시길 권장드립니다. 39 | 40 | - [코스모스팜 회원관리↗](https://www.cosmosfarm.com/wpstore/product/cosmosfarm-members) : 다날의 SMS본인인증 지원 41 | - [단비스토어 얼티밋멤버↗](https://staging-danbistoretk.kinsta.cloud/product/um-verification/) : 다날의 SMS본인인증, KG이니시스 통합인증 지원 42 | 43 | 44 | 45 | #### **참고 연동가이드** 46 | 47 | 포트원을 통한 워드프레스 우커머스 플러그인 사용방법을 안내드립니다. 48 | 49 | 50 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/payment-type/content200003.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 정기결제 again 과 schedule API의 차이가 있나요? 3 | category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 정기결제 4 | tags: 5 | - 정기결제 6 | searchTags: 7 | - 정기결제 api 8 | - 정기결제 9 | - 스케줄 API 10 | - 스케줄 11 | - schedule API 12 | datetime: 2024-05-09T08:20:14.620Z 13 | --- 14 | 15 | 17 | 18 | 포트원을 통해 schedule API를 활용하실 경우, 19 | 결제 결과는 설정하신 웹훅으로 보내 드리기 때문에 정기결제를 구현함에 있어 그 로직이나 과정이 복잡하지 않습니다. 20 | 21 | 정해진 일자에 단순하게 결제가 이루어지기만 하면 될 경우 schedule  API를 쓰셔서 웹훅으로 받은 결제 결과의 실패/성공에 따른 처리만 하시면 됩니다.\ 22 | 반면, 가맹점의 정기결제 서비스 로직 전/후에 수행해야하는 특별한 로직이 있거나 정기결제가 이루어지는 과정을 자유롭게 커스터마이징 하고 싶으시다면 cronjob을 직접 수행하여 again api 를 사용하셔도 무방합니다. 23 | 24 | 포트원에서는 가맹점의 정기결제 로직이 복잡하지 않다면 schedule api를 사용하시길 권장드리고 있습니다. 25 | 26 | ### **schedule API의 처리 순서** 27 | 28 | 1.최초 카드정보 등록으로 빌링키 발급 및 발급된 빌링키에 customer\_uid로 1:1대응 후 포트원 내 저장        29 | 30 | 2.결제일자가 확정되는 시점에 schedule API로 일정 / 금액 / 결제할 customer\_uid 등 지정        31 | 32 | 3.해당 시각에 처리가 완료되면 성공/실패 여부를  웹훅으로 POST요청        33 | 34 | 4.결제 성공이면 webhook에서 크레딧 증가 후 다음 schedule등록 API추가 35 | (실패될 경우 원하는 일자에 다시 재결제 되도록 로직을 구현해주셔야 합니다.)      36 | 37 | 38 | 39 | 40 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/payment-type/content200036.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '나이스페이먼츠_허브형 간편결제 추가방법 ' 3 | category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 간편결제 4 | tags: 5 | - 허브형 6 | - 간편결제 7 | pgCompanies: 8 | - 나이스페이먼츠 9 | searchTags: 10 | - 허브형 간편결제 11 | - 나이스페이먼츠 간편결제 12 | - 나이스페이먼츠 13 | - 간편결제 14 | - 허브형 15 | datetime: 2024-09-24T05:40:12.616Z 16 | --- 17 | 18 | 20 | 21 | ### 나이스페이먼츠 추가계약 절차 22 | 23 | - 나이스페이먼츠 계약부서(TEL : 1661-7335 > 3)를 통해, 간편결제 서비스 추가 계약 요청 24 | - 나이스페이먼츠 서비스 추가 계약/심사 진행 25 | \- 간편결제용 MID 발급을 위한 \[아이디 추가 신청서] 및 \[간편결제 신청서] 접수 필요 26 | \- 별도 심사 후 이용가능, 일부 유의업종 서비스 제공 불가 27 | - 나이스페이먼츠 간편결제 서비스 입점 심사 진행 및 가맹점 심사 결과 안내 28 | - 나이스페이먼츠 간편결제 서비스 사용 설정 29 | - 서브몰 심사 요청(원천사(간편결제사) 심사 요청) 30 | - 서브몰 심사 완료 31 | 32 | 추가 계약 요청 후 나이스페이먼츠 담당자가 계약절차 및 계약서류 안내드릴 예정입니다. (약 3영업일 소요) 33 | 34 | - [허브형 간편결제 이용 방법 보러가기 ↗](https://help-center-portone.vercel.app/content/hub-service-fee) 35 | - [나이스페이먼츠\_간편결제 연동 방법 ↗](https://help.portone.io/content/nice-easypay-hub-fee) 36 | 37 | 38 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/payment-type/inicis-easypay-hub-fee.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: KG이니시스 허브형 간편결제 신청방법 3 | category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 간편결제 4 | seo: 5 | title: KG이니시스 허브형 간편결제 신청방법 6 | description: >- 7 | KG이니시스에서는 다양한 간편결제사가 제휴되어 있어 이니시스를 통해 이용이 가능합니다. 간편결제사별로 심사 절차가 필요하므로 아래 경로로 8 | 신청주시면 이니시스 담당 부서 확인 후 심사 및 설정 가능합니다. 9 | keywords: 10 | - KG이니시스 11 | - 간편결제 12 | tags: 13 | - KG이니시스 14 | - 간편결제 15 | pgCompanies: 16 | - KG이니시스 17 | searchTags: 18 | - 허브형간편결제 19 | - 간편결제추가 20 | - KG이니시스간편결제 21 | - KG이니시스허브형 22 | datetime: 2024-01-25T15:00:00.000Z 23 | --- 24 | 25 | 27 | 28 | ### **KG이니시스 간편결제 상점아이디 추가** 29 | 30 | KG이니시스에서는 다양한 간편결제사가 제휴되어있어 이니시스를 통해 이용이 가능합니다.\ 31 | 다만, 간편결제사별로 심사 절차가 필요하므로 아래 경로로 신청주시면 이니시스 담당부서에서 확인 후 심사 및 설정 가능합니다. 32 | 33 | 34 | 35 | ### **KG이니시스 간편결제 추가 절차** 36 | 37 | - [KG이니시스 상점관리자페이지↗](https://iniweb.inicis.com/) : 포트원용 KG이니시스 MID 로그인 > 우측 상단 \[변경/추가] > 1.2.1 지불수단 추가 및 변경 > 6. 간편결제 에서 이용하실 간편결제 서비스 체크 후 \[신청하기] 38 | 39 | 40 | 41 | - 네이버페이의 경우 간편결제 신청 시 요청사항 란에 ‘네이버페이 신청’으로 기입해 주시기 바랍니다. 42 | - 허브형 간편결제는 정기결제방식은 제공하지 않습니다. 43 | 44 | 45 | 46 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/payment-type/internationl-pg.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 해외결제 지원 결제대행사 목록 3 | category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 해외결제 4 | seo: 5 | title: 결제대행사별 특징 | 해외결제 6 | description: 해외결제를 지원하는 결제대행사 목록입니다. 결제대행사별 해외결제 서비스를 비교,검토하시어 이용하실 결제대행사를 결정하시기 바랍니다. 7 | tags: 8 | - 공통 9 | - 해외결제 10 | pgCompanies: 11 | - 엑심베이 12 | - 페이먼트월 13 | - 페이팔 14 | - 토스페이먼츠 15 | - 나이스페이먼츠 16 | - KG이니시스 17 | - NHN KCP 18 | searchTags: 19 | - 해외카드 20 | - 해외결제지원 21 | - 해외결제 pg사 22 | - 헤외결제 지원 pg사 23 | - 해외결제 지원 24 | datetime: 2024-03-18T06:45:29.257Z 25 | --- 26 | 27 | 28 | 29 | ### **해외결제 지원 결제대행사 목록** 30 | 31 | 1. **해외카드 + 현지결제 지원 결제대행사 : 페이먼트월, 페이팔, 엑심베이** 32 | 33 | - [페이먼트월 해외결제 서비스 이용안내 보러가기↗](/content/paymentwall-international) 34 | - [페이팔 해외결제 서비스 이용안내 보러가기↗](/content/paypal-international) 35 | - [엑심베이 해외결제 서비스 이용안내 보러가기↗](/content/eximbay-international) 36 | 37 | **2. 해외카드 지원 국내 결제대행사 : KG이니시스, NHN KCP, 나이스페이먼츠, 토스페이먼츠** 38 | 39 | - 국내PG사를 통해서 해외특약을 맺고, 해외결제를 이용하실 수 있습니다. 40 | - 단, 사업자는 반드시 국내사업자(해외사업자 불가)여야 하는 점 참고해주세요! 41 | - 정기결제는 지원 되지 않습니다. 42 | 43 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/payment-type/nice-international.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 나이스페이먼츠 해외결제 서비스 이용안내 3 | category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 해외결제 4 | seo: 5 | title: 나이스페이먼츠 해외결제 서비스 이용안내 6 | description: >- 7 | 나이스페이먼츠의 해외카드결제 서비스를 통한 해외결제 이용방법 안내드립니다. 나이스페이먼츠의 지원결제 수단 및 특징, 입점기준, 특약 8 | 신청방법, 참고사항까지 자세한 정보를 확인해보세요. 9 | keywords: 10 | - 나이스페이먼츠 11 | - 해외결제 12 | tags: 13 | - 나이스페이먼츠 14 | - 해외결제 15 | pgCompanies: 16 | - 나이스페이먼츠 17 | datetime: 2024-01-25T15:00:00.000Z 18 | --- 19 | 20 | 21 | 22 | ### **나이스페이먼츠의 해외카드결제 서비스 이용안내** 23 | 24 | 1. **지원 결제수단** 25 | 26 | - 해외카드 : VISA, MASTER, Unionpay 27 | 28 | ##### **2. 지원 서비스 특징** 29 | 30 | - 지원가능 통화 : KRW (승인/정산) , USD (나이스페이측과 별도 협의필요) 31 | - 결제방식 : KCP결제창을 띄우는 방식으로만 가능 32 | - 지원가능언어 : 한국어, 영어, 중국어 33 | - 정산방식 : 원화결제 - 원화정산 34 | 35 | ##### **3. 입점기준** 36 | 37 | - 국내사업자로만 계약이 가능합니다. (해외 법인 사업자 계약불가) 38 | - 나이스페이먼츠를 통해 해외카드 사용 특약을 맺은 후 서비스 사용이 가능합니다. 39 | - 컨텐츠 상품도 입점심사을 받아볼 수 있습니다. 40 | 41 | ##### **4. 참고사항** 42 | 43 | 나이스페이먼츠의 경우에는 해외카드 결제 시 국내 카드 결제와 비슷하게 인증시스템(3D인증)을 거쳐야하기에\ 44 | 인증 절차가 없는 해외 결제자들에게는 결제과정이 다소 불편할 수 있습니다. 45 | 46 | 48 | 49 | 50 | 51 | 52 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/payment-type/tosspayment-international.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 토스페이먼츠 해외결제 서비스 이용안내 3 | category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 해외결제 4 | seo: 5 | title: 토스페이먼츠 해외결제 서비스 이용안내 6 | description: >- 7 | 토스페이먼츠의 해외카드결제 서비스를 통한 해외결제 이용방법 안내드립니다. 토스페이먼츠의 지원결제 수단 및 서비스 특징, 입점기준, 8 | 토스페이먼츠 MID추가 절차, 참고사항까지 자세한 정보를 확인해보세요. 9 | keywords: 10 | - 해외결제 11 | tags: 12 | - 토스페이먼츠 13 | - 해외결제 14 | pgCompanies: 15 | - 토스페이먼츠 16 | searchTags: 17 | - 해외카드 특약 18 | - 해외카드 19 | - 토스페이먼츠 해외결제 20 | - 해외결제 21 | datetime: 2024-01-25T15:00:00.000Z 22 | --- 23 | 24 | 25 | 26 | #### **토스페이먼츠의 해외카드결제 서비스 이용안내** 27 | 28 | 1. **지원 결제수단** 29 | 30 | - 해외카드 (VISA, MASTER, JCB) 31 | 32 | ##### **2. 지원 서비스 특징** 33 | 34 | - 지원가능 통화 : KRW (승인/정산) 35 | - 결제방식 : 토스페이먼츠 결제창을 띄우는 방식으로만 가능 36 | - 지원가능언어 : 한국어, 영어, 중국어 37 | - 정산방식 : 원화정산 38 | 39 | ##### **3. 입점기준** 40 | 41 | - 국내사업자로만 계약이 가능합니다. (해외 법인 사업자 계약불가) 42 | - 토스페이먼츠를 통해 해외카드 사용 특약을 맺은 후 서비스 사용이 가능합니다. 43 | - 컨텐츠 상품도 입점심사을 받아볼 수 있습니다. 44 | 45 | ##### **4. 참고사항** 46 | 47 | - 토스페이먼츠의 경우에는 해외카드 결제 시 국내 카드 결제와 비슷하게 인증시스템(3D인증)을 거쳐야하기에 인증 절차가 없는 해외 결제자들에게는 결제를 하는데 불편함이 있습니다. 48 | 49 | ##### **5. 신청방법** 50 | 51 | 기존에 토스페이먼츠를 통해 국내결제만 이용하고 계셨다면 해외결제용 MID 추가발급이 필요합니다.\ 52 | 신규계약절차와 동일한 접수 프로세스로 진행 해주시기 바랍니다. 53 | 54 | 55 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/payment-type/tosspayments-easypay-hub-fee.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 토스페이먼츠_허브형 간편결제 추가 방법 안내 3 | category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 간편결제 4 | seo: 5 | title: 토스페이먼츠_허브형 간편결제 추가 방법 안내 6 | description: | 7 | 토스페이먼츠에 이미 가입되어 있으신 경우, 8 | 토스페이먼츠측에 간편결제 추가계약 절차가 필요 합니다! 9 | tags: 10 | - 간편결제 11 | - 토스페이먼츠 12 | pgCompanies: 13 | - 토스페이먼츠 14 | searchTags: 15 | - 추가계약 16 | - 간편결제 추가 17 | - 간편결제 18 | - 허브형 19 | - 토스페이먼츠 20 | datetime: 2024-07-10T07:39:34.415Z 21 | --- 22 | 23 | 25 | 26 | ### 토스페이먼츠 추가계약 절차 27 | 28 | - 토스페이먼츠 홈페이지 접속 > 기존 토스페이먼츠 계정 로그인 29 | - 로그인 후 화면 하단 "전자결제 신청" 선택 30 | - 사업자등록번호 입력 31 | - 호스팅사에서 제공하는 쇼핑몰 구축 서비스를 이용 중이신가요? > “네” 선택 32 | - 이용중인 호스팅사를 선택하세요 > "\[다른 업체 검색]" 선택 후 검색란에 "포트원(간편결제)" 입력 33 | - 검색된 리스트 중 "포트원(간편결제)" 선택 34 | 35 | 신청접수가 완료되면 토스페이먼츠 담당자가 계약절차 및 계약서류 안내드릴 예정입니다. (약 3영업일 소요) 36 | 37 | 38 | 39 | - 토스페이먼츠는 일반결제와 허브형 간편결제용 MID가 개발 발급되므로, 추가 설정하시어 pg파라미터에 MID를 지정하여 요청하도록 구현 부탁 드립니다. 40 | - [허브형 간편결제 이용 방법 보러가기 ↗](https://help-center-portone.vercel.app/content/hub-service-fee) 41 | - [토스페이먼츠\_간편결제 연동 방법 ↗](https://guide.portone.io/67330b1b-24a9-444a-a394-a2783e8876a2) 42 | - [토스페이먼츠\_애플페이 이용 방법 보러가기 ↗ ](https://guide.portone.io/67330b1b-24a9-444a-a394-a2783e8876a2) 43 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/core-service/payment-type/webhook-re-send.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 웹훅 재 발송 기능 3 | category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 정기결제 4 | seo: 5 | description: 웹훅 재발송 기능을 설명하고 설정할 수 있는 방법에 대한 가이드입니다. 6 | tags: 7 | - 공통 8 | pgCompanies: 9 | - null 10 | searchTags: 11 | - 웹훅 12 | - 웹훅발송 13 | - 웹훅재발송 14 | datetime: 2024-04-18T10:00:41.772Z 15 | --- 16 | 17 | 20 | 21 | #### **1.** **자동** **재발송기능** **설정** 22 | 23 | 포트원의 웹훅은 1회 발송을 기본으로 하나, 고객사의 일시적인 오류 등으로 인하여 오류코드 응답시 1분단위로 최대 5회까지 재 전송되도록 설정이 가능합니다. \ 24 | 아래 옵션 중 설정을 원하시는 경우를 선택하여 포트원 고객지원팀()으로 포트원 계정 주소와 함께 웹훅 재발송 기능적용을 요청 주시기 바랍니다. 25 | 26 | \[설정옵션] 27 | 28 | - 응답코드 : 0 혹은 500번대 일 때 발송 29 | 30 | 33 | 34 | #### **2.** **수기** **재발송** **기능** 35 | 36 | • [포트원 관리자콘솔](https://admin.portone.io/) > 결제내역 > 결제내역 상세 > 웹훅 재발송 >웹훅 관리 클릭! 37 | 38 | • 웹훅 로그에서 "웹훅 재발송처리" 도 가능 ! 39 | 40 | 41 | 42 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/console-faq/add-admin-account.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 관리자 계정은 몇 개까지 추가할 수 있나요? 3 | category: 자주 묻는 질문 (일반 문의) > 관리자콘솔 > 관리자콘솔 문의 4 | seo: 5 | title: 관리자 계정은 몇 개까지 추가할 수 있나요? 6 | description: >- 7 | 포트원 관리자콘솔 계정의 권한별 생성가능한 경로 및 갯수 안내입니다. 계정추가 경로, 권한별 설정가능 갯수, 권한별 이용 가능한 기능 8 | 모두 확인해보세요. 9 | keywords: 10 | - 관리자콘솔 11 | tags: 12 | - 관리자콘솔 13 | pgCompanies: 14 | - 공통 15 | searchTags: 16 | - 권한추가 17 | - 관리자권한추가 18 | - 관리자권한 19 | - 관리자계정 20 | datetime: 2024-01-25T15:00:00.000Z 21 | --- 22 | 23 | 24 | 25 | #### **계정추가 경로** 26 | 27 | [관리자콘솔 상점·계정관리 ↗](https://admin.portone.io/merchant) > 관리자 계정관리 > 관리자계정 추가 28 | 29 | 30 | 31 | #### **권한별 설정가능 갯수** 32 | 33 | - admin : 1개 34 | - dev : 10개 35 | - manager / read only : 갯수 제한 없음 36 | 37 | #### **권한별 이용 가능한 기능** 38 | 39 | - admin : 전체 권한 40 | - dev : 연동, 내역 조회 41 | - manager : 내역 조회/수정, 리포트, 계정 관리 42 | - read only : 내역 조회/ 리포트 43 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/console-faq/change-console-url.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 관리자콘솔의 계정 주소를 변경할 수 있나요? 3 | category: 자주 묻는 질문 (일반 문의) > 관리자콘솔 > 관리자콘솔 문의 4 | seo: 5 | title: 관리자콘솔의 계정 주소를 변경할 수 있나요? 6 | description: 포트원 관리자콘솔 로그인 메일주소를 변경할 수 있는 방법 안내입니다. 로그인이 불가하신 경우에는 별도의 인증과정이 진행될 수 있습니다. 7 | keywords: 8 | - 관리자콘솔 9 | tags: 10 | - 관리자콘솔 11 | pgCompanies: 12 | - 공통 13 | searchTags: 14 | - 메일주소변경 15 | - 관리자콘솔계정 16 | - 계정주소변경 17 | - 계정변경 18 | datetime: 2024-01-25T15:00:00.000Z 19 | --- 20 | 21 | 22 | 23 | #### **관리자콘솔 로그인이 가능한 경우** 24 | 25 | - [포트원 관리자콘솔 로그인↗](https://admin.portone.io/) > 설정 > 내 정보 관리 > 이메일 변경 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | #### **관리자콘솔 로그인이 불가한 경우** 34 | 35 | [포트원 관리자콘솔↗](https://admin.portone.io/) > 비밀번호 재설정 > 메일로 비밀번호 재설정 링크 수신 후 변경가능 36 | 37 | 38 | 39 | 40 | 41 | #### **관리자콘솔 로그인 & 메일 수신이 불가한 경우** 42 | 43 | 아래 정보를 포트원 고객지원팀()으로 전달하신 후 강제로 포트원 메일주소를 변경합니다. \ 44 | (변경된 메일주소로 비밀번호 재설정링크 수신하여 변경 가능합니다) 45 | 46 | - 상호명 : 47 | - 사업자번호 : 48 | - 대표자명 : 49 | - 대표자 생년월일 : 50 | - 고객사 식별코드 : 51 | - 이용하시는 결제대행사(PG사) / 상점아이디 : 52 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/console-faq/impossible-login.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 관리자 콘솔 로그인이 안될 땐 어떻게 하나요? 3 | category: 자주 묻는 질문 (일반 문의) > 관리자콘솔 > 관리자콘솔 문의 4 | seo: 5 | title: 관리자 콘솔 로그인이 안될 땐 어떻게 하나요? 6 | description: 포트원 관리자콘솔 로그인 관련 문제가 발생한 경우 체크하실 사항을 안내드립니다. 7 | keywords: 8 | - 관리자콘솔 9 | tags: 10 | - 관리자콘솔 11 | pgCompanies: 12 | - 공통 13 | datetime: 2024-01-25T15:00:00.000Z 14 | --- 15 | 16 | #### **포트원 계정으로 메일 수신이 `가능`한 경우** 17 | 18 | - [포트원 관리자콘솔↗ ](https://admin.portone.io/auth/signin) > 비밀번호 재설정 > 메일로 비밀번호 재설정 링크 수신 후 변경가능 19 | 20 | #### **포트원 계정으로 메일 수신이 `불가능`한 경우** 21 | 22 | 아래 정보를 포트원 고객지원팀()으로 전달하신 후 강제로 포트원 메일주소를 변경합니다.\ 23 | (변경된 메일주소로 비밀번호 재설정링크 수신하여 변경가능) 24 | 25 | - 상호명 : 26 | - 사업자번호 : 27 | - 대표자명 : 28 | - 대표자 생년월일 : 29 | - 고객사 식별코드 : 30 | - 이용하시는 결제대행사(PG사) / 상점아이디 : 31 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/console-faq/payment-list.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 포트원 결제내역은 어떤 기준으로 집계되나요? 3 | category: 자주 묻는 질문 (일반 문의) > 관리자콘솔 > 관리자콘솔 문의 4 | seo: 5 | title: 포트원 결제내역은 어떤 기준으로 집계되나요? 6 | description: 관리자콘솔 결제 상세내역의 집계 기준 안내입니다. 상세내역조회 집계기준, 홈 대시보드 집계기준 등 상세한 정보를 확인해보세요. 7 | keywords: 8 | - 관리자콘솔 9 | tags: 10 | - 관리자콘솔 11 | pgCompanies: 12 | - 공통 13 | searchTags: 14 | - 홈대시보드 15 | - 상태승인시각 16 | - 결제요청시각 17 | - 결제상세내역 18 | - 집계기준 19 | - 결제내역 20 | datetime: 2024-01-25T15:00:00.000Z 21 | --- 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | #### **상세내역조회 집계기준** 30 | 31 | - 결제 요청 시각 : 결제가 처음 요청된 시각을 기준으로 조회합니다. 32 | - 상태 승인 시각 : 결제상태가 가장 최근에 변경된 시각을 기준으로 조회합니다. 33 | - ex) 결제 1/2 일 / 취소 1/4일 경우 > 조회 날짜를 1/4\~1/4일로 고정하면 \ 34 | **결제 요청 시각** 기준에서는 결과가 나오지 않고 **상태 승인 시각** 기준에서는 결과가 조회 됩니다. 35 | 36 | #### **홈 대시보드의 집계기준** 37 | 38 | - 기간 동안 승인된 금액을 합계 (그 사이에 결제만 됐다면 무조건 합계포함) 39 | - 기간 동안 취소된 금액을 합계 (그 사이에 결제만 됐다면 무조건 합계포함) 40 | - 순거래액 : 승인 - 취소 합계 41 | 42 | #### **홈(대시보드) 집계기준과 비교하기** 43 | 44 | - 홈(대시보드)는 **결제 요청 시각 기준**으로만 집계가 되고 있습니다. 45 | - 또한 집계기준과 별개로 홈 화면에는 테스트 결제내역 및 해외결제를 포함하고 있지 않아 (KRW기준으로만 표기) 결제내역과의 차이가 발생될 수 있으며 결제내역에는 필터링 옵션이 존재하므로 필터링에 따라 다르게 조회될 여지가 있습니다. 46 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/general-inquiry/change-business-number.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 사업자번호가 바뀌면 어떻게 하나요? 3 | category: 자주 묻는 질문 (일반 문의) > 일반 문의 > 자주 묻는 질문 4 | seo: 5 | title: 사업자번호가 바뀌면 어떻게 하나요? 6 | description: >- 7 | 결제대행사와의 계약은 사업자번호를 기준으로 이루어집니다. 사업자번호 변경 시에는, 결제대행사의 정책에 따라 포트원을 통해 결제대행사와의 8 | 계약을 신규로 진행해주시기 바랍니다. 9 | keywords: 10 | - 계약절차 11 | tags: 12 | - 계약절차 13 | pgCompanies: 14 | - 공통 15 | searchTags: 16 | - 양도양수 17 | - 폐업 18 | - 사업자변경 19 | - 법인변경 20 | - 개인법인변경 21 | - 사업자번호 22 | - 사업자번호 변경 23 | datetime: 2024-01-25T15:00:00.000Z 24 | --- 25 | 26 | 사업자의 ①양도양수 ②법인사업자로의 전환 ③폐업 후 신규 서비스 등록 등 다양한 사유로 사업자번호가 변경되는 경우가 존재할텐데요! 기본적으로 결제대행사와의 계약은 사업자번호를 기준으로 이루어집니다. 27 | 28 | 따라서 사업자번호가 변경된다면, 결제대행사의 정책에 따라 포트원을 통해 결제대행사와의 계약을 신규로 진행해주셔야 합니다. 29 | 30 | 신규 계약과 동시에 기존 서비스가 정상 운영되어야 하는 경우 연동 과정을 세밀히 신경써주셔야 하므로 관련 가이드를 자세히 참고해주세요. 31 | 32 | 33 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/general-inquiry/content200011.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 인앱결제를 이용해야 하는 기준 3 | category: 자주 묻는 질문 (일반 문의) > 일반 문의 > 자주 묻는 질문 4 | tags: 5 | - 공통 6 | searchTags: 7 | - PG결제 8 | - 스토어정책 9 | - 인앱결제 10 | datetime: 2024-06-21T07:20:17.493Z 11 | --- 12 | 13 | ### **인앱결제란?** 14 | 15 | 16 | 17 | ### **PG결제 or 인앱결제?** 18 | 19 | 20 | 21 | - 앱스토어 정책 : 22 | - 구글스토어 정책 : 23 | 24 | 25 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/general-inquiry/content200041.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: SMS 본인인증도 테스트 가능한가요? 3 | category: 자주 묻는 질문 (일반 문의) > 일반 문의 > 자주 묻는 질문 4 | tags: 5 | - 테스트 6 | pgCompanies: 7 | - 다날 8 | searchTags: 9 | - 테스트 10 | - 본인인증 테스트 11 | - 본인인증 서비스 12 | - 인증 13 | - 다날 인증 14 | datetime: 2024-11-11T05:53:52.332Z 15 | --- 16 | 17 | 다날PG사에서 제공하는 SMS본인인증 서비스는 통신사 정책으로 인하여 테스트개발이 어렵습니다. 18 | 19 | 다날 PG사와 실제 계약을 맺으신 후 발급받는 상점정보로 개발테스트를 진행하시면 됩니다. 20 | 21 | 22 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/general-inquiry/what-is-the-small-business-fee.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 영중소 수수료율은 무엇인가요? 3 | category: 자주 묻는 질문 (일반 문의) > 일반 문의 > 자주 묻는 질문 4 | seo: 5 | title: 영중소 수수료율은 무엇인가요? 6 | description: >- 7 | 정부 정책에 의해 매출규모에 따라 영세, 중소 사업자에 대한 우대 수수료율이 적용되며, 포트원은 해당 영중소 수수료율의 기준을 따르고 8 | 있습니다. 지금 상세 정보를 확인해보세요. 9 | keywords: 10 | - PG사 요금 11 | tags: 12 | - 공통 13 | - PG사 요금 14 | pgCompanies: 15 | - 공통 16 | searchTags: 17 | - 일반사업자 18 | - 중소 19 | - 영세 20 | - 영중소수수료율 21 | - 수수료율 22 | - 영중소 23 | datetime: 2024-01-25T15:00:00.000Z 24 | --- 25 | 26 | 27 | 28 | #### **영중소 수수료율이란?** 29 | 30 | PG사 수수료율은 2019년 1월 31일부터 정부 정책에 의해 매출규모에 따라 영세, 중소 사업자에 대한 우대 수수료율이 적용됩니다. 31 | 32 | - 적용시점 : 매년 반기별(1월/7월) 적용 33 | - 적용방법 : 국세청으로부터 영세/중소 신용카드 사업장들의 사업자 명단을 PG사로 전달하고, PG사에서는 해당 매출액을 기준으로 수수료율 자동적용 (PG사별 어드민 페이지 및 공지사항 참조) 34 | - 참고 : 신규서비스(매출이 발생되지 않은 사업자)는 첫 세금 신고 전까지 '일반사업자'로 적용됩니다. 35 | 36 | 42 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/payment-faq/cancel-deadline.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 결제취소는 언제까지 가능한가요? 3 | category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스 4 | seo: 5 | title: 결제취소는 언제까지 가능한가요? 6 | description: >- 7 | 결제취소가 가능한 기한 안내입니다. 결제하신 수단에 따라 다르며 기본적으로 원천사(카드사, 통신사 등)의기준을 따라 적용됩니다. 지금 8 | 상세 정보를 확인해보세요. 9 | keywords: 10 | - 일반결제 11 | tags: 12 | - 공통 13 | - 일반결제 14 | pgCompanies: 15 | - 공통 16 | searchTags: 17 | - 최대결제취소 18 | - 결제취소기간 19 | - 결제취소가능기간 20 | - 결제취소기한 21 | datetime: 2024-01-25T15:00:00.000Z 22 | --- 23 | 24 | 25 | 26 | - 결제취소는 결제하신 수단에 따라 다르며 기본적으로 **원천사(카드사, 통신사 등)의 기준**을 따라 적용됩니다. 27 | - 일반적으로 **카드는 결제 이후 1년 이내,** 가상계좌,계좌이체는 기한 제한이 없이 취소가 가능하며, 휴대폰결제는 반드시 결제한 당월 내에만 취소가 가능합니다. 28 | 29 | 33 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/payment-faq/cancel-guide.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 결제는 어떻게 취소할 수 있나요? 3 | category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스 4 | seo: 5 | title: 결제는 어떻게 취소할 수 있나요? 6 | description: >- 7 | 포트원을 통해 거래를 취소(환불)하는 방법 안내입니다. 결제대행사를 통해 직접 취소를 진행하는 경우 포트원에서 취소 여부를 알 수 8 | 없습니다. 결제부터 취소까지 모두 포트원 API 혹은 관리자콘솔에서 진행부탁드립니다. 9 | keywords: 10 | - 관리자콘솔 11 | tags: 12 | - 공통 13 | - 관리자콘솔 14 | pgCompanies: 15 | - 공통 16 | searchTags: 17 | - 취소방법 18 | - 결제환불 19 | - API취소 20 | - 관리자콘솔 환불 21 | - 환불방법 22 | - 관리자콘솔 결제취소 23 | - 콘솔 결제취소 24 | - 결제취소 25 | datetime: 2024-01-25T15:00:00.000Z 26 | --- 27 | 28 | 29 | 30 | - **결제대행사를 통해 직접 취소를 진행하는 경우 포트원에서 취소 여부를 알 수 없기 때문에 정상 취소된 건도 포트원에서는 여전히 '결제완료'로 상태값이 반영되지 않고 남아있게 됩니다** 31 | - **결제부터 취소까지 모두 포트원의 API 혹은 관리자콘솔을 사용해 주셔야 하는 점 유의하여 주시기 바랍니다.** 32 | 33 | ### **포트원 관리자콘솔을 통해 환불하기** 34 | 35 | 1. [포트원 관리자콘솔↗](https://admin.portone.io)클릭 > 내역 > 우측 표기된 취소 버튼으로 취소 36 | 37 | 38 | 39 | 2\. [포트원 관리자콘솔↗ ](https://admin.portone.io)클릭 > 내역 > 취소하고자 하는 거래건의 행을 클릭 > 결제내역 상세 결제취소 탭 진입 40 | 41 | 42 | 43 | ### **포트원의 API로 환불하기** 44 | 45 | - 포트원에서 제공드리는 API로 환불요청이 가능합니다. 46 | - V1 취소요청 API [POST `/payments/cancel`](https://developers.portone.io/api/rest-v1/payment#post%20%2Fpayments%2Fcancel) 47 | - V2 취소요청 API [POST `/payments/{paymentId}/cancel`](https://developers.portone.io/api/rest-v2/payment#post%20%2Fpayments%2F%7BpaymentId%7D%2Fcancel) 48 | ] 49 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/payment-faq/receipt-guide.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 매출전표는 어떻게 확인하나요? 3 | category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스 4 | seo: 5 | title: 영수증 확인방법 6 | description: >- 7 | 포트원을 통한 영수증 확인방법을 안내드립니다. 포트원은 PG사에서 제공하는 매출전표 URL을 그대로 전달하고 있습니다. 현재 URL 8 | 형태로만 제공되며 PG사에 따라 URL 접속시 구매정보를 인증할 수도 있습니다. 9 | keywords: 10 | - 영수증 11 | tags: 12 | - 공통 13 | - 영수증 14 | pgCompanies: 15 | - 공통 16 | searchTags: 17 | - 승인전표 18 | - 매출전표 조회 19 | - 매출전표 20 | --- 21 | 22 | 24 | 25 | ### **매출전표 확인방법** 26 | 27 | **1. 포트원 관리자콘솔 내 조회** 28 | 29 | - [포트원 관리자 콘솔](https://admin.portone.io/) > 결제내역 > 확인이 필요한 결제 행 클릭 > 결제내역 상세 > 승인영수증 30 | 31 | 32 | 33 | ##### **2. API 호출 후 응답** 34 | 35 | ##### API 호출하시면 매출전표 URL을 나타내는 receipt\_url 파라미터가 응답됩니다. 36 | 37 | - 결제정보 조회 API : GET /payments/`{imp_uid}` 38 | - 결제정보 조회 API : GET /payments/`{imp_uid}` 39 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/payment-faq/tosspayments-cash-receipt.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 토스페이먼츠 현금영수증 옵션을 제어할 수 있나요? 3 | category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스 4 | seo: 5 | title: 토스페이먼츠 현금영수증 노출제어방법 6 | description: >- 7 | 토스페이먼츠의 현금영수증 발행화면 제어 방법 안내입니다. 토스페이먼츠를 통해 현금영수증을 발행하시는 경우 결제수단별로 토스페이먼츠 결제창 8 | 내 현금영수증 발행여부의 노출여부를 제어할 수 있습니다. 9 | keywords: 10 | - 현금영수증 11 | tags: 12 | - 토스페이먼츠 13 | - 현금영수증 14 | pgCompanies: 15 | - 토스페이먼츠 16 | searchTags: 17 | - 현금영수증 노출 18 | - 토스페이먼츠 현금영수증 19 | datetime: 2024-01-25T15:00:00.000Z 20 | --- 21 | 22 | 23 | 24 | ### **토스페이먼츠 결제창 내 현금영수증 노출 제어** 25 | 26 | 토스페이먼츠를 통해 현금영수증을 발행하시는 경우 결제수단별로 토스페이먼츠 결제창 내 ‘현금영수증 발행여부’ 노출여부를 제어할 수 있습니다. 27 | 28 | - 경로 : [토스페이먼츠 상점관리자페이지↗](https://app.tosspayments.com/) > 상점정보관리 > MID 검색 > 결제수단 관리에서 각 지불수단 선택 후 현금영수증 사용여부 확인 29 | 30 | 현금영수증은 발행 유형과 관련하여 보다 자세한 안내는 아래에서 확인하실 수 있습니다. 31 | 32 | 33 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/faq/payment-faq/vbank-info.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 가상계좌 계좌정보는 어떻게 확인할 수 있나요? 3 | category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스 4 | tags: 5 | - 공통 6 | - 가상계좌 7 | pgCompanies: 8 | - 공통 9 | searchTags: 10 | - 가상계좌은행정보 11 | - 계좌번호조회 12 | - 가상계좌조회 13 | datetime: 2024-04-18T10:00:41.772Z 14 | --- 15 | 16 | 17 | 18 | #### 1. API 로 정보 받아오기 19 | 20 | 아래 API 호출하여 가상계좌 관련된 응답값을 받아보실 수 있습니다.파라메터를 활용하시어 고객에게 문자발송 & 카카오톡 안내 & 마이페이지에 표기 등 원하시는 로직을 구현하실 수 있습니다. 21 | 22 | API : [`GET /payments/\{imp_uid\}`](https://developers.portone.io/api/rest-v1/payment#get%20%2Fpayments%2F%7Bimp_uid%7D) 23 | 24 | - 가상계좌 응답 파라메터 25 | - vbank\_code (string) : 가상계좌 은행 표준코드 (금융결제원기준) 26 | - vbank\_name (string): 입금받을 가상계좌 은행명 27 | - vbank\_num (string) : 입금받을 가상계좌 계좌번호 28 | - vbank\_holder (string) : 입금받을 가상계좌 예금주 29 | - vbank\_date (integer) : 입금받을 가상계좌 마감기한 UNIX timestamp 30 | - vbank\_issued\_at (integer) : 가상계좌 생성 시각 UNIX timestamp 31 | 32 | #### 2. 포트원 관리자콘솔에서 확인하기 33 | 34 | 포트원 관리자콘솔 > 통합 결제 > 결제내역 상세 > 결제정보 ‘결제수단’ 에서 확인가능 35 | 36 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/holidays.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 추석연휴 휴무공지' 3 | category: 공지사항 4 | tags: 5 | - 공지사항 6 | datetime: 2024-09-13T09:02:24.352Z 7 | --- 8 | 9 | 안녕하세요, 포트원 고객지원팀입니다. 10 | 11 | 이번 한 해도 변함없이 포트원을 사랑해주셔서 무한한 감사를 전해드리며, 12 | 13 | 이번 추석을 맞이하여 고객지원센터 휴무 일정을 안내 드립니다. 14 | 15 | #### 🍂 **추석 연휴 고객센터 운영 안내** 16 | 17 | - **내용 : 추석연휴로 인한 휴무 일정 공지** 18 | - **기간 : 2024년 9월 16일(월) \~ 09월 18일(수)** 19 | 20 | --- 21 | 22 | 연휴 기간은 고객센터 상담 및 PG가입 접수건 진행이 불가능한 점 양해 부탁드리며, 23 | 문의 사항이 있을 경우 이메일 및 톡 상담(카카오톡, 채널톡)으로 남겨주시면 09월 19일(목)부터 순차적으로 빠른 답변드리겠습니다. 24 | 25 | 모두 건강하고 풍요로운 한가위 보내시고, 오가는 귀향길 안전운전하시기 바랍니다. 26 | 27 | 감사합니다. 28 | 29 | 포트원 드림 30 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/procedure/payment-integration/real-integration.md: -------------------------------------------------------------------------------- 1 | --- 2 | description: >- 3 | 포트원 이용절차 중 실연동에 관련된 안내입니다. 결제대행사와 계약을 맺으신 후 운영환경 반영이 가능합니다. 미리 확인해야할 사항들을 4 | 체크해보세요. 5 | title: 실 연동 6 | category: 포트원 이용절차 (온보딩 가이드) > 결제 연동 > 실연동 7 | seo: 8 | title: 실 연동 9 | tags: 10 | - 공통 11 | - 실 연동 12 | pgCompanies: 13 | - 공통 14 | searchTags: 15 | - 운영환경 16 | - 실운영 17 | - 채널설정 18 | - 연동방법 19 | - 실연동 20 | --- 21 | 22 | 23 | 24 | 25 | 26 | ### **사전 점검사항** 27 | 28 | 1. **실 결제는 카드사(원천사) 심사까지 최종적으로 완료되었을 때 가능합니다.** 29 | 30 | - 결제대행사와 계약만 완료되고 카드사 심사가 완료되지 않은 경우 실 KEY가 발급 되었을지라도 결제가 이루어지지 않는 것이 정상입니다. 31 | - 최종적으로 마지막 단계인 ‘원천사(카드사, 통신사 등)심사’가 완료된 후 결제대행사(PG)로부터 서비스 사용 안내를 받으셨을 때 실제 결제 승인이 가능합니다. 32 | 33 | **2. 테스트 KEY만 운영용 KEY로 바꾸고 바로 서비스 오픈하면 되나요?** 34 | 35 | - 카드사 심사가 완료되었다고 안내받으셨을지라도 예상하지 못한 변수로 인하여 결제오류가 발생되거나 내부적으로 구현하시는 로직이 올바르게 동작하지 않을 수 있습니다. 따라서 **서비스를 오픈하기 전 반드시 충분한 테스트를 진행해주시길 권고드립니다.** 또한 테스트환경에서 실 연동환경으로 전환하셨다면 실운영 KEY로 결제가 발생되고 있는지 확인하시어 테스트용 KEY로 서비스가 오픈되지 않도록 유의해주세요. 36 | 37 | ### **실 연동 채널 설정방법** 38 | 39 | 심사가 완료된 KEY를 포트원 관리자콘솔에서 설정해주세요.\ 40 | 연동을 위한 KEY는 결제대행사(PG)에서 계약을 진행하신 담당자님 메일로 안내를 드리고 있습니다.\ 41 | 아래 가이드를 통해 원하시는 결제대행사의 실 연동 채널 설정방법을 확인해보세요. 42 | 43 | 44 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/procedure/pg-application/content53.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 결제대행사 계약절차 3 | category: 포트원 이용절차 (온보딩 가이드) > 전자결제 신청 > 결제대행사 계약안내 4 | seo: 5 | title: 결제대행사 계약절차 6 | description: >- 7 | 포트원 전자결제 신청을 위한 안내입니다. 전자결제 신청 후 계약은 PG사와 진행되기에, 진행 전에 포트원이 제공하는 결제대행사별 안내 8 | 경로 및 특징 정보를 확인하시기 바랍니다. 9 | keywords: 10 | - 이용절차 11 | - PG사 12 | - PG사 계약안내 13 | - 계약안내 14 | - 결제대행사 15 | - 결제대행사 계약안내 16 | tags: 17 | - 공통 18 | - PG계약 19 | - 가입신청 20 | - 계약서작성 21 | pgCompanies: 22 | - 공통 23 | searchTags: 24 | - 결제대행사 25 | - 전자결제신청 26 | - 가입신청 27 | - PG사별계약안내방법 28 | - 미리준비하기 29 | - PG계약절차 30 | --- 31 | 32 | 34 | 35 | ### **결제대행사별 안내 경로** 36 | 37 | 가입신청까지 모두 완료되었다면 다음 단계부터는 결제대행사로부터 안내를 받습니다. 38 | 39 | 신청 이후 다음 단계부터는 결제대행사별로 진행 절차가 조금씩 상이한데요, 결제대행사에 따라 포트원에서 먼저 안내를 드리기도 하며 결제대행사에서 직접 메일로 안내를 드리기도 합니다. 40 | 41 | 기본적으로 모든 안내는 메일로 확인해주시기 바라며 종종 **스팸함**으로 누락되는 경우도 있으니 유의하여 진행상황을 체크해주시기 바랍니다. 42 | 43 | 44 | 45 | ### **결제대행사별 특징 알고 가기** 46 | 47 | 결제대행사에서 제공되는 서비스는 각 결제대행사별 정책에 따라 조금씩 다른 차이점이 존재하는데요, 미리 알아두면 좋을 결제대행사별 특징을 모아두었으니 이용하실 결제대행사에 맞춰 필요한 정보를 확인하시기 바랍니다. 48 | 49 | 50 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/recon_issue1.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] 결제사 정산 업데이트 오류 안내 (조치완료)' 3 | category: 공지사항 4 | seo: 5 | title: '[공지] 결제사 정산 업데이트 오류 안내' 6 | description: "안녕하세요, 포트원\_고객지원팀입니다.\n현재 당사의 결제사\_정산 서비스에서\_데이터 정확도를 위한 보강 작업을 진행하였으나,\n정산 데이터가 중복\_집계되는\_이슈가 발생하여 공지드립니다.\n" 7 | tags: 8 | - 공지사항 9 | pgCompanies: 10 | - null 11 | datetime: 2024-04-26T09:53:36.865Z 12 | --- 13 | 14 | 안녕하세요. 포트원 고객지원팀입니다. 15 | 16 | 현재 당사의 결제사 정산 서비스에서 데이터 정확도를 위한 보강 작업을 진행하였으나, 17 | 18 | 정산 데이터가 중복 집계되는 이슈가 발생하여 공지드립니다. 19 | 20 | --- 21 | 22 | 1. 이슈 내용 : 결제사 정산 4/1-4/12까지의 데이터가 중복 집계되는 이슈 발생 23 | 2. 작업 일정 : 4/26-4/28 내부 작업으로 인하여 4월 정산 데이터 조회 불가 → 4/29 정상 제공 예정 24 | 25 | 이용에 불편을 드려 죄송합니다. 26 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/recon_issue2.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: '[공지] (구)토스페이먼츠 결제사 정산 업데이트 오류 안내 (조치완료)' 3 | category: 공지사항 4 | seo: 5 | title: '' 6 | description: > 7 | 안녕하세요. 포트원 고객지원팀입니다 8 | 9 | 현재 당사의 결제사 정산 서비스 중 (구)토스페이먼츠의 정산 데이터를 수집하는 과정에서 4월 정산 데이터가 중복으로 집계되는 이슈가 10 | 발생하여 공지드립니다. 11 | tags: 12 | - 공지사항 13 | datetime: 2024-04-30T02:23:58.602Z 14 | --- 15 | 16 | 안녕하세요. 포트원 고객지원팀입니다 17 | 18 | 현재 당사의 결제사 정산 서비스 중 (구)토스페이먼츠의 정산 데이터를 수집하는 과정에서 4월 정산 데이터가 중복으로 집계되는 이슈가 발생하여 공지드립니다. 19 | 20 | --- 21 | 22 | - 이슈 내용 : **(구)토스페이먼츠** 정산데이터가 중복 수집되어 노출 23 | - 해당 날짜 : 2024.04.01-2024.04.30 24 | - 작업 일정 : 2024.04.30-2024.05.01 (내부 작업으로 인하여 (구)토스페이먼츠 정산 데이터 조회 불가) 25 | - 재개 일정 : 2024.05.02 26 | 27 | 서비스 이용에 불편 드려 죄송합니다. 28 | 29 | 감사합니다. 30 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/service/integration-type/integration-type.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 연동방식 3 | category: 서비스 종류 (결제대행사별 지원서비스) > 연동방식 > 연동방식 4 | seo: 5 | title: 연동방식 6 | description: >- 7 | 결제창 방식과 API 방식으로 제공되는 포트원의 연동방식 안내입니다. 유저의 결제 경험에 큰 영향을 미치는 결제 화면 UI가 관련된 매우 8 | 중요한 요소이며, 결제대행사를 고르기 전 아주 중요한 기준이 됩니다. 9 | keywords: 10 | - 연동방식 11 | - 결제창방식 12 | - API 13 | - SDK 14 | - 인증결제 15 | - 비인증결제 16 | tags: 17 | - 연동방식 18 | - 결제창 19 | - API 20 | pgCompanies: 21 | - 공통 22 | searchTags: 23 | - API방식 24 | - 결제창방식 25 | - 결제모듈 26 | --- 27 | 28 | 31 | 32 | ## 33 | 34 | ### **결제창 방식** 35 | 36 | 결제대행사(PG사)에서 제공하는 결제창을 이용하여 결제하는 방식을 의미합니다.\ 37 | 결제창 화면 UI 및 구성을 변경할 수는 없으나 반대로 추가 개발 없이 결제대행사에서 제공하는 화면을 그대로 사용할 수 있다는 특징이 있습니다. 38 | 39 | 일반적인 이커머스에서 구현하시는 단건결제(일회성결제) 에서 가장 많이 사용하시는 방식입니다.\ 40 | 참고로 결제창 내 표기되는 항목들은 결제방식(일반결제, 정기결제 등)에 따라 상이할 수 있습니다. 41 | 42 | 43 | 44 | ### **API 방식** 45 | 46 | 결제대행사(PG사)에서 제공하는 결제창을 이용하지 않고 결제화면 UI를 직접 만드는 방식을 의미합니다. 결제요청이 API 로 이루어지기 때문에 유저에게 노출되는 결제 화면은 고객사에서 직접 만들어야 합니다. 이러한 점에서 원하시는 브랜드 이미지로 결제화면을 맞춤형으로 제작이 가능하며 반대로 추가적인 화면 구현 개발이 필요하다는 특징이 있습니다. 47 | 48 | 또한 결제창 방식과 다르게 카드사 인증과정이 생략되어있기 때문에 간편하게 결제가 가능하나 동시에 인증 과정이 생략되었기 때문에 이용을 원할 시 결제대행사측의 추가 심사가 필요할 수 있습니다. 49 | 50 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/help/service/version/portone-version.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 결제모듈 3 | category: 서비스 종류 (결제대행사별 지원서비스) > 결제모듈 > 결제모듈 4 | seo: 5 | title: 결제모듈 6 | description: >- 7 | 포트원에서 제공하는 결제 모듈입니다. 결제 모듈별 지원하는 결제대행사 및 기능이 상이하므로 개발하고자 하는 결제대행사 및 기능에 따라 8 | 버전을 선택하시어 연동하시길 바랍니다. 9 | keywords: 10 | - 결제모듈 11 | - V1 12 | - V2 13 | tags: 14 | - 공통 15 | pgCompanies: 16 | - 공통 17 | searchTags: 18 | - ' 서비스 종류' 19 | - 결제모듈 20 | - 포트원결제모듈 21 | - 포트원모듈 22 | - V1 23 | - V2 24 | - 라이트닝 25 | --- 26 | 27 | 29 | 30 | ## 31 | 32 | ### **결제모듈 V1** 33 | 34 | - 결제 대행사 및 결제수단 연동 국내외 30개 PG사를 통한 최적의 결제수단 선택 가능 35 | - 데이터 통합 관리 관리자콘솔을 통한 PG사 결제 데이터 확인 / 취소 / 환불 / 본인인증 / 현금영수증 관리 36 | 37 | ### **결제모듈 V2** 38 | 39 | - 혁신적인 개발자 경험: 쉽고 편리한 결제 연동 40 | 41 | 42 | 43 | - Open API Spec Download 44 | - 직관적인 스키마 설계 45 | - npm, Typescript 지원 46 | 47 | 48 | 49 | - 내부 시스템 개선: 풍부한 데이터와 견고한 서버 50 | - 확장성: 무한한 가능성을 열어주는 결제 시스템 51 | - 안정성: 신뢰할 수 있는 서버 52 | - 완벽한 데이터 보존: 우수한 데이터 정합성과 풍부한 정보 제공 53 | - 기능 확장: 신속한 업데이트와 혁신 54 | - 사용 가능한 PG사 55 | 56 | 57 | 58 | - 결제 : 나이스페이먼츠, 토스페이먼츠, 이니시스, 스마트로, KSNET, 카카오페이, 네이버페이, 페이팔 59 | - 본인인증 : 다날 (휴대폰 본인인증) , 이니시스(통합인증) 60 | 61 | 62 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/console/guide/api-keys.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 내 식별코드, API Keys 3 | description: '' 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | ## 내 식별코드 , API Keys 9 | 10 | ## 위치 11 | 12 | ![]() 13 | 14 | `상점 계정 관리` 페이지 우측 상단에 `내 식별코드 , API Keys` 를 누르시면 고객사의 식별 코드 및 api 정보를 확인 및 수정하실 수 있습니다. 15 | 16 | ## 고객사 식별 코드 17 | 18 | ![]() 19 | 20 | 포트원에서 제공하는 모듈을 사용할 때 고객사를 구분하기 위해, 관리자 페이지 가입과 동시에 자동 발급되는 고유한 문자입니다. 21 | 22 | [고객사 식별코드란 무엇인가요?](https://portone.gitbook.io/docs/ready/3.) 23 | 24 | ## Rest API Key , API Secret Key 25 | 26 | [REST API 키 와 secret은 어떻게 사용하나요?](https://portone.gitbook.io/docs/ready/3.) 27 | 28 | `재발급` 버튼을 통해 api secret key 를 다시 발급받으실 수 있습니다. 해당 기능을 사용하시면 기존 secret 이 무효처리 되므로 확인 후 실행해 주세요. 29 | 30 | ## 티어코드 31 | 32 | 하위상점 설정시 티어코드를 임의로 발급해 주신뒤 `imp.init` 대신 `IMP.agency('고객사 식별코드', '티어코드')` 에서 호출해줍니다.\ 33 | \ 34 | [티어코드란 무엇인가요?](https://portone.gitbook.io/docs/tip/agency-and-tier) 35 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/console/guide/home.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 홈 3 | description: >- 4 | 포트원 콘솔 홈화면에서는 결제 현황 대시보드, 공지사항, FAQ, 포트원 새소식, 포트원 서비스 가이드 링크를 제공하고 있으며, 이에 대해 5 | 안내합니다. 6 | --- 7 | 8 | (이미지 첨부: 관리자콘솔-홈 화면 예시) 9 | 10 | ## 대시보드 11 | 12 | 1주/1개월/6개월/사용자 선택 기간에 따른 일간 결제 데이터를 확인할 수 있습니다. 13 | 아직 실 결제가 일어나지 않은 경우 오른쪽 상단에 \[테스트 데이터]를 활성화하여 대시보드 그래프 예시 등을 14 | 확인할 수 있습니다. 15 | 16 | - 거래액 : 결제승인이 발생한 모든 금액이 표시됩니다. 현재 결제 상태가 승인(`PAID`) 17 | 혹은 취소(`CANCELLED`/`PARTIAL_CANCELLED`) 거래건이 모두 집계됩니다. 18 | 19 | - 거래취소액 : 결제 승인 이후 결제 취소된 금액이 표시됩니다. 전액 취소(`CANCELLED`) 및 부분 취소(`PARTIAL_CANCELLED`) 거래건이 모두 집계됩니다. 20 | 21 | - 순거래액 : 거래액에서 거래취소액을 제외한 금액이 표시됩니다. 22 | 23 | ## 공지사항 24 | 25 | 포트원의 최신 공지사항을 확인할 수 있습니다. 우측 상단의 \[더보기]를 클릭하여 더 많은 공지사항을 확인해 보세요. 26 | 27 | ## FAQ 28 | 29 | 포트원의 FAQ를 확인할 수 있습니다. 우측 상단의 \[더보기]를 클릭하여 더 많은 FAQ를 확인해 보세요. 30 | 31 | ## 포트원 새소식 32 | 33 | 포트원의 새로운 소식을 확인할 수 있습니다. 우측 상단의 \[더보기]를 클릭하여 포트원 블로그에서 더 많은 소식을 확인해 보세요. 34 | 35 | ## 포트원 서비스 가이드 36 | 37 | 포트원 서비스에 대한 이용 가이드를 확인할 수 있습니다. 38 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/console/guide/integration.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 연동 관리 3 | description: >- 4 | 포트원 결제 모듈을 사용하기 위한 연동 설정을 관리할 수 있습니다. 결제대행사 채널 관리, 식별코드 및 API Keys, 결제알림(웹훅) 5 | 관리, 추가 설정 관리 방법에 대해 안내합니다. 6 | targetVersions: 7 | - v1 8 | - v2 9 | --- 10 | 11 | 포트원 연동 시 필요한 사항들을 설정 및 관리할 수 있습니다. 12 | 13 | 연동 정보 탭에서는 채널관리, 식별코드·API Keys, 결제알림(Webhook)관리, 추가 설정 관리 등을 설정할 수 있고, 14 | 스마트 라우팅 탭에서는 스마트 라우팅 그룹을 설정할 수 있습니다. 15 | 16 | [연동 정보](https://developers.portone.io/opi/ko/console/guide/channel-manage) 17 | 18 | [스마트 라우팅](https://developers.portone.io/opi/ko/console/guide/smartrouting) 19 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/console/guide/pay.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 결제 3 | description: 포트원을 관리자콘솔을 통해 발생한 거래를 조회 및 관리하는 방법을 안내합니다. 4 | --- 5 | 6 | 포트원을 통해 발생한 결제 거래 건을 조회하고 부분 취소 및 전체 취소 기능을 이용하여 결제 건을 관리할 수 있습니다. 7 | 엑셀 다운로드 기능을 제공하여 화면에서 필터링된 결제 내역을 다운로드 받아 활용할 수 있습니다. 8 | 9 | 또한 발급한 빌링키를 이용한 결제 거래 건을 별도 내역으로 확인할 수 있으며, 빌링 결제 예약건을 상태별로 10 | 관리할 수 있고, 빌링 결제 캘린더에서 일간/월간 결제 데이터를 확인할 수 있습니다. 11 | 12 | [결제 내역 조회](https://developers.portone.io/opi/ko/console/guide/payments) 13 | 14 | [빌링결제 내역 조회](https://developers.portone.io/opi/ko/console/guide/billing-payments) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/console/guide/readme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 관리자 콘솔 소개 3 | description: 포트원 관리자 콘솔 사용법을 안내합니다. 4 | --- 5 | 6 | 포트원 관리자콘솔은 포트원 계정 생성 및 하위상점 관리, 전자결제 신청, 결제대행사 연동 설정을 통합하여 관리할 수 있는 페이지입니다. 7 | 8 | 또한, 결제 내역 조회 및 결제 취소를 할 수 있으며, 예약된 결제 내역 및 예약 변경, 해지 기능을 제공하며 통합된 결제대행산 정산 내역을 확인할 수 있습니다. 9 | 10 | 별도로 포트원에서 제공하는 파트너 정산 자동화 및 결제 데이터 분석도 이용하실 수 있습니다. 11 | 12 | [포트원 관리자콘솔 바로가기](https://admin.portone.io) 13 | 14 | [전자결제 신청](https://developers.portone.io/opi/ko/console/guide/reg) 15 | 16 | [홈](https://developers.portone.io/opi/ko/console/guide/home) 17 | 18 | [결제](https://developers.portone.io/opi/ko/console/guide/pay) 19 | 20 | [연동 관리](https://developers.portone.io/opi/ko/console/guide/integration) 21 | 22 | [상점 계정 관리](https://developers.portone.io/opi/ko/console/guide/account) 23 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/identity-verification/v1/all/0.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 통합인증 준비하기 3 | description: 통합인증 연동을 시작하기 위한 준비작업을 소개합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | ## 1. 포트원 SDK 설치하기 9 | 10 | 포트원은 다양한 PG의 본인인증창을 통일된 방법으로 호출할 수 있도록 자바스크립트 SDK를 제공합니다. 11 | 브라우저에서 포트원 SDK를 호출하여 본인인증을 진행하게 됩니다. 12 | 13 | 14 | 15 | 결제창 연동을 진행할 주문 페이지에 아래 JS 라이브러리를 추가합니다. 16 | 17 | ```html 18 | 19 | ``` 20 | 21 | [포트원 라이브러리 추가하기](https://www.youtube.com/watch?v=FLyOmbtnr48) 22 | 23 | 24 | 25 | ## 2. SDK 초기화하기 26 | 27 | 포트원 SDK를 사용하여 결제창을 호출하려면, 먼저 포트원 SDK를 초기화하여야 합니다. 28 | 29 | 먼저, 관리자 콘솔의 결제 연동 페이지에서 **고객사 식별코드**를 확인해 주세요. 30 | 31 | 그리고 결제창을 호출할 페이지에서 다음과 같이 포트원 SDK를 초기화합니다. 32 | 33 | ```ts title="client-side" 34 | IMP.init("{고객사 식별코드}"); // 예: imp00000000 35 | ``` 36 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/identity-verification/v1/all/1.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 통합인증 요청하기 3 | description: 통합인증 페이지를 호출하는 방법을 확인합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | 통합인증은 아래 두 가지 방법으로 호출할 수 있습니다. 9 | 10 | > **팝업**(**Default**) 방식 11 | > 12 | > 통합인증 본인인증 팝업창이 열리고 본인인증를 완료하면 두 번째 인자로 지정된 `callback` 함수가 실행됩니다. 13 | 14 | > **리디렉션**(redirect)방식(**Mobile** 환경에서만 적용) 15 | > 16 | > 모바일 환경에서 `param.popup`을 **`false`**`(기본값)`로 설정하면 본인인증 페이지로 리디렉션되고 본인인증을 완료하면 `param.m_redirect_url`로 다시 리디렉션됩니다. 17 | > 18 | > `param.popup`을 **`true`** 로 설정하면 팝업(기본) 방식으로 작동합니다. 19 | > 20 | > **WebView 등 팝업이 차단되는 환경**에서는 `popup : false`로 설정하는 것을 권장합니다 21 | 22 | 아래는 JavaScript SDK [**IMP.certification**](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/cft) 함수를 이용하여 통합인증 23 | 본인인증창을 호출하는 예제입니다. 24 | 25 | ```ts title="client-side" 26 | // IMP.certification(param, callback) 호출 27 | IMP.certification( 28 | { 29 | // param 30 | channelKey: "{콘솔 내 연동 정보의 채널키}", 31 | merchant_uid: "ORD20180131-0000011", // 주문 번호 32 | m_redirect_url: "{리디렉션 될 URL}", // 모바일환경에서 popup:false(기본값) 인 경우 필수, 예: https://www.myservice.com/payments/complete/mobile 33 | popup: false, // PC환경에서는 popup 파라미터가 무시되고 항상 true 로 적용됨 34 | }, 35 | function (rsp) { 36 | // callback 37 | if (rsp.success) { 38 | // 인증 성공 시 로직 39 | } else { 40 | // 인증 실패 시 로직 41 | } 42 | }, 43 | ); 44 | ``` 45 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/identity-verification/v1/all/readme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 통합인증 연동하기 3 | description: 통합인증 기능을 구현하는 방법을 설명합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | ## 통합인증 서비스란 ? 9 | 10 | 카카오톡 인증서, 네이버 인증서 등의 민간 인증서를 통한 인증 절차를 거쳐 본인 여부와 입력한 정보의 11 | 정확성을 확인하여 주는 서비스입니다. 통합인증은 **KG이니시스**를 통해 제공되며 민간 인증서를 12 | 이용하거나 사용자 본인이 가입된 간편인증을 통해 인증요청을 보내고 간편인증 페이지에서 인증처리를 13 | 하는 방식으로 이루어 집니다. 14 | 15 | > **이용가능 수단 : 네이버 / PASS / 페이코 / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스** 16 | 17 | [이미지 링크]() 18 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/identity-verification/v1/credit-auth/1.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 1. 본인인증 준비하기 3 | description: 신용카드 본인인증을 시작하기 위한 안내입니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | ## 1. 포트원 SDK 설치하기 9 | 10 | 포트원은 다양한 PG의 본인인증창을 통일된 방법으로 호출할 수 있도록 자바스크립트 SDK를 제공합니다. 11 | 브라우저에서 포트원 SDK를 호출하여 본인인증을 진행하게 됩니다. 12 | 13 | 14 | 15 | 결제창 연동을 진행할 주문 페이지에 아래 JS 라이브러리를 추가합니다. 16 | 17 | ```html 18 | 19 | ``` 20 | 21 | [포트원 라이브러리 추가하기](https://www.youtube.com/watch?v=FLyOmbtnr48) 22 | 23 | 24 | 25 | ## 2. SDK 초기화하기 26 | 27 | 포트원 SDK를 사용하여 결제창을 호출하려면, 먼저 포트원 SDK를 초기화하여야 합니다. 28 | 29 | 먼저, 관리자 콘솔의 결제 연동 페이지에서 **고객사 식별코드**를 확인해 주세요. 30 | 31 | 그리고 결제창을 호출할 페이지에서 다음과 같이 포트원 SDK를 초기화합니다. 32 | 33 | ```ts title="client-side" 34 | IMP.init("{고객사 식별코드}"); // 예: imp00000000 35 | ``` 36 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/identity-verification/v1/credit-auth/readme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 신용카드 본인인증 연동 3 | description: 신용카드 본인인증 기능을 구현하는 방법을 설명합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 |
9 | 10 | 신용카드본인인증 서비스는 현재 서비스 중단으로 신규계약이 불가합니다.\ 11 | (기존에 이용중인 고객사는 지속 사용 가능) 12 | 13 |
14 | 15 | **신용카드 본인인증 서비스란** 신용카드 인증을 통하여 해당 신용카드 소지자의 개인정보(이름, 생년월일, 성별, 외국인여부, KISA 고유식별값)를 확인할 수 있는 서비스입니다. 16 | 17 | (이미지 첨부: 신용카드 본인인증 화면 예시) 18 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/identity-verification/v1/phone/1.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 1. 본인인증 준비하기 3 | description: 휴대폰 본인인증 연동을 위한 준비 4 | targetVersions: 5 | - v1 6 | versionVariants: 7 | v2: /opi/ko/extra/identity-verification/readme-v2 8 | --- 9 | 10 | ## 1. 포트원 SDK 설치하기 11 | 12 | 포트원은 다양한 PG의 본인인증창을 통일된 방법으로 호출할 수 있도록 자바스크립트 SDK를 제공합니다. 13 | 브라우저에서 포트원 SDK를 호출하여 본인인증을 진행하게 됩니다. 14 | 15 | 16 | 17 | 결제창 연동을 진행할 주문 페이지에 아래 JS 라이브러리를 추가합니다. 18 | 19 | ```html 20 | 21 | ``` 22 | 23 | [포트원 라이브러리 추가하기](https://www.youtube.com/watch?v=FLyOmbtnr48) 24 | 25 | 26 | 27 | ## 2. SDK 초기화하기 28 | 29 | 포트원 SDK를 사용하여 결제창을 호출하려면, 먼저 포트원 SDK를 초기화하여야 합니다. 30 | 31 | 먼저, 관리자 콘솔의 결제 연동 페이지에서 **고객사 식별코드**를 확인해 주세요. 32 | 33 | 그리고 결제창을 호출할 페이지에서 다음과 같이 포트원 SDK를 초기화합니다. 34 | 35 | ```ts title="client-side" 36 | IMP.init("{고객사 식별코드}"); // 예: imp00000000 37 | ``` 38 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/identity-verification/v1/phone/readme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 휴대폰 본인인증 연동하기 3 | description: 포트원을 이용하여 간편하게 휴대폰 본인인증을 연동하는 방법을 확인합니다. 4 | targetVersions: 5 | - v1 6 | versionVariants: 7 | v2: /opi/ko/extra/identity-verification/readme-v2 8 | --- 9 | 10 | **휴대폰 본인인증 서비스**란 본인 명의로 개통한 휴대폰을 이용하여 최소한의 개인정보를 입력하는 인증 절차를 거쳐 본인 여부와 입력한 정보의 정확성을 확인하여 주는 서비스입니다. 11 | 12 | 고객은 웹사이트에 가입, 결제, 또는 성인 인증 등을 위해 본인인증을 시행합니다. 13 | 본인인증은 모바일 기기에 설치된 본인인증 전용 앱을 이용하거나 사용자 본인 정보(**이름, 생년월일, 휴대폰번호**)를 인증요청 페이지에 입력한 후 14 | 문자로 온 인증번호를 기입하는 방식으로 이루어집니다. 15 | 16 | (이미지 첨부: 휴대폰 본인인증 화면예) 17 | 18 | 포트원을 이용한 휴대폰 본인인증의 Flow는 JavaScript SDK 를 이용하여 휴대폰 본인인증을 완료하고 19 | 고객사 서버에서 포트원 REST API를 이용하여 **인증완료정보를 획득**하는 방법으로 진행됩니다. 20 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/identity-verification/v1/readme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 본인인증 연동하기 3 | description: 포트원을 이용하여 간편하게 본인인증을 연동하는 방법을 확인합니다. 4 | targetVersions: 5 | - v1 6 | versionVariants: 7 | v2: /opi/ko/extra/identity-verification/readme-v2 8 | --- 9 | 10 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/plugins/readme-v1.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 플러그인을 통해 포트원 이용하기 3 | description: 여러 플랫폼의 플러그인을 통해 포트원을 이용하는 방법을 안내합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/plugins/shopify/shopify/shopify-1.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: PortOne(KR) 가입 및 PG 계약 3 | description: Shopify 연동을 위해 선행해야할 내용을 설명합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | 1. 먼저 포트원(KR) 계정을 생성하고, 원하는 PG사에 대해 가입을 신청합니다. 9 | 10 | (관련 이미지 첨부) 11 | 12 | 2. 가입 신청 후 계약이 진행되는 과정에서 PG사의 Credential을 메일이나 PG사 어드민을 통해 획득하게 됩니다. 13 | 14 | 3. PG사로부터 Credential을 획득한 뒤 콘솔에 접속하여 연동을 원하는 PG사를 추가합니다. 15 | 16 | (관련 이미지 첨부) 17 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/plugins/shopify/shopify/shopify-2.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: PortOne(Global) 가입 및 결제수단 설정 3 | description: Shopify 연동을 위해 선행해야할 내용을 설명합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | ## 1. PortOne 글로벌 가입하기 9 | 10 | PortOne 글로벌 어드민에 접속하여 가입합니다. 11 | 12 | (이미지 첨부: 포트원 글로벌 사이트 어드민 Register 화면) 13 | 14 | (이미지 첨부: 포트원 글로벌 가입 후 최초 로그인 화면) 15 | 16 | ## 2. 어드민 설정하기 17 | 18 | 포트원 글로벌 어드민에서 PortOne을 선택하고 PortOne(KR)의 Key값들을 추가합니다. 19 | 20 | (이미지 첨부: 포트원 글로벌 어드민 > Payment Channels > Filters: South Korea) 21 | 22 | (이미지 첨부: 포트원(KR) 콘솔 > 결제연동 > 내 식별코드/API Keys 를 통해 key값들을 확인할 수 있습니다.) 23 | 24 | (이미지 첨부: 포트원(Global) 콘솔로 돌아와서 포트원(KR) 의 Key값을 입력하고 Fetch MIDs를 클릭하면 등록된 PG사들의 MID값들을 불러옵니다.) 25 | 26 | (이미지 첨부: 포트원(Global) 콘솔로 돌아와서 포트원(KR) 의 Key 값을 입력하고 Fetch MIDs를 클릭하면 등록된 PG사들의 MID값들을 불러옵니다.) 27 | 28 | (이미지 첨부: 결제가 발생할 지역별로 Wallet(간편결제) Credit/Debit Cards(신용/체크카드) 등 결제수단 별 디폴트 PG사를 설정합니다.) 29 | 30 | (이미지 첨부: 특정 결제수단들을 활성화(Enable) 시키거나, 동일한 결제수단을 다른 PG를 통해 설정하는 경우 디폴트로 설정(Make Default)할 수 있습니다.) 31 | 32 | (관련 이미지 첨부) 33 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/plugins/shopify/shopify/shopify-3.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: PortOne(Global) 에 Shopify 스토어 등록 3 | description: Shopify 스토어 등록방법을 설명합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | ## 1. Shopify 채널 추가 9 | 10 | PortOne(Global) 어드민 > Payment Channel 메뉴에서 Shopify 를 선택하여 Shopify 스토어의 URL을 추가합니다. 11 | 12 | (이미지 첨부: Payment Channels >Filters: Global > Shopify 선택합니다.) 13 | 14 | (이미지 첨부: Shopify > Add keys 클릭하여 Shopify 스토어 URL 을 등록해야 합니다.) 15 | 16 | (이미지 첨부: Shopify 대쉬보드에 접속하면 스토어 URL 을 복사할 수 있습니다.) 17 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/plugins/shopify/shopify/shopify-4.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Shopify 스토어에 PortOne 연결하기 3 | description: Shopify 스토어에 PortOne 연결방법을 설명합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | ## 1. Shopify 앱 추가 9 | 10 | 먼저 Shopify 앱스토어에서 [PortOne Payments](https://apps.shopify.com/chaiport-payments) 링크를 통해 앱을 추가합니다. 11 | (또는 지급(Payments) > 결제방법 추가 > 공급업체로 검색에서 \[PortOne Payments]를 검색하여 설치하실 수 있습니다.) 12 | 13 | (이미지 첨부: \`앱 추가\` 버튼을 클릭합니다.) 14 | 15 | (이미지 첨부: 우측 상단에 \`Install app\`을 클릭하여 플러그인을 설치합니다.) 16 | 17 | ## 2. 결제수단 선택 18 | 19 | Shopify 스토어의 `Settings > Payments` 페이지에서 PortOne Payments 앱이 제공하는 결제수단을 선택해 줍니다. 20 | 이 부분은 엔드유저에게 스토어에서 제공하는 결제수단에 대한 마크를 노출시킵니다. 실제로 제공되는 결제수단과는 무관합니다. 21 | 22 | (이미지 첨부: Visa, Mastercard 등의 결제수단 마크를 추가할 수 있습니다.) 23 | 24 | ## 3. Portone Payments 선택 25 | 26 | Shopify 스토어의 `PortOne Payments` 설정페이지에서 Key 값을 추가하고, `Verify Now` 합니다. 27 | 28 | `Shopify > Settings > Payments` 페이지 상단에 `Manage` 버튼을 클릭하여 PortOne Payments 세팅 페이지에 접속합니다. 29 | PortOne Key 값을 입력하게 되어있습니다. 30 | 31 | (이미지 첨부: \`Payment Channels >Filters: Global > Shopify\` 선택합니다.) 32 | 33 | (이미지 첨부: \`PortOne(Global) 어드민 > Management > General\` 화면에서 Key 값을 확인하고 복사합니다.) 34 | 35 | (이미지 첨부: Key 값을 입력한 후 \`Verify Now\` 버튼을 클릭하여 연동상태를 확인합니다. 이제 모든 연동이 완료되었습니다!) 36 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/plugins/shopify/shopify/shopify-5.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 엔드유저의 Shopify 결제 경험 3 | description: 실 고객의 Shopify 결제 화면을 설명합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | ## 구매 플로우 9 | 10 | 1. 엔드유저는 고객사의 Shopify 스토어에서 상품을 장바구니에 추가하여 최종 구매페이지에 도달하게 됩니다. 11 | 12 | (관련 이미지 첨부) 13 | 14 | (관련 이미지 첨부) 15 | 16 | (관련 이미지 첨부) 17 | 18 | (관련 이미지 첨부) 19 | 20 | 2. 최종 체크아웃 페이지에 도달하면 결제가 PortOne Payment 로 진행된다는 안내문구를 확인할 수 있습니다. 21 | 22 | (관련 이미지 첨부) 23 | 24 | 3. Pay now 를 클릭하면 유저는 PortOne 의 체크아웃 창으로 이동하게 되고 25 | Shopify 스토어에 설정된 Currency 와 PortOne(Global) 어드민에서 설정된 조건에 따라 결제수단이 노출되고 최종결제가 이루어집니다. 26 | 27 | (관련 이미지 첨부) 28 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/plugins/wordpress/readme-v1.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 워드프레스 플러그인 3 | description: 워드프레스 플러그인을 통해 포트원을 사용하는 방법을 안내합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | 우커머스 플러그인을 통해 워드프레스에서 포트원을 사용할 수 있습니다. 9 | 10 | [우커머스 플러그인](https://developers.portone.io/opi/ko/extra/plugins/wordpress/woocommerce/readme) 11 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/plugins/wordpress/woocommerce/payment.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 일반결제 연동하기 3 | description: 우커머스 플러그인을 통해 일반결제를 연동합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | 이 문서는 우커머스 플러그인을 사용하여 일반결제 기능을 연동하는 방법을 설명합니다. 9 | 10 | ## STEP1: 포트원SDK 버전 설정하기 11 | 12 | 워드프레스 관리자 페이지의 우커머스 > 설정 > 포트원 페이지로 이동합니다. 인증결제를 위해 SDK버젼 설정이 필요합니다. 13 | 14 | (관련 이미지 첨부) 15 | 16 | ## STEP2: 결제 수단 활성화하기 17 | 18 | 워드프레스 관리자 페이지의 우커머스 > 설정 > 결제 페이지로 이동합니다. 사용하고자 하는 포트원 결제 수단을 활성화하고 관리 버튼을 통해 설정 페이지로 이동합니다. 19 | 20 | (관련 이미지 첨부) 21 | 22 | ## STEP3: 고객사 정보 입력하기 23 | 24 | 포트원 관리자 콘솔 > 결제연동 > 내 식별정보에서 확인한 고객사 정보를 입력합니다. 변경 사항 저장 버튼을 눌러 설정 내용을 저장합니다. 25 | 26 | (관련 이미지 첨부) 27 | 28 | ## STEP4: PG사 및 상점아이디 설정하기 29 | 30 | 연동하실 PG사와 PG사의 상점아이디를 입력해주세요. 31 | 32 | (관련 이미지 첨부) 33 | 34 | ## STEP5: 결제 수단별 설정하기 35 | 36 | 결제 수단별 옵션들을 다음과 같이 설정할 수 있습니다. 37 | 38 | ### 신용카드, 카카오페이, PAYCO, Eximbay, Paymentwall 39 | 40 | - 추가 옵션이 없습니다. 41 | 42 | ### 휴대폰 소액결제 43 | 44 | - 디지털 상품: 실물이 아닌 디지털 상품은 활성화해야 합니다. 45 | 46 | ### 실시간 계좌이체 47 | 48 | - 실시간 계좌이체 에스크로: 활성화하여 우커머스의 실시간 계좌이체 결제 수단을 에스크로 방식으로 변경할 수 있습니다. 49 | 50 | ### 가상계좌 51 | 52 | - 가상계좌 에스크로: 활성화하여 우커머스의 가상계좌 결제 수단을 에스크로 방식으로 변경할 수 있습니다. 53 | - 가상계좌 입금통지 설정: 가상계좌 입금통지를 받기 위해 반드시 설정해야 합니다. (필수) 54 | - 사업자등록번호: 다날 - 신용카드/계좌이체/가상계좌를 PG사로 사용할때 반드시 입력해야 합니다. 55 | 56 |
57 | 58 | 가상계좌 입금통지 설정 59 | 60 | 가상계좌를 사용하는 경우에는 가상계좌 입금통지 설정을 반드시 설정해야 합니다. 61 | 62 |
63 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/plugins/wordpress/woocommerce/readme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 우커머스 플러그인 3 | description: 포트원 우커머스 플러그인 사용방법을 안내합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | 이 문서는 포트원 우커머스용 결제플러그인을 사용하여 쉽고 빠르게 결제를 연동하는 방법을 설명합니다. 9 | 10 | ## 플러그인 설치 및 활성화하기 11 | 12 | 포트원 우커머스용 플러그인을 워드프레스 사이트에 설치합니다. 해당 플러그인을 사용하기 위해서 13 | [우커머스 플러그인](https://ko.wordpress.org/plugins/woocommerce/)이 설치되어 있어야 합니다. 14 | 15 | 먼저 워드프레스 관리자 페이지에서 **플러그인** 메뉴를 클릭합니다. 페이지의 상단 플러그인 검색창에 포트원을 검색하여 결과 목록에 있는 **포트원 16 | 우커머스 결제**를 선택합니다. 17 | 18 | (관련 이미지 첨부) 19 | 20 | 플러그인을 설치하고 플러그인을 활성화 합니다. 21 | 22 | (관련 이미지 첨부) 23 | 24 | ## 결제 연동하기 25 | 26 | 일반결제 또는 정기결제 기능을 워드프레스 우커머스 플러그인을 사용하여 연동할 수 있습니다. 27 | 28 | [일반결제 연동하기](https://developers.portone.io/opi/ko/extra/plugins/wordpress/woocommerce/payment) 29 | 30 | [정기결제 연동하기](https://developers.portone.io/opi/ko/extra/plugins/wordpress/woocommerce/subscription) 31 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/extra/promotion/intro.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 프로모션 3 | description: 카드 즉시 할인을 쉽게 운영 및 관리할 수 있는 서비스입니다. 4 | targetVersions: 5 | - v1 6 | - v2 7 | --- 8 | 9 | ## 프로모션이란? 10 | 11 | 고객사가 카드사와 계약하여 사용자에게 즉시 할인을 제공하는 **카드 즉시 할인 서비스**를 운영하고 관리할 12 | 수 있는 서비스 입니다. 13 | 14 | 카드 즉시 할인 서비스를 이용시 필요한 **프로모션 관리 시스템**과 **프로모션 정산 대사 시스템** 을 제공합니다. 15 | 포트원 콘솔에서 기간, 할인 조건, 예산 등 다양한 옵션의 프로모션을 설정할 수 있으며, 16 | 생성된 프로모션 아이디를 포함하여 결제 요청시 즉시 할인을 적용할 수 있습니다. 17 | 또한, 프로모션이 종료된 후 할인이 적용된 거래 건들만 모아 엑셀로 다운로드하여 한 번에 결제 내역 정리 및 정산 금액 대사를 할 수 있습니다. 18 | 19 | 프로모션은 일부 고객사에 한하여 제공하고 있으며, 프로모션 도입을 원하시는 고객사의 경우 포트원으로 문의 주시기 바랍니다. 20 | 21 |
22 | 23 | 프로모션 메뉴의 경우 도입 고객사에 한하여 포트원 콘솔 내에서 확인하실 수 있습니다. 24 | 25 |
26 | 27 | [프로모션 생성하기](https://developers.portone.io/opi/ko/extra/promotion/console-guide) 28 | 29 | [프로모션 결제 연동하기](https://developers.portone.io/opi/ko/extra/promotion/integration) 30 | 31 | [프로모션 결제 취소하기](https://developers.portone.io/opi/ko/extra/promotion/refund) 32 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/integration/start/v1/readme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 결제 연동 시작하기 3 | description: 결제 연동을 시작합니다. 4 | targetVersions: 5 | - v1 6 | versionVariants: 7 | v2: /opi/ko/integration/start/v2/readme 8 | --- 9 | 10 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/integration/start/v2/billing/payment.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 2. 결제 요청하기 3 | description: 포트원 빌링키 결제 API를 사용해 바로 결제를 요청합니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /opi/ko/integration/start/v1/non-auth 8 | --- 9 | 10 | 포트원의 빌링키 결제 API를 호출하여 결제를 진행합니다. 11 | 12 | 바로 결제를 진행하고 싶은 것이 아니라 미래 특정 시점에 결제가 일어나게 하고 싶다면 [결제 예약하기](https://developers.portone.io/opi/ko/integration/start/v2/billing/schedule)을 참고하세요. 13 | 14 | ```ts title="server-side" 15 | // 고객사에서 채번하는 새로운 결제 ID를 만들어주세요. 16 | const paymentId = OrderService.getNewPaymentId(); 17 | 18 | // 포트원 빌링키 결제 API 호출 19 | const paymentResponse = await fetch( 20 | `https://api.portone.io/payments/${encodeURIComponent(paymentId)}/billing-key`, 21 | { 22 | method: "POST", 23 | headers: { 24 | Authorization: `PortOne ${PORTONE_API_SECRET}`, 25 | "Content-Type": "application/json", 26 | }, 27 | body: JSON.stringify({ 28 | billingKey, 29 | orderName: "월간 이용권 정기결제", 30 | // 빌링키 결제 API를 참고해 고객 정보를 채워주세요. 31 | customer: YOUR_CUSTOMER_INFO, 32 | amount: { 33 | total: 8900, 34 | }, 35 | currency: "KRW", 36 | }), 37 | }, 38 | ); 39 | if (!paymentResponse.ok) 40 | throw new Error(`paymentResponse: ${await paymentResponse.json()}`); 41 | ``` 42 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/integration/start/v2/billing/readme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 빌링키 결제 연동하기 3 | description: 카드 혹은 휴대 전화 정보를 이용하여 빌링키를 발급하고, 빌링키를 이용해 결제를 요청하는 방법을 안내합니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /opi/ko/integration/start/v1/non-auth 8 | --- 9 | 10 | ## 빌링키란? 11 | 12 | 구독형 정기결제, 종량제 과금결제 등 고객사가 원하는 시점에 결제를 일으키기 위한 결제용 비밀 키입니다. 13 | 14 | 고객사가 고객의 카드정보를 저장할 수 없기 때문에, 해당 카드에 대응하는 빌링키를 발급 받아 저장하고, 결제 시점에는 결제 정보 대신 빌링키를 이용하여 요청하는 방식을 씁니다. 15 | 16 | 가지고 있는 빌링키를 사용해 즉시 결제를 요청하거나, 시간을 정해 결제를 예약할 수 있습니다. 17 | 18 |
19 | 20 | ### 빌링키는 정기 구독에만 사용이 가능합니다. 21 | 22 | 빌링키를 이용한 결제는 결제수단이 본인 소유인지 확인이 어려워 관리가 어렵고, 카드사 심사 시 빌링키를 사용한 비정기적인 결제를 허용하지 않을 수 있습니다. 23 | 24 |
25 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/integration/start/v2/keyin.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 수기(키인) 결제 연동하기 3 | description: 구매자 인증 없이 결제 수단 정보만으로 결제를 요청합니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /opi/ko/integration/start/v1/non-auth 8 | --- 9 | 10 |
11 | 12 | 수기 결제를 이용하기 위해서는 PG사와 별도 협의가 필요합니다. 13 | 14 |
15 | 16 | 수기(키인) 결제 API를 이용해 1회성 결제 요청이 가능합니다. 17 | 18 | ## 수기 결제의 장단점 19 | 20 | 아래의 예제처럼 고객사가 직접 만든 UI로 결제 정보를 입력받을 수 있습니다. 21 | 22 | 그러나 간편 결제와 다르게 고객이 매번 정보를 기입해야 한다는 번거로움이 있습니다. 23 | 24 | ## 수기 결제 예제 25 | 26 | 고객사 서버에서 아래와 같이 포트원 API를 호출합니다. 27 | 28 | ```ts title="server-side" 29 | // 포트원 수기(키인)결제 API 호출 30 | const paymentResponse = await fetch( 31 | `https://api.portone.io/payments/${encodeURIComponent(UNIQUE_PAYMENT_ID)}/instant`, 32 | { 33 | method: "POST", 34 | headers: { 35 | Authorization: `PortOne ${PORTONE_API_SECRET}`, 36 | "Content-Type": "application/json", 37 | }, 38 | body: JSON.stringify({ 39 | channelKey: CHANNEL_KEY_HERE, 40 | orderName: "월간 이용권 정기결제", 41 | // 수기 결제 API를 참고해 고객 정보를 채워주세요. 42 | customer: YOUR_CUSTOMER_INFO, 43 | amount: { 44 | total: 8900, 45 | }, 46 | currency: "KRW", 47 | // 수기(키인)결제 API를 참고해 카드 / 가상계좌 정보를 채워주세요. 48 | method: PAYMENT_METHOD_HERE, 49 | }), 50 | }, 51 | ); 52 | if (!paymentResponse.ok) 53 | throw new Error(`paymentResponse: ${await paymentResponse.json()}`); 54 | ``` 55 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/support/agency-and-tier.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 대표상점과 하위상점 3 | description: 대표상점과 하위상점 설정에 대한 안내 입니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | **하나의 계정으로 하위 상점별 결제대행사 이용을 원하시는 경우 포트원에서 제공하는 하위상점 기능을 사용하시면 됩니다.** 9 | 10 | 회원가입 시 대표상점이 자동으로 생성되며, 추가로 하위상점을 추가하여 하위 상점별 결제대행사 채널 등록 및 결제내역 조회(취소)가 가능합니다. 11 | 하위 상점 생성 시 `Tier Code`(영문, 숫자를 조합한 3자리 고유 코드를 지정) 이용하여 결제를 진행해야 합니다. 12 | 13 | 하위상점 생성은 포트원 콘솔 내 [하위 상점 관리](https://admin.portone.io/merchant/?tab=store)에서 생성할 수 있습니다. 14 | 15 | ## 주요 기능 16 | 17 | **1. 하위몰별 결제대행사 채널 설정** 18 | 19 | - 하위 상점을 추가 혹은 삭제하고, 하위 상점의 PG사 MID 설정 및 관리를 하실 수 있습니다. 20 | - 하위 상점은 대표 상점에 추가된 채널에 한해서만 선택하여 추가할 수 있습니다. 21 | 22 | (이미지 첨부: 하위 상점 생성 예시 화면 1) 23 | 24 | (이미지 첨부: 하위 상점 생성 예시 화면 2) 25 | 26 | **2. 결제 요청** 27 | 28 |
29 | 30 | 포트원 V1 결제 모듈의 경우 아래 방법으로 결제를 요청해야 합니다. 31 | 포트원 V2 결제 모듈의 경우 하위 상점 생성 시 채번되는 store id를 이용하여 대표상점과 동일하게 결제 요청/조회/취소를 진행할 수 있습니다. 32 | 33 |
34 | 35 | - 하위 상점 결제요청시 **JavaScript SDK** 에서 다음과 같이 **Tier를 구분하여 호출**하실 수 있습니다. 36 | 37 | **IMP.agency(고객사 식별코드, Tier(고유)코드 3자리)** 38 | 39 | `ex) IMP.agency('imp12345678', '001')` 40 | 41 |
42 | 43 | **REST API호출시 주의 사항** 44 | 45 | REST API호출시에는 Header에 Tier정보를 같이 보내야 해당 Tier에 대한 접근이 가능 46 | 47 | HTTP Header 에 아래와 같은 파라미터 설정 필요 48 | 49 | `"Tier" : "티어코드 3자리"` 50 | 51 |
52 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/support/code-info/card-code.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 카드사 코드 3 | description: PortOne 에서 처리하는 카드사별 코드목록 입니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | | 카드사명 | code| 9 | |:--------:|:---:| 10 | | BC |`361`| 11 | | KB |`381`| 12 | | 현대 |`367`| 13 | | 삼성 |`365`| 14 | | 롯데 |`368`| 15 | | NH |`371`| 16 | | 우리 |`041`| 17 | | 하나SK |`374`| 18 | | 새마을 |`045`| 19 | | 제주 |`373`| 20 | | 광주 |`364`| 21 | | 신한 |`366`| 22 | | KDB |`002`| 23 | | 수협 |`369`| 24 | | 신협 |`048`| 25 | | 씨티 |`370`| 26 | | 우체국 |`071`| 27 | | K뱅크 |`089`| 28 | | 전북 |`372`| 29 | |카카오뱅크|`090`| 30 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/support/code-info/code.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 택배사 코드 3 | description: 에스크로 배송등록에 필요한 택배사 코드표를 확인합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | **이용하시는 PG사 상관없이 동일한 코드표가 적용됩니다.** 9 | 10 | |택배사 코드|택배사 이름 | 11 | |-----------|-------------------------------------------------------------------| 12 | |`HYUNDAI` |롯데택배 | 13 | |`HANARO` |하나로택배 | 14 | |`SAGAWA` |SC로지스 | 15 | |`KGB` |로젠택배 | 16 | |`YELLOWCAP`|옐로우캡 | 17 | |`DONGBU` |동부택배 | 18 | |`EPOST` |우체국택배 | 19 | |`CJGLS` |CJ대한통운 | 20 | |`HANJIN` |한진택배 | 21 | |`DAESIN` |대신택배 | 22 | |`ETC` |기타(위 코드표에 해당되지 않는 값이 전달되면 ETC로 자동 처리됩니다)| 23 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/support/code-info/pg-3.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: PG사 오류코드 3 | description: 각 PG사별 오류코드집을 내려받을 수 있습니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | ## NHN KCP 9 | 10 | (파일: NHN KCP 오류코드 다운로드) 11 | 12 | ## KG이니시스 13 | 14 | (파일: KG이니시스 오류코드 다운로드) 15 | 16 | ## 카카오페이 17 | 18 | (파일: 카카오페이 오류코드 다운로드) 19 | 20 | ## 토스페이먼츠 21 | 22 | (파일: 토스페이먼츠 오류코드 다운로드) 23 | 24 | ## KG모빌리언스 25 | 26 | (파일: KG모빌리언스 휴대폰 결제 오류코드 다운로드) 27 | 28 | (파일: KG모빌리언스 휴대폰 결제 취소 오류코드 다운로드) 29 | 30 | ## 다날 31 | 32 | (파일: 다날 오류코드 다운로드) 33 | 34 | ## 페이먼트월 35 | 36 | [페이먼트월 오류코드 바로가기](https://docs.paymentwall.com/integration/direct/brick/error-codes) 37 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/support/code-info/portone-code.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 해외 카드코드 3 | description: 금융결제원 기관코드가 정의되어 있지 않은 해외 카드사 코드를 확인합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | |카드코드|카드명 | 9 | |--------|----------------| 10 | |`10001` |해외은련카드 | 11 | |`10002` |해외다이너스카드| 12 | |`10003` |해외아멕스카드 | 13 | |`10004` |해외마스터카스 | 14 | |`10005` |해외비자카드 | 15 | |`10006` |해외JCB카드 | 16 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/support/code-info/readme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 코드 정보 3 | description: PG사/카드사/택배사/은행별 코드들을 확인할 수 있습니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | [결제대행사별 빌링키 획득 규칙](https://developers.portone.io/opi/ko/support/code-info/pg) 9 | 10 | [PG사별 은행코드](https://developers.portone.io/opi/ko/support/code-info/pg-1) 11 | 12 | [PG사 코드](https://developers.portone.io/opi/ko/support/code-info/pg-2) 13 | 14 | [카드사 코드](https://developers.portone.io/opi/ko/support/code-info/card-code) 15 | 16 | [택배사 코드](https://developers.portone.io/opi/ko/support/code-info/code) 17 | 18 | [PG사 오류코드](https://developers.portone.io/opi/ko/support/code-info/pg-3) 19 | 20 | [해외 카드코드](https://developers.portone.io/opi/ko/support/code-info/portone-code) 21 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/support/contact.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 직접 문의하기 3 | description: 기술지원 문의를 위한 연락처 정보입니다. 4 | targetVersions: 5 | - v1 6 | - v2 7 | --- 8 | 9 | 포트원 결제 연동 및 운영 과정에서 기술적인 어려움을 겪고 있다면, 아래 메일로 문의하세요. 10 | 11 | 12 | 13 | - V1: 14 | - V2: 15 | 16 | 17 | 18 | 19 | 20 | - V2: 21 | - V1: 22 | 23 | 24 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/support/flow.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 포트원 결제 플로우 3 | description: PG사 직연동과 포트원 연동시의 결제 플로우 차이점을 확인할 수 있습니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | ## 1. PG사 직연동시 결제 흐름도 9 | 10 | (이미지 첨부: PG사 직연동 결제 플로우) 11 | 12 | > PG사 모듈을 직접 연동시에는 일반적으로 결제요청은 **2-Transaction** 으로 처리됩니다. 13 | > 14 | > 1. 결제요청을 위한 **인증키 획득** 15 | > 2. **실 결제요청** 16 | 17 | > 백엔드 개발 포인트가 여러군데 존재하며 복잡한 형태의 연동 모듈과 샘플페이지 18 | > 그리고 이해하기 어려운 연동메뉴얼 분석의 **삼중고**를 겪으시게 됩니다. 19 | 20 | ## 2. 포트원 결제 흐름도 21 | 22 | (이미지 첨부: 포트원 결제 플로우) 23 | 24 | > 포트원을 통해 결제연동을 진행하시는 경우 복잡한 PG사 모듈 연동부는 이미 포트원에서 처리 되었기 때문에 도식의 흐름대로 결제처리가 이루어집니다. 25 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/opi/ko/support/redirect.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 리디렉션이란? 3 | description: 리디렉션의 정의를 자세히 확인할수 있습니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | **현재 페이지를 다른 페이지로 이동함을 의미합니다.** 9 | 10 | ![]() 11 | 12 | ## 리디렉션은 왜 필요할까요? 13 | 14 | - 기존의 페이지의 주소가 새롭게 변경되어 이동이 필요한 경우 15 | - 불필요하거나 잘못된 서브 주소를 하나로 이동시키는 경우 16 | - 로그인, 인증 등의 목적으로 다른 주소로 이동이 필요한 경우 17 | 18 | **리디렉션은 아래와 같이 두 가지로 구분이 됩니다.** 19 | 20 | - **리디렉션 301** 21 | 22 | - 서버사이드 및 클라이언트 언어에서 어떤 코드도 수행하지 않고 바로 리디렉션 처리 23 | 24 | - **리디렉션 302** 25 | 26 | - 일시적인 방법으로 Redirect으로 스크립트나 html 태그를 이용한 방법 27 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/platform/ko/guides/process.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 서비스 프로세스 3 | description: '' 4 | --- 5 | 6 | ## ✔️ 파트너 정산 자동화 서비스 프로세스 7 | 8 |
9 | 10 | 📘 **파트너정산은 간단한 API연동과 관리자 콘솔 등록을 통해 파트너정산을 자동화 하는 서비스 입니다.** 11 | 12 |
13 | 14 | 전반적인 프로세스는 다음과 같으며 포트원의 결제 서비스를 이용하고 있다고 가정합니다. 15 | 16 | - 포트원 고객사는 API/콘솔을 통해 **파트너와 포트원 고객사간의 계약을 등록**합니다. 17 | - 중개수수료, 정산 주기, 추가수수료 등 정산정보를 등록합니다. 18 | 19 | - 포트원 고객사는 API/콘솔을 통해 **파트너(하위셀러)를 등록**합니다. 20 | - 파트너 아이디, 파트너 계좌 등 파트너 정보를 등록합니다. 21 | - 파트너에게 기본으로 적용될 계약을 등록합니다. 22 | 23 | - 포트원 고객사가 정산 API를 통해 **결제 아이디와 할인금액, 상품정보와 같은 주문정보, 파트너 아이디를 전달**합니다. 24 | - 포트원 결제 sdk/api 처리 이후 정산 api를 통해 결제 아이디, 할인금액, 주문정보, 파트너 아이디를 전달합니다. 25 | 26 | - 포트원은 정산 API를 통해 **주문정보 기반으로 정산금액을 계산**합니다. 27 | - 파트너 아이디 를 통해 정산대상 파트너를 찾습니다. 28 | - 해당 파트너로 등록된 기본계약 아이디를 통해 중개수수료를 계산하고 정산주기를 통해 해당 정산건의 정산일을 계산합니다. 29 | - 할인금액을 반영하여 결제금액과 합하여 주문금액을 계산합니다. 30 | - 할인아이디를 통해 할인금액의 파트너 분담금을 계산합니다. 31 | - 추가수수료 아이디를 통해 해당 주문건에 적용되어야할 추가 과금을 계산합니다. 32 | 33 | - 포트원은 파트너별로 **누적된 정산금액을 정산일에 맞춰 이체할 금액을 계산**합니다. 34 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/platform/ko/usages/client.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 고객사 예시 3 | description: '' 4 | --- 5 | 6 | ## 사전 조건 7 | 8 | - 가맹점 : 커머스 마켓플레이스 9 | 10 | - 파트너 : 셀러 A, 셀러 B 11 | 12 | - 계약 조건 13 | 14 | |파트너|중개수수료| 정산주기 | 15 | |:----:|:--------:|:----------------------------:| 16 | | A | 10% |D+2, 매월 31일, 전 영업일 기준| 17 | | B | 20% |D+2, 매월 31일, 전 영업일 기준| 18 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2023-04-24.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-04-24T00:00:00.000Z 3 | writtenAt: 2023-04-27T00:00:00.000Z 4 | --- 5 | 6 | ## 수정사항 7 | 8 | ### ✔️ 비인증 결제에서 웹훅 재전송이 작동하지 않던 오류를 수정했습니다 9 | 10 | 비인증 결제건의 웹훅 응답이 500으로 전송되는 경우, 1분 간격으로 최대 5회 웹훅이 재전송 됩니다. 11 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2023-05-08.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-05-08T00:00:00.000Z 3 | writtenAt: 2023-05-11T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ 결제내역 대용량 조회 API를 이용할 수 있습니다 9 | 10 | 결제내역 대용량 조회 API를 통해 5만건 이상의 결제내역을 한 번에 조회할 수 있습니다. 1회 호출 시 11 | 1,000건의 결제내역이 나타나며, 추가 호출을 통해 5만건 이상의 결제내역을 확인할 수 있습니다. 12 | 13 | 본 기능 설정을 위한 자세한 내용은 관련 API 문서를 확인 바랍니다. [→ 결제내역 다건조회 API](https://developers.portone.io/api/rest-v2/payment?v=v2#get%20%2Fpayments-by-cursor) 14 | 15 | ## 기타 수정사항 16 | 17 | ### ✔️ 네이버페이 구매확정 API 에서 요청인을 설정할 수 있습니다 18 | 19 | 기존 네이버페이 구매확정 시 admin(store)이 기본값으로 구현되어 있었으나, `/requester` 파라미터를 20 | 추가하여 customer 로 구매확정할 수 있습니다. 21 | 22 | 본 기능 설정을 위한 자세한 내용은 관련 API 문서를 확인 바랍니다. [→ \[결제형-네이버페이\] 에스크로 주문 확정 API](https://api.iamport.kr/) 23 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2023-05-12.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-05-12T00:00:00.000Z 3 | writtenAt: 2023-05-15T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ 스마트로의 새로운 결제모듈을 이용할 수 있습니다 9 | 10 | 기존 결제모듈을 통해 제공되는 결제기능은 제한적이었으나, 이번 업데이트를 통해 이용 가능한 결제기능이 11 | 대폭 확대되었습니다. 그럼, 새로운 스마트로 결제모듈의 주요 기능을 바로 소개합니다. 12 | 13 | - REST API 를 이용해 연동합니다 14 | - 기존에 발급된 연동키값(MID, 서명, 결제취소 비밀번호)을 그대로 새로운 결제모듈에서 이용할 수 있습니다 15 | - 정기결제를 지원합니다 16 | - 허브형 간편결제를 지원합니다 17 | - KRW, USD 결제를 지원합니다 18 | - 카드사 결제창 다이렉트 호출이 가능합니다 19 | - 에스크로 결제를 지원합니다 20 | - 에스크로 배송 정보를 수정할 수 있습니다 21 | - 면세 금액을 직접 설정할 수 있습니다 22 | - 회전식/고정식 가상계좌를 발급할 수 있습니다 23 | 24 | 본 기능 설정을 위한 자세한 내용은 관련 API 문서를 확인 바랍니다. [→ 스마트로 PG 설정하기](https://developers.portone.io/docs/ko/pg/payment-gateway/smartro-v2/readme) 25 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2023-05-22.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-05-22T00:00:00.000Z 3 | writtenAt: 2023-05-25T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ 페이팔 정기결제를 이용 가능합니다 9 | 10 | 기존에 해외 정기결제를 연동하기 위해서는 페이먼트월이 유일한 선택지였지만 이번 업데이트를 통해 보다 다양한 선택지를 제공합니다. 11 | 그럼, 페이팔 정기결제를 이용하기 위한 주요 절차를 소개합니다. 12 | 13 | - 포트원 SDK 1.3.0 부터 빌링키를 발급할 수 있습니다 14 | 15 | - 빌링키 발급을 위해서는 포트원의 페이팔 파트너 계정으로 사전에 등록해야 합니다 16 | - 기존 페이팔 SPB 를 이용 중인 고객은 바로 이용 가능합니다 17 | 18 | - 결제창 호출을 위해서는 페이팔 SPB 버튼 렌더링이 필요합니다 19 | 20 | 본 기능 설정을 위한 자세한 내용은 관련 API 문서를 확인 바랍니다. 21 | [→ 페이팔 RT 빌링키 발급 연동가이드 바로가기](https://developers.portone.io/docs/ko/pg/payment-gateway/rt) 22 | 23 |
24 | 25 | ### ✔️ 네이버페이(결제형)을 이용 중인 경우, 모바일 결제창이 표시됩니다 26 | 27 | 네이버페이의 업데이트에 따라, 네이버페이(결제형)을 이용 중인 경우 PC에서 결제창 호출 시 모바일 UI의 결제창이 표시되도록 수정했습니다. 28 | 또한 결제창 호출 시, 열린 웹페이지의 전체화면으로 결제창이 표시됩니다. 29 | 30 | 전체화면이 아닌 팝업으로 결제창을 나타나도록 하기 위해서는 `naverPopupMode` 파라미터 설정이 필요합니다. 31 | 32 | 본 기능 설정을 위한 자세한 내용은 관련 API 문서를 확인 바랍니다. 33 | [→ 네이버페이(결제형) 팝업 모드 설정하기](https://developers.portone.io/docs/ko/pg/simple/naver) 34 | 35 |
36 | 37 | ### ✔️ 워드프레스 우커머스를 통해 네이버페이(주문형)을 이용 중인 경우, 구매자의 배송지 변경 사항이 자동 반영됩니다 38 | 39 | 이번 업데이트를 통해 우커머스에서 배송지 정보를 간편하게 확인할 수 있습니다. 40 | 41 | 구매자가 배송지 변경 시 주문 건의 \[상세정보] - \[상태] 항목은 ‘배송지 변경’으로 표시되며, \[배송] 항목에서 변경된 배송지를 확인할 수 있습니다. 42 | 이와 함께 \[주문 메모]에 변경 내역이 기록됩니다. 43 | 44 | 본 기능 이용을 위해서는 아임포트 우커머스 플러그인 `2.2.36` 버전으로 업데이트하시기 바랍니다. 45 | 46 | (관련 이미지 첨부) 47 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2023-05-25.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-05-25T00:00:00.000Z 3 | writtenAt: 2023-05-31T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ 우리카드 독자 결제망을 이용할 수 있습니다 9 | 10 | 우리카드가 독자 결제망을 구축함에 따라 우리카드 결제건의 매입도 우리카드를 통해 실행됩니다.\ 11 | 이러한 변경은 5월 26일부터 발급되는 모든 우리카드에 적용됩니다. 12 | 13 | 이번 업데이트를 통해 우리카드 결제창을 다이렉트 호출할 수 있습니다. 14 | 우리카드 결제 건에 대해 관리자콘솔에서 결제내역 조회 시, 결제수단에서 바로 '우리카드'로 구별할 수 있으며 15 | API 결제내역 조회 시 카드사 코드번호(금융결제원 표준코드번호) '041' 로 구별할 수 있습니다. 16 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2023-06-19.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-06-19T00:00:00.000Z 3 | writtenAt: 2023-06-21T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ KG이니시스를 통해 애플페이를 이용할 수 있습니다 9 | 10 | KG이니시스 간편결제수단으로 애플페이를 이용할 수 있습니다. 이번 업데이트를 통해 포트원은 토스, KCP, KG이니시스, 총 3개 PG사를 통해 애플페이를 지원합니다. 11 | 12 | 기존에 KG이니시스를 이용 중이라면 결제수단 추가 계약을 통해 애플페이를 연동할 수 있습니다. 하단의 일반 13 | 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이 안내드리겠습니다. 14 | 15 | ### ✔️ 기타 수정사항 16 | 17 | - 블루월넛 가상계좌 만료일자가 실제 만료일자로 저장됩니다 18 | - 엑심베이 결제 취소 안내 메일이 결제시 설정된 언어로 발송됩니다 19 | - 페이먼트월 결제대기(pending) 단계에서 결제실패로 웹훅이 발송되던 오류를 수정했습니다 20 | - 카카오페이 이용시 `partner_user_id`를 고객 식별 파라미터로 설정 가능합니다 21 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2023-07-03.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-07-03T00:00:00.000Z 3 | writtenAt: 2023-07-05T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ (구)토스페이먼츠 SDK(결제창) 결제 요청 시 아이패드 기기에서 모바일 환경의 결제창이 표시됩니다 9 | 10 | iOS13 이후 아이패드 기기에서 결제 요청 시 PC 환경의 결제창이 표시되어 결제가 정상적으로 진행되지 11 | 않았습니다. 이번 업데이트를 통해 아이패드에서도 모바일 환경의 결제창이 표시되어 정상적으로 결제를 12 | 진행할 수 있습니다. 13 | 14 | ### ✔️ 헥토파이낸셜 빌링키 발급을 위한 API를 이용할 수 있습니다 15 | 16 | 기존 헥토파이낸셜의 경우 API를 통한 빌링키 발급 요청 시 결제가 함께 진행되었으나, 이번 업데이트를 통해 결제 없이 빌링키만 독립적으로 발급할 수 있습니다. 17 | 18 | 본 기능 사용을 위한 자세한 내용은 관련 연동가이드를 확인 바랍니다. [→ 헥토파이낸셜 빌링키 발급 요청하기](https://developers.portone.io/docs/ko/pg/payment-gateway/settle/readme) 19 | 20 | ## 기타 수정사항 21 | 22 | ### ✔️ KG모빌리언스를 통해 신용카드 결제를 이용할 수 있습니다 23 | 24 | KG모빌리언스와 계약을 통해 새로운 결제수단으로 신용카드를 이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이 안내드리겠습니다. 25 | 26 | 본 기능 설정을 위한 자세한 내용은 관련 연동가이드를 확인 바랍니다. [→ KG모빌리언스](https://developers.portone.io/docs/ko/pg/payment-gateway/kg) 27 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2023-07-10.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-07-10T00:00:00.000Z 3 | writtenAt: 2023-07-12T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V1**✔️ 나이스페이먼츠의 새로운 결제창을 이용할 수 있습니다 9 | 10 | 포트원을 통해 나이스페이먼츠의 새로운 결제창(이하 ‘(신) 나이스페이먼츠’)을 이용할 수 있습니다. 이번 11 | 업데이트를 통해 기존 모듈보다 확장된 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트 12 | 호출을 지원합니다. 13 | 14 | (신) 나이스페이먼츠에서 이용 가능한 간편결제는 다음과 같습니다. 15 | 16 | - 카카오페이 17 | - 네이버페이 18 | - 페이코 19 | - 삼성페이 20 | - 11Pay (구.SKPay) 21 | - SSG Pay 22 | - L Pay 23 | - 애플페이 24 | 25 | 이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 회수, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다. 26 | 27 | (신) 나이스페이먼츠 이용시 고려해야 하는 조건들이 있으니 다음 문서를 참고하시기 바랍니다. 28 | 29 | [→ (신)나이스페이먼츠 일반결제 연동 유의사항](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/payment-caution) 30 | 31 | [→ (신)나이스페이먼츠 비인증결제 연동 유의사항(빌링키 발급 및 API 연동)](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution) 32 | 33 | 기존에 나이스페이먼츠를 이용 중이라면 간편결제사와 별도의 계약없이 간단한 신청만으로 간편결제를 34 | 이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이 35 | 안내드리겠습니다. 36 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2023-07-17.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-07-17T00:00:00.000Z 3 | writtenAt: 2023-07-19T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V1**✔️ KCP를 통해 PC환경에서 애플페이 허브형과 다이렉트형을 이용할수 있습니다 9 | 10 | 기존에 KCP를 통해 애플페이를 이용하기 위해서는 모바일 환경에서만 가능했지만, 11 | 이번 업데이트를 통해 PC환경에서 애플페이 허브형과 다이렉트형을 모두 지원합니다. 12 | 13 | ### **결제 모듈 V1**✔️ PG MID 복수조회 API (`GET /users/pg`) 호출시 `channel_name`과 `channel_key`를 받아볼 수 있습니다 14 | 15 | API를 통해 PG 설정 정보 호출시 channel\_name과 channel\_key 응답을 받아볼 수 있습니다. 16 | 17 | 본 기능 설정을 위한 자세한 내용은 관련 API 문서를 확인 바랍니다. 18 | [→ PG MID 복수조회 API 호출하기](https://developers.portone.io/docs/ko/api/miscellaneous-api/pg/pg-mid-api) 19 | 20 |
21 | 22 | ## 기타 수정사항 23 | 24 | ### **결제 모듈 V1**✔️ 네이버페이 웹훅 수신 시점에 거래 취소시 콜백을 수신합니다 25 | 26 | 웹훅 우선순위 설정 후 네이버페이 결제시, 웹훅 수신 포인트에서 결제상태가 결제취소여도 콜백을 수신합니다. 27 | 28 | ### **결제 모듈 V1**✔️ 페이먼트월 취소 요청 시점에 고객사 웹훅을 호출하지 않습니다 29 | 30 | 기존에는 결제 취소 요청시 즉시 결제상태가 변경되는 웹훅이 전송되어 잘못된 결제상태를 수신하는 문제가 있었으나, 31 | 이번 업데이트를 통해 페이먼트월 결제 취소 요청시 콜백을 수신하는 시점에 결제상태를 결제취소로 변경합니다. 32 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2023-07-31.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-07-31T00:00:00.000Z 3 | writtenAt: 2023-07-31T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V1**✔️ KCP 결제창 내 할인쿠폰 적용 여부 파라미터 기능 추가 9 | 10 | KCP 인증결제창에서 할인쿠폰 적용 여부를 컨트롤 할수 있는 파라미터가 추가되었습니다. 11 | 할인쿠폰기능을 사용하기 위해서는 KCP와 협의가 먼저 선행되어야 하는점 유의하세요 12 | 13 | 본 기능 설정을 위한 자세한 내용은 SDK 가이드 문서를 확인 해주세요 14 | [→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/docs/ko/pg/payment-gateway/nhn-kcp#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2023-08-31.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-09-01T00:00:00.000Z 3 | writtenAt: 2023-09-01T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V1**✔️ 엑심베이 브라우저 팝업 차단 해제 문구 default 언어를 영문으로 변경 9 | 10 | 엑심베이는 해외결제를 지원하는 PG사이기에 글로벌 언어인 영어로 11 | 팝업차단 해제 문구가 고객에게 안내되도록 변경하였습니다. 12 | 13 | ### **결제 모듈 V1**✔️ NHN KCP 빌링키 발급 시 주민등록입력/생년월일 파라미터로 노출 여부 14 | 15 | NHN KCP결제창을 통한 빌링키 발급시 파라미터를 통해 빌링키 발급을 위한 정보입력 과정에서 필요한 항목중 개인정보에 해당되는 주민등록번호/생년월일 항목을 16 | 선택할수 있도록 하였습니다. 17 | 18 | 본 기능 설정을 위한 자세한 내용은 SDK 가이드 문서를 확인 해주세요 19 | [→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/docs/ko/pg/payment-gateway/nhn-kcp#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0) 20 | 21 | ### **결제 모듈 V1**✔️ 결제 URL 생성 API 지원 PG사 확대 22 | 23 | 이번 업데이트를 통해 아래 PG사도 결제 URL 생성 API를 통해 결제를 발생시킬수 있게되었습니다. 24 | 25 | - (신)토스페이먼츠 26 | - (신)스마트로 27 | - KSNET 28 | - (신)페이팔 일반결제/정기결제 29 | - (신)나이스페이먼츠 30 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2023-12-15.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-12-15T00:00:00.000Z 3 | writtenAt: 2023-12-15T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V1**✔️ (신) 토스페이먼츠 SDK(결제창) 빌링키 발급 시 결제창 백그라운드 변경 9 | 10 | 기존에는 토스페이먼츠 결제창의 백그라운드가 모서리 부분에만 표시되었으나 결제창 호출 시 전체 백그라운드를 동일한 색상으로 처리하여 깔끔하게 표시되도록 하였습니다. 11 | 12 | (관련 이미지 첨부) 13 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-01-08.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-01-08T00:00:00.000Z 3 | writtenAt: 2024-01-08T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 나이스페이먼츠 결제를 지원합니다. 9 | 10 | 이제 포트원 V2를 통해 나이스페이먼츠 일반결제/정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다. 11 | 12 | 나이스페이먼츠에서 지원하는 결제수단 아래와 같습니다. 13 | 14 | - 카드 15 | 16 | - 실시간 계좌이체 17 | 18 | - 가상계좌 (회전식/고정식) 19 | 20 | - 휴대폰 소액결제 21 | 22 | - 상품권 (컬쳐랜드) 23 | 24 | - 간편결제 (허브형/다이렉트) 25 | - 카카오페이 26 | - 네이버페이 27 | - 페이코 28 | - 삼성페이 29 | - 애플페이 30 | - 11Pay (구.SKPay) 31 | - SSGPay 32 | - LPay 33 | 34 | 이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 말소, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다. 35 | 36 | 나이스페이먼츠 연동에 대해 자세히 알고 싶다면 [→ 나이스페이먼츠 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/nice-v2?v=v2) 에서 확인하실 수 있습니다. 37 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-01-11.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-01-11T00:00:00.000Z 3 | writtenAt: 2024-01-11T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V1**✔️ 토스페이 정기결제 이용이 가능합니다. 9 | 10 | 기존에는 토스페이 일반결제만 지원하였으나 이번 업데이트를 통해 토스페이 일반결제와 정기결제를 11 | 이용하실 수 있습니다. 그럼, 토스페이 정기결제를 이용하기 위한 주요 절차를 소개합니다. 12 | 13 | - 포트원 SDK 1.3.0 부터 빌링키 발급 및 정기결제를 사용할 수 있습니다. 14 | - 토스페이 일반결제 / 정기결제를 사용하시려면 (신)토스페이(tosspay\_v2)로 연동해야 합니다. 15 | - (신)토스페이 결제 시 카드결제, 계좌결제를 지정할 수 있습니다. 16 | 17 | (신)토스페이 연동에 대해 자세히 알고 싶다면 18 | [→ (신)토스페이 연동가이드](https://developers.portone.io/docs/ko/pg/simple/tosspay-v2/readme?v=v1) 에서 확인하실 수 있습니다. 19 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-01-25.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-01-24T00:00:00.000Z 3 | writtenAt: 2024-01-25T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V1**✔️ 네이버페이 결제형에서 10원부터 결제할 수 있습니다. 9 | 10 | 네이버페이 결제형의 기존 최소주문금액 100원이었으나, 10원으로 수정되었습니다. 11 | 12 | ### **관리자 콘솔**✔️ 가상계좌 발급취소/말소 API를 이용하여 가상계좌를 말소한 경우 결제실패로 분류되어 표시됩니다. 13 | 14 | 가상계좌 발급 후 입금 전에 API를 이용해 가상계좌를 말소한 경우, 관리자콘솔 \[결제 상세 내역 조회]에서 15 | 결제실패로 분류됩니다. 가상계좌 말소 건은 엑셀 다운로드시 실패 상세 항목에 **계좌말소**로 표시되어 16 | 구분할 수 있습니다. 17 | 18 | ### **관리자 콘솔**✔️ 엑셀 내의 `PG계정` 컬럼명이 `PG상점아이디(MID)` 로 변경되었습니다. 19 | 20 | \[결제 상세 내역 조회]에서 엑셀 다운로드시 기존에 PG계정으로 표시되던 컬럼명이 **PG상점아이디(MID)** 로 표시됩니다. 21 | 22 |
23 | 24 | ## 기타 수정사항 25 | 26 | ### **결제 모듈 V1**✔️ Microsoft Edge 브라우저에서 adblock extension과 충돌하는 현상이 수정되었습니다. 27 | 28 | Microsoft Edge 브라우저 환경에서 결제 모듈 호출 시 adblock extension과 충돌을 일으켜 결제창이 29 | 정상적으로 호출되지 않는 현상이 간헐적으로 발생하였으나 현재는 수정되어 정상적으로 호출이 30 | 가능합니다. 31 | 32 | ### **결제 모듈 V1**✔️ (신) 페이팔 결제 요청 시 컨텐츠 상품인 경우 배송지 입력란이 표시되지 않습니다. 33 | 34 | 기존에는 디지털 상품인 경우에도 배송지 입력란이 표시되었으나 결제 요청 시 `digital:true`로 35 | 입력한 경우 청구주소로 배송 체크박스 및 상세 주소 입력 칸이 표시되지 않습니다. 36 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-01-30.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-01-31T00:00:00.000Z 3 | writtenAt: 2024-02-01T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V2**✔️ easyPay.easyPayProvider(간편결제수단) 파라미터에 대한 동작이 변경되었습니다. 9 | 10 | 기존에는 토스페이먼츠 결제창(SDK) 결제 요청 시 `payMethod:EASY_PAY` 입력 후 11 | `easyPay.easyPayProvider` 파라미터를 입력하지 않은 경우 통합결제창이 호출되었으나, 12 | `payMethod:EASY_PAY` 입력 후 `easyPay.easyPayProvider` 파라미터를 입력하지 않은 경우 **에러를 13 | 리턴**합니다. 14 | 15 | 따라서, 통합결제창 호출을 원하시는 경우 `payMehtod:CARD` 로 변경하여 호출하시고, 간편결제 다이렉트 16 | 호출을 원하시는 경우 `payMethod:EASY_PAY`로 입력하신 후 `easyPayProvider`를 입력하여 호출하시기 17 | 바랍니다. 18 | 19 | (빌링키 발급 및 정기결제를 사용하시는 경우 위의 변경으로 인한 영향을 받지 않습니다.) 20 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-02-23.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-02-23T00:00:00.000Z 3 | writtenAt: 2024-02-26T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 페이팔 결제를 지원합니다. 9 | 10 | 이제 포트원 V2를 통해 페이팔 일반결제 및 정기결제를 이용할 수 있습니다. 포트원에서는 페이팔 11 | 일반결제는 SPB(Smart Payment Button) 방식으로, 정기결제는 RT(Reference Transaction) 방식으로 12 | 제공합니다. 13 | 14 | 페이팔 연동에 대해 자세히 알고 싶다면 [→ 페이팔 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/paypal-v2?v=v2) 에서 확인하실 수 있습니다. 15 | 16 | ### **결제 모듈 V1**✔️ 결제 취소 시 발송되는 웹훅에 취소내역 아이디 (`cancellation_id`)가 포함됩니다. 17 | 18 | 기존에는 웹훅 발송 시 결제번호(`imp_uid`), 주문번호(`merchant_uid`), 결제 결과(`status`) 정보만 19 | 전달하였으나, 이제 취소내역 아이디(`cancellation_id`)도 포함하여 전달됩니다. 20 | 21 | ### **결제 모듈 V1**✔️ Schedule API의 `checking_amount` 파라미터 입력시 `currency`가 `KRW`로 자동 입력됩니다. 22 | 23 | 기존에는 `checking_amount` 파라미터를 사용할 때, 직접 `currency` 파라미터를 입력해야 정상적으로 결제 및 취소 처리가 가능했습니다. 24 | 25 | 이번 업데이트에서는 고객 편의성을 높이고자 자동으로 `currency` 파라미터가 `KRW`로 적용되도록 변경했습니다. 26 | 따라서 해외 통화 결제를 이용하는 경우 반드시 `currency` 파라미터에 해당 국가 통화를 입력하여 이용하시기 바랍니다. 27 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-03-08.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-03-08T00:00:00.000Z 3 | writtenAt: 2024-03-11T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 스마트로 API 정기결제를 지원합니다. 9 | 10 | 이제 포트원 V2를 통해 스마트로에서도 API를 이용하여 빌링키를 발급할 수 있습니다. 11 | 12 | 스마트로 API 빌링키 발급에 대해 자세히 알고싶다면 [→ 스마트로 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/smartro-v2?v=v2) 에서 확인하실 수 있습니다. 13 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-03-15.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-03-15T00:00:00.000Z 3 | writtenAt: 2024-03-18T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V1**✔️ 결제 요청 시 파라미터 유효성 검증이 추가되었습니다. 9 | 10 | 결제 요청 시 필수 파라미터인 `amount`와 `merchant_uid`에 대한 유효성 검증 로직이 추가되었습니다. 11 | `amount`는 number 형식으로, `merchant_uid`는 string 형식으로 요청해야 합니다. 12 | 형식이 올바르지 않는 경우 에러가 리턴되며 결제창 호출이 실패하니 유의하시기 바랍니다. 13 | 14 | ### **결제 모듈 V1****결제 모듈 V2**✔️ 토스페이먼츠(신모듈) 간편결제를 IFRAME으로 이용할 수 있습니다. 15 | 16 | 토스페이먼츠를 통해 카카오페이, 페이코, 삼성페이, Lpay, 토스페이 호출 시 기존에는 POPUP 방식으로 호출되었으나 17 | 이번 업데이트를 통해 IFRAME으로 이용 가능하여 간편결제 창을 닫은 후에도 정상적으로 실패응답을 확인할 수 있습니다. 18 | 19 |
20 | 21 | ## 기타 수정사항 22 | 23 | ### **결제 모듈 V1**✔️ 엑심베이 결제 취소시 호출되는 API 버전이 업그레이드 되었습니다. 24 | 25 | 기존에 포트원이 제공하던 알리페이가 알리페이 플러스로 변경됨에 따라 결제 취소시 호출되는 API 버전이 업그레이드 되었습니다. 26 | 결제 취소의 경우 기존과 동일한 방법으로 이용할 수 있습니다. 27 | 28 | ### **결제 모듈 V2**✔️ 모바일 환경에서 웰컴페이먼츠를 통해 가상계좌 결제 요청시 입금 기한을 설정할 수 있습니다. 29 | 30 | 기존에는 모바일 환경에서 웰컴페이먼츠를 통해 가상계좌 결제 요청시 입금 기한 설정이 불가능했으나, 이제 입금 기한 파라미터에 입력된 날짜로 설정할 수 있습니다. 31 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-03-25.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-03-25T00:00:00.000Z 3 | writtenAt: 2024-03-25T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **관리자 콘솔**✔️ 결제 연동 페이지가 새롭게 단장했습니다. 9 | 10 | - **\[채널 관리]** 11 | - 기존 연동 관리와 달리 채널 추가 시 결제 모듈 별 지원되는 기능 및 결제 수단 정보를 쉽게 확인할 수 있습니다. 12 | (관련 이미지 첨부) 13 | - 자세한 채널 추가 방법은 가이드를 참고해 주세요. [→ 포트원 V1 채널 연동 가이드 바로가기](../../../../docs/ko/ready/readme) 14 | 15 | - **\[식별코드·API Keys]** 16 | - V2 API Secret을 발급할 수 있습니다. 17 | - V2 API Secret의 경우 유효기간에 따라 갯수에 제한없이 발급이 가능합니다. 18 | (관련 이미지 첨부) 19 | 20 | - **\[결제알림(Webhook) 관리]** 21 | - 포트원 V2 결제모듈에서 사용하는 웹훅 데이터 형식으로도 테스트할 수 있습니다. 22 | - 포트원 V1/V2 결제 모듈 모두 테스트/실환경에 대해 웹훅을 각각 설정할 수 있습니다. 23 | (관련 이미지 첨부) 24 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-04-01.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-03-29T00:00:00.000Z 3 | writtenAt: 2024-04-04T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 KG이니시스 결제를 지원합니다. 9 | 10 | 이제 포트원 V2를 통해 KG이니시스 일반결제 및 정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다. 11 | 12 | KG이니시스에서 지원하는 결제수단 아래와 같습니다. 13 | 14 | - 카드 15 | 16 | - 실시간 계좌이체 17 | 18 | - 가상계좌 (회전식/고정식) 19 | 20 | - 휴대폰 소액결제 21 | 22 | - 상품권 (컬쳐랜드/스마트문상/해피머니/도서문화상품권) 23 | 24 | - 간편결제 (허브형/다이렉트) 25 | - 카카오페이 26 | - 네이버페이 27 | - 페이코 28 | - 삼성페이 29 | - 애플페이 30 | - 토스페이 31 | - SSGPay 32 | - LPay 33 | 34 | 이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 말소, 면세 및 부가세 금액 지정, 상점분담무이자, 35 | 하위 사업자 정보로 현금영수증 발급 등의 기능을 지원합니다. 36 | 37 | KG이니시스 연동에 대해 자세히 알고 싶다면 [→ KG이니시스 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/inicis-v2?v=v2) 에서 확인하실 수 있습니다. 38 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-04-05.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-04-03T00:00:00.000Z 3 | writtenAt: 2024-04-04T00:00:00.000Z 4 | --- 5 | 6 | ## 기타 수정사항 7 | 8 | ### **관리자 콘솔**✔️ 결제 내역 엑셀 내의 카드유형 정보가 추가되었습니다. 9 | 10 | \[결제 상세 내역 조회]에서 엑셀 다운로드시 신용카드, 체크카드, 기프트카드에 대한 정보가 표시됩니다. 11 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-04-12.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-04-12T00:00:00.000Z 3 | writtenAt: 2024-04-12T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 한국결제네트웍스(KPN) 결제를 지원합니다. 9 | 10 | 이제 포트원 V2를 통해 한국결제네트웍스 일반결제 및 정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 11 | 일부 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다. 12 | 13 | 한국결제네트웍스에서 지원하는 결제수단은 아래와 같습니다. 14 | 15 | - 카드 16 | 17 | - 실시간 계좌이체 18 | 19 | - 가상계좌 (회전식) 20 | 21 | - 휴대폰 소액결제 22 | 23 | - 간편결제 (허브형/다이렉트) 24 | - 카카오페이 25 | - 네이버페이 (다이렉트 호출 불가) 26 | - 페이코 27 | - 삼성페이 28 | - 토스페이 29 | 30 | 이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 말소, 면세 금액 지정, 상점분담무이자 등의 기능을 지원합니다. 31 | 32 | 한국결제네트웍스 연동에 대해 자세히 알고 싶다면 [→ 한국결제네트웍스 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/kpn?v=v2) 에서 확인하실 수 있습니다. 33 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-05-08.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-05-08T00:00:00.000Z 3 | writtenAt: 2024-05-08T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **관리자 콘솔**✔️ 빌링결제 내역조회 페이지가 새롭게 오픈했습니다. 9 | 10 | 새로운 빌링결제 내역 조회 페이지에서는 빌링키 결제 및 결제 예약건에 대해 한 번에 조회 및 관리할 수 있습니다. 11 | 12 | - **\[상세 내역 조회]** 13 | 14 | - 빌링키 결제 내역을 상태별로 조회할 수 있습니다. 15 | 16 | - 콘솔 화면에서 결제 예약일 변경, 예약 해지, 결제 즉시 재시도, 결제 재예약을 할 수 있습니다. 17 | 18 | - 리커버리 기능을 설정하여 결제 실패 건에 대한 일괄 재시도를 자동화할 수 있습니다. 19 | - 포트원 V1 결제 서비스의 경우 결제예약 API(Schedule API)를 이용한 결제 예약 건 중 결제 실패 상태인 20 | 거래 건에 한하여 리커버리 기능을 사용할 수 있습니다. 비 인증 결제(빌링키) API(Again API) 건에 대한 21 | 리커버리 기능은 상반기 내로 업데이트될 예정입니다. 22 | 23 | - 포트원 V2 결제 서비스의 경우 빌링키 결제 API 및 결제 예약 API를 이용한 결제 건 중 결제 실패 24 | 상태인 거래 건에 한하여 리커버리 기능을 사용할 수 있습니다. 25 | 26 | (관련 이미지 첨부) 27 | 28 | - **\[빌링결제 캘린더]** 29 | 30 | - 빌링결제 건에 대한 월간/일간 데이터를 확인할 수 있습니다. 31 | 32 | (관련 이미지 첨부) 33 | 34 | - 자세한 내용은 가이드를 참고해 주세요. [→ 포트원 빌링결제 내역 가이드 바로가기](../../../../docs/ko/console/guide/billing-payments) 35 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-05-14.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-05-14T00:00:00.000Z 3 | writtenAt: 2024-05-17T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V1**✔️ KSNET을 통한 카드사 다이렉트 기능을 지원합니다. 9 | 10 | 이제 포트원 V1의 KSNET을 통해 카드사 다이렉트 결제가 가능합니다. 이번 업데이트를 통해 카드사 결제창을 11 | 바로 호출하여 사용하세요. 12 | 13 | KSNET 카드사 다이렉트 연동에 대해 자세히 알고 싶다면 14 | [→ KSNET 연동가이드](https://developers.portone.io/docs/ko/pg/payment-gateway/ksnet/readme?v=v1#%EC%B9%B4%EB%93%9C%EC%82%AC-%EB%8B%A4%EC%9D%B4%EB%A0%89%ED%8A%B8-%ED%98%B8%EC%B6%9C) 15 | 에서 확인하실 수 있습니다. 16 | 17 | (\* 포트원 V2 결제 모듈의 경우 추후에 KSNET을 통한 카드사 다이렉트 기능이 지원될 예정입니다.) 18 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-06-03.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-06-03T00:00:00.000Z 3 | writtenAt: 2024-06-03T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V2**✔️ 스마트 라우팅 기능이 새롭게 출시되었습니다. 9 | 10 | 포트원 V2에서 스마트 라우팅 기능을 제공합니다. 11 | 12 | (관련 이미지 첨부) 13 | 14 | ### 스마트 라우팅이란? 15 | 16 | 스마트 라우팅은 원클릭 결제 트래픽 자동 분산 서비스로 최초 연동 이후 포트원 관리자콘솔 내에서 17 | 결제대행사 추가/삭제 및 결제대행사 별 결제 요청 비율을 설정할 수 있습니다. 18 | 노코드 방식으로 고객사에서 멀티 PG 인프라를 구성하는데 필요한 개발 리소스를 확 줄였습니다. 19 | 20 | **지원 범위** 21 | 22 | - 결제창(SDK) 인증결제 23 | - API 수기(키인) 결제 24 | - API 빌링키 발급 및 빌링키결제/예약결제 25 | 26 | **지원 기능** 27 | 28 | 1. 스마트 라우팅 그룹 설정에 따른 결제 트래픽 분산 자동화 29 | 2. 슈퍼빌링키 발급 30 | 31 | - 스마트 라우팅 그룹 내 모든 결제대행사에 대해 빌링키 발급 요청 및 저장 32 | 33 | **지원 결제대행사** 34 | 35 | - 나이스페이먼츠 36 | - KG이니시스 37 | - 토스페이먼츠 38 | - 스마트로 39 | - KSNET 40 | - KPN 41 | - NHN KCP (6월 중 제공 예정) 42 | 43 | 이번 업데이트를 통해 스마트 라우팅 그룹을 생성하고 자동화된 결제 트래픽 분산 서비스를 경험해보세요. 44 | 45 | 스마트 라우팅에 대해 자세히 알고 싶다면 46 | [→ 스마트 라우팅 소개](https://developers.portone.io/opi/ko/extra/smart-routing/intro) 및 47 | [→ 스마트 라우팅 연동하기](https://developers.portone.io/opi/ko/extra/smart-routing/integration) 48 | 문서에서 확인하실 수 있습니다. 49 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-06-17.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-06-17T00:00:00.000Z 3 | writtenAt: 2024-06-17T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V2**✔️ 포트원 V2 결제모듈에서 NHN KCP 결제를 지원합니다. 9 | 10 | 이제 포트원 V2를 통해 NHN KCP 일반결제 및 정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 11 | 일부 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다. 12 | 13 | NHN KCP에서 지원하는 결제수단은 아래와 같습니다. 14 | 15 | - 카드 16 | 17 | - 실시간 계좌이체 18 | 19 | - 가상계좌 20 | 21 | - 휴대폰 소액결제 22 | 23 | - 상품권 결제(컬쳐랜드/해피머니/도서문화상품권) 24 | 25 | - 간편결제 (허브형/다이렉트) 26 | - 카카오페이 27 | - 네이버페이 28 | - 페이코 29 | - SSG페이 30 | - L페이 31 | - 삼성페이 32 | - 애플페이 33 | - 토스페이 34 | 35 | 이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급, 면세 금액 지정, 상점분담무이자 등의 기능을 지원합니다. 36 | 37 | NHN KCP 연동에 대해 자세히 알고 싶다면 [→ NHN KCP 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/kcp-v2?v=v2) 에서 확인하실 수 있습니다. 38 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-06-19.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-06-19T00:00:00.000Z 3 | writtenAt: 2024-06-19T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V2**✔️ 포트원 V2 결제모듈에서 토스페이 결제 직연동을 지원합니다. 9 | 10 | 이제 포트원 V2를 통해 토스페이 직연동이 가능합니다. 이번 업데이트를 통해 일반결제 및 정기결제를 지원합니다. 11 | 12 | 토스페이에서 지원하는 결제수단은 아래와 같습니다. 13 | 14 | - 카드 15 | - 계좌 16 | - 토스머니 17 | 18 | 토스페이 연동에 대해 자세히 알고 싶다면 [→ 토스페이 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/tosspay-v2?v=v2) 에서 확인하실 수 있습니다. 19 | 20 | ### **결제 모듈 V2**✔️ 웹훅 신버전이 추가되었습니다. 21 | 22 | V2 결제모듈을 이용하시는 경우 빌링키 발급 관련 웹훅을 받아보실 수 있습니다. 23 | 웹훅을 연동하여 이벤트 발생 시 결제 건의 상태를 동기화할 수 있습니다. 24 | 25 | 웹훅 버전에 대한 자세한 내용은 [웹훅 연동하기](https://developers.portone.io/docs/ko/v2-payment/webhook?v=v2#웹훅-버전에-따른-스키마-안내)에서 확인하실 수 있습니다. 26 | 27 | ### **결제 모듈 V2**✔️ 웹훅 시크릿 기능이 추가되었습니다. 28 | 29 | V2 결제모듈을 이용하시는 경우 웹훅 시크릿을 사용하여 포트원이 생성한 웹훅 요청인지 출처를 확인할 수 있으며, 30 | 악의적인 공격자가 보낸 웹훅 요청을 차단할 수 있습니다. 31 | 32 | 웹훅 시크릿에 대한 자세한 내용은 [웹훅 연동하기](https://developers.portone.io/docs/ko/v2-payment/webhook?v=v2#웹훅-요청-검증하기)에서 확인하실 수 있습니다. 33 | 34 | ## 기타 업데이트 사항 35 | 36 | ### **결제 모듈 V1**✔️ KG이니시스 통합인증 시 보안성이 강화되었습니다. 37 | 38 | 이제 포트원을 통한 KG이니시스 통합인증 이용시 민감정보를 암호화하여 처리할 수 있습니다. 39 | 고객사에서는 별도로 추가 대응 없이 바로 적용되어 사용하실 수 있습니다. 40 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-06-20.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-06-27T00:00:00.000Z 3 | writtenAt: 2024-07-01T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V1****결제 모듈 V2**✔️ 빌링키 다건조회 API가 추가되었습니다. 9 | 10 | 이제 포트원을 통해 발급된 빌링키를 한 번에 조회할 수 있습니다. 11 | 12 | 빌링키 다건조회 API에 대한 자세한 내용은 [빌링키 다건조회 API](https://developers.portone.io/api/rest-v2/billingKey#get%20%2Fbilling-keys)에서 13 | 확인하실 수 있습니다. 14 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-07-04.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-07-05T00:00:00.000Z 3 | writtenAt: 2024-07-08T00:00:00.000Z 4 | --- 5 | 6 | ## 기타 업데이트 사항 7 | 8 | ### **결제 모듈 V1**✔️ 엑심베이 Econtext 결제 시 일부 건에 대한 결제 상태 처리 로직이 변경되었습니다. 9 | 10 | 결제 승인이 완료된 경우 브라우저 새로고침 등의 이유로 결제 프로세스가 비정상적으로 종료된 경우에도 11 | 결제 상태가 `결제 완료`로 유지됩니다. 12 | 13 | ### **결제 모듈 V1**✔️ 엑심베이 결제 시 금액 위변조가 발생하는 경우 결제 취소 처리되도록 변경되었습니다. 14 | 15 | 승인 결과 처리 단계에서 결제 요청 당시 결제 금액과 승인 결제 금액이 다른 경우 자동으로 결제 취소 됩니다. 16 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-07-11.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-07-10T00:00:00.000Z 3 | writtenAt: 2024-07-10T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V1**✔️ KG이니시스 통합인증 결과 중 성별 정보를 확인할 수 있습니다. 9 | 10 | 이제 KG이니시스 통합인증을 통해 인증 시 응답에 성별 정보가 포함되며, 인증 후 내역 조회 시 응답 필드에도 11 | 성별 정보가 포함됩니다. 12 | 13 | 성별 정보를 활용하시려면 이전 인증 내역의 경우 Null로 응답됩니다. 14 | 15 | ### **결제 모듈 V2**✔️ 한국결제네트웍스(KPN)을 통한 카드 다이렉트 결제가 지원됩니다. 16 | 17 | 이제 한국결제네트웍스(KPN)을 이용하시는 고객사에서도 아래 지원되는 카드사에 한하여 카드 다이렉트 18 | 결제를 이용하실 수 있습니다. 19 | 20 | **지원 카드 목록** 21 | 22 | - BC카드 23 | - 신한카드 24 | - 삼성카드 25 | - 현대카드 26 | - 롯데카드 27 | - KB국민카드 28 | - NH농협카드 29 | - 씨티카드 30 | - 우리카드 31 | - 하나카드 32 | - 우체국은행카드 33 | - 카카오뱅크카드 34 | - 케이뱅크카드 35 | - 신협카드 36 | - KDB산업은행 37 | - 저축은행카드 38 | - 새마을금고카드 39 | 40 | KPN 카드 다이렉트에 대한 자세한 내용은 [KPN 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/kpn)에서 확인하실 수 있습니다. 41 | 42 | ## 기타 업데이트 사항 43 | 44 | ### **결제 모듈 V2**✔️ redirectUrl 파라미터 입력 형식 유효성 검증 기준이 완화되었습니다. 45 | 46 | 기존에는 http 또는 https 프로토콜인 경우에만 입력 가능하였으나, 이제 다른 프로토콜로 입력한 경우에도 47 | 정상적으로 결제 요청이 가능하도록 유효성 검증 기준을 완화하였습니다. 48 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-09-05.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-09-05T00:00:00.000Z 3 | writtenAt: 2024-09-05T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **결제 모듈 V2**✔️ 포트원 V2 결제모듈에서 KG이니시스 통합인증을 지원합니다. 9 | 10 | 이제 포트원 V2를 통해 KG이니시스 통합인증이 가능합니다. 11 | 이번 업데이트를 통해 통신사PASS, 토스 인증서, 카카오 인증서, 네이버 인증서 등 민간인증서를 이용하여 12 | 본인인증을 진행할 수 있습니다. 13 | 14 | 통합인증에서 지원하는 인증수단은 아래와 같습니다. 15 | 16 | - 통신사PASS 17 | - 토스 18 | - 카카오 19 | - 네이버 20 | - 페이코 21 | - 금융결제원 22 | - KB국민은행 23 | - 신한은행 24 | - 하나은행 25 | - 우리은행 26 | - IBK기업은행 27 | - NH농협은행 28 | - 카카오뱅크 29 | - 삼성패스 30 | 31 | KG이니시스 통합인증 연동에 대해 자세히 알고 싶다면 [→ KG이니시스 통합인증 연동가이드](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-unified-identity-verification?v=v2) 에서 확인하실 수 있습니다. 32 | 33 | ### **결제 모듈 V1**✔️ 포트원 V1 결제모듈에서 KCP 간편결제 다이렉트 호출 결제 이용시 해당 거래건에 결제수단 정보를 표시하는 방식이 일부 변경되었습니다. 34 | 35 | KCP 간편결제 다이렉트 호출 결제의 경우 기존에 결제수단(`pay_method`)이 `naverpay`, `payco`, `kakaopay와` 같은 36 | 간편결제사로 분류하는 코드였으나 9월 2일 거래건부터 결제 승인 시 결제수단에 따라 `point` 혹은 `card`로 표시되도록 변경되었습니다. 37 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-09-27.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-09-27T00:00:00.000Z 3 | writtenAt: 2024-09-30T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **PG 거래대사**✔️ 이제 콘솔 내 PG 거래대사에서 조회한 데이터를 엑셀로 다운로드하여 사용해 보세요. 9 | 10 | (관련 이미지 첨부) 11 | 12 | PG 거래대사 내의 **거래 정산 내역** 메뉴에서 정산일 또는 거래일을 기준으로, 13 | **거래 건별 조회** 메뉴에서는 정산일을 기준으로 최대 3개월 분량의 데이터를 엑셀로 다운로드할 수 있습니다. 14 | 15 | ### **PG 거래대사**✔️ KSNET, KPN, 하이픈에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다. 16 | 17 | 기존에 12개 PG사 (KCP, KG이니시스, 나이스페이먼츠, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 18 | 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN, 하이픈까지 확장하여 19 | 총 15개 PG사 데이터에 한하여 제공됩니다. 20 | 21 | (참고 : PG 거래대사 메뉴의 경우 클로즈 베타로 운영되고 있으며, 22 | 사용을 원하시는 고객께서는 [PG거래대사 베타서비스 신청 바로가기](https://forms.gle/cZAqJLGqovC1STrS8)에서 신청해 주시길 바랍니다.) 23 | 24 | ### **결제 모듈 V1**✔️ 엑심베이 결제시 결제 금액 위변조 확인이 강화됩니다. 25 | 26 | 기존에는 엑심베이로부터 전달받은 값 자체에 위변조 내용이 있는지 hash만 검증했으나 27 | 앞으로는 hash 검증에 추가로 실제 결제금액까지 비교하여 금액을 위변조하여 결제가 승인되지 않도록 로직을 추가하였습니다. 28 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2024-12-19.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-12-19T00:00:00.000Z 3 | writtenAt: 2024-12-12T00:00:00.000Z 4 | --- 5 | 6 | 안녕하세요 원 페이먼트 인프라팀입니다. 7 | 8 | 24년 12월 19일, 서비스 업데이트 사항 안내드립니다. 9 | 10 | 이번 업데이트에서는 아래 3가지 개선으로 보다 좋은 사용성을 제공합니다. 11 | 12 | 1. 통합 결제 내역 - 상점별 내역 조회 기능이 추가되었습니다. 13 | 2. 통합 결제 내역 - 일괄 웹훅 재전송 기능이 추가되었습니다. 14 | 3. 통합 결제 내역 - 필터 사용성을 개선하였습니다. 15 | 16 | ### **관리자 콘솔** 17 | 18 | ## 주요 업데이트 사항 19 | 20 | ### ✔️ 통합 결제 내역 - 상점별 내역 조회 21 | 22 | - **상점별 내역 조회** 23 | - 전체 또는 하위 상점별로 나누어 통합 결제 내역을 확인할 수 있습니다. 24 | 25 | 이를 통해, 기존에 전체 내역에서 수동으로 분류해서 확인해야 하는 번거로움을 대폭 줄이고 쉽게 상점별로 결제 내역을 조회할 수 있게 되었습니다. 26 | 27 | (관련 이미지 첨부) 28 | 29 | ### ✔️ 통합 결제 내역 - 일괄 웹훅 재전송 30 | 31 | - **웹훅 일괄 재전송** 32 | - 웹훅 수신에 실패한 결제 건들에 대해 일괄로 웹훅을 재전송할 수 있도록 기능이 추가되었습니다. 33 | - 조회된 기간 내에 웹훅 수신에 실패한 결제 건 수를 한 번에 파악할 수 있습니다. 34 | 35 | - **상점별 구분 발송** 36 | - 전체 또는 하위 상점별로 나누어 웹훅 일괄 재전송 기능을 사용할 수 있습니다. 37 | 38 | 이를 통해, 기존에 웹훅 재전송을 개별 건마다 적용하던 불편함을 개선하고 웹훅 재전송을 일괄적으로 빠르게 적용할 수 있게 되었습니다. 39 | 40 | (관련 이미지 첨부) 41 | 42 | ### ✔️ 통합 결제 내역 - 필터 사용성 개선 43 | 44 | - **옵션 배열 방식 변경** 45 | - 선택 항목이 많은 경우, 기존 **horizontal 배열**에서 **vertical 배열**로 변경하여 가독성과 사용성을 개선하였습니다. 46 | 47 | - **“전체 선택” 기능 확장** 48 | - 기존 “전체 선택” 기능이 일괄 적용만 가능했던 점을 개선하여, 각 항목별로도 “전체 선택” 기능을 추가했습니다. 이를 통해 더 세부적으로 선택 및 해제가 가능하도록 했습니다. 49 | 50 | 이를 통해, 기존에 비해 한눈에 옵션을 확인할 수 있어 선택 과정이 간소화되었고 필요한 옵션만 빠르고 정확하게 설정할 수 있도록 편의성을 향상시켰습니다. 51 | 52 | (관련 이미지 첨부) 53 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/api-sdk/2025-05-19.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2025-05-19T00:00:00.000Z 3 | writtenAt: 2025-05-19T00:00:00.000Z 4 | --- 5 | 6 | 안녕하세요 원 페이먼트 인프라팀입니다. 25년 5월 19일, 서비스 업데이트 사항 안내드립니다. 7 | 8 | 이번 업데이트를 통해 통합 결제 내역 페이지가 새롭게 탈바꿈을 했습니다. 9 | 10 | 개선 작업은 아래와 같습니다. 11 | 12 | ### **관리자 콘솔** 13 | 14 | ## 주요 업데이트 사항 15 | 16 | ### ✔️ 캘린더 UI 고도화 17 | 18 | (이미지 첨부: 캘린더 UI 고도화) 19 | 20 | - 상태 승인 시각, 결제 요청 시각을 기준으로 원하는 날짜를 쉽게 조회할 수 있습니다. 21 | - 시작일과, 종료일을 직접 입력하거나 캘린더에서 일자를 선택하여 날짜를 조회할 수 있습니다. 22 | - “오늘”, “어제”, “1주”, “1개월”, “3개월”, “6개월” 의 프리셋을 활용하여 직접 입력하지 않고도 간편하게 일자를 설정할 수 있습니다. 23 | 24 | ### ✔️ 검색 조건 최적화 25 | 26 | (이미지 첨부: 검색 조건 최적화) 27 | 28 | - 검색을 쉽게 할 수 있도록 각 검색 조건마다 최적화 작업을 진행하였습니다. 29 | - 주문 정보 30 | - 주문자명, 주문자 연락처, 주문명, 주문자 이메일, 주문자 주소로 더욱 정교화된 검색을 할 수 있습니다. 31 | 32 | - 거래번호 33 | - 포트원 거래번호, 고객사 거래번호를 동시에 검색할 수 있습니다. 34 | 35 | - 승인번호 36 | - 카드사 승인번호, 결제대행사 승인번호, PG결제취소 승인번호를 동시에 검색할 수 있습니다. 37 | 38 | ### ✔️ 필터 최적화 39 | 40 | (이미지 첨부: 필터 최적화) 41 | 42 | - 테이블 UI를 고도화함에 따라 테이블 헤더에 필터, 정렬 버튼이 추가되어 빠른 적용이 가능합니다. 43 | - Tip) 실 운영 업무를 위해 결제 모드는 “실결제”로 필터가 기본 적용되어 있습니다. 테스트 결제 건을 확인하고 싶으시다면 결제 모드 필터를 해제해 주세요. 44 | 45 | ### ✔️ 결제 히스토리 파악 가능 46 | 47 | (이미지 첨부: 결제 히스토리 파악 가능) 48 | 49 | - 기존에는 결제 상세 모달에서만 히스토리를 확인 가능했다면, 이제는 결제 내역에서 바로 확인할 수 있게 되었습니다. 결제 히스토리를 쉽게 확인하고 운영 업무에 활용하실 수 있습니다. 50 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/console/2023-04-24.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-04-24T00:00:00.000Z 3 | writtenAt: 2023-04-27T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ 결제내역 조회 시 상태 승인 시각을 기준으로 확인할 수 있습니다 9 | 10 | 관리자콘솔 `[결제 상세 내역 조회]` 메뉴 - `[기준 시각]`을 `'상태 승인 시각'`으로 선택해 보세요.\ 11 | 다섯 가지 결제 상태에 따라 가장 최근에 업데이트된 시각을 확인할 수 있습니다. 12 | 13 | 앞으로는 결제건의 결제 상태와 더불어 마지막 결제 상태가 업데이트된 시각도 함께 볼 수 있습니다. 14 | 15 |
16 | 17 | **Tip**: 포트원 관리자콘솔은 결제 상태를 결제완료, 결제예정, 결제실패, 결제취소, 승인대기로 분류하고 있습니다. 18 | 19 |
20 | 21 | (관련 이미지 첨부) 22 | 23 | ## 기타 수정사항 24 | 25 | ### ✔️ 매니저 권한을 부여받은 계정으로 정산 서비스를 이용할 수 있습니다 26 | 27 | 포트원 관리자콘솔은 계정 권한을 총 다섯 가지로 분류하고 있습니다. 28 | 29 | 1. **Admin(Owner)**: 모든 기능 접근 가능, 계정 삭제 시 상점 삭제 30 | 2. **Admin**: 모든 기능 접근 가능 31 | 3. **Dev**: 결제 연동 설정, 결제 내역 조회 32 | 4. **Manager**: 결제 내역 조회 및 수정, 리포트 조회, 계정 관리 33 | 5. **Read Only**: 결제 내역 조회, 리포트 조회 34 | 35 | ### ✔️ 결제연동 설정 시, 결제대행사로 다날 또는 KG이니시스를 선택하는 경우에만 본인인증을 선택할 수 있습니다 36 | 37 | 관리자콘솔 `[결제연동]` 메뉴 - `[테스트/실 연동 관리]` 탭에서 결제대행사 설정 및 추가를 진행할 때 38 | 본인인증 서비스를 제공하는 다날과 KG이니시스를 선택하는 경우에만 채널 속성에서 `'본인인증'` 선택이 39 | 활성화 됩니다. 이 외 결제대행사 선택 시 `'본인인증'` 선택은 비활성화 됩니다. 40 | 41 | (관련 이미지 첨부) 42 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/console/2023-05-08.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-05-08T00:00:00.000Z 3 | writtenAt: 2023-05-11T00:00:00.000Z 4 | --- 5 | 6 | (관련 이미지 첨부) 7 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/console/2023-05-22.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-05-22T00:00:00.000Z 3 | writtenAt: 2023-05-25T00:00:00.000Z 4 | --- 5 | 6 | (관련 이미지 첨부) 7 | 8 |
9 | 10 | ## 주요 업데이트 사항 11 | 12 | ### ✔️ 페이코 직연동을 이용 중인 경우, 판매자용 매출전표가 표시됩니다 13 | 14 | 이번 업데이트를 통해 판매자용 매출전표가 표시되도록 수정했습니다. 15 | 관리자콘솔 \[결제 상세 내역 조회] - 결제 건 선택 - ‘승인 영수증’을 선택해 확인해보세요. 16 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/console/2023-07-05.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-07-05T00:00:00.000Z 3 | writtenAt: 2023-07-05T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ 전자결제 신청시 포트원 추천 패키지를 선택할 수 있습니다. 9 | 10 | 수많은 결제수단과 결제대행사 중 어떤 것이 우리 서비스에 알맞을지 고민됐다면, 포트원이 추천하는 결제수단과 결제대행사를 선택해서 전자결제를 신청하세요. 11 | 12 | 결제 데이터를 기반으로 증명된, 온라인 서비스를 운영 중인 기업이 가장 많이 이용하는 결제수단 네 13 | 가지를 제안합니다. 결제수단 선택시 포트원이 추천하는 결제대행사를 즉시 확인할 수 있습니다. 14 | 15 | 포트원 추천 패키지는 결제수단, 결제대행사 이용 비용, 결제형태와 연동방식을 종합적으로 고려하여 16 | 선별했습니다. 특정 결제수단과 결제대행사를 이용을 원한다면 \[전자결제 직접 선택하기]를 통해 자유롭게 17 | 골라보세요. 18 | 19 | (관련 이미지 첨부) 20 | 21 | ### ✔️ 전자결제 신청시 결제서비스의 모든 구성을 커스텀할 수 있습니다. 22 | 23 | 기존에는 결제수단을 선택한 후 다음 페이지에서 결제대행사와 결제형태를 확인할 수 있었기에 전자결제 신청 과정이 번거로웠습니다. 24 | 25 | 앞으로는 한 페이지에서 결제수단별로 이용 가능한 결제대행사를 확인하고, 결제형태까지 선택해보세요. 선택한 결제서비스는 장바구니에 담겨 즉시 확인하고 수정할 수 있습니다. 26 | 27 | 결제대행사별로 제공하는 결제수단이 궁금하다면, 우측 상단의 \[모든 결제대행사 보기]를 통해 포트원에서 지원하는 모든 결제대행사와 결제수단, 수수료까지 한 눈에 살펴보세요. 28 | 29 | (관련 이미지 첨부) 30 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/console/2023-07-07.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-07-07T00:00:00.000Z 3 | writtenAt: 2023-07-10T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **PG 거래대사**✔️ 엑심베이의 정산내역을 확인할 수 있습니다 9 | 10 | 이번 업데이트를 통해 처음으로 해외결제건의 정산내역을 조회할 수 있습니다. 11 | 관리자콘솔 \[정산]메뉴 - \[통합 내역 조회]에서 정산내역을 조회할 수 있으며, 엑심베이를 통한 7월 5일 결제건부터 확인할 수 있습니다.\ 12 | 엑심베이는 결제일로부터 2일 후에 결제일의 정산내역을 수신합니다. 13 | 이용에 참고바랍니다. 14 | 15 | 📍정산통합조회 서비스의 기능이 궁금하다면 [→ 서비스소개 보기](https://guide.portone.io/a89f61e5-4545-41ae-9b72-14f506adcac6)\ 16 | 📍이용 중인 PG사도 정산내역 조회가 가능한지 궁금하다면 17 | [→ 지원 PG사 확인하기](https://guide.portone.io/a89f61e5-4545-41ae-9b72-14f506adcac6)\ 18 | 📍정산통합조회 서비스의 이용방법이 궁금하다면 [→ 이용방법 보기](https://guide.portone.io/92af7604-5813-48fa-a186-82e8e7356a3e) 19 | 20 | ### **PG 거래대사**✔️ 정산 통화별로 정산내역을 조회할 수 있습니다 21 | 22 | 기존에는 원화로만 정산내역을 조회할 수 있엇지만, 이번 업데이트를 통해 결제통화 및 정산통화별로 정산내역을 조회할 수 있습니다. 23 | 또한 \[통합 내역 조회] 메뉴의 조회 기준일이 정산예정일에 맞추어 자동으로 설정됩니다. 24 | 25 | (관련 이미지 첨부) 26 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/console/2023-07-17.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-07-17T00:00:00.000Z 3 | writtenAt: 2023-07-19T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ KG이니시스 승인 영수증에서 신규 매출전표가 표시됩니다 9 | 10 | 이번 업데이트를 통해 관리자콘솔의 \[결제 내역 상세 조회] 메뉴에서 KG이니시스 결제건 선택시 승인 영수증에서 신규 매출전표가 표시됩니다. 11 | 12 |
13 | 14 | ## 기타 수정사항 15 | 16 | - 클래식 콘솔에서 결제내역 조회시 모든 PG사를 필터로 추가하여 검색할 수 있습니다 17 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/console/2023-08-23.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-08-23T00:00:00.000Z 3 | writtenAt: 2023-08-23T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **PG 거래대사**✔️ KG이니시스의 정산내역을 확인할 수 있습니다. 9 | 10 | 이번 업데이트를 통해 KG이니시스를 포함한 주요 10개 결제대행사(PG)/간편결제사의 정산 내역을 조회할 수 있습니다. 11 | 관리자콘솔 메뉴 \[결제사 정산] - \[통합 내역 조회]에서 정산 내역을 조회할 수 있으며, KG이니시스의 경우 8월 1일 결제건부터 조회가 가능하오니 이용에 참고하시기 바랍니다. 12 | 13 | 📍 정산 통합 조회 서비스의 기능이 궁금하다면 14 | [→ 서비스 소개 보기](https://guide.portone.io/a89f61e5-4545-41ae-9b72-14f506adcac6)\ 15 | 📍 이용 중인 결제대행사(PG사)도 정산 내역 조회가 가능한지 궁금하다면 16 | [→ 지원 결제대행사(PG)사 확인하기](https://guide.portone.io/a89f61e5-4545-41ae-9b72-14f506adcac6)\ 17 | 📍 정산 통합 조회 서비스의 이용 방법이 궁금하다면 [→ 이용 방법 보기](https://guide.portone.io/92af7604-5813-48fa-a186-82e8e7356a3e) 18 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/console/2023-09-12.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-09-15T00:00:00.000Z 3 | writtenAt: 2023-09-15T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ 전자결제 신청하기 페이지 리뉴얼 9 | 10 | 이번 업데이트를 통해 전자결제 신청 후 계약 진행 상황을 실시간을 볼 수 있는 상태값 조회 페이지가 개선되었습니다. 11 | 이외에 자세한 리뉴얼 상황은 아래와 같습니다. 12 | 13 | 📍 결제대행사별로, 계약 건별로 상황을 확인할 수 있습니다.\ 14 | 📍 계약 과정에서 필요한 서류 등 체크리스트를 확인할 수 있습니다.\ 15 | 📍 워드프레스/ 우커머스 사이트를 지원하는 결제대행사 정보를 확인하실 수 있습니다.\ 16 | 📍 포트원 추천패키지 상세 가이드가 추가되었습니다. 17 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/console/2023-12-27.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-12-27T00:00:00.000Z 3 | writtenAt: 2024-01-02T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **PG 거래대사**✔️ 헥토파이낸셜의 정산내역을 확인할 수 있습니다. 9 | 10 | 이번 업데이트를 통해 헥토파이낸셜을 포함한 11개 PG사와 간편결제사의 정산 내역을 조회할 수 있습니다. 11 | 관리자콘솔 메뉴 \[결제사 정산] - \[통합 내역 조회]에서 정산 내역을 조회할 수 있으며, 12 | 헥토파이낸셜의 경우 8월 1일 결제건부터 조회가 가능하오니 이용에 참고하시기 바랍니다. 13 | 14 | 📍 정산 통합 조회 서비스의 기능이 궁금하다면 15 | [→ 서비스 소개 보기](https://guide.portone.io/a89f61e5-4545-41ae-9b72-14f506adcac6)\ 16 | 📍 이용 중인 결제대행사(PG사)도 정산 내역 조회가 가능한지 궁금하다면 17 | [→ 지원 결제대행사(PG)사 확인하기](https://guide.portone.io/a89f61e5-4545-41ae-9b72-14f506adcac6)\ 18 | 📍 정산 통합 조회 서비스의 이용 방법이 궁금하다면 [→ 이용 방법 보기](https://guide.portone.io/92af7604-5813-48fa-a186-82e8e7356a3e) 19 | 20 | ## 기타 수정사항 21 | 22 | ### **결제 모듈 V1**✔️ KG이니시스 결제 시 결제 통화 위/변조 검사가 추가되었습니다. 23 | 24 | PC 환경에서 KG이니시스의 승인 요청시 결제 통화 및 결제 금액 위/변조 검사를 진행합니다. 25 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/console/2024-09-05.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-09-05T00:00:00.000Z 3 | writtenAt: 2024-09-05T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ 좌측 메뉴 영역이 새롭게 변경되었습니다. 9 | 10 | (관련 이미지 첨부) 11 | 12 | 기존 \[파트너 정산] 메뉴는 \[파트너 정산 자동화], \[애널리틱스] 메뉴는 \[결제 데이터 분석]으로 변경됩니다. 13 | 14 | - **\[메뉴 접기]** 15 | 16 | - 메뉴 접기 아이콘을 클릭하여 좌측 메뉴 영역을 접을 수 있습니다. 17 | - 메뉴가 접힌 상태에서 한번 더 클릭하는 경우 다시 메뉴를 펼칠 수 있습니다. 18 | 19 | - **\[전자결제 신청]** 20 | - 전자결제 신청을 원하시는 경우 좌측 메뉴 영역 하단의 \[전자결제 신청]을 클릭해 주세요. 21 | 22 | - **\[로그아웃]** 23 | - 좌측 메뉴 영역 상단의 \[계정 정보]를 클릭한 후 \[로그아웃]을 클릭해 주세요. 24 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/platform/2023-08-31.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-08-31T00:00:00.000Z 3 | writtenAt: 2023-09-01T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **파트너 정산 자동화**✔️ 파트너정산 서비스가 출시되었습니다. 9 | 10 | 플랫폼 및 마켓플레이스 사업자가 손쉽게 하위정산 할 수 있는 파트너정산 서비스가 런칭 되었습니다. 11 | 파트너(셀러) 등록, 계약 등록, 정산등록 과 같은 정산의 세밀한 모든 부분을 관리자 콘솔로 관리하세요! 12 | 해당 서비스는 유료 서비스입니다. 문의를 원하시면 신청()하시면 13 | 영업일 2일안에 연락드리겠습니다. 14 | 15 | [→ 파트너 정산 자동화 서비스 소개](https://portone.io/korea/ko/service/platform) 16 | [→ 파트너 정산 자동화 연동가이드 확인하기](https://developers.portone.io/platform/ko/readme) 17 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/platform/2023-11-14.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-11-14T00:00:00.000Z 3 | writtenAt: 2023-11-15T00:00:00.000Z 4 | --- 5 | 6 | 주문 정산 등록 API가 개선되며, 인증 토큰 발급과 관련하여 변경 사항이 있습니다. 7 | 8 | ## 주요 업데이트 사항 9 | 10 | ### ✔️ 주문 정산 등록 API가 개선되었습니다. 11 | 12 | - **paymentId** 기반으로 파트너당 여러 건의 주문 정산 건을 등록할 수 있게됩니다. 13 | - 추후 정산 아이디(transferId) 기반으로 주문 취소 정산을 등록할 수 있는 API도 개발 예정이며, 곧 안내드리겠습니다. 14 | 15 | ### ✔️ 주문 정산 삭제 API가 추가되었습니다. 16 | 17 | - 정산 아이디(transferId)를 기반하여 정산이 완료되지 않은(상태: 정산 예정, 정산 중) 정산 건을 삭제할 수 있습니다. 18 | - `DELETE /platform/transfers/{$id}` 요청 본문 없이 호출하여 사용하실 수 있습니다. 19 | 20 | ### ✔️ 인증 토큰 발급 시 일부 사항이 변경되었습니다. 21 | 22 | - graphql 중 `loginViaApiKey` mutation이 `loginViaApiSecret` 로 변경됩니다. 23 | 24 | - 따라서 rest api 중 `/login/api-key` api는 **deprecate**되고 25 | [API secret 를 사용한 토큰 발급 api](https://developers.portone.io/api/rest-v2/auth#post%20%2Flogin%2Fapi-secret)가 26 | 추가됩니다. 27 | 28 | - `/login/api-key`의 경우, 하위 호환성 보장을 위해 24년 3월까지 사용이 가능하나, 가급적 변경해주시길 바랍니다. 29 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/platform/2023-12-15.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2023-12-15T00:00:00.000Z 3 | writtenAt: 2023-12-15T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### **파트너 정산 자동화**✔️ 정산 건을 삭제할 수 있도록 변경 9 | 10 | 주문 정산 건, 취소 주문 정산 건, 수동 정산 건을 삭제할 수 있습니다. 단, 정산 건의 상태가 정산 예정, 정산 중일 경우에만 삭제가 가능합니다. 11 | 주문 정산 건의 경우 동일한 paymentId를 가진 취소 주문 정산 건이 등록되어있는 경우에는 삭제가 불가능합니다. 12 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/platform/2024-05-20.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-05-20T00:00:00.000Z 3 | writtenAt: 2024-05-20T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ 상세 내역 다운로드 API가 추가되었습니다. 9 | 10 | - \[상세 내역 조회] 페이지에서 정산 상세 내역을 CSV 파일로 다운로드할 수 있습니다. 11 | - 파일 다운로드 후 상세 내역을 확인하고 정산 명세서를 손쉽게 정리해보세요. 12 | 13 | (관련 이미지 첨부) 14 | 15 | ### ✔️ 예금주 조회 API 응답 본문이 변경되었습니다. 16 | 17 | - 예금주 조회 API 요청 후 정상 인증 완료 시 응답 본문에 `accountVerificationId`가 추가되었습니다. 18 | 19 | ### ✔️ 파트너 관리 API 요청/응답 본문이 일부 변경되었습니다. 20 | 21 | - 파트너 생성/다건 생성/수정 API 요청 시 파트너 유형이 비사업자 (원천징수납세자)인 경우, 22 | 생년월일을 선택적으로 등록할 수 있습니다. 23 | - 생년월일을 입력할 경우, 8자리로 입력 가능합니다. ex. (YYYYMMDD/YYYY-MM-DD)로 입력 가능 24 | 25 | - 파트너 조회/다건 조회/생성/다건 생성/수정/보관/복원 API 응답 시 파트너 사업자 상태 필드(`businessStatus`)가 26 | 추가되었습니다. 사업자등록번호(`businessRegistrationNumber`)가 변경되거나 기입하여 생성한 경우에 사업자 27 | 상태가 업데이트 됩니다. 28 | 29 | - 파트너 생성/수정 API 요청 시 예금주 계좌조회에 실패하더라도 파트너를 등록할 수 있습니다. 계좌조회가 30 | 어려운 경우 고객사가 직접 계좌 정보를 입력할 수 있습니다. 31 | - 예금주 조회에서 발급받은 `accountVerificationId`를 사용하여 추가적인 계좌 인증을 생략할 수 있습니다. 32 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/platform/2024-06-05.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-06-05T00:00:00.000Z 3 | writtenAt: 2024-06-05T00:00:00.000Z 4 | --- 5 | 6 | ## 주요 업데이트 사항 7 | 8 | ### ✔️ 파트너 관리 기능 업데이트 9 | 10 | (관련 이미지 첨부) 11 | 12 | - 과세 유형 등록 기능 업데이트 13 | - 파트너가 사업자인 경우, 과세 유형을 등록하고 수정할 수 있습니다. 14 | - 일반 과세 사업자, 간이 과세 사업자 - 세금계산서 발행 유형, 간이 과세 사업자 - 세금계산서 미발행 유형, 면세 사업자를 구분하여 저장할 수 있습니다. 15 | - 등록한 과세 유형은 파트너 관리 테이블에서 확인할 수 있습니다. 16 | 17 | - 파트너 관리 테이블 업데이트 18 | - 파트너별 과세 유형을 파트너 관리 테이블에서 확인할 수 있습니다. 19 | 20 | - 담당자 연락처 선택값으로 변경 21 | - 파트너 등록/수정 시 필수적으로 입력해야했던 담당자 정보 (휴대폰 번호)를 선택값으로 변경하였습니다. 22 | - 파트너의 휴대폰 번호가 없을 경우, 공란으로 등록/수정할 수 있습니다. 23 | 24 | ### ✔️ API 업데이트 25 | 26 | - 파트너 생성/조회/수정 API 27 | - 사업자 유형에 과세 유형(`taxationType`)이 추가되었습니다. 28 | 29 | - 파트너 생성 API 30 | - 담당자 정보의 휴대폰 번호(`phoneNumber`)가 선택 값으로 변경되었습니다. 31 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/platform/2024-07-30.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-07-30T00:00:00.000Z 3 | writtenAt: 2024-07-30T00:00:00.000Z 4 | --- 5 | 6 | 안녕하세요. 파트너 정산 자동화팀입니다. 7 | 8 | 24년 07월 30일, 서비스 개선 사항 안내드립니다. 9 | 10 | 파트너와 정산내역에 관한 사용자 정의 속성을 등록/ 관리할 수 있는 기능이 출시되었습니다. 11 | 12 | ## 주요 업데이트 사항 13 | 14 | ### ✔️ 파트너 사용자 정의 속성 15 | 16 | (이미지 첨부: 파트너 관리 > 파트너 사용자 정의 속성) 17 | 18 | - 파트너 관리 페이지에서 파트너 사용자 정의 속성을 등록할 수 있으며 최대 10개까지 추가 가능합니다. 19 | - 속성 이름은 등록 후에도 수정 가능합니다. 20 | - 보안에 민감한 정보도 관리할 수 있도록 각각의 속성 값의 조회 권한을 설정할 수 있습니다. 21 | - 등록된 값은 \[파트너 관리] 페이지와 \[정산 상세 조회] 페이지에서 확인 가능합니다. 22 | 23 | (이미지 첨부: 파트너 관리 > 파트너 정보 수정) 24 | 25 | - 파트너 정보 등록 / 파트너 정보 수정 시 속성 값을 지정할 수 있습니다. 26 | 27 | ### ✔️ 정산 사용자 정의 속성 28 | 29 | (이미지 첨부: 정산 상세 조회 > 정산 사용자 정의 속성) 30 | 31 | - 정산 상세 조회 페이지에서 정산 사용자 정의 속성을 등록할 수 있으며 최대 10개까지 추가 가능합니다. 32 | - 속성 이름은 등록 후에도 수정 가능합니다. 33 | - 보안에 민감한 정보도 관리할 수 있도록 각 속성 값의 조회 권한을 설정할 수 있습니다. 34 | 35 | (이미지 첨부: 정산 상세 조회) 36 | 37 | - 파트너 사용자 정의 속성값과 정산 사용자 정의 속성 값은 \[정산 상세 조회] 페이지에서 확인할 수 있습니다. 38 | - 관리자만 조회 가능할 수 있는 속성 칼럼은 비관리자가 조회 시 노출되지 않습니다. 39 | 40 | --- 41 | 42 | 감사합니다. 43 | 44 | 파트너정산 자동화 팀 드림 45 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/platform/2024-08-07.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2024-08-07T00:00:00.000Z 3 | writtenAt: 2024-08-07T00:00:00.000Z 4 | --- 5 | 6 | 안녕하세요 파트너 정산 자동화팀입니다. 7 | 8 | 24년 8월 7일, 서비스 업데이트 사항 안내드립니다. 9 | 10 | 지급 및 정산 내역의 다건 조회를 위한 API가 추가되었습니다. 11 | 12 | ## 주요 업데이트 사항 13 | 14 | ### ✔️ 지급/정산 내역 조회 API 지원 15 | 16 | (이미지 첨부: 정산 내역 관련 API > 정산 내역 다건 조회) 17 | 18 | - 정산내역 다건 조회 API가 추가되었습니다. 19 | 20 | (이미지 첨부: 지급 내역 관련 API > 지급 내역 다건 조회) 21 | 22 | - 지급 내역 다건 조회 API가 추가되었습니다. 23 | 24 | (이미지 첨부: 일괄 지급 내역 관련 API > 일괄 지급 내역 다건 조회) 25 | 26 | - 일괄 지급 내역 다건 조회 API가 추가되었습니다. 27 | 28 | ### ✔️ 수기 정산 건 임의 정산일 지원 29 | 30 | - 임의의 정산일을 지정해 수기 정산건을 등록할 수 있도록 변경되었습니다. 31 | - 모든 정산일을 지원함에 따라 PlatformUnavailableSettlementDateError 에러가 삭제되었습니다. 32 | 33 | --- 34 | 35 | 감사합니다. 36 | 37 | 파트너정산 자동화 팀 드림 38 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/platform/2025-02-13.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2025-02-13T00:00:00.000Z 3 | writtenAt: 2025-02-13T00:00:00.000Z 4 | --- 5 | 6 | 안녕하세요 파트너 정산 자동화팀입니다. 7 | 8 | 세금계산서 발행을 위한 **파트너 국세청 연동/연동해제 기능**을 REST API로 지원합니다. 9 | 10 | 이제 더욱 유연하게 파트너 정보를 국세청 시스템과 연동할 수 있습니다. 11 | 12 | ## ✔️ 파트너 국세청 연동/연동해제 REST API 제공 13 | 14 | - **단건 연동/연동해제 API** 지원 15 | - **다양한 필터링 조건**을 통한 **다건 연동/연동해제 API** 추가 16 | 17 | 신규 API 스키마는 개발자 센터에서 참조하실 수 있습니다. \[[개발자센터 바로 가기](https://developers.portone.io/api/rest-v2/platform.partner?v=v2#post%20%2Fplatform%2Fpartners%2Fmember-company-connect%2F%7Bid%7D)] 18 | 19 | 이제 API를 활용하여 **세금계산서 발행 프로세스를 더욱 간편하게 자동화**하세요! 🚀 20 | 21 | (관련 이미지 첨부) 22 | 23 | --- 24 | 25 | 감사합니다. 26 | 27 | 파트너정산 자동화 팀 드림 28 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/platform/2025-03-04.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2025-03-04T00:00:00.000Z 3 | writtenAt: 2025-03-04T00:00:00.000Z 4 | --- 5 | 6 | 안녕하세요, 파트너 정산 자동화팀입니다. 7 | 8 | 금번 업데이트 사항 공유 드립니다. 9 | 10 | ## ✅ 주요 업데이트 11 | 12 | ## ✔️ 1. 수기정산건 등록 시 즉시반영 13 | 14 | - **기존:** 정산 완료 상태의 수기 정산건 등록 후 **10분 후** 정산내역 관리에 반영 15 | 16 | - **변경:** 정산 완료 상태의 수기 정산건 등록 시 **즉시** 정산내역 관리에 반영 17 | - 수기 정산건 등록 후, **정산 내역 관리 페이지**에서 수기 정산건에 등록한 정산일이 포함된 기간으로 조회하면 **수기 정산건이 반영된 정산 내역을 즉시 확인 가능** 18 | 19 | - **경로:** 정산 상세 조회 > **수기 정산 등록 > 정산 내역 관리 페이지**에서 확인 가능 20 | 21 | (이미지 첨부: Step 1. 정산 상세 조회 페이지에서 수기정산건 등록) 22 | 23 | (이미지 첨부: Step 2. 수기 정산건 등록 시 정산 내역 관리 목록에서 즉시 확인 가능) 24 | 25 |
26 | 27 | ## ✔️ 2. 국세청 미연동 사업자번호 세금계산서 발행 제한 28 | 29 | - **기존:** 국세청 연동되지 않은 사업자번호도 세금계산서 **발행 요청 가능** → 공급자가 발행 페이지에서 오류 확인 30 | 31 | - **변경:** 국세청 미연동 사업자번호의 세금계산서 **발행 요청이 실패**하도록 개선 → 파트너의 오류 경험을 사전에 방지 32 | 33 | - **경로:** 34 | - 세금계산서 > 세금계산서 작성 > **일괄등록 (단건등록은 기존에도 국세청 미연동자 세금계산서 발행 제한)** 35 | - 세금계산서 > 세금계산서 목록 > **요청실패** 36 | 37 | (관련 이미지 첨부) 38 | 39 |
40 | 41 | 늘 파트너정산자동화 서비스를 이용해주셔 감사합니다. 42 | 43 | 자세한 사항은 [업데이트 상세보기](https://developers.portone.io/release-notes) 페이지에서 확인할 수 있습니다. 44 | 45 | --- 46 | 47 | 감사합니다. 48 | 49 | 파트너정산 자동화 팀 드림 50 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/release-notes/platform/2025-03-17.md: -------------------------------------------------------------------------------- 1 | --- 2 | releasedAt: 2025-03-17T00:00:00.000Z 3 | writtenAt: 2025-03-17T00:00:00.000Z 4 | --- 5 | 6 | 안녕하세요 파트너 정산 자동화 팀입니다. 7 | 8 | 세금계산서 역발행 기능에 대해 두 가지 주요 업데이트를 안내드립니다. 9 | 10 | ## ✔️ 1. 세금계산서 역발행 상태 변화 웹훅 기능 지원 11 | 12 | - 세금계산서 및 연동사업자의 상태 변경 시, **웹훅을 통해 실시간 알림을 제공합니다.** 13 | - 웹훅 사용을 희망하는 고객사는 문의 부탁드립니다. (상세 스펙 및 설정 지원) 14 | 15 | ## ✔️ 2. 사업자등록 정보조회 API 지원 16 | 17 | - **사업자등록번호만으로** 해당 사업자에 대한 **상세 정보를 조회**할 수 있습니다. [(API 확인하기)](https://developers.portone.io/api/rest-v2/platform.company?v=v2#post%20%2Fb2b%2Fcompanies%2Fbusiness-info) 18 | 19 | - 사업자등록번호를 입력하면 아래 항목들이 응답값으로 제공됩니다. (다건 지원이며, 건당 비용 발생) 20 | - **응답 항목:** 21 | 사업자등록번호, 상호, 대표자명, 우편번호, 주소, 사업자유형, 사업상태, 과세유형, 간이과세-일반과세전환일, 폐업일, 개업일, 업태, 종목, 업종코드, 법인등록번호, 전화번호, 관할세무서코드, 관할세무서명 22 | 23 | - 본 API를 활용하면 세금계산서 역발행 시 **파트너사의 사업자 정보를 자동으로 최신 상태로 업데이트**하여 **업무 효율성을 극대화**할 수 있습니다. 24 | 25 | ## 🔹 **사용 문의 경로** 26 | 27 | - 기존 파트너정산자동화 제품을 이용하고 계신 고객이더라도, 세금계산서 역발행 기능 사용을 위해서는 별도 문의가 필요합니다. 28 | 29 | - 세금계산서 상태변화 웹훅 및 사업자번호 기업정보조회 API 연동이 필요하신 고객사는 30 | [📩 support.b2b@portone.io](mailto:support.b2b@portone.io)로 문의해 주세요. 31 | 32 | 포트원의 전체 업데이트 소식은 [개발자센터 릴리즈노트](https://developers.portone.io/release-notes) 페이지에서 확인할 수 있습니다. 33 | 34 | 늘 파트너정산자동화 서비스를 이용해주셔 감사합니다. 35 | 36 | --- 37 | 38 | 감사합니다. 39 | 40 | 파트너정산 자동화 팀 드림 41 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v1-mobile-sdk/readme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 모바일 SDK 레퍼런스 3 | description: 포트원에서 제공하는 네이티브 모바일 SDK(플러그인)를 통해 포트원 서비스를 연동할 수 있습니다. 4 | targetVersions: 5 | - v1 6 | versionVariants: 7 | v2: /sdk/ko/v2-mobile-sdk/readme 8 | --- 9 | 10 | 포트원은 고객사에서 보다 쉽게 서비스를 이용하실 수 있도록 프로그래밍 언어 / 플랫폼 별 SDK 를 오픈소스로 운영하고 있습니다. 11 | 12 | 공식 지원중인 JavaScript SDK / REST API 이외에 이와 같은 오픈소스 프로젝트들은 현재 공식 지원 범위에 포함되지 않지만, 추후 포트원 V2 모듈을 비롯해 더욱 다양한 프로그래밍 언어 및 플랫폼 SDK 를 공식 지원하며 가장 쉬운 결제 연동 경험을 위한 지원을 전폭적으로 확대할 예정입니다. 13 | 14 | 앞으로 공식 지원을 통해 제공될 SDK 또한 모두 오픈소스로 운영될 예정이니, 자유로운 참여를 부탁드립니다. 15 | 16 | ## iOS/Android 17 | 18 | - [iOS](https://github.com/iamport/iamport-ios) 19 | - [Android](https://github.com/iamport/iamport-android) 20 | 21 | ## Cross-Platform Frameworks 22 | 23 | - [Flutter](https://github.com/iamport/iamport-flutter) 24 | - [Ionic](https://github.com/iamport/iamport-ionic) 25 | - [React Native](https://github.com/iamport/iamport-react-native) 26 | - [Cordova](https://github.com/iamport/iamport-cordova) 27 | - [Capacitor](https://github.com/iamport/iamport-Capacitor) 28 | 29 | ## REST API Client 30 | 31 | - [REST API Client](https://github.com/iamport/iamport-rest-client) 32 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v1-sdk/javascript-sdk-old/readme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Javascript SDK 3 | description: 결제창 연동시 호출 및 응답 파라미터를 확인 할 수 있습니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | 포트원 JavaScript SDK를 사용하면 웹사이트 또는 앱에서 결제창 또는 본인인증창과 연동할 수 있습니다. 9 | 10 | ## SDK Library 로드하기 11 | 12 | **포트원 JavaScript SDK**를 사용하기 위해서 먼저 해당 라이브러리를 다음과 같이 페이지에 추가해야 합니다. 13 | 해당 라이브러리는 CDN **(**)을 통한 14 | 사용을 권장합니다. 라이브러리가 로드되면, **IMP** 전역 객체를 **window** 객체의 프로퍼티로 접근하여 **IMP**의 함수들을 호출할 수 있습니다. 15 | 16 | ```html title="HTML" 17 | 18 | 22 | 23 | 27 | ``` 28 | 29 |
30 | 31 | **jQuery 1.0 이상이 설치**되어 있어야 합니다. 32 | 33 |
34 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v1-sdk/javascript-sdk/cft-rt.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 본인인증 결과 파라미터 3 | description: 본인인증 요청에 대해 반환되는 응답 정보를 확인합니다. 4 | targetVersions: 5 | - v1 6 | versionVariants: 7 | v2: /sdk/ko/v2-sdk/identity-verification-response 8 | --- 9 | 10 | ## rsp (object) 11 | 12 | - success: boolean 13 | 14 | **본인인증 성공여부** 15 | 16 | - error\_code: string 17 | 18 | **실패코드** 19 | 20 | - error\_msg: string 21 | 22 | **실패사유 문구** 23 | 24 | - imp\_uid: string 25 | 26 | **고유 본인인증 번호** 27 | 28 | - merchant\_uid: string 29 | 30 | **주문번호** 31 | 32 | 본인인증창 요청시 전달된 주문번호가 그대로 반환됩니다. 33 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v1-sdk/javascript-sdk/load-module-rt.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 모듈 로드 결과 파라미터 3 | description: 모듈로드 요청에 대해 반환되는 응답정보를 확인합니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | ## rsp (Object) 9 | 10 | **PG사별 module이 돌아옵니다. 결제연동 탭의 PG사별 모듈 연동 부분을 확인해주세요.** 11 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v1-sdk/javascript-sdk/load-module.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 모듈 로드 파라미터 3 | description: PG사의 모듈 로딩에 필요한 파라미터 정보를 가져옵니다. 4 | targetVersions: 5 | - v1 6 | --- 7 | 8 | ## 모듈로드 파라미터 정의 9 | 10 |
11 | 12 |
13 | 14 | ```ts title="Javascript SDK" 15 | await IMP.loadModule( 16 | "moduleType", 17 | { 18 | userCode: "Merchant ID", //// Example: imp00000000 19 | tierCode: "Tier Code", 20 | }, 21 | { 22 | //something loadModule option 23 | }, 24 | ); 25 | ``` 26 | 27 |
28 | 29 | 30 | 31 | 주요 파라미터 설명 32 | 33 | 34 | 35 | - moduleType: string 36 | 37 | **모듈 타입** 38 | 39 | - userCode: string 40 | 41 | **고객사 식별코드** 42 | 43 | `IMP` 로 시작하는 고객사 식별코드입니다. 44 | 45 | - tier\_code?: string 46 | 47 | **하위상점(Tier)의 고유코드** 48 | 49 | 알파벳 대문자 또는 숫자 3자리입니다. 50 | 51 |
52 | 53 |
54 | 55 |
56 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-mobile-sdk/readme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 모바일 SDK 레퍼런스 3 | description: 결제창 연동시 사용되는 SDK에 대한 설명 문서입니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-mobile-sdk/readme 8 | --- 9 | 10 | 포트원 모바일 SDK는 Javascript로 작성된 포트원 V2 SDK를 모바일 환경에서 모바일 플랫폼 네이티브 코드(Kotlin, Swift 등) 으로 사용 가능하도록 만들어진 SDK입니다. 11 | 12 | 현재는 Android SDK와 React Native만 지원하고 있으며, iOS, Flutter 등 다른 플랫폼에 대해서도 지원 예정입니다. 13 | 14 | ## Android SDK 15 | 16 | Android 네이티브 환경에서 사용 가능한 SDK 입니다. 해당 Git 레포지토리의 README.md 파일을 참고하여 사용하실 수 있습니다. 17 | 18 | - [Github 링크](https://github.com/portone-io/android-sdk) 19 | 20 | ## React Native 21 | 22 | React Native 환경에서 사용 가능한 SDK 입니다. 해당 Git 레포지토리의 README.md 파일을 참고하여 사용하실 수 있습니다. 23 | 24 | - [Github 링크](https://github.com/portone-io/react-native-sdk) 25 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/billing-key-and-pay-request.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: requestIssueBillingKeyAndPay 요청 형식 3 | description: requestIssueBillingKeyAndPay 호출 시 사용되는 파라미터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/payrq 8 | --- 9 | 10 |
11 | 12 | 아래의 경우 정책상 빌링키 발급과 초회 결제가 함께 일어나야 하므로 이용하는 함수입니다. 13 | 14 | - KG이니시스 휴대폰 결제 15 | - 웰컴페이먼츠 휴대폰 결제 16 | 17 | 위에 해당하지 않는 경우에는 `requestIssueBillingKey` 함수로 빌링키를 발급한 뒤, 별도로 결제를 호출해 주시기 바랍니다. 18 | 19 |
20 | 21 | ## `requestIssueBillingKeyAndPay` 요청 데이터 정의 22 | 23 | - request: IssueBillingKeyAndPayRequest 24 | 25 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/request/IssueBillingKeyAndPayRequest) 26 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/billing-key-and-pay-response.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: requestIssueBillingKeyAndPay 응답 형식 3 | description: requestIssueBillingKeyAndPay 호출 결과로 받는 데이터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/payrt 8 | --- 9 | 10 | ## `requestIssueBillingKeyAndPay` 응답 데이터 정의 11 | 12 | - response: IssueBillingKeyAndPayResponse 13 | 14 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/response/IssueBillingKeyAndPayResponse) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/billing-key-request.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: requestIssueBillingKey 요청 형식 3 | description: requestIssueBillingKey 호출 시 사용되는 파라미터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/payrq 8 | --- 9 | 10 |
11 | 12 | 아래의 경우에는 정책상 빌링키 발급과 초회 결제가 함께 일어나야 하므로 `requestIssueBillingKeyAndPay` 함수를 이용해 주세요. 13 | 14 | - KG이니시스 휴대폰 결제 15 | - 웰컴페이먼츠 휴대폰 결제 16 | 17 |
18 | 19 | ## `requestIssueBillingKey` 요청 데이터 정의 20 | 21 | - request: IssueBillingKeyRequest 22 | 23 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/request/IssueBillingKeyRequest) 24 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/billing-key-response.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: requestIssueBillingKey 응답 형식 3 | description: requestIssueBillingKey 호출 결과로 받는 데이터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/payrt 8 | --- 9 | 10 | ## `requestIssueBillingKey` 응답 데이터 정의 11 | 12 | - response: IssueBillingKeyResponse 13 | 14 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/response/IssueBillingKeyResponse) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/changelog.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 버전별 Changelog 3 | description: '@portone/browser-sdk 패키지의 버전별 변경 사항을 확인하세요.' 4 | targetVersions: 5 | - v2 6 | --- 7 | 8 | [SDK Changelog](https://developers.portone.io/sdk/ko/v2-sdk/changelog) 9 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/identity-verification-request.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: requestIdentityVerification 요청 형식 3 | description: requestIdentityVerification 호출 시 사용되는 파라미터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/cft 8 | --- 9 | 10 | ## `requestIdentityVerification` 요청 데이터 정의 11 | 12 | - request: IdentityVerificationRequest 13 | 14 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/request/IdentityVerificationRequest) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/identity-verification-response.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: requestIdentityVerification 응답 형식 3 | description: requestIdentityVerification 호출 결과로 받는 데이터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/cft-rt 8 | --- 9 | 10 | ## `requestIdentityVerification` 응답 데이터 정의 11 | 12 | - response: IdentityVerificationResponse 13 | 14 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/response/IdentityVerificationResponse) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/load-issue-billing-key-ui-request.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: loadIssueBillingKeyUI 요청 형식 3 | description: loadIssueBillingKeyUI 호출 시 사용되는 파라미터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/payrq 8 | --- 9 | 10 | ## `loadIssueBillingKeyUI` 요청 데이터 정의 11 | 12 | - request: LoadIssueBillingKeyUIRequest 13 | 14 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/request/LoadIssueBillingKeyUIRequest) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/load-issue-billing-key-ui-response.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: loadIssueBillingKeyUI 응답 형식 3 | description: loadIssueBillingKeyUI 호출 결과로 받는 데이터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/payrt 8 | --- 9 | 10 | ## `loadIssueBillingKeyUI` 응답 데이터 정의 11 | 12 | ### onIssueBillingKeySuccess 13 | 14 | - response: IssueBillingKeyResponse 15 | 16 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/response/IssueBillingKeyResponse) 17 | 18 | ### onIssueBillingKeyFail 19 | 20 | - response: IssueBillingKeyError 21 | 22 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/exception/IssueBillingKeyError) 23 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/load-payment-ui-request.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: loadPaymentUI 요청 형식 3 | description: loadPaymentUI 호출 시 사용되는 파라미터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/payrq 8 | --- 9 | 10 | ## `loadPaymentUI` 요청 데이터 정의 11 | 12 | - request: LoadPaymentUIRequest 13 | 14 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/request/LoadPaymentUIRequest) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/load-payment-ui-response.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: loadPaymentUI 응답 형식 3 | description: loadPaymentUI 호출 결과로 받는 데이터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/payrt 8 | --- 9 | 10 | ## `loadPaymentUI` 응답 데이터 정의 11 | 12 | ### onPaymentSuccess 13 | 14 | - response: PaymentResponse 15 | 16 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/response/PaymentResponse) 17 | 18 | ### onPaymentFail 19 | 20 | - response: PaymentError 21 | 22 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/exception/PaymentError) 23 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/payment-request.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: requestPayment 요청 형식 3 | description: requestPayment 호출 시 사용되는 파라미터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/payrq 8 | --- 9 | 10 | ## `requestPayment` 요청 데이터 정의 11 | 12 | - request: PaymentRequest 13 | 14 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/request/PaymentRequest) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/payment-response.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: requestPayment 응답 형식 3 | description: requestPayment 호출 결과로 받는 데이터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/payrt 8 | --- 9 | 10 | ## `requestPayment` 응답 데이터 정의 11 | 12 | - response: PaymentResponse 13 | 14 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/response/PaymentResponse) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/update-load-issue-billing-key-ui-request.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: updateLoadIssueBillingKeyUIRequest 요청 형식 3 | description: updateLoadIssueBillingKeyUIRequest 호출 시 사용되는 파라미터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/payrq 8 | --- 9 | 10 | ## `updateLoadIssueBillingKeyUIRequest` 요청 데이터 정의 11 | 12 | - request: LoadIssueBillingKeyUIRequest 13 | 14 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/request/LoadIssueBillingKeyUIRequest) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/docs/sdk/ko/v2-sdk/update-load-payment-ui-request.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: updateLoadPaymentUIRequest 요청 형식 3 | description: updateLoadPaymentUIRequest 호출 시 사용되는 파라미터의 형식을 확인할 수 있습니다. 4 | targetVersions: 5 | - v2 6 | versionVariants: 7 | v1: /sdk/ko/v1-sdk/javascript-sdk/payrq 8 | --- 9 | 10 | ## `updateLoadPaymentUIRequest` 요청 데이터 정의 11 | 12 | - request: LoadPaymentUIRequest 13 | 14 | [definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/request/LoadPaymentUIRequest) 15 | -------------------------------------------------------------------------------- /src/portone_mcp_server/resources/instructions.md: -------------------------------------------------------------------------------- 1 | # portone-mcp-server 2 | 3 | portone-mcp-server는 포트원의 문서를 검색하고 읽을 수 있는 도구(MCP tool)들을 제공합니다. 4 | 5 | ## 예외 없이 지켜야 할 규칙들 (앞선 규칙이 더 우선순위 높음) 6 | 7 | - 포트원 V2에 관련해 프로그래밍 언어로 코드를 작성해야 한다면, 예외 없이 가장 먼저 read_portone_v2_frontend_code, read_portone_v2_backend_code tool들을 호출해 예시 코드를 참고한 후 사용자를 도우세요. 8 | 9 | - 포트원 V1, V2 API를 직접 호출하는 코드를 작성해야 하는 경우 read_portone_openapi_schema_summary, read_portone_openapi_schema tool들을 호출해 정확한 스펙을 확인한 후 사용자를 도우세요. 10 | 11 | - 사용자가 포트원 관련 내용을 질의하는 경우 이미 학습하고 있는 내용일지라도, portone-mcp-server가 제공하는 tool들을 통해 내용을 더블체크한 후 사용자를 도와야 합니다. 12 | 13 | ## 기타 14 | 15 | - 포트원 V2 API를 직접 호출하는 코드를 작성해야 하는 경우 `Bearer` 보다 `PortOne` 인증 스킴을 우선적으로 사용하세요. 16 | 17 | - `help/`로 시작하는 경로의 문서는 기술 외적인 내용을 다루는 [포트원 헬프센터](https://help.portone.io)의 문서이며, 나머지는 모두 [포트원 개발자센터](https://developers.portone.io)를 중심으로 한 기술 관련 문서입니다. 18 | 19 | - 추가적인 맥락이 필요한 경우 GitHub 저장소 및 레퍼런스 링크를 문서 내에서 찾아, web fetch를 통해 구체적인 사용 방법을 파악할 수 있습니다. 20 | -------------------------------------------------------------------------------- /src/portone_mcp_server/server.py: -------------------------------------------------------------------------------- 1 | from mcp.server.fastmcp import FastMCP 2 | 3 | from .loader import load_resources 4 | from .tools import ( 5 | list_docs, 6 | read_doc, 7 | read_doc_metadata, 8 | read_openapi_schema, 9 | read_openapi_schema_summary, 10 | read_v2_backend_code, 11 | read_v2_frontend_code, 12 | regex_search, 13 | ) 14 | 15 | 16 | def run_server(): 17 | # Load documents 18 | resources = load_resources() 19 | documents = resources.documents 20 | 21 | # Initialize the MCP server 22 | mcp = FastMCP( 23 | "portone-mcp-server", 24 | instructions=resources.instructions + "\n" + documents.readme, 25 | ) 26 | 27 | # Initialize tools 28 | mcp.add_tool(list_docs.initialize(documents)) 29 | mcp.add_tool(read_doc_metadata.initialize(documents)) 30 | mcp.add_tool(read_doc.initialize(documents)) 31 | mcp.add_tool(regex_search.initialize(documents)) 32 | mcp.add_tool(read_openapi_schema_summary.initialize(documents.schema)) 33 | mcp.add_tool(read_openapi_schema.initialize(documents.schema)) 34 | 35 | api_base_path = "https://developers.portone.io" 36 | mcp.add_tool(read_v2_backend_code.initialize(api_base_path)) 37 | mcp.add_tool(read_v2_frontend_code.initialize(api_base_path)) 38 | 39 | # Run the server 40 | mcp.run("stdio") 41 | -------------------------------------------------------------------------------- /src/portone_mcp_server/tools/read_doc.py: -------------------------------------------------------------------------------- 1 | from ..loader import Documents 2 | 3 | 4 | def initialize(documents: Documents): 5 | def read_portone_doc(path: str) -> str: 6 | """포트원 개별 문서의 경로를 통해 해당 포트원 문서의 내용을 가져옵니다. 7 | 8 | Args: 9 | path: 읽을 포트원 문서의 경로 10 | 11 | Returns: 12 | 포트원 문서를 찾으면 해당 내용을 반환하고, 찾지 못하면 오류 메시지를 반환합니다 13 | 14 | Note: 15 | 먼저 list_portone_docs을 사용해 포트원 문서 목록을 확인하고, 16 | 그 중 원하는 문서의 path를 read_portone_doc에 전달하여 내용을 확인할 수 있습니다. 17 | """ 18 | # Check in markdown documents - direct dictionary access 19 | if path in documents.markdown_docs: 20 | return documents.markdown_docs[path].content 21 | 22 | # Document not found 23 | return f"Error: Document with path '{path}' not found." 24 | 25 | return read_portone_doc 26 | -------------------------------------------------------------------------------- /src/portone_mcp_server/tools/read_doc_metadata.py: -------------------------------------------------------------------------------- 1 | from ..loader import Documents 2 | from .utils.markdown import format_document_metadata 3 | 4 | 5 | def initialize(documents: Documents): 6 | def read_portone_doc_metadata(path: str) -> str: 7 | """포트원 개별 문서의 경로를 통해 해당 포트원 문서의 제목, 설명, 대상 버전을 포함한 메타 정보 전체를 가져옵니다. 8 | 9 | Args: 10 | path: 읽을 포트원 문서의 경로 11 | 12 | Returns: 13 | 포트원 문서를 찾으면 해당 메타 정보를 반환하고, 찾지 못하면 오류 메시지를 반환합니다 14 | """ 15 | # Check in markdown documents - direct dictionary access 16 | if path in documents.markdown_docs: 17 | return format_document_metadata(documents.markdown_docs[path], full=True) 18 | 19 | # Document not found 20 | return f"Error: Document with path '{path}' not found." 21 | 22 | return read_portone_doc_metadata 23 | -------------------------------------------------------------------------------- /src/portone_mcp_server/tools/read_openapi_schema.py: -------------------------------------------------------------------------------- 1 | from typing import Literal 2 | 3 | import yaml 4 | 5 | from ..loader import Schema 6 | from .utils.yaml import sub_yaml 7 | 8 | 9 | def initialize(schema: Schema): 10 | def read_portone_openapi_schema(version: Literal["V1", "V2"], path: list[str]) -> str: 11 | """요청된 포트원 버전에서 제공하는 OpenAPI 스키마 내 특정 path의 데이터를 반환합니다. 12 | 13 | Args: 14 | version: 포트원 버전 ("V1" or "V2") 15 | path: OpenAPI 스키마 내의 yaml path (list of strings) 16 | 키 또는 인덱스(0부터 시작)를 포함할 수 있습니다. 17 | 18 | Returns: 19 | OpenAPI 스키마를 최대 depth 3으로 요약한 YAML 형식의 문자열을 반환합니다. 20 | """ 21 | # Get the parsed YAML data from the schema 22 | if version == "V2": 23 | yaml_data = schema.openapi_v2_yml 24 | elif version == "V1": 25 | yaml_data = schema.openapi_v1_yml 26 | else: 27 | return f"Error: Invalid version '{version}'. You need to specify 'V1' or 'V2'." 28 | 29 | # Get the sub-data from the path 30 | sub_data = sub_yaml(yaml_data, path) 31 | 32 | # Convert the sub-data to a YAML string 33 | return yaml.dump(sub_data, default_flow_style=False, sort_keys=False, allow_unicode=True) 34 | 35 | return read_portone_openapi_schema 36 | -------------------------------------------------------------------------------- /src/portone_mcp_server/tools/read_openapi_schema_summary.py: -------------------------------------------------------------------------------- 1 | from typing import Literal 2 | 3 | import yaml 4 | 5 | from ..loader import Schema 6 | from .utils.yaml import prune_yaml 7 | 8 | 9 | def initialize(schema: Schema): 10 | def read_portone_openapi_schema_summary(version: Literal["V1", "V2"]) -> str: 11 | """요청된 포트원 버전에서 제공하는 OpenAPI 스키마를 요약해 문자열로 반환합니다. 12 | 해당 요약에는 요청된 포트원 버전에서 제공하는 모든 REST API가 포함되어 있습니다. 13 | 14 | Args: 15 | version: 포트원 버전 ("V1" or "V2") 16 | 17 | Returns: 18 | OpenAPI 스키마를 최대 depth 3으로 요약한 YAML 형식의 문자열을 반환합니다. 19 | """ 20 | # Get the parsed YAML data from the schema 21 | if version == "V2": 22 | yaml_data = schema.openapi_v2_yml 23 | elif version == "V1": 24 | yaml_data = schema.openapi_v1_yml 25 | else: 26 | return f"Error: Invalid version '{version}'. You need to specify 'V1' or 'V2'." 27 | 28 | # Prune the YAML data 29 | pruned_data = prune_yaml(yaml_data, max_depth=3) 30 | 31 | # Convert the pruned data back to a YAML string 32 | return yaml.dump(pruned_data, default_flow_style=False, sort_keys=False, allow_unicode=True) 33 | 34 | return read_portone_openapi_schema_summary 35 | -------------------------------------------------------------------------------- /src/portone_mcp_server/tools/utils/markdown.py: -------------------------------------------------------------------------------- 1 | from typing import Any, Dict 2 | 3 | import yaml 4 | 5 | from ...loader.markdown import MarkdownDocument 6 | 7 | 8 | def format_document_metadata(doc: MarkdownDocument, full: bool = False) -> str: 9 | """ 10 | Format a document's metadata into a string. 11 | 12 | Args: 13 | doc: a MarkdownDocument object 14 | full: whether to include all frontmatter fields. If False, only title, description, and targetVersions are included. 15 | 16 | Returns: 17 | Formatted string with document path, length and frontmatter fields 18 | """ 19 | 20 | metadata: Dict[str, Any] = { 21 | "path": doc.path, 22 | } 23 | 24 | if doc.frontmatter: 25 | frontmatter = doc.frontmatter 26 | if full: 27 | metadata["contentLength"] = len(doc.content) 28 | metadata.update(frontmatter.all_fields_dict) 29 | else: 30 | if frontmatter.title: 31 | metadata["title"] = frontmatter.title 32 | if frontmatter.description: 33 | metadata["description"] = frontmatter.description 34 | if frontmatter.targetVersions: 35 | metadata["targetVersions"] = frontmatter.targetVersions 36 | 37 | dict_string = yaml.dump(metadata, default_flow_style=False, allow_unicode=True, sort_keys=False) 38 | 39 | return dict_string 40 | -------------------------------------------------------------------------------- /tests/__init__.py: -------------------------------------------------------------------------------- 1 | 2 | --------------------------------------------------------------------------------