iamport-react-native 2.0.13 → 2.0.15

package/manuals/EXPO.md

@@ -0,0 +1,246 @@
+# Expo에서 아임포트 연동하기
+
+`iamport-react-native`는 Expo 환경에서 사용하실 수 있습니다.
+또한 eject를 하지 않아도 사용 가능합니다.
+
+이 문서에서는 eject를 하지 않은 managed 프로젝트와 eject를 한 bare 프로젝트 양 쪽에서 Expo를 설정하는 방법을 설명하고 있습니다.
+
+## Expo CLI 설치하기
+```
+$ npm install -g expo-cli
+```
+
+## 1. managed 프로젝트
+
+managed 프로젝트는 Expo의 가장 기초적인 프로젝트 생성 방식으로 플랫폼별 네이티브 코드 없이 오직 자바스크립트 및 타입스크립트만으로 앱을 개발하는 방식입니다.
+Expo 자체 서버에서 빌드 및 배포를 모두 처리할 수 있습니다.
+`ios`및 `android` 폴더가 없기 때문에 필요한 설정들은 `app.json`에 적어주셔야 합니다.
+
+### 1-1. Expo 서버 빌드를 위한 설정
+
+managed로 개발하는 경우 빌드를 Expo 서버에서 원격으로 진행하게 되며 그에 따른 [필수 값들](https://docs.expo.dev/distribution/building-standalone-apps/#2-configure-appjson)을 채워야 합니다.
+
+- `name`, `icon`, `version`, 그리고 `slug`는 앱 공통 설정으로 필수입니다.
+- `ios`의 `bundleIdentifier` 및 `buildNumber`는 iOS 앱 배포 및 빌드를 위해 필수입니다.
+-  `android`의 `package` 및 `versionCode`는 안드로이드 앱 배포 및 빌드를 위해 필수입니다.
+
+```json
+// app.json
+{
+  "expo": {
+    "name": "Your App Name",
+    "icon": "./path/to/your/app-icon.png",
+    "version": "1.0.0",
+    "slug": "your-app-slug",
+    "ios": {
+      "bundleIdentifier": "com.yourcompany.yourappname",
+      "buildNumber": "1.0.0"
+    },
+    "android": {
+      "package": "com.yourcompany.yourappname",
+      "versionCode": 1
+    }
+  }
+}
+```
+
+### 1-2. 외부 앱 실행을 위한 설정
+
+Expo bare 프로젝트나 일반 리액트 네이티브 프로젝트의 경우 AndroidManifest.xml 및 Info.plist에 앱 scheme [관련 설정](./SETTING.md)을 작성하지만, managed 프로젝트의 경우 네이티브 코드가 없어 app.json에 대신 설정을 적어주셔야 합니다.
+
+먼저 안드로이드를 위한 외부 앱 설정에 필요한 expo-build-properties를 설치합니다.
+
+```sh
+npx expo install expo-build-properties
+```
+
+- `ios.infoPlist.LSApplicationQueriesSchemes`에는 외부 앱 리스트를 작성합니다.
+- `ios.infoPlist.NSAppTransportSecurity`의 두 항목을 `YES`로 설정합니다.
+- `android.intentFilters`에 개발하시는 앱의 scheme을 설정합니다.
+- `plugins`에 expo-build-properties를 이용해 안드로이드 외부 앱 리스트를 추가로 작성합니다.
+
+```json
+// app.json
+{
+  "expo": {
+    ...,
+    "ios": {
+      ...
+      "infoPlist": {
+        "LSApplicationQueriesSchemes": [
+          "kftc-bankpay",
+          "ispmobile",
+          "itms-apps",
+          "hdcardappcardansimclick",
+          "smhyundaiansimclick",
+          "shinhan-sr-ansimclick",
+          "smshinhanansimclick",
+          "kb-acp",
+          "mpocket.online.ansimclick",
+          "ansimclickscard",
+          "ansimclickipcollect",
+          "vguardstart",
+          "samsungpay",
+          "scardcertiapp",
+          "lottesmartpay",
+          "lotteappcard",
+          "cloudpay",
+          "nhappcardansimclick",
+          "nonghyupcardansimclick",
+          "citispay",
+          "citicardappkr",
+          "citimobileapp",
+          "kakaotalk",
+          "payco",
+          "chaipayment",
+          "kb-auth",
+          "hyundaicardappcardid",
+          "com.wooricard.wcard",
+          "lmslpay",
+          "lguthepay-xpay",
+          "liivbank",
+          "supertoss",
+          "kakaobank"
+        ],
+        "NSAppTransportSecurity": {
+          "NSAllowsArbitraryLoads": true,
+          "NSAllowsArbitraryLoadsInWebContent": true
+        }
+      }
+    },
+    ...
+    "android": {
+      ...
+      "intentFilters": [
+        {
+          "action": "VIEW",
+          "category": [
+            "DEFAULT",
+            "BROWSABLE"
+          ],
+          "data": {
+            "scheme": "exampleformanagedexpo"
+          }
+        }
+      ]
+    },
+    ...
+    "plugins": [
+      [
+        "expo-build-properties",
+        {
+          "android": {
+            "manifestQueries": [
+              {
+                "intent": {
+                  "action": "android.intent.action.VIEW",
+                  "category": "android.intent.category.BROWSABLE",
+                  "data": {
+                    "scheme": "https"
+                  }
+                },
+                "package": [
+                  "kvp.jjy.MispAndroid320",
+                  "com.kftc.bankpay.android",
+                  "com.kbstar.liivbank",
+                  "com.nh.cashcardapp",
+                  "kr.co.kfcc.mobilebank",
+                  "com.knb.psb",
+                  "com.kakao.talk",
+                  "com.mysmilepay.app",
+                  "finance.chai.app",
+                  "com.nhnent.payapp",
+                  "com.hyundaicard.appcard",
+                  "viva.republica.toss",
+                  "com.shcard.smartpay",
+                  "com.shinhan.smartcaremgr",
+                  "com.hanaskard.paycla",
+                  "kr.co.samsungcard.mpocket",
+                  "com.kbcard.cxh.appcard",
+                  "nh.smart.nhallonepay",
+                  "kr.co.citibank.citimobile",
+                  "com.lcacApp",
+                  "com.lotte.lpay",
+                  "com.ssg.serviceapp.android.egiftcertificate",
+                  "com.inicis.kpay",
+                  "com.kbankwith.smartbank",
+                  "com.lguplus.paynow",
+                  "com.wooricard.smartapp",
+                  "com.lottemembers.android",
+                  "com.kt.ktauth",
+                  "com.lguplus.smartotp",
+                  "com.sktelecom.tauth",
+                  "com.wooribank.smart.npib",
+                  "com.kakaobank.channel"
+                ]
+              }
+            ]
+          }
+        }
+      ]
+    ]
+  }
+}
+```
+
+### 1-3. 예제
+
+- [예제 코드 작성하기](./EXAMPLE.md)
+- [예제 프로젝트 실행하기](../exampleForManagedExpo/README.md)
+
+## 2. bare 프로젝트
+
+bare 프로젝트는 기존 managed 프로젝트에서 eject를 실행해 네이티브 코드를 사용하고자 하는 개발 방식입니다.
+Expo 자체 서버에서 bare 프로젝트의 빌드를 지원하고 있지 않기 때문에 앱 배포를 위해서는 로컬에서 직접 빌드하게 됩니다.
+
+### 2-1. 설정 파일(app.json) 확인하기
+
+원활한 ejecting을 위해 아래와 같이 설정되어 있는지 확인합니다.
+
+```
+// app.json
+{
+  "expo": {
+    "name": "Your App Name",
+    "icon": "./path/to/your/app-icon.png",
+    "version": "1.0.0",
+    "slug": "your-app-slug",
+    "sdkVersion": "XX.0.0",
+    "ios": {
+      "bundleIdentifier": "com.yourcompany.yourappname"
+    },
+    "android": {
+      "package": "com.yourcompany.yourappname"
+    }
+  }
+}
+```
+
+- IOS의 `bundleIdentifier`값과 Android의 `package`값에 알맞은 값을 넣어야 합니다.
+- `name`, `icon` 그리고 `version` 필드는 필수입력입니다.
+- 보다 자세한 내용은 엑스포 공식문서 [Configuration with app.json](https://docs.expo.dev/workflow/configuration)을 참고해주세요.
+
+### 2-2. EJECT 하기
+
+프로젝트 폴더에서 expo 명령어를 통해 eject 합니다. `android`와 `ios` 폴더가 생성되며 필요한 dependency들이 설치됩니다.
+
+```shell
+$ expo eject
+```
+
+### 2-3. [아임포트 설치 및 링킹하기](./INSTALL.md)
+```shell
+$ yarn add iamport-react-native
+$ yarn add react-native-webview
+```
+
+### 2-4. 설정하기
+  - [IOS 설정하기](./SETTING.md)
+  - [실시간 계좌이체 설정하기](./TRANS.md)
+
+###2-5. 예제
+
+- [예제 코드 작성하기](./EXAMPLE.md)
+- [예제 프로젝트 실행하기](../exampleForExpo/README.md)
+
+### 2-6 [콜백 함수 설정하기](./CALLBACK.md)

package/manuals/INSTALL.md

@@ -0,0 +1,31 @@
+# 설치하기
+아임포트 리액트 네이티브 모듈 설치 안내입니다.
+아래 명령어를 통해 아임포트 모듈을 귀하의 리액트 네이티브 프로젝트에 추가할 수 있습니다.
+`react-native-webview` 모듈은 아임포트 모듈을 사용하기 위해 꼭 필요하기 때문에 반드시 함께 설치해야 합니다.
+
+```shell
+$ npm install iamport-react-native --save
+$ npm install react-native-webview --save
+```
+또는
+```shell
+$ yarn add iamport-react-native
+$ yarn add react-native-webview
+```
+
+`iamport-react-native`는 `v10.8.3` 이상의 `react-native-webview`를 필요로 합니다.
+위 명령어대로 `iamport-react-native` 플러그인을 설치했을 때 다음과 같은 Warning Message가 나온다면 기존에 설치된 `react-native-webview` 플러그인을 업데이트해주세요.
+
+![](../manuals/assets/webview-peer-dependency.png)
+
+`react-native` `v0.60.0` 부터는 auto linking 및 jetifier 자동 적용이 지원됩니다.
+다만 자동으로 링크가 되어도 iOS의 경우 `pod install`은 직접 실행해주셔야 합니다.
+
+구 버전의 `react-native`를 사용하신다면 업데이트해주셔야 별도의 링크 작업 없이 아임포트 모듈을 사용하실 수 있습니다.
+
+설치를 성공적으로 마쳤을 경우, 아래와 같은 화면을 보실 수 있습니다.
+
+![](assets/after-linking-iamport.png)
+![](assets/after-linking-webview.png)
+
+[comment]: <> (실패한 경우, 아래 과정을 통해 `iamport-react-native` 모듈을 귀하의 프로젝트에 [수동으로 연결]&#40;https://facebook.github.io/react-native/docs/linking-libraries-ios&#41;시킬 수 있습니다.)

package/manuals/SETTING.md

@@ -0,0 +1,140 @@
+아임포트 리액트 네이티브 모듈 설정 안내입니다.
+
+# 안드로이드 설정하기
+안드로이드에서 아임포트 결제연동 모듈을 사용하기 위해서는 아래 항목을 설정해주셔야 합니다.
+카드사 혹은 간편결제 앱 등을 실행할 수 있도록 외부 앱 리스트를 등록해야 합니다.
+
+`[프로젝트 폴더]/android/app/src/main/AndroidManifest.xml` 파일을 연 후 아래 내용을 추가합니다.
+
+```xml
+  <queries>
+    <package android:name="kvp.jjy.MispAndroid320" />
+    <package android:name="com.kftc.bankpay.android" />
+    <package android:name="com.kbstar.liivbank" />
+    <package android:name="com.nh.cashcardapp" />
+    <package android:name="kr.co.kfcc.mobilebank" />
+    <package android:name="com.knb.psb" />
+    <package android:name="com.kakao.talk" />
+    <package android:name="com.mysmilepay.app" />
+    <package android:name="finance.chai.app" />
+    <package android:name="com.nhnent.payapp" />
+    <package android:name="com.hyundaicard.appcard" />
+    <package android:name="viva.republica.toss" />
+    <package android:name="com.shcard.smartpay" />
+    <package android:name="com.shinhan.smartcaremgr" />
+    <package android:name="com.hanaskard.paycla" />
+    <package android:name="kr.co.samsungcard.mpocket" />
+    <package android:name="com.kbcard.cxh.appcard" />
+    <package android:name="nh.smart.nhallonepay" />
+    <package android:name="kr.co.citibank.citimobile" />
+    <package android:name="com.lcacApp" />
+    <package android:name="com.lotte.lpay" />
+    <package android:name="com.ssg.serviceapp.android.egiftcertificate" />
+    <package android:name="com.inicis.kpay" />
+    <package android:name="com.kbankwith.smartbank" />
+    <package android:name="com.lguplus.paynow" />
+    <package android:name="com.wooricard.smartapp" />
+    <package android:name="com.lottemembers.android" />
+    <package android:name="com.kt.ktauth" />
+    <package android:name="com.lguplus.smartotp" />
+    <package android:name="com.sktelecom.tauth" />
+    <package android:name="com.wooribank.smart.npib" />
+    <package android:name="com.kakaobank.channel" />
+    <package android:name="com.shinhan.sbanking" />
+    <intent>
+      <action android:name="android.intent.action.VIEW" />
+      <category android:name="android.intent.category.BROWSABLE" />
+      <data android:scheme="https" />
+    </intent>
+  </queries>
+```
+
+# iOS 설정하기
+iOS에서 아임포트 결제연동 모듈을 사용하기 위해서는 아래 3가지 항목을 설정해주셔야 합니다.
+
+## 1. App Scheme 등록
+외부 결제 앱(e.g. 페이코, 신한 페이판)에서 결제 후 돌아올 때 사용할 URL identifier를 설정해야 합니다.
+![](assets/app-scheme-registry.gif)
+```xml
+<key>CFBundleURLTypes</key>
+<array>
+  <dict>
+    <key>CFBundleURLSchemes</key>
+    <array>
+      <string>myawesomeapp</string>
+    </array>
+  </dict>
+</array>
+```
+
+1. `[프로젝트 폴더]/ios/[프로젝트 이름]/Info.plist` 파일을 연 후 `URL Types`속성을 추가합니다.
+2. `URL Schemes`에 원하는 scheme 값을 입력합니다.
+
+## 2. 외부 앱 리스트 등록
+3rd party앱(예) 간편결제 앱)을 실행할 수 있도록 외부 앱 리스트를 등록해야합니다.
+
+1. `[프로젝트 폴더]/ios/[프로젝트 이름]/Info.plist` 파일을 오픈합니다.
+2. [LSApplicationQueriesSchemes](https://developer.apple.com/library/content/documentation/General/Reference/InfoPlistKeyReference/Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-SW14) 속성을 추가하고 아래에 외부 앱 리스트를 등록합니다.
+
+```xml
+<key>LSApplicationQueriesSchemes</key>
+<array>
+  <string>kftc-bankpay</string> <!-- 계좌이체 -->
+  <string>ispmobile</string> <!-- ISP모바일 -->
+  <string>itms-apps</string> <!-- 앱스토어 -->
+  <string>hdcardappcardansimclick</string> <!-- 현대카드-앱카드 -->
+  <string>smhyundaiansimclick</string> <!-- 현대카드-공인인증서 -->
+  <string>shinhan-sr-ansimclick</string> <!-- 신한카드-앱카드 -->
+  <string>smshinhanansimclick</string> <!-- 신한카드-공인인증서 -->
+  <string>kb-acp</string> <!-- 국민카드-앱카드 -->
+  <string>mpocket.online.ansimclick</string> <!-- 삼성카드-앱카드 -->
+  <string>ansimclickscard</string> <!-- 삼성카드-온라인결제 -->
+  <string>ansimclickipcollect</string> <!-- 삼성카드-온라인결제 -->
+  <string>vguardstart</string> <!-- 삼성카드-백신 -->
+  <string>samsungpay</string> <!-- 삼성카드-삼성페이 -->
+  <string>scardcertiapp</string> <!-- 삼성카드-공인인증서 -->
+  <string>lottesmartpay</string> <!-- 롯데카드-모바일결제 -->
+  <string>lotteappcard</string> <!-- 롯데카드-앱카드 -->
+  <string>cloudpay</string> <!-- 하나카드-앱카드 -->
+  <string>nhappcardansimclick</string> <!-- 농협카드-앱카드 -->
+  <string>nonghyupcardansimclick</string> <!-- 농협카드-공인인증서 -->
+  <string>citispay</string> <!-- 씨티카드-앱카드 -->
+  <string>citicardappkr</string> <!-- 씨티카드-공인인증서 -->
+  <string>citimobileapp</string> <!-- 씨티카드-간편결제 -->
+  <string>kakaotalk</string> <!-- 카카오톡 -->
+  <string>payco</string> <!-- 페이코 -->
+  <string>lpayapp</string> <!-- (구)롯데 L페이 -->
+  <string>hanamopmoasign</string> <!-- 하나카드 공인인증앱 -->
+  <string>wooripay</string> <!-- (구) 우리페이 -->
+  <string>nhallonepayansimclick</string> <!-- NH 올원페이 -->
+  <string>hanawalletmembers</string> <!-- 하나카드(하나멤버스 월렛) -->
+  <string>chaipayment</string> <!-- 차이 -->
+  <string>kb-auth</string> <!-- 국민 -->
+  <string>hyundaicardappcardid</string>  <!-- 현대카드 -->
+  <string>com.wooricard.wcard</string>  <!-- 우리won페이 -->
+  <string>lmslpay</string>  <!-- 롯데 L페이 -->
+  <string>lguthepay-xpay</string>  <!-- 페이나우 -->
+  <string>liivbank</string>  <!-- Liiv 국민 -->
+  <string>supertoss</string> <!-- 토스 -->
+  <string>newsmartpib</string> <!-- 우리WON뱅킹 -->
+  <string>ukbanksmartbanknonloginpay</string> <!-- 케이뱅크 페이 -->
+  <string>kakaobank</string> <!-- 카카오뱅크 -->
+</array>
+```
+
+## 3. App Transport Security 설정
+![](assets/allow-arbitrary.gif)
+
+1. `[프로젝트 폴더]/ios/[프로젝트 이름]/Info.plist` 파일을 오픈합니다.
+2. `App Transport Security` 속성을 추가합니다.
+3. 하부 속성에 `Allow Arbitrary Loads in Web Content`,`Allow Arbitrary Loads` 속성을 추가하고 각각의 값(value)을 `YES`로 변경합니다.
+
+```xml
+<key>NSAppTransportSecurity</key>
+<dict>
+  <key>NSAllowsArbitraryLoadsInWebContent</key>
+  <true/>
+  <key>NSAllowsArbitraryLoads</key>
+  <true/>
+</dict>
+```

package/manuals/SUPPORT.md

@@ -0,0 +1,35 @@
+# 지원정보
+
+아임포트 리액트 네이티브(이하 RN) 모듈이 지원하는 PG사 및 결제수단 안내입니다.
+
+| pg           | 이름                  | 결제수단                                                                                          |
+|--------------|---------------------|-----------------------------------------------------------------------------------------------|
+| html5_inicis | 웹 표준 이니시스           | 신용카드, 가상계좌, 실시간 계좌이체(IOS 별도 설정 필요), 휴대폰 소액결제, 삼성페이, KPAY, 문화상품권, 스마트문상, 해피머니                  |
+| kcp          | NHN KCP             | 신용카드, 가상계좌, 실시간 계좌이체, 휴대폰 소액결제, 삼성페이                                                          |
+| kcp_billing  | NHN KCP 정기결제        | 신용카드                                                                                          |
+| uplus        | 토스페이먼츠 - (구)LG 유플러스 | 신용카드, 가상계좌, 실시간 계좌이체, 휴대폰 소액결제, 문화상품권, 스마트문상, 도서상품권                                           |
+| jtnet        | JTNET               | 신용카드, 가상계좌, 실시간 계좌이체, 휴대폰 소액결제                                                                |
+| nice         | 나이스 정보통신            | 신용카드, 가상계좌, 실시간 계좌이체(IOS/안드로이드 별도 설정 필요), 휴대폰 소액결제                                            |
+| kakaopay     | 신 - 카카오페이           | 신용카드                                                                                          |
+| kakao        | 구 - LG CNS 카카오페이    | 신용카드                                                                                          |
+| danal        | 다날 휴대폰 소액결제         | 휴대폰 소액결제                                                                                      |
+| danal_tpay   | 다날 일반결제             | 신용카드, 가상계좌, 실시간 계좌이체                                                                          |
+| kicc         | 한국정보통신              | 신용카드, 가상계좌, 실시간 계좌이체, 휴대폰 소액결제                                                                |
+| paypal       | 페이팔                 | 신용카드                                                                                          |
+| mobilians    | 모빌리언스               | 신용카드, 가상계좌(준비중), 실시간 계좌이체(준비중), 휴대폰 소액결제                                                      |
+| payco        | 페이코                 | 신용카드                                                                                          |
+| eximbay      | 엑심베이                | 신용카드 [주의사항](https://github.com/iamport/iamport-react-native/issues/70#issuecomment-704601908) |
+| settle       | 세틀뱅크                | 가상계좌                                                                                          |
+| naverco      | 네이버 체크아웃            | 신용카드, 가상계좌, 실시간 계좌이체, 휴대폰 소액결제                                                                |
+| naverpay     | 네이버페이               | 신용카드, 가상계좌, 실시간 계좌이체, 휴대폰 소액결제                                                                |
+| smilepay     | 스마일페이               | 신용카드 [주의사항](https://github.com/iamport/iamport-react-native/issues/71)                        |
+| chai         | 차이페이                | 신용카드                                                                                          |
+| payple       | 페이플                 | 실시간 계좌이체                                                                                      |
+| alipay       | 알리페이                | 신용카드                                                                                          |
+| bluewalnut   | 블루월넛                | 신용카드, 가상계좌, 실시간 계좌이체, 휴대폰 소액결제                                                                |
+| tosspay      | 토스 - 간편결제           | 신용카드                                                                                          |                                                                                           |
+| smartro      | 스마트로                | 신용카드, 가상계좌, 실시간 계좌이체                                                                          |
+| tosspayments | 토스페이먼츠 (신 모듈)       | 신용카드, 가상계좌, 실시간 계좌이체, 휴대폰 소액결제, 상품권(도서문화상품권, 스마트문상, 컬처랜드), 간편결제                               |
+| ksnet        | KSNET               | 신용카드, 가상계좌, 실시간 계좌이체, 휴대폰 소액결제, 간편결제                                                          |
+| daou         | 키움페이(다우데이터, 페이조아)   | 신용카드, 가상계좌, 실시간 계좌이체, 휴대폰 소액결제                                                                |
+| nice_v2      | (신) 나이스페이먼츠         | 신용카드, 가상계좌, 실시간 계좌이체, 휴대폰 소액결제, 상품권(컬처랜드), 간편결제                                               |

package/manuals/TRANS.md

@@ -0,0 +1,77 @@
+# 실시간 계좌이체 설정하기
+## iOS - 웹 표준 이니시스 또는 나이스 정보통신
+iOS에서 `웹 표준 이니시스(이하 이니시스)` 또는 `나이스 정보통신(이하 나이스)` `실시간 계좌이체`를 연동하는 경우 별도 설정이 요구됩니다.
+이니시스는 결제완료 후 콜백이 실행되지 않고, 나이스는 결제인증 후 결제완료 처리가 되지 않기 때문입니다.
+이는 이니시스와 나이스 결제모듈 자체 문제입니다.
+아임포트 RN 모듈은 이에 대응하기 위한 안내를 제공하고 있습니다.
+
+Expo 프로젝트의 경우 아래의 Linking 작업들을 하지 않으셔도 됩니다.
+
+### 실시간 계좌이체 결제처리 원리
+먼저 뱅크페이 앱에서 귀하의 앱으로 복귀할때를 트리거해야 합니다.
+아임포트 RN 모듈은 트리거 된 순간 이니시스의 경우 콜백을 실행시키고, 나이스의 경우 나이스로 결제정보가 담긴 POST 요청을 보냅니다.
+Objective C는 들어오는(incoming) 앱 링크를 트리거 하기 위해 `openURL` 메소드를 제공합니다.
+이때 RN `Linking`을 활용해 RN단에서 들어오는 앱 링크를 트리거 하게 만들 수 있습니다.
+
+자세한 내용은 [RN Linking](https://reactnative.dev/docs/linking)을 참고하세요.
+
+### 프로젝트에 openURL 메소드 추가하기
+`*AppDelegate.m` 파일에 아래 코드를 복사합니다.
+
+```objectivec
+// iOS 9.x or newer
+#import <React/RCTLinkingManager.h>
+
+- (BOOL)application:(UIApplication *)application
+   openURL:(NSURL *)url
+   options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
+{
+  return [RCTLinkingManager application:application openURL:url options:options];
+}
+```
+
+```objectivec
+// iOS 8.x or older
+#import <React/RCTLinkingManager.h>
+
+- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
+  sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
+{
+  return [RCTLinkingManager application:application openURL:url
+                      sourceApplication:sourceApplication annotation:annotation];
+}
+```
+
+## Android - 나이스 정보통신
+안드로이드에서는 `나이스` `실시간 계좌이체`를 연동하는 경우 iOS와 같은 이유로 별도 설정이 요구됩니다.
+
+### 실시간 계좌이체 결제처리 원리
+iOS와 동일하게 뱅크페이 앱에서 귀하의 앱으로 복귀할때를 트리거해야 합니다.
+아임포트 RN 모듈은 트리거 된 순간 나이스로 결제정보가 담긴 POST 요청을 보냅니다.
+안드로이드에서는 들어오는(incoming) 앱 링크를 트리거하기 위해 deep linking 기능을 제공합니다.
+
+### Intent Filter 추가하고 launchMode 설정하기
+deep linking 기능을 활성화하기 위해 `Intent Filter`를 추가하고 `MainActivity`의 `launchMode`를 아래와 같이 `singleTask`로 설정해야 합니다.
+
+자세한 내용은 [RN Linking](https://reactnative.dev/docs/linking)을 참고하세요.
+
+```xml
+...
+<!-- [프로젝트 폴더]/android/app/src/main/AndroidManifest.xml -->.
+<!-- MainActivity의 launchMode를 singleTask로 설정 -->
+<activity
+  android:name=".MainActivity"
+  android:launchMode="singleTask"
+>
+  ...
+  <!-- Intent Filter 추가 -->
+  <intent-filter>
+    <action android:name="android.intent.action.VIEW"/>
+    <category android:name="android.intent.category.DEFAULT"/>
+    <category android:name="android.intent.category.BROWSABLE"/>
+    <data android:scheme="앱 스킴 값 EX. example" />
+  </intent-filter>
+  ...
+</activity>
+...
+```