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

package/assets/docs/sdk/ko/v2-mobile-sdk/android.md

@@ -131,25 +131,34 @@ targetVersions:
 
 ### 일반 결제(PortOne.requestPayment)
 
-결제 요청 시 필요한 자세한 파라미터에 대한 내용은 PaymentRequest.kt 파일에 기술되어 있습니다.
+결제 요청 시 필요한 자세한 파라미터에 대한 내용은 `PaymentRequest.kt` 파일에 기술되어 있습니다.
 
 ```kotlin
+import io.portone.sdk.android.PortOne
+import io.portone.sdk.android.payment.PaymentCallback
+import io.portone.sdk.android.type.request.PaymentRequest
+import io.portone.sdk.android.type.response.PaymentResponse
+import io.portone.sdk.android.type.entity.Currency
+import io.portone.sdk.android.type.entity.PaymentPayMethod
+
 class MainActivity : AppCompatActivity() {
     // 결제 완료/실패 이후 응답을 처리 하기 위한 ResultLauncher 생성
     private val paymentActivityResultLauncher =
         PortOne.registerForPaymentActivity(this, callback = object :
             PaymentCallback {
-            override fun onSuccess(response: PaymentResponse.Success) {
+            override fun onSuccess(response: PaymentResponse) {
+                // code가 null이면 결제 성공
                 AlertDialog.Builder(this@MainActivity)
                     .setTitle("결제 성공")
-                    .setMessage(response.toString())
+                    .setMessage("결제 ID: ${response.paymentId}")
                     .show()
             }
 
-            override fun onFail(response: PaymentResponse.Fail) {
+            override fun onFail(response: PaymentResponse) {
+                // code가 null이 아니면 결제 실패
                 AlertDialog.Builder(this@MainActivity)
                     .setTitle("결제 실패")
-                    .setMessage(response.toString())
+                    .setMessage("오류 코드: ${response.code}\n오류 메시지: ${response.message}")
                     .show()
             }
 
@@ -162,11 +171,12 @@ class MainActivity : AppCompatActivity() {
             this,
             request = PaymentRequest(
                 storeId = "상점 아이디",
-                channelKey = "채널 키",
                 paymentId = "결제 건 ID",
                 orderName = "주문 명",
-                amount = Amount(total = 1000, currency = Currency.KRW), // 금액
-                method = PaymentMethod.Card() // 결제수단 관련 정보
+                channelKey = "채널 키",
+                totalAmount = 1000, // 결제 금액 (Long)
+                currency = Currency.KRW, // 화폐 단위
+                payMethod = PaymentPayMethod.CARD, // 결제수단 (enum)
             ),
             resultLauncher = paymentActivityResultLauncher
         )
@@ -175,25 +185,33 @@ class MainActivity : AppCompatActivity() {
 
 ### 빌링키 발급(PortOne.requestIssueBillingKey)
 
-빌링키 발급 시 필요한 자세한 파라미터에 대한 내용은 IssueBillingKeyRequest.kt 파일에 기술되어 있습니다.
+빌링키 발급 시 필요한 자세한 파라미터에 대한 내용은 `IssueBillingKeyRequest.kt` 파일에 기술되어 있습니다.
 
 ```kotlin
