@portone/mcp-server 0.15.0-alpha.5 → 0.16.0

package/assets/docs/schema/browser-sdk.yml

@@ -33,6 +33,10 @@ flags:
     description: KG이니시스(일본)
   payletter_global:
     description: 페이레터해외결제
+  triple_a:
+    description: Triple-A
+  paymentwall:
+    description: 페이먼트월
 resources:
   entity:
     Address:
@@ -213,6 +217,27 @@ resources:
         MIRAE_ASSET_SECURITIES:
           description: 미래에셋증권 카드
       valuePrefix: CARD_COMPANY
+    CardPromotion:
+      type: object
+      description: |
+        **카드 프로모션 정보**
+
+        카드사 다이렉트 호출 시 적용할 카드사 할인 쿠폰 정보입니다.
+
+        현재 KCP_V2 채널에서만 사용 가능합니다.
+      properties:
+        promotionId:
+          type: string
+          description: |
+            **프로모션 ID**
+
+            카드사에서 제공하는 프로모션 식별자입니다.
+        discountAmount:
+          type: integer
+          description: |
+            **할인 금액**
+
+            프로모션으로 할인받을 금액입니다.
     Carrier:
       type: enum
       description: |
@@ -1120,7 +1145,7 @@ resources:
           description: |
             **구매자 ID**
 
-            스마트로, KG이니시스 SBPS 일본결제에서 사용합니다.
+            스마트로, KG이니시스 SBPS 일본결제, Triple-A에서 사용합니다.
 
             토스페이먼츠와 스마트로의 빌링키 발급에서 사용합니다.
 
@@ -1141,6 +1166,10 @@ resources:
             <PgSection pgName={(name) => ['inicis'].includes(name)}>
             KG이니시스 SBPS 일본결제에서 필수입니다. 이 경우 30자 이내여야 합니다.
             </PgSection>
+
+            <PgSection pgName={(name) => ['triple_a'].includes(name)}>
+            Triple-A에 전달됩니다. 값이 없으면 포트원에서 자동으로 생성합니다.
+            </PgSection>
         fullName:
           type: string
           optional: true
@@ -1180,6 +1209,10 @@ resources:
             <PgSection pgName={(name) => ['hyphen'].includes(name)}>
             하이픈에서는 필수입니다.
             </PgSection>
+
+            <PgSection pgName={(name) => ['triple_a'].includes(name)}>
+            Triple-A에 전달됩니다.
+            </PgSection>
         firstName:
           type: string
           optional: true
@@ -1200,8 +1233,6 @@ resources:
           description: |
             **구매자 휴대전화 번호**
 
-            숫자만 입력합니다.
-
             <PgSection pgName={(name) => ['tosspayments'].includes(name)}>
             토스페이먼츠에 전달됩니다. 퀵계좌이체, 가상계좌에서 기본값으로 사용되고, UI에서 변경 가능합니다.
             </PgSection>
@@ -1221,6 +1252,10 @@ resources:
             <PgSection pgName={(name) => ['smartro'].includes(name)}>
             스마트로에 전달됩니다.
             </PgSection>
