connection token error handling

README.md

@@ -64,11 +64,12 @@ First, create an endpoint on your backend server that creates a new connection t
 Next, create a token provider that will fetch connection token from your server and provide it to StripeTerminalProvider as a parameter.
 Stripe Terminal SDK will fetch it when it's needed.
 
+
 ```tsx
-// App.ts
+// Root.ts
 import { StripeTerminalProvider } from '@stripe/stripe-terminal-react-native';
 
-function App() {
+function Root() {
   const fetchTokenProvider = async () => {
     const response = await fetch(`${API_URL}/connection_token`, {
       method: 'POST',
@@ -85,12 +86,32 @@ function App() {
       logLevel="verbose"
       tokenProvider={fetchTokenProvider}
     >
-      <Screen />
+      <App />
     </StripeTerminalProvider>
   );
 }
 ```
 
+As a last step, simply call `initialize` method from `useStripeTerminal` hook.
+Please note that `initialize` method must be called from the nested component of `StripeTerminalProvider`.
+
+```tsx
+// App.tsx
+function App() {
+  const { initialize } = useStripeTerminal()
+
+  useEffect(() => {
+    initialize({
+      logLevel: 'verbose',
+    });
+  }, [])
+
+  return (
+    <View />
+  );
+}
+```
+
 ## Configure your app
 
 ### Android

android/src/main/java/com/stripeterminalreactnative/StripeTerminalReactNativeModule.kt

@@ -135,8 +135,10 @@ class StripeTerminalReactNativeModule(reactContext: ReactApplicationContext) :
   }
 
   @ReactMethod
-  fun setConnectionToken(token: String, promise: Promise) {
-    TokenProvider.setConnectionToken(token)
+  fun setConnectionToken(params: ReadableMap, promise: Promise) {
+    val token = getStringOr(params, "token")
+    val error = getStringOr(params, "error")
+    TokenProvider.setConnectionToken(token, error)
     promise.resolve(null)
   }
 

android/src/main/java/com/stripeterminalreactnative/TokenProvider.kt

@@ -12,10 +12,16 @@ class TokenProvider() {
 
     private var connectionTokenCallback: ConnectionTokenCallback? = null
 
-    fun setConnectionToken(token: String) {
+    fun setConnectionToken(token: String?, error: String?) {
       try {
-        connectionTokenCallback?.onSuccess(token)
-        connectionTokenCallback = null
+        if (!token.isNullOrEmpty()) {
+          connectionTokenCallback?.onSuccess(token)
+          connectionTokenCallback = null
+        } else {
+          connectionTokenCallback?.onFailure(
+            ConnectionTokenException(error ?: "", null)
+          )
+        }
       } catch (e: Exception) {
         connectionTokenCallback?.onFailure(
           ConnectionTokenException("Failed to fetch connection token", e)

docs/set-up-your-sdk.md

@@ -147,10 +147,10 @@ This function is called whenever the SDK needs to authenticate with Stripe or th
 To get started, provide your token provider implemented in [Step 3](#set-up-the-connection-token-endpoint) to `StripeTerminalProvider` as a prop.
 
 ```tsx
-// App.ts
+// Root.ts
 import { StripeTerminalProvider } from '@stripe/stripe-terminal-react-native';
 
-function App() {
+function Root() {
   const fetchTokenProvider = async () => {
     const response = await fetch(`${API_URL}/connection_token`, {
       method: 'POST',
@@ -167,8 +167,28 @@ function App() {
       logLevel="verbose"
       tokenProvider={fetchTokenProvider}
     >
-      <Screen />
+      <App />
     </StripeTerminalProvider>
   );
 }
 ```
+
+As a last step, simply call `initialize` method from `useStripeTerminal` hook.
+Please note that `initialize` method must be called from the nested component of `StripeTerminalProvider`.
+
+```tsx
+// App.tsx
+function App() {
+  const { initialize } = useStripeTerminal()
+
+  useEffect(() => {
+    initialize({
+      logLevel: 'verbose',
+    });
+  }, [])
+
+  return (
+    <View />
+  );
+}
+```

example/index.js

@@ -1,5 +1,5 @@
 import { AppRegistry } from 'react-native';
-import App from './src/App';
+import Root from './src/Root';
 import { name as appName } from './app.json';
 
-AppRegistry.registerComponent(appName, () => App);
+AppRegistry.registerComponent(appName, () => Root);

example/ios/StripeTerminalReactNativeExample.xcodeproj/project.pbxproj

@@ -753,7 +753,7 @@
 				COPY_PHASE_STRIP = NO;
 				ENABLE_STRICT_OBJC_MSGSEND = YES;
 				ENABLE_TESTABILITY = YES;
-				"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = "arm64 ";
+				"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = "";
 				GCC_C_LANGUAGE_STANDARD = gnu99;
 				GCC_DYNAMIC_NO_PIC = NO;
 				GCC_NO_COMMON_BLOCKS = YES;
@@ -810,7 +810,7 @@
 				COPY_PHASE_STRIP = YES;
 				ENABLE_NS_ASSERTIONS = NO;
 				ENABLE_STRICT_OBJC_MSGSEND = YES;
-				"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = "arm64 ";
+				"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = "";
 				GCC_C_LANGUAGE_STANDARD = gnu99;
 				GCC_NO_COMMON_BLOCKS = YES;
 				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;