+import io.portone.sdk.android.PortOne
+import io.portone.sdk.android.issuebillingkey.IssueBillingKeyCallback
+import io.portone.sdk.android.type.request.IssueBillingKeyRequest
+import io.portone.sdk.android.type.response.IssueBillingKeyResponse
+import io.portone.sdk.android.type.entity.BillingKeyMethod
+
 class MainActivity : AppCompatActivity() {
     // 빌링키 발급 완료/실패 이후 응답을 처리 하기 위한 ResultLauncher 생성
     private val issueBillingKeyActivityResultLauncher =
         PortOne.registerForIssueBillingKeyActivity(this, callback = object :
             IssueBillingKeyCallback {
-            override fun onSuccess(response: IssueBillingKeyResponse.Success) {
-                AlertDialog.Builder(this@IssueBillingKeyTestActivity)
+            override fun onSuccess(response: IssueBillingKeyResponse) {
+                // code가 null이면 빌링키 발급 성공
+                AlertDialog.Builder(this@MainActivity)
                     .setTitle("빌링키 발급 성공")
-                    .setMessage(response.toString())
+                    .setMessage("빌링키: ${response.billingKey}")
                     .show()
             }
 
-            override fun onFail(response: IssueBillingKeyResponse.Fail) {
-                AlertDialog.Builder(this@IssueBillingKeyTestActivity)
+            override fun onFail(response: IssueBillingKeyResponse) {
+                // code가 null이 아니면 빌링키 발급 실패
+                AlertDialog.Builder(this@MainActivity)
                     .setTitle("빌링키 발급 실패")
-                    .setMessage(response.toString())
+                    .setMessage("오류 코드: ${response.code}\n오류 메시지: ${response.message}")
                     .show()
             }
 
@@ -208,7 +226,7 @@ class MainActivity : AppCompatActivity() {
                     request = IssueBillingKeyRequest(
                         storeId = "상점 아이디",
                         channelKey = "채널 키",
-                        method = BillingKeyMethod.Card() // 빌링키 발급 수단
+                        billingKeyMethod = BillingKeyMethod.CARD // 빌링키 발급 수단 (enum)
                     ),
                     resultLauncher = issueBillingKeyActivityResultLauncher
                 )
@@ -217,25 +235,32 @@ class MainActivity : AppCompatActivity() {
 
 ### 본인인증 (PortOne.requestIdentityVerification)
 
-본인인증 시 필요한 자세한 파라미터에 대한 내용은 IdentityVerificationRequest.kt 파일에 기술되어 있습니다.
+본인인증 시 필요한 자세한 파라미터에 대한 내용은 `IdentityVerificationRequest.kt` 파일에 기술되어 있습니다.
 
 ```kotlin
+import io.portone.sdk.android.PortOne
+import io.portone.sdk.android.identityverification.IdentityVerificationCallback
+import io.portone.sdk.android.type.request.IdentityVerificationRequest
+import io.portone.sdk.android.type.response.IdentityVerificationResponse
+
 class MainActivity : AppCompatActivity() {
     // 본인인증 완료/실패 이후 응답을 처리 하기 위한 ResultLauncher 생성
     private val identityVerificationActivityResultLauncher =
         PortOne.registerForIdentityVerificationActivity(this, callback = object :
             IdentityVerificationCallback {
-            override fun onSuccess(response: IdentityVerificationResponse.Success) {
-                AlertDialog.Builder(this@IdentityVerificationTestActivity)
+            override fun onSuccess(response: IdentityVerificationResponse) {
+                // code가 null이면 본인인증 성공
+                AlertDialog.Builder(this@MainActivity)
                     .setTitle("본인인증 성공")
-                    .setMessage(response.toString())
+                    .setMessage("본인인증 ID: ${response.identityVerificationId}")
                     .show()
             }
 
-            override fun onFail(response: IdentityVerificationResponse.Fail) {
-                AlertDialog.Builder(this@IdentityVerificationTestActivity)
+            override fun onFail(response: IdentityVerificationResponse) {
+                // code가 null이 아니면 본인인증 실패
+                AlertDialog.Builder(this@MainActivity)
                     .setTitle("본인인증 실패")
-                    .setMessage(response.toString())
+                    .setMessage("오류 코드: ${response.code}\n오류 메시지: ${response.message}")
                     .show()
             }
 
@@ -248,7 +273,7 @@ class MainActivity : AppCompatActivity() {
          PortOne.requestIdentityVerification(
                     this,
                     request = IdentityVerificationRequest(
-                        storeId = "상정 아이디",
+                        storeId = "상점 아이디",
                         identityVerificationId = "본인인증 요청 ID",
                         channelKey = "채널 키"
                     ),
@@ -257,6 +282,19 @@ class MainActivity : AppCompatActivity() {
 
 ```
 
+### 응답 처리
+
+모든 응답(PaymentResponse, IssueBillingKeyResponse, IdentityVerificationResponse)은 `code` 필드를 통해 성공/실패를 판단합니다.
+
+- `code == null`: 성공
+- `code != null`: 실패 (오류 코드와 메시지 포함)
+
+실패 시 응답에 포함되는 필드:
+- `code`: 오류 코드
+- `message`: 오류 메시지
+- `pgCode`: PG사에서 전달한 원본 오류 코드 (있는 경우)
+- `pgMessage`: PG사에서 전달한 원본 오류 메시지 (있는 경우)
+
 ## 버전
 
 [유의적 버전 2.0.0](https://semver.org/spec/v2.0.0.html)을 사용합니다.

package/assets/docs/sdk/ko/v2-mobile-sdk/react-native.md

@@ -20,11 +20,10 @@ Node.js v18을 지원하며, Expo 51.0.38과 react-native-webview 13.8.6 환경
 
 ## 설치 (Expo 사용)
 
-1. Expo CLI를 사용해 @portone/react-native-sdk와 의존성인 react-native-webview,
-   expo-intent-launcher을 설치합니다.
+1. Expo CLI를 사용해 @portone/react-native-sdk와 의존성인 react-native-webview를 설치합니다.
 
 ```shell
-npx expo install @portone/react-native-sdk react-native-webview expo-intent-launcher
+npx expo install @portone/react-native-sdk react-native-webview
 ```
 
 2. TypeScript를 사용하시는 경우 @portone/browser-sdk를 devDependencies에
@@ -37,6 +36,10 @@ yarn add -D @portone/browser-sdk
 
 3. app.json의 plugin 항목으로 `@portone/react-native-sdk/plugin`를 추가합니다.
 
+이 플러그인은 앱 링크를 사용하기 위한 AndroidManifest.xml 및 Info.plist 설정을 자동으로 추가합니다.
+단, iOS 15 이상 버전에서 Info.plist 설정에는 최대 50개의 LSApplicationQueriesSchemes 항목만이 적용되므로
+일부 앱 링크만이 열리지 않는 등의 문제가 발생하실 경우 플러그인을 제거하고 필요한 항목만을 골라 직접 설정해주세요.
+
 ```json
 {
   "expo": {
@@ -57,12 +60,11 @@ yarn add -D @portone/browser-sdk
 
 ## 설치 (Expo 미사용)
 
-1. @portone/react-native-sdk와 의존성인 react-native-webview,
-   expo-intent-launcher을 설치합니다.
+1. @portone/react-native-sdk와 의존성인 react-native-webview를 설치합니다.
 
 ```shell
-npm install --save @portone/react-native-sdk react-native-webview expo-intent-launcher
-yarn add @portone/react-native-sdk react-native-webview expo-intent-launcher
+npm install --save @portone/react-native-sdk react-native-webview
+yarn add @portone/react-native-sdk react-native-webview
 ```
 
 2. ios 서브디렉토리에서 pod를 사용해 react-native-webview에 필요한 네이티브
@@ -97,39 +99,45 @@ yarn add -D @portone/browser-sdk
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
   <!-- 중략 -->
   <queries>
-    <package android:name="com.kftc.bankpay.android" />
-    <package android:name="kvp.jjy.MispAndroid320" />
-    <package android:name="com.hyundaicard.appcard" />
-    <package android:name="com.shcard.smartpay" />
-    <package android:name="com.shinhan.smartcaremgr" />
-    <package android:name="com.kbcard.cxh.appcard" />
-    <package android:name="com.kbstar.kbbank" />
-    <package android:name="com.kbstar.reboot" />
-    <package android:name="kr.co.samsungcard.mpocket" />
-    <package android:name="kr.co.shiftworks.vguardweb" />
-    <package android:name="net.ib.android.smcard" />
-    <package android:name="com.lcacApp" />
-    <package android:name="com.lottemembers.android" />
-    <package android:name="com.hanaskcard.paycla" />
-    <package android:name="nh.smart.card" />
-    <package android:name="nh.smart.nhallonepay" />
-    <package android:name="kr.co.citibank.citimobile" />
-    <package android:name="com.kakao.talk" />
-    <package android:name="com.nhnent.payapp" />
-    <package android:name="com.wooricard.smartapp" />
-    <package android:name="com.wooribank.smart.npib" />
-    <package android:name="viva.republica.toss" />
-    <package android:name="com.nhn.android.search" />
-    <package android:name="com.kakaobank.channel" />
-    <package android:name="com.ahnlab.v3mobileplus" />
-    <package android:name="com.samsung.android.spay" />
-    <package android:name="jp.naver.line.android" />
-    <package android:name="com.eg.android.AlipayGphone" />
-    <package android:name="com.tencent.mm" />
-    <package android:name="com.sktelecom.tauth" />
-    <package android:name="com.kt.ktauth" />
-    <package android:name="com.lguplus.smartotp" />
-    <package android:name="com.shinhan.sbanking" />
+    <package android:name="com.kftc.bankpay.android" /> <!-- 뱅크페이 -->
+    <package android:name="kvp.jjy.MispAndroid320" /> <!-- ISP / 페이북 -->
+    <package android:name="com.hyundaicard.appcard" /> <!-- 현대카드 -->
+    <package android:name="com.shcard.smartpay" /> <!-- 신한 SOL페이 -->
+    <package android:name="com.shinhan.smartcaremgr" /> <!-- 신한 슈퍼SOL -->
+    <package android:name="com.shinhan.sbanking" /> <!-- 신한 SOL뱅크 -->
+    <package android:name="com.kbcard.cxh.appcard" /> <!-- KB Pay -->
+    <package android:name="com.kbstar.kbbank" /> <!-- KB스타뱅킹 -->
+    <package android:name="kr.co.samsungcard.mpocket" /> <!-- 삼성카드 -->
+    <package android:name="com.samsung.android.spay" /> <!-- Samsung Wallet -->
+    <package android:name="net.ib.android.smcard" /> <!-- monimo -->
+    <package android:name="com.lcacApp" /> <!-- 디지로카 (롯데카드) -->
+    <package android:name="com.lottemembers.android" /> <!-- L.POINT with L.PAY -->
+    <package android:name="com.hanaskcard.paycla" /> <!-- 하나Pay (하나카드) -->
+    <package android:name="nh.smart.nhallonepay" /> <!-- NH Pay -->
+    <package android:name="kr.co.citibank.citimobile" /> <!-- 씨티모바일 -->
+    <package android:name="com.kakao.talk" /> <!-- 카카오톡 (카카오페이) -->
+    <package android:name="com.nhnent.payapp" /> <!-- PAYCO -->
+    <package android:name="com.wooricard.smartapp" /> <!-- 우리카드 우리WON카드 -->
+    <package android:name="com.wooribank.smart.npib" /> <!-- 우리은행 우리WON뱅킹 -->
+    <package android:name="viva.republica.toss" /> <!-- 토스 -->
+    <package android:name="com.nhn.android.search" /> <!-- 네이버 (네이버페이) -->
+    <package android:name="com.kakaobank.channel" /> <!-- 카카오뱅크 -->
+    <package android:name="com.ahnlab.v3mobileplus" /> <!-- V3 Mobile Plus -->
+    <package android:name="com.TouchEn.mVaccine.webs" /> <!-- 터치엔 엠백신 -->
+    <package android:name="com.sktelecom.tauth" /> <!-- PASS by SKT -->
+    <package android:name="com.kt.ktauth" /> <!-- PASS by KT -->
+    <package android:name="com.lguplus.smartotp" /> <!-- PASS by U+ -->
+    <package android:name="com.mysmilepay.app" /> <!-- 스마일페이 -->
+    <package android:name="com.ssg.serviceapp.android.egiftcertificate" /> <!-- SSGPAY -->
+    <package android:name="com.hanabank.mzplatform" /> <!-- 아이부자 -->
+    <package android:name="com.knb.psb" /> <!-- BNK경남은행 -->
+    <package android:name="kr.ac.yonsei.idcard" /> <!-- 연세대학교 모바일 학생증/신분증 (연세페이) -->
+    <package android:name="jp.naver.line.android" /> <!-- LINE (LINE Pay) -->
+    <package android:name="com.eg.android.AlipayGphone" /> <!-- Alipay -->
+    <package android:name="hk.alipay.wallet" /> <!-- AlipayHK -->
+    <package android:name="com.tencent.mm" /> <!-- WeChat -->
+    <package android:name="com.globe.gcash.android" /> <!-- GCash -->
+    <package android:name="th.co.truemoney.wallet" /> <!-- TrueMoney -->
     <intent>
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.BROWSABLE" />
@@ -139,67 +147,46 @@ yarn add -D @portone/browser-sdk
 </manifest>
 ```
 
-6. 앱 링크를 사용하기 위해 ios/(프로젝트 이름)/Info.plist 파일에 아래 내용을
-   추가합니다.
+6. 앱 링크를 사용하기 위해 ios/(프로젝트 이름)/Info.plist 파일에 아래 내용을 추가합니다.
+
+iOS 15 이상 버전에서는 최대 50개의 항목만이 적용되므로, 필요한 항목만을 추가합니다.
 
 ```xml
 <dict>
   <!-- 중략 -->
   <key>LSApplicationQueriesSchemes</key>
   <array>
-    <string>kftc-bankpay</string>
-    <string>ispmobile</string>
-    <string>hdcardappcardansimclick</string>
-    <string>smhyundaiansimclick</string>
-    <string>hyundaicardappcardid</string>
-    <string>shinhan-sr-ansimclick</string>
-    <string>shinhan-sr-ansimclick-naverpay</string>
-    <string>shinhan-sr-ansimclick-payco</string>
-    <string>shinhan-sr-ansimclick-lpay</string>
-    <string>shinhan-sr-ansimclick-mola</string>
-    <string>smshinhanansimclick</string>
-    <string>smailapp</string>
-    <string>kb-acp</string>
-    <string>kb-auth</string>
-    <string>kb-screen</string>
-    <string>kbbank</string>
-    <string>liivbank</string>
-    <string>newliiv</string>
-    <string>mpocket.online.ansimclick</string>
-    <string>ansimclickscard</string>
-    <string>ansimclickipcollect</string>
-    <string>vguardstart</string>
-    <string>samsungpay</string>
-    <string>scardcertiapp</string>
-    <string>monimopay</string>
-    <string>monimopayauth</string>
-    <string>lottesmartpay</string>
-    <string>lotteappcard</string>
-    <string>lmslpay</string>
-    <string>lpayapp</string>
-    <string>cloudpay</string>
-    <string>hanawalletmembers</string>
-    <string>nhappcardansimclick</string>
-    <string>nonghyupcardansimclick</string>
-    <string>nhallonepayansimclick</string>
-    <string>citispay</string>
-    <string>citicardappkr</string>
-    <string>citimobileapp</string>
-    <string>kakaotalk</string>
-    <string>payco</string>
-    <string>com.wooricard.wcard</string>
-    <string>newsmartpib</string>
-    <string>NewSmartPib</string>
-    <string>supertoss</string>
-    <string>naversearchthirdlogin</string>
-    <string>kakaobank</string>
-    <string>v3mobileplusweb</string>
-    <string>line</string>
-    <string>alipays</string>
-    <string>weixin</string>
-    <string>tauthlink</string>
-    <string>ktauthexternalcall</string>
-    <string>upluscorporation</string>
+    <string>kftc-bankpay</string> <!-- 뱅크페이 -->
+    <string>ispmobile</string> <!-- ISP / 페이북 -->
+    <string>hdcardappcardansimclick</string> <!-- 현대카드 -->
+    <string>shinhan-sr-ansimclick</string> <!-- 신한 SOL페이 -->
+    <string>shinhan-sr-ansimclick-payco</string> <!-- 신한 SOL페이 (PAYCO) -->
+    <string>shinhan-sr-ansimclick-lpay</string> <!-- 신한 SOL페이 (L.PAY) -->
+    <string>kb-acp</string> <!-- KB Pay -->
+    <string>kbbank</string> <!-- KB스타뱅킹 -->
+    <string>mpocket.online.ansimclick</string> <!-- 삼성카드 -->
+    <string>lotteappcard</string> <!-- 디지로카 (롯데카드) -->
+    <string>lmslpay</string> <!-- L.POINT with L.PAY -->
+    <string>cloudpay</string> <!-- 하나Pay (하나카드) -->
+    <string>nhallonepayansimclick</string> <!-- NH Pay -->
+    <string>citimobileapp</string> <!-- 씨티모바일 (씨티카드) -->
+    <string>kakaotalk</string> <!-- 카카오톡 (카카오페이) -->
+    <string>payco</string> <!-- PAYCO -->
+    <string>com.wooricard.wcard</string> <!-- 우리카드 우리WON카드 -->
+    <string>newsmartpib</string> <!-- 우리은행 우리WON뱅킹 -->
+    <string>supertoss</string> <!-- 토스 -->
+    <string>naversearchthirdlogin</string> <!-- 네이버 (네이버페이) -->
+    <string>kakaobank</string> <!-- 카카오뱅크 -->
+    <string>tauthlink</string> <!-- PASS by SKT -->
+    <string>ktauthexternalcall</string> <!-- PASS by KT -->
+    <string>upluscorporation</string> <!-- PASS by U+ -->
+    <string>kn-bankpay</string> <!-- BNK경남은행 -->
+    <string>yonseipay</string> <!-- 연세대학교 모바일 학생증/신분증 (연세페이) -->
+    <string>line</string> <!-- LINE (LINE Pay) -->
+    <string>alipays</string> <!-- Alipay -->
+    <string>alipayhk</string> <!-- AlipayHK -->
+    <string>weixin</string> <!-- WeChat -->
+    <string>ascendmoney</string> <!-- TrueMoney -->
   </array>
 </dict>
 ```

package/assets/docs/sdk/ko/v2-mobile-sdk/readme.md

@@ -9,7 +9,7 @@ versionVariants:
 
 포트원 모바일 SDK는 Javascript로 작성된 포트원 V2 SDK를 모바일 환경에서 모바일 플랫폼 네이티브 코드(Kotlin, Swift 등) 으로 사용 가능하도록 만들어진 SDK입니다.
 
-현재는 Android, iOS, React Native를 지원하고 있으며, Flutter 등 다른 플랫폼에 대해서도 지원 예정입니다.
+현재는 Android, iOS, React Native, Flutter를 지원하고 있습니다.
 
 ## Android SDK
 
@@ -29,8 +29,9 @@ React Native 환경에서 사용 가능한 SDK입니다. 해당 Git 레포지토
 
 - [GitHub 링크](https://github.com/portone-io/react-native-sdk)
 
-## Flutter
+## Flutter SDK
 
-Flutter 환경에서 사용 가능한 SDK는 제공하고 있지 않으나, Flutter을 사용하여 직접 연동하는 방법에 참고가 되도록 샘플 프로젝트를 제공하고 있습니다.
+Flutter 환경에서 사용 가능한 SDK입니다. V1 및 V2 결제/본인인증을 지원하며, 해당 Git 레포지토리의 README.md 파일을 참고하여 사용하실 수 있습니다.
 
-- [GitHub 링크](https://github.com/portone-io/portone-sample/tree/main/flutter)
+- [GitHub 링크](https://github.com/portone-io/portone_flutter)
+- [pub.dev 링크](https://pub.dev/packages/portone_flutter)