+
+            <PgSection pgName={(name) => ['triple_a'].includes(name)}>
+            Triple-A에 전달됩니다. `+6591234567`과 같이 `+(국가코드)`로 시작하는 [E.164](https://www.itu.int/rec/T-REC-E.164/) 형식의 전화번호를 입력합니다.
+            </PgSection>
         email:
           type: string
           optional: true
@@ -1250,12 +1285,20 @@ resources:
             <PgSection pgName={(name) => ['smartro'].includes(name)}>
             스마트로에 전달됩니다. 최대 60자입니다.
             </PgSection>
+
+            <PgSection pgName={(name) => ['triple_a'].includes(name)}>
+            Triple-A에 전달됩니다.
+            </PgSection>
         address:
           type: resourceRef
           $ref: "#/resources/entity/Address"
           optional: true
           description: |
             **구매자 주소**
+
+            <PgSection pgName={(name) => ['triple_a'].includes(name)}>
+            Triple-A에 전달됩니다.
+            </PgSection>
         zipcode:
           type: string
           optional: true
@@ -1449,6 +1492,58 @@ resources:
           description: |
             Merpay
             - KG이니시스 JPPG 일본결제
+        ALIPAY:
+          description: |
+            Alipay
+            - KICC V2 알리페이 플러스
+        ALIPAY_HK:
+          description: |
+            Alipay (HK)
+            - KICC V2 알리페이 플러스
+        TRUE_MONEY:
+          description: |
+            TrueMoney
+            - KICC V2 알리페이 플러스
+        TOUCH_N_GO:
+          description: |
+            Touch'n Go eWallet
+            - KICC V2 알리페이 플러스
+        GCASH:
+          description: |
+            GCash
+            - KICC V2 알리페이 플러스
+        DANA:
+          description: |
+            DANA
+            - KICC V2 알리페이 플러스
+        RABBIT_LINE_PAY:
+          description: |
+            Rabbit LINE Pay
+            - KICC V2 알리페이 플러스
+        BPI:
+          description: |
+            BPI (Bank of the Philippine Islands)
+            - KICC V2 알리페이 플러스
+        BOOST:
+          description: |
+            Boost
+            - KICC V2 알리페이 플러스
+        BILL_EASE:
+          description: |
+            BillEase
+            - KICC V2 알리페이 플러스
+        TINABA:
+          description: |
+            Tinaba
+            - KICC V2 알리페이 플러스
+        MPAY:
+          description: |
+            MPay
+            - KICC V2 알리페이 플러스
+        KREDIVO:
+          description: |
+            Kredivo
+            - KICC V2 알리페이 플러스
       valuePrefix: EASY_PAY_PROVIDER
     FreeInstallmentPlan:
       type: object
@@ -1689,6 +1784,7 @@ resources:
             - 웰컴페이먼츠 (PC)
             - 한국결제네트웍스
             - 엑심베이
+            - 페이먼트월
         EN_US:
           description: |
             영어
@@ -1698,36 +1794,144 @@ resources:
             - 웰컴페이먼츠 (PC)
             - 한국결제네트웍스
             - 엑심베이
+            - Triple-A
+            - 페이먼트월
         ZH_CN:
           description: |
             중국어 (중국 본토)
             - KG이니시스 (PC)
             - 웰컴페이먼츠 (PC)
             - 엑심베이
+            - Triple-A
+            - 페이먼트월
         ZH_TW:
           description: |
             중국어 (대만)
             - 엑심베이
+            - Triple-A
+            - 페이먼트월
         JA_JP:
           description: |
             일본어
             - 엑심베이
+            - Triple-A
+            - 페이먼트월
         RU_RU:
           description: |
             러시아어
             - 엑심베이
+            - Triple-A
+            - 페이먼트월
         TH_TH:
           description: |
             타이어
             - 엑심베이
+            - 페이먼트월
         VI_VN:
           description: |
             베트남어
             - 엑심베이
+            - Triple-A
+            - 페이먼트월
+        ID_ID:
+          description: |
+            인도네시아어
+            - Triple-A
+        FR_FR:
+          description: |
+            프랑스어
+            - Triple-A
+            - 페이먼트월
+        NL_NL:
+          description: |
+            네덜란드어
+            - Triple-A
+            - 페이먼트월
+        ES_ES:
+          description: |
+            에스파냐어
+            - Triple-A
+            - 페이먼트월
+        PT_PT:
+          description: |
+            포르투갈어
+            - Triple-A
+            - 페이먼트월
+        DE_DE:
+          description: |
+            독일어
+            - Triple-A
+            - 페이먼트월
+        IT_IT:
+          description: |
+            이탈리아어
+            - Triple-A
+            - 페이먼트월
+        PL_PL:
+          description: |
+            폴란드어
+            - Triple-A
+            - 페이먼트월
+        AR_001:
+          description: |
+            현대 표준 아랍어
+            - Triple-A
+        TR_TR:
+          description: |
+            터키어
+            - 페이먼트월
+        SV_SE:
+          description: |
+            스웨덴어
+            - 페이먼트월
+        FI_FI:
+          description: |
+            핀란드어
+            - 페이먼트월
+        UK_UA:
+          description: |
+            우크라이나어
+            - 페이먼트월
+        EL_GR:
+          description: |
+            그리스어
+            - 페이먼트월
+        TL_PH:
+          description: |
+            타갈로그어
+            - 페이먼트월
+        HI_IN:
+          description: |
+            힌디어
+            - 페이먼트월
+        HR_HR:
+          description: |
+            크로아티아어
+            - 페이먼트월
+        LT_LT:
+          description: |
+            리투아니아어
+            - 페이먼트월
+        SL_SI:
+          description: |
+            슬로베니아어
+            - 페이먼트월
+        SR_RS:
+          description: |
+            세르비아어
+            - 페이먼트월
+        BG_BG:
+          description: |
+            불가리아어
+            - 페이먼트월
+        PT_BR:
+          description: |
+            포르투갈어 (브라질)
+            - 페이먼트월
       description: |
         **UI 언어**
 
-        KG이니시스, 스마트로, KSNET, 웰컴페이먼츠 (PC), 한국결제네트웍스, 엑심베이에서 설정 가능하며, PG마다 지원하는 언어 목록은 차이가 있습니다.
+        KG이니시스, 스마트로, KSNET, 웰컴페이먼츠 (PC), 한국결제네트웍스, 엑심베이, Triple-A, 페이먼트월에서 설정 가능하며, PG마다 지원하는 언어 목록은 차이가 있습니다.
     OfferPeriod:
       type: oneOf
       properties:
@@ -1807,6 +2011,8 @@ resources:
           description: 알리페이
         CONVENIENCE_STORE:
           description: 편의점 결제
+        ALIPAY_PLUS:
+          description: 알리페이 플러스
       description: |
         **결제수단 구분코드**
 
@@ -1832,10 +2038,20 @@ resources:
       properties:
         id:
           type: string
-          description: "**상품 ID**"
+          description: |
+            **상품 ID**
+
+            <PgSection pgName={(name) => ['triple_a'].includes(name)}>
+            Triple-A에 전달됩니다.
+            </PgSection>
         name:
           type: string
-          description: "**상품명**"
+          description: |
+            **상품명**
+
+            <PgSection pgName={(name) => ['triple_a'].includes(name)}>
+            Triple-A에 전달됩니다.
+            </PgSection>
         code:
           type: string
           optional: true
@@ -1850,15 +2066,26 @@ resources:
           description: |
             **상품 단위 가격**
 
-            결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
+            상품의 단위당 가격을 정수로 나타냅니다.
+
+            해외 통화의 경우 통화의 최소 단위(minor unit)를 기준으로 합니다. 예를 들어, USD의 최소 단위는 센트(0.01 USD)이므로, 6 USD의 경우 100배하여 600으로 입력합니다.
 
-            - 1000 만큼 원화(KRW) 결제를 하는 경우, scale factor가 0이기 때문에 **1000 \* (10의 0승) = 1000**을 전달해야 합니다.
-            - 1.50 만큼 달러(USD) 결제를 하는 경우, scale factor가 2이기 때문에 **1.50 \* (10의 2승) = 150**을 전달해야 합니다.
+            최소 단위는 [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)에 표준화된 것을 기준으로 합니다.
+            - KRW: 1배
+            - USD: 100배
+            - JPY: 1배
 
-            이렇게 전달 된 값은 실제로 PG사에 결제를 요청할때 currency에 따라 올바른 값으로 변환되기 때문에 반드시 currency값을 필수로 입력해야 합니다.
+            <PgSection pgName={(name) => ['triple_a'].includes(name)}>
+            Triple-A에 전달됩니다.
+            </PgSection>
         quantity:
           type: integer
-          description: "**상품 수량**"
+          description: |
+            **상품 수량**
+
+            <PgSection pgName={(name) => ['triple_a'].includes(name)}>
+            Triple-A에 전달됩니다.
+            </PgSection>
         tag:
           type: string
           optional: true
@@ -4517,6 +4744,71 @@ resources:
               description: |
                 고객사 서비스명, WeChatPay, Alipay 이용 시 필수 입력
               optional: true
+        TripleA:
+          type: object
+          description: "Triple-A bypass 파라미터"
+          name: TripleABypass
+          properties:
+            payer_poi:
+              type: string
+              description: |
+                **결제자 신원 증명 정보**
+
+                신분증, 여권 등 결제자의 신원을 증명할 수 있는 자료의 URL을 입력합니다.
+
+                SGD 1500 이상의 결제 등 결제자 신원 조회가 필요한 경우에, `payer_poi`를 입력하면 별도의 신원 요청 과정을 거치지 않고 결제가 진행됩니다.
+              optional: true
+            shipping_cost:
+              type: integer
+              description: |
+                **배송비**
+
+                결제창에 표시할 배송비를 정수로 나타냅니다.
+                `products`가 지정된 경우에만 사용할 수 있습니다.
+
+                해외 통화의 경우 통화의 최소 단위(minor unit)를 기준으로 합니다. 예를 들어, USD의 최소 단위는 센트(0.01 USD)이므로, 6 USD의 경우 100배하여 600으로 입력합니다.
+
+                최소 단위는 [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)에 표준화된 것을 기준으로 합니다.
+                - KRW: 1배
+                - USD: 100배
+                - JPY: 1배
+              optional: true
+            shipping_discount:
+              type: integer
+              description: |
+                **배송비 할인 금액**
+
+                결제창에 표시할 배송비 할인 금액을 정수로 나타냅니다.
+                `products`가 지정된 경우에만 사용할 수 있습니다.
+              optional: true
+            tax_cost:
+              type: integer
+              description: |
+                **세금**
+
+                결제창에 표시할 세금을 정수로 나타냅니다.
+                `products`가 지정된 경우에만 사용할 수 있습니다.
+              optional: true
+        Paymentwall:
+          type: object
+          description: 'Paymentwall bypass 파라미터'
+          name: PaymentwallBypass
+          properties:
+            widget:
+              type: string
+              description: |
+                **위젯 코드**
+              optional: true
+            ps:
+              type: string
+              description: |
+                **결제수단 코드**
+              optional: true
+            country_code:
+              type: string
+              description: |
+                **국가 코드 (ISO 3166 두 자리)**
+              optional: true
       PaymentBypass:
         type: object
         description: |
@@ -4641,6 +4933,20 @@ resources:
             flagOptions:
               payletter_global:
                 visible: true
+          triple_a:
+            type: resourceRef
+            optional: true
+            $ref: "#/resources/entity/bypass/payment/TripleA"
+            flagOptions:
+              triple_a:
+                visible: true
+          paymentwall:
+            type: resourceRef
+            optional: true
+            $ref: "#/resources/entity/bypass/payment/Paymentwall"
+            flagOptions:
+              paymentwall:
+                visible: true
     OfferPeriodRange:
       type: union
       description: |
@@ -5287,6 +5593,17 @@ resources:
           type: resourceRef
           optional: true
           $ref: "#/resources/entity/RedirectUrl"
+        forceRedirect:
+          type: boolean
+          optional: true
+          description: |
+            **결과 리턴 방식을 리디렉션으로 강제**
+
+            `true`로 설정하면 원래 프로미스로 resolve 되었을 상황에서도
+            `redirectUrl`로 쿼리 파라미터와 함께 리디렉션합니다.
+
+            - `redirectUrl`이 없으면 기존처럼 프로미스로 반환합니다.
+            - 본인인증 시작 전 발생하는 에러는 리디렉션하지 않습니다.
         customData:
           type: string
           optional: true
@@ -5371,6 +5688,17 @@ resources:
           type: resourceRef
           optional: true
           $ref: "#/resources/entity/RedirectUrl"
+        forceRedirect:
+          type: boolean
+          optional: true
+          description: |
+            **결과 리턴 방식을 리디렉션으로 강제**
+
+            `true`로 설정하면 원래 프로미스로 resolve 되었을 상황에서도
+            `redirectUrl`로 쿼리 파라미터와 함께 리디렉션합니다.
+
+            - `redirectUrl`이 없으면 기존처럼 프로미스로 반환합니다.
+            - 빌링키 발급 시작 전 발생하는 에러는 리디렉션하지 않습니다.
         locale:
           optional: true
           type: resourceRef
@@ -5493,6 +5821,17 @@ resources:
           type: resourceRef
           optional: true
           $ref: "#/resources/entity/RedirectUrl"
+        forceRedirect:
+          type: boolean
+          optional: true
+          description: |
+            **결과 리턴 방식을 리디렉션으로 강제**
+
+            `true`로 설정하면 원래 프로미스로 resolve 되었을 상황에서도
+            `redirectUrl`로 쿼리 파라미터와 함께 리디렉션합니다.
+
+            - `redirectUrl`이 없으면 기존처럼 프로미스로 반환합니다.
+            - 빌링키 발급 및 결제 시작 전 발생하는 에러는 리디렉션하지 않습니다.
         noticeUrls:
           optional: true
           type: array
@@ -5616,6 +5955,17 @@ resources:
           type: resourceRef
           optional: true
           $ref: "#/resources/entity/RedirectUrl"
+        forceRedirect:
+          type: boolean
+          optional: true
+          description: |
+            **결과 리턴 방식을 리디렉션으로 강제**
+
+            `true`로 설정하면 원래 프로미스로 resolve 되었을 상황에서도
+            `redirectUrl`로 쿼리 파라미터와 함께 리디렉션합니다.
+
+            - `redirectUrl`이 없으면 기존처럼 프로미스로 반환합니다.
+            - 결제 시작 전 발생하는 에러는 리디렉션하지 않습니다.
         noticeUrls:
           optional: true
           type: array
@@ -5757,6 +6107,10 @@ resources:
           type: resourceRef
           $ref: "#/resources/request/PaymentRequestUnionConvenienceStore"
           optional: true
+        alipayPlus:
+          type: resourceRef
+          $ref: "#/resources/request/PaymentRequestUnionAlipayPlus"
+          optional: true
     IssueBillingKeyRequestUnionCard:
       type: object
       properties:
@@ -5866,6 +6220,18 @@ resources:
           type: boolean
           description: |
             할부 사용 가능 여부
+        cardPromotion:
+          optional: true
+          type: resourceRef
+          $ref: "#/resources/entity/CardPromotion"
+          description: |
+            **카드 프로모션 정보**
+
+            카드사 다이렉트 호출 시 적용할 카드사 할인 쿠폰 정보입니다.
+
+            <PgSection pgName={(name) => name === 'kcp'}>
+            NHN KCP에서 카드사 다이렉트 호출 시 카드사 할인 쿠폰을 적용할 수 있습니다.
+            </PgSection>
     PaymentRequestUnionVirtualAccount:
       type: object
       description: |
@@ -6157,6 +6523,19 @@ resources:
           type: resourceRef
           $ref: "#/resources/request/PaymentRequestUnionConvenienceStorePaymentDeadline"
           optional: true
+    PaymentRequestUnionAlipayPlus:
+      type: object
+      properties:
+        easyPayProvider:
+          type: resourceRef
+          $ref: "#/resources/entity/EasyPayProvider"
+          optional: true
+          description: |
+            **간편결제 UI 직접 호출**
+
+            알리페이 플러스에서 제공하는 간편결제의 UI를 직접 호출하기 위해, 간편결제 서비스를 지정합니다.
+
+            지정하지 않을 경우 이용 가능한 모든 간편결제 수단이 노출되는 통합 결제 페이지로 연결됩니다.
     PaymentRequestUnionVirtualAccountAccountExpiry:
       type: oneOf
       description: |