{"_id":"@atoapayments/atoa-react-native-sdk","_rev":"4-deee6ba0a3b572e89da8a157f9ac3771","name":"@atoapayments/atoa-react-native-sdk","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@atoapayments/atoa-react-native-sdk","version":"1.0.0","keywords":["react-native","ios","android","atoa","payments","open-banking","sdk"],"author":{"url":"https://paywithatoa.co.uk","name":"Vancha Omer","email":"vamsi@paywithatoa.co.uk"},"license":"MIT","_id":"@atoapayments/atoa-react-native-sdk@1.0.0","maintainers":[{"name":"shariqueatoa","email":"sharique@paywithatoa.co.uk"},{"name":"rvkrish","email":"vamsi@paywithatoa.co.uk"},{"name":"tushargupta224","email":"tushar@paywithatoa.co.uk"},{"name":"atoalicence","email":"licence@paywithatoa.co.uk"}],"homepage":"https://github.com/ATOAPaymentsLimited/AtoaReactNativeSDK#readme","bugs":{"url":"https://github.com/ATOAPaymentsLimited/AtoaReactNativeSDK/issues"},"dist":{"shasum":"23bf421aabe9d133f30179624cdc4a62f5d74d9c","tarball":"https://registry.npmjs.org/@atoapayments/atoa-react-native-sdk/-/atoa-react-native-sdk-1.0.0.tgz","fileCount":569,"integrity":"sha512-FSG9ZqIysaFKd9aHinLIwEJgSVISKw/Q+mVdq8IGLeNS/VRq11PjvlRJXr5b6iFFOSdHq8wTM9gRYjMBDl8F9A==","signatures":[{"sig":"MEQCIAU6eBc5rcM6L32A3GoI+eGaP9fVO3zLp+eIRtmDbtCeAiASRSyAZ9gleSTzaE8nbIefDbkrWcymWXc/R7LP7q8weg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2521865},"jest":{"preset":"react-native","modulePathIgnorePatterns":["<rootDir>/example/node_modules","<rootDir>/lib/"]},"main":"lib/commonjs/index","types":"lib/typescript/index.d.ts","module":"lib/module/index","source":"src/index","gitHead":"999ba5c0ae0859ae1e6bf8f24d10b01f949fa933","scripts":{"lint":"eslint \"**/*.{js,ts,tsx}\"","test":"jest","clean":"del-cli lib","prepare":"bob build","release":"release-it","typecheck":"tsc --noEmit"},"_npmUser":{"name":"atoalicence","email":"licence@paywithatoa.co.uk"},"repository":{"url":"git+https://github.com/ATOAPaymentsLimited/AtoaReactNativeSDK.git","type":"git"},"_npmVersion":"10.8.2","description":"Atoa React Native SDK for integrating Atoa Payments into mobile applications","directories":{},"_nodeVersion":"20.20.0","dependencies":{"@babel/runtime":"^7.20.0","react-native-root-siblings":"^5.0.1"},"react-native":"lib/module/index","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","react":"^18.2.0","eslint":"^8.57.0","del-cli":"^5.1.0","tsutils":"^3.21.0","prettier":"^3.2.0","typescript":"^5.3.0","@types/react":"^18.2.0","react-native":"^0.76.0","react-native-svg":"^15.8.0","@types/react-native":"^0.72.0","lottie-react-native":"^7.1.0","@gorhom/bottom-sheet":"^5.0.0","react-native-reanimated":"^4.0.0","react-native-builder-bob":"^0.30.0","@react-native/eslint-config":"^0.76.0","react-native-gesture-handler":"^2.20.0","@react-native-community/netinfo":"^11.4.0"},"peerDependencies":{"react":">=18","react-native":">=0.72","react-native-svg":">=13","lottie-react-native":">=6","@gorhom/bottom-sheet":">=4","react-native-reanimated":">=3","react-native-gesture-handler":">=2","@react-native-community/netinfo":">=9"},"_npmOperationalInternal":{"tmp":"tmp/atoa-react-native-sdk_1.0.0_1772691553063_0.4447516498300388","host":"s3://npm-registry-packages-npm-production"},"react-native-builder-bob":{"output":"lib","source":"src","targets":["commonjs","module",["typescript",{"project":"tsconfig.build.json"}]]}},"1.0.1":{"name":"@atoapayments/atoa-react-native-sdk","version":"1.0.1","keywords":["react-native","ios","android","atoa","payments","open-banking","sdk"],"author":{"url":"https://paywithatoa.co.uk","name":"Vancha Omer","email":"vamsi@paywithatoa.co.uk"},"license":"MIT","_id":"@atoapayments/atoa-react-native-sdk@1.0.1","maintainers":[{"name":"shariqueatoa","email":"sharique@paywithatoa.co.uk"},{"name":"rvkrish","email":"vamsi@paywithatoa.co.uk"},{"name":"tushargupta224","email":"tushar@paywithatoa.co.uk"},{"name":"atoalicence","email":"licence@paywithatoa.co.uk"},{"name":"anandtanu","email":"tanushree@paywithatoa.co.uk"}],"homepage":"https://github.com/ATOAPaymentsLimited/AtoaReactNativeSDK#readme","bugs":{"url":"https://github.com/ATOAPaymentsLimited/AtoaReactNativeSDK/issues"},"dist":{"shasum":"b823c0e95e51026d43dec13203c92c6ed7033163","tarball":"https://registry.npmjs.org/@atoapayments/atoa-react-native-sdk/-/atoa-react-native-sdk-1.0.1.tgz","fileCount":579,"integrity":"sha512-u1Kcm/3iBKSm+CoiqUiht1EWwHuRUUfqmiYP6RTnIijQVjDlMSlTeaf+KwPIf38cTZGi/GDszg2Lf5BYMdz3wA==","signatures":[{"sig":"MEUCIQDclCAC6RfHk0R/jRRCVSaZxCLOrJQ9YFcrNzeIKD9rrQIgORXyFRBSiNEr64XaDlG8SldqDN0Re9iCzsdpch8I1zw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7289605},"jest":{"preset":"react-native","modulePathIgnorePatterns":["<rootDir>/example/node_modules","<rootDir>/lib/"]},"main":"lib/commonjs/index","types":"lib/typescript/index.d.ts","module":"lib/module/index","source":"src/index","gitHead":"358ee8c0f8cbde576051e0aeb01732d21b4833be","scripts":{"lint":"eslint \"**/*.{js,ts,tsx}\"","test":"jest","clean":"del-cli lib","prepare":"bob build","release":"release-it","typecheck":"tsc --noEmit"},"_npmUser":{"name":"atoalicence","email":"licence@paywithatoa.co.uk"},"repository":{"url":"git+https://github.com/ATOAPaymentsLimited/AtoaReactNativeSDK.git","type":"git"},"_npmVersion":"10.8.2","description":"Atoa React Native SDK for integrating Atoa Payments into mobile applications","directories":{},"_nodeVersion":"20.20.0","dependencies":{"@babel/runtime":"^7.20.0","react-native-root-siblings":"^5.0.1"},"react-native":"lib/module/index","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","react":"^18.2.0","eslint":"^8.57.0","del-cli":"^5.1.0","tsutils":"^3.21.0","prettier":"^3.2.0","typescript":"^5.3.0","@types/react":"^18.2.0","react-native":"^0.76.0","react-native-svg":"^15.8.0","@types/react-native":"^0.72.0","lottie-react-native":"^7.1.0","@gorhom/bottom-sheet":"^5.0.0","react-native-reanimated":"^4.0.0","react-native-builder-bob":"^0.30.0","@react-native/eslint-config":"^0.76.0","react-native-gesture-handler":"^2.20.0","@react-native-community/netinfo":"^11.4.0"},"peerDependencies":{"react":">=18","react-native":">=0.72","react-native-svg":">=13","lottie-react-native":">=6","@gorhom/bottom-sheet":">=4","react-native-reanimated":">=3","react-native-gesture-handler":">=2","@react-native-community/netinfo":">=9"},"_npmOperationalInternal":{"tmp":"tmp/atoa-react-native-sdk_1.0.1_1772769265394_0.3913637610037719","host":"s3://npm-registry-packages-npm-production"},"react-native-builder-bob":{"output":"lib","source":"src","targets":["commonjs","module",["typescript",{"project":"tsconfig.build.json"}]]}},"1.0.2":{"name":"@atoapayments/atoa-react-native-sdk","version":"1.0.2","description":"Atoa React Native SDK for integrating Atoa Payments into mobile applications","main":"lib/commonjs/index","module":"lib/module/index","types":"lib/typescript/index.d.ts","react-native":"lib/module/index","source":"src/index","scripts":{"test":"jest","typecheck":"tsc --noEmit","lint":"eslint \"**/*.{js,ts,tsx}\"","clean":"del-cli lib","prepare":"bob build","release":"release-it"},"keywords":["react-native","ios","android","atoa","payments","open-banking","sdk"],"repository":{"type":"git","url":"git+https://github.com/ATOAPaymentsLimited/AtoaReactNativeSDK.git"},"author":{"name":"Vancha Omer","email":"vamsi@paywithatoa.co.uk","url":"https://paywithatoa.co.uk"},"license":"MIT","bugs":{"url":"https://github.com/ATOAPaymentsLimited/AtoaReactNativeSDK/issues"},"homepage":"https://github.com/ATOAPaymentsLimited/AtoaReactNativeSDK#readme","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"dependencies":{"@babel/runtime":"^7.20.0","react-native-root-siblings":"^5.0.1"},"peerDependencies":{"@gorhom/bottom-sheet":">=4","@react-native-community/netinfo":">=9","react":">=18","react-native":">=0.72","react-native-gesture-handler":">=2","react-native-reanimated":">=3","react-native-svg":">=13","lottie-react-native":">=6"},"devDependencies":{"@gorhom/bottom-sheet":"^5.0.0","@react-native-community/netinfo":"^11.4.0","@react-native/eslint-config":"^0.76.0","@types/react":"^18.2.0","@types/react-native":"^0.72.0","del-cli":"^5.1.0","eslint":"^8.57.0","jest":"^29.7.0","lottie-react-native":"^7.1.0","prettier":"^3.2.0","react":"^18.2.0","react-native":"^0.76.0","react-native-builder-bob":"^0.30.0","react-native-gesture-handler":"^2.20.0","react-native-reanimated":"^4.0.0","react-native-svg":"^15.8.0","tsutils":"^3.21.0","typescript":"^5.3.0"},"jest":{"preset":"react-native","modulePathIgnorePatterns":["<rootDir>/example/node_modules","<rootDir>/lib/"]},"react-native-builder-bob":{"source":"src","output":"lib","targets":["commonjs","module",["typescript",{"project":"tsconfig.build.json"}]]},"_id":"@atoapayments/atoa-react-native-sdk@1.0.2","gitHead":"be257123168242fcc64a8373240853e897a5b2b6","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-CzrxG+Iw4LwS5vGpkiqMm+GofEVvkN8BXF+VbRMVkfMtMDpMiDDP/uRVQe8TCEuIJfQpBDVva1M7Yz8Vm8sUnQ==","shasum":"e04e5b72e76960dde0fa5ed5c74eb488e800fc7c","tarball":"https://registry.npmjs.org/@atoapayments/atoa-react-native-sdk/-/atoa-react-native-sdk-1.0.2.tgz","fileCount":579,"unpackedSize":7289605,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC7EoUaYuwruT2u1aTkgxtVkyiePKRhOI1WZN4pXiOecwIhAIkUaDHaYDJfIboMI1phD8imUyGKqJEpbF++K4CLGQ7i"}]},"_npmUser":{"name":"atoalicence","email":"licence@paywithatoa.co.uk"},"directories":{},"maintainers":[{"name":"shariqueatoa","email":"sharique@paywithatoa.co.uk"},{"name":"rvkrish","email":"vamsi@paywithatoa.co.uk"},{"name":"tushargupta224","email":"tushar@paywithatoa.co.uk"},{"name":"atoalicence","email":"licence@paywithatoa.co.uk"},{"name":"anandtanu","email":"tanushree@paywithatoa.co.uk"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/atoa-react-native-sdk_1.0.2_1781528843061_0.5102466444023377"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-05T06:19:12.980Z","modified":"2026-06-15T13:07:23.599Z","1.0.0":"2026-03-05T06:19:13.331Z","1.0.1":"2026-03-06T03:54:25.748Z","1.0.2":"2026-06-15T13:07:23.433Z"},"bugs":{"url":"https://github.com/ATOAPaymentsLimited/AtoaReactNativeSDK/issues"},"author":{"name":"Vancha Omer","email":"vamsi@paywithatoa.co.uk","url":"https://paywithatoa.co.uk"},"license":"MIT","homepage":"https://github.com/ATOAPaymentsLimited/AtoaReactNativeSDK#readme","keywords":["react-native","ios","android","atoa","payments","open-banking","sdk"],"repository":{"type":"git","url":"git+https://github.com/ATOAPaymentsLimited/AtoaReactNativeSDK.git"},"description":"Atoa React Native SDK for integrating Atoa Payments into mobile applications","maintainers":[{"name":"shariqueatoa","email":"sharique@paywithatoa.co.uk"},{"name":"rvkrish","email":"vamsi@paywithatoa.co.uk"},{"name":"tushargupta224","email":"tushar@paywithatoa.co.uk"},{"name":"atoalicence","email":"licence@paywithatoa.co.uk"},{"name":"anandtanu","email":"tanushree@paywithatoa.co.uk"}],"readme":"# Atoa React Native SDK\n\nThe official React Native SDK for integrating Atoa Payments into mobile applications.\n\n[![License: MIT][license_badge]][license_link]\n![Atoa SDK Flow][atoa_banner]\n\n## Overview\n\nThe Atoa React Native SDK allows merchants to easily integrate Atoa Payments into their React Native applications. The SDK provides a simple interface for showing a payment page that handles the entire payment flow securely and efficiently.\n\n- [Installation](#installation)\n- [Setup](#setup)\n- [Usage](#usage)\n- [API Reference](#api-reference)\n- [Handle Response](#handle-response)\n- [Handle Redirection](#handle-redirection-optional)\n- [Bank App Detection](#bank-app-detection)\n- [Complete Demo App](demo_app/App.tsx)\n\n> Please refer to our official React Native documentation [here](https://docs.atoa.me/react-native-sdk).\n\n## Installation\n\n### 1. Install the SDK\n\n```sh\nnpm install @atoapayments/atoa-react-native-sdk\n```\n\nor\n\n```sh\nyarn add @atoapayments/atoa-react-native-sdk\n```\n\n### 2. Install required dependencies\n\nThe SDK uses a few community libraries for its payment sheet UI. **Most React Native projects already have some of these** — only add the ones you're missing.\n\n| Package                           | Used for                       | You likely have it if...                  |\n| --------------------------------- | ------------------------------ | ----------------------------------------- |\n| `react-native-gesture-handler`    | Touch & swipe gestures         | You use React Navigation or bottom sheets |\n| `react-native-reanimated`         | Smooth animations              | You use any animation-heavy library       |\n| `react-native-svg`                | Icons and graphics             | You render SVGs anywhere in your app      |\n| `@gorhom/bottom-sheet`            | Payment sheet modal            | —                                         |\n| `@react-native-community/netinfo` | Network connectivity detection | —                                         |\n| `lottie-react-native`             | Payment status animations      | —                                         |\n\nInstall all at once (skip any you already have):\n\n```sh\nnpm install @gorhom/bottom-sheet react-native-gesture-handler react-native-reanimated react-native-svg @react-native-community/netinfo lottie-react-native\n```\n\nUsing Expo? Use `npx expo install` instead to ensure compatible versions:\n\n```sh\nnpx expo install @gorhom/bottom-sheet react-native-gesture-handler react-native-reanimated react-native-svg @react-native-community/netinfo lottie-react-native\n```\n\n> **Note:** `react-native-reanimated` requires a Babel plugin. If you haven't already, add `'react-native-reanimated/plugin'` to your `babel.config.js`. See the [Reanimated installation guide](https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/getting-started/) for details.\n\n### 3. Install native dependencies (iOS)\n\n```sh\ncd ios && pod install\n```\n\n## Setup\n\n### Wrap your app with AtoaProvider\n\nWrap your app root with `<AtoaProvider>` to enable the Atoa payment modal. This is **required** for `AtoaSdk.pay()` to work.\n\n```tsx\n// index.js\nimport { AppRegistry } from 'react-native';\nimport { AtoaProvider } from '@atoapayments/atoa-react-native-sdk';\nimport App from './App';\nimport { name as appName } from './app.json';\n\nconst Root = () => (\n  <AtoaProvider>\n    <App />\n  </AtoaProvider>\n);\n\nAppRegistry.registerComponent(appName, () => Root);\n```\n\nAlternatively, if you already use `react-native-root-siblings` in your project, you can wrap with `<RootSiblingParent>` directly:\n\n```tsx\nimport { RootSiblingParent } from 'react-native-root-siblings';\n\nconst Root = () => (\n  <RootSiblingParent>\n    <App />\n  </RootSiblingParent>\n);\n```\n\n## Usage\n\nSample code to integrate can be found in [demo_app/App.tsx](demo_app/App.tsx).\n\n### Import package\n\n```tsx\nimport {\n  AtoaSdk,\n  isCompleted,\n  isFailed,\n  isPending,\n  type AtoaPayOptions,\n} from '@atoapayments/atoa-react-native-sdk';\n```\n\n### Show Payment Sheet\n\nA full-screen payment sheet presents available banks. The user selects a bank, confirms the details, and is redirected to their bank app or website to complete payment.\n\n```tsx\nconst result = await AtoaSdk.pay({\n  paymentId: 'your-payment-request-id',\n  env: 'production',\n  // or 'sandbox'\n  showHowPaymentWorks: false,\n  // pass customer details for pre-select bank\n  customerDetails: {\n    phoneCountryCode: '44',\n    phoneNumber: '8788899999',\n    email: 'aaa@gmail.com',\n  },\n  onUserClose: ({\n    paymentRequestId,\n    redirectUrlParams,\n    signature,\n    signatureHash,\n  }) => {\n    // handle payment when user closes the payment verification bottom sheet\n    console.log(\n      `User closed the payment for paymentRequestId: ${paymentRequestId}`\n    );\n  },\n  onPaymentStatusChange: ({\n    status,\n    redirectUrlParams,\n    signature,\n    signatureHash,\n  }) => {\n    // handle payment status\n    console.log(`Payment Status Changed to ${status}`);\n  },\n  onError: (error) => {\n    // handle Atoa SDK error\n    console.error(`Error in Atoa SDK: ${error.message}`);\n  },\n});\n```\n\n### Customer Details for Previously Used Banks\n\nThe SDK supports displaying banks the customer has previously paid with through the `customerDetails` parameter:\n\n#### Important Notes About Customer Details\n\n- **Uniqueness**: The `customerDetails` should be a unique identifier for each customer in your system.\n- **Persistence**: When a customer completes a payment, the bank they used is remembered and associated with this customerDetails.\n- **Returning Customers**: For returning customers, providing the same `customerDetails` allows the SDK to offer the option to pay with banks they've previously used.\n- **Security**: The information about previously used banks is securely stored by Atoa, not in your application.\n- **Optional**: This parameter is optional. If not provided, each payment will be treated as a new transaction without showing previously used banks.\n\n#### Best Practices\n\n- Use a consistent and unique identifier from your system (e.g., user ID, customer reference).\n- Keep the same `customerDetails` across all payments for the same customer to ensure continuity of previously used banks.\n- Consider user consent and data privacy regulations when implementing this functionality.\n\n## API Reference\n\n#### Parameters\n\n- `options`: Configuration object (required)\n  - `env`: The Atoa environment to use (`'sandbox'` | `'production'`)\n  - `paymentId`: The payment request ID (required)\n  - `showHowPaymentWorks`: Shows a sheet which explains the steps for making a payment (required)\n  - `customerDetails`: Customer details for the payment (optional)\n  - `onError`: Error callback function (optional)\n  - `onPaymentStatusChange`: Callback for payment status updates (optional)\n  - `onUserClose`: Callback when payment dialog is closed (optional)\n\n#### Detailed SDK Options\n\n##### Environment\n\n- Type: `AtoaEnv` (`'sandbox'` | `'production'`)\n- Required: Yes\n- Description: Specifies which Atoa environment to use for the payment\n\n##### Payment Request ID\n\n- Type: `string`\n- Required: Yes\n- Description: Unique identifier for the payment request\n\n##### Show How Payment Works\n\n- Type: `boolean`\n- Required: Yes\n- Description: Shows a sheet which explains the steps for making a payment.\n\n##### Customer Details\n\n- Type: `CustomerDetails`\n- Required: No\n- Description: Customer information for the payment. When provided, the SDK will use this information to fetch the last bank used by the customer for payment, improving the user experience by showing their preferred bank first.\n\n```tsx\ninterface CustomerDetails {\n  phoneCountryCode?: string;\n  phoneNumber?: string;\n  email?: string;\n}\n```\n\n##### Event Handlers\n\n###### onError\n\n- Type: `(error: AtoaException) => void`\n- Description: Called when an error occurs during the payment process\n- Parameters:\n  - `error`: Error object containing:\n    - `message`: Error message\n\n###### onPaymentStatusChange\n\n- Type: `(params: { status: string; redirectUrlParams?: Record<string, string>; signature?: string; signatureHash?: string }) => void`\n- Description: Called when the payment status changes\n- Parameters:\n  - `status`: Current payment status\n  - `redirectUrlParams`: (optional) Additional callback parameters\n  - `signature`: (optional) Atoa signature for verification\n  - `signatureHash`: (optional) Atoa signature hash for verification\n\n###### onUserClose\n\n- Type: `(params: { paymentRequestId: string; redirectUrlParams?: Record<string, string>; signature?: string; signatureHash?: string }) => void`\n- Description: Called when the user cancels the payment\n- Parameters:\n  - `paymentRequestId`: The payment request ID\n  - `redirectUrlParams`: (optional) Additional callback parameters\n  - `signature`: (optional) Atoa signature for verification\n  - `signatureHash`: (optional) Atoa signature hash for verification\n\n## Handle Response\n\nYou can handle the payment success, failure, pending and other statuses based on payment response\n\n```tsx\nif (result) {\n  if (isCompleted(result)) {\n    // handle success\n  } else if (isPending(result)) {\n    // handle pending\n  } else if (isFailed(result)) {\n    // handle failure\n  }\n} else {\n  // Bottom sheet was dismissed or encountered an error\n}\n```\n\nSample response can be seen [here](https://docs.atoa.me/introduction#step-3-handle-payment-status).\n\n## Handle Redirection (Optional)\n\nWhen calling the [payment-process](https://docs.atoa.me/api-reference/Payment/process-payment) API, you can specify a `redirectUrl` in your request body. After payment, the user is redirected to this URL, which can deep link back into your app.\n\nUse [App Links](https://developer.android.com/training/app-links) (Android) or [Universal Links](https://developer.apple.com/documentation/xcode/allowing-apps-and-websites-to-link-to-your-content) (iOS) as your redirect URL. These must use the `https` scheme.\n\n**What happens after redirect:**\n\n1. Deep link configured and working — user returns to your app automatically\n2. Deep link not configured — user lands on the redirect URL in a browser\n3. Deep link configured but fails — user lands on the browser; consider adding a \"Return to app\" button on your redirect page as a fallback\n\n> **Tip:** If deep linking fails, the user can always manually switch back to your app after payment.\n\n### Android Setup\n\nAdd an intent filter to `android/app/src/main/AndroidManifest.xml`. Replace `devapp.atoa.me` with your domain and `/sdk-redirect` with your path:\n\n```xml\n  <intent-filter android:autoVerify=\"true\">\n    <action android:name=\"android.intent.action.VIEW\" />\n    <category android:name=\"android.intent.category.DEFAULT\" />\n    <category android:name=\"android.intent.category.BROWSABLE\" />\n    <data android:scheme=\"https\" />\n    <data android:host=\"devapp.atoa.me\" />\n    <data android:path=\"/sdk-redirect\" />\n  </intent-filter>\n```\n\n### iOS Setup\n\nAdd the following to your `Info.plist`. Replace `devapp.atoa.me` with your domain:\n\n    <dict>\n      <key>CFBundleTypeRole</key>\n      <string>Editor</string>\n      <key>CFBundleURLSchemes</key>\n      <array>\n        <string>https</string>\n      </array>\n      <key>CFBundleURLName</key>\n      <string>devapp.atoa.me</string>\n    </dict>\n\nThen update your entitlements file — add `com.apple.developer.associated-domains` with your domain:\n\n```xml\n  <?xml version=\"1.0\" encoding=\"UTF-8\"?>\n  <!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n  <plist version=\"1.0\">\n    <dict>\n      <key>aps-environment</key>\n      <string>development</string>\n      <key>com.apple.developer.associated-domains</key>\n      <array>\n        <string>applinks:devapp.atoa.me</string>\n      </array>\n    </dict>\n  </plist>\n```\n\n### Bank App Detection\n\nThe SDK checks whether the user's selected bank app is installed on their device. This requires declaring the bank app package names / URL schemes in your native configuration.\n\n#### Android\n\nAdd a `<queries>` block to your `AndroidManifest.xml`:\n\n```xml\n <queries>\n    <package android:name=\"com.barclays.android.barclaysmobilebanking\" />\n    <package android:name=\"com.starlingbank.android\" />\n    <package android:name=\"com.grppl.android.shell.CMBlloydsTSB73\" />\n    <package android:name=\"uk.co.hsbc.hsbcukmobilebanking\" />\n    <package android:name=\"com.rbs.mobile.android.natwest\" />\n    <package android:name=\"co.uk.Nationwide.Mobile\" />\n    <package android:name=\"com.grppl.android.shell.halifax\" />\n    <package android:name=\"com.rbs.mobile.android.rbs\" />\n    <package android:name=\"uk.co.santander.santanderUK\" />\n    <package android:name=\"com.revolut.revolut\" />\n    <package android:name=\"co.uk.getmondo\" />\n    <package android:name=\"com.grppl.android.shell.BOS\" />\n    <package android:name=\"ftb.ibank.android\" />\n    <package android:name=\"uk.co.tsb.newmobilebank\" />\n    <package android:name=\"com.firstdirect.bankingonthego\" />\n    <package android:name=\"com.virginmoney.uk.mobile.android\" />\n    <package android:name=\"uk.co.ybs.savings.external\" />\n    <package android:name=\"com.transferwise.android\" />\n    <package android:name=\"com.nearform.ptsb\" />\n    <package android:name=\"com.bankofireland.mobilebanking\" />\n    <package android:name=\"aib.ibank.android\" />\n    <package android:name=\"uk.co.bankofscotland.businessbank\" />\n    <package android:name=\"com.chase.intl\" />\n    <package android:name=\"com.rbs.mobile.android.ubn\" />\n    <package android:name=\"com.rbs.banklinemobile.rbs\" />\n    <package android:name=\"uk.co.hsbc.hsbcukbusinessbanking\" />\n    <package android:name=\"com.lloydsbank.businessmobile\" />\n    <package android:name=\"com.rbs.banklinemobile.natwest\" />\n  </queries>\n```\n\n#### iOS\n\nAdd `LSApplicationQueriesSchemes` to your `Info.plist`:\n\n```xml\n<key>LSApplicationQueriesSchemes</key>\n<array>\n    <string>pulsesecure</string>\n    <string>launchbmb</string>\n    <string>lloyds-retail</string>\n    <string>hsbc-pwnwguti5z</string>\n    <string>uk.co.santander.santanderUK</string>\n    <string>fb894703657238109</string>\n    <string>bos-retail</string>\n    <string>halifax-retail</string>\n    <string>monzo</string>\n    <string>starlingbank</string>\n    <string>tsbmobile</string>\n    <string>comfirstdirectbankingonthego</string>\n    <string>launchFT</string>\n    <string>virginmoneyimport</string>\n    <string>ybssavings</string>\n    <string>transferwise</string>\n    <string>tg</string>\n    <string>BOIOneAPP</string>\n    <string>ie.aib.mobilebanking</string>\n    <string>bos-commercial</string>\n    <string>chase-international</string>\n    <string>revolut</string>\n    <string>lloyds-commercial</string>\n    <string>dbbukmobileapp</string>\n    <string>nationwide</string>\n    <string>ydl</string>\n</array>\n```\n\n### Resources\n\n- [React Native Linking](https://reactnative.dev/docs/linking)\n- [Android App Links](https://developer.android.com/training/app-links)\n- [iOS Universal Links](https://developer.apple.com/documentation/xcode/allowing-apps-and-websites-to-link-to-your-content)\n\n## Support\n\nFor any issues or inquiries, please contact hello@paywithatoa.co.uk.\n\n[license_badge]: https://img.shields.io/badge/license-MIT-blue.svg\n[license_link]: https://opensource.org/licenses/MIT\n[atoa_banner]: src/assets/images/atoa_sdk.png\n\n## License\n\nMIT © [Atoa Payments Limited](https://github.com/ATOAPaymentsLimited)\n","readmeFilename":"README.md"}