feat: ACH public API, sample UI and Android wrapper

.github/workflows/android-build-and-distribute.yml

@@ -13,6 +13,12 @@ jobs:
         with:
           access_token: ${{ github.token }}
 
+      - name: Set up JDK 17
+        uses: actions/setup-java@99b8673ff64fbf99d8d325f52d9a5bdedb8483e9 # v4.2.1
+        with:
+          java-version: 17
+          distribution: 'corretto'
+
       - uses: actions/checkout@1d96c772d19495a3b5c517cd2bc0cb401ea0529f # v4.1.3
 
       - uses: ruby/setup-ruby@6bd3d993c602f6b675728ebaecb2b569ff86e99b # v1.174.0

.github/workflows/unit-tests-and-code-quality.yml

@@ -27,6 +27,12 @@ jobs:
     name: Run Android unit tests
     runs-on: ubuntu-latest
     steps:
+      - name: Set up JDK 17
+        uses: actions/setup-java@99b8673ff64fbf99d8d325f52d9a5bdedb8483e9 # v4.2.1
+        with:
+          java-version: 17
+          distribution: 'corretto'
+
       - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
 
       - name: Setup Node.js

packages/example/android/app/build.gradle

@@ -63,6 +63,11 @@ def enableProguardInReleaseBuilds = false
  */
 def jscFlavor = 'org.webkit:android-jsc:+'
 
+java {
+  toolchain {
+    languageVersion.set(JavaLanguageVersion.of(17))
+  }
+}
 
 android {
   ndkVersion rootProject.ext.ndkVersion
@@ -71,6 +76,10 @@ android {
 
   namespace "com.example_0_70_6"
 
+  buildFeatures {
+    buildConfig true
+  }
+
   defaultConfig {
     applicationId "com.example_0_70_6"
     minSdkVersion rootProject.ext.minSdkVersion
@@ -117,6 +126,7 @@ dependencies {
   implementation "io.primer:3ds-android:1.4.3"
   implementation "io.primer:ipay88-my-android:1.0.3"
   implementation "io.primer:klarna-android:1.0.4"
+  implementation "io.primer:stripe-android:1.0.0"
 
   implementation project(path: ':primerioreactnative')
 

packages/example/android/build.gradle

@@ -2,25 +2,24 @@
 
 buildscript {
   ext {
-    buildToolsVersion = "33.0.0"
     minSdkVersion = 21
-    compileSdkVersion = 33
+    compileSdkVersion = 34
     targetSdkVersion = 33
     // We use NDK 23 which has both M1 support and is the side-by-side NDK version from AGP.
     ndkVersion = "23.1.7779620"
-    kotlinVersion = '1.9.0'
+    kotlinVersion = '1.9.24'
   }
   repositories {
     google()
     mavenCentral()
   }
   dependencies {
-    classpath("com.android.tools.build:gradle")
+    classpath("com.android.tools.build:gradle:8.2.2")
     classpath("com.facebook.react:react-native-gradle-plugin")
     classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion")
   }
 }
 
 plugins {
-  id "org.jetbrains.kotlin.android" version "1.8.21" apply false
+  id "org.jetbrains.kotlin.android" version "1.9.24" apply false
 }

packages/example/android/gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.0.1-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.2.1-all.zip
 networkTimeout=10000
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

packages/example/package.json

@@ -12,10 +12,8 @@
     "build:ios": "npx react-native bundle --entry-file='../sdk/index.js' --bundle-output='./ios/main.jsbundle' --dev=true --platform='ios'"
   },
   "dependencies": {
-    "@react-native-masked-view/masked-view": "^0.2.8",
-    "@react-native-picker/picker": "^2.4.8",
     "@react-native-segmented-control/segmented-control": "^2.4.0",
-    "@react-native/gradle-plugin": "^0.72.0",
+    "@react-native/gradle-plugin": "^0.74.0",
     "@react-navigation/native": "^6.1.1",
     "@react-navigation/native-stack": "^6.9.6",
     "add": "^2.0.6",

packages/example/src/App.tsx

@@ -13,6 +13,7 @@ import RawRetailOutletScreen from './screens/RawRetailOutletScreen';
 import HeadlessCheckoutVaultScreen from './screens/HeadlessCheckoutVaultScreen';
 import HeadlessCheckoutKlarnaScreen from './screens/HeadlessCheckoutKlarnaScreen';
 import HeadlessCheckoutWithRedirect from './screens/HeadlessCheckoutWithRedirect';
+import HeadlessCheckoutStripeAchScreen from './screens/HeadlessCheckoutStripeAchScreen';
 import { LogBox } from 'react-native';
 
 const Stack = createNativeStackNavigator();
@@ -37,6 +38,7 @@ const App = () => {
           <Stack.Screen name="RawRetailOutlet" component={RawRetailOutletScreen} />
           <Stack.Screen name="Klarna" component={HeadlessCheckoutKlarnaScreen} />
           <Stack.Screen name="HeadlessCheckoutWithRedirect" component={HeadlessCheckoutWithRedirect} />
+          <Stack.Screen name="HeadlessCheckoutStripeAchScreen" component={HeadlessCheckoutStripeAchScreen} />
         </Stack.Navigator>
       </NavigationContainer>
   );

packages/example/src/models/IClientSessionRequestBody.ts

@@ -7,6 +7,7 @@ export interface IClientSessionRequestBody {
     customerId?: string;
     orderId?: string;
     currencyCode?: string;
+    metadata?: IClientSessionMetadata;
     order?: IClientSessionOrder;
     customer?: IClientSessionCustomer;
     paymentMethod?: IClientSessionPaymentMethod;
@@ -17,6 +18,15 @@ export interface IClientSessionOrder {
     lineItems?: Array<IClientSessionLineItem>
 }
 
+export interface IClientSessionMetadata {
+    scenario?: string;
+    deviceInfo?: IClientSessionDeviceInfo;
+}
+
+export interface IClientSessionDeviceInfo {
+    ipAddress?: string;
+}
+
 export interface IClientSessionCustomer {
     emailAddress?: string;
     mobileNumber?: string;
@@ -91,6 +101,12 @@ export let appPaymentParameters: AppPaymentParameters = {
         customerId: `rn-customer-${makeRandomString(8)}`,
         orderId: `rn-order-${makeRandomString(8)}`,
         currencyCode: 'EUR',
+        metadata: {
+          scenario: 'STRIPE_ACH_ONEOFF',
+          deviceInfo : {
+            ipAddress: '127.0.0.1'
+          } 
+        },
         order: {
             countryCode: 'DE',
             lineItems: [

packages/example/src/screens/AchMandateAlert.tsx

@@ -0,0 +1,17 @@
+import { AchMandateManager } from '@primer-io/react-native';
+import { Alert } from 'react-native';
+
+export async function showAchMandateAlert() {
+    const achMandateManager = new AchMandateManager();
+    Alert.alert('ACH Mandate', 'Would you like to accept this mandate?', [
+        {
+          text: 'No',
+          onPress: () => achMandateManager.declineMandate(),
+          style: 'cancel',
+        },
+        {
+          text: 'Yes', 
+          onPress: () => achMandateManager.acceptMandate()
+        },
+      ]);
+}

packages/example/src/screens/HeadlessCheckoutScreen.tsx

@@ -18,9 +18,10 @@ import {
   NativeUIManager,
   PaymentMethod,
   PrimerSettings,
-  SessionIntent,
+  SessionIntent
 } from '@primer-io/react-native';
 import SegmentedControl from '@react-native-segmented-control/segmented-control';
+import { showAchMandateAlert } from './AchMandateAlert';
 
 let log: string = '';
 let merchantPaymentId: string | null = null;
@@ -80,6 +81,9 @@ export const HeadlessCheckoutScreen = (props: any) => {
       iOS: {
         urlScheme: 'merchant://primer.io',
       },
+      stripeOptions: {
+          publishableKey: "pk_test_51O8zfQKUK6bXIdC2xPvSS6UvriE9kwpvttwB7H9PAzhNAZoGzLgiDOyd4WooozeWHxoRrKo6b2VjZYxNCMX3W7bk00rMDivjau"
+      },
     },
     debugOptions: {
       is3DSSanityCheckEnabled: false
@@ -142,6 +146,11 @@ export const HeadlessCheckoutScreen = (props: any) => {
           )}\n`,
         );
         setIsLoading(false);
+        switch(merchantCheckoutAdditionalInfo.additionalInfoName) {
+          case "DisplayStripeAchMandateAdditionalInfo":
+            showAchMandateAlert();
+            break;
+        }
       },
       onCheckoutComplete: checkoutData => {
         merchantCheckoutData = checkoutData;
@@ -375,6 +384,8 @@ export const HeadlessCheckoutScreen = (props: any) => {
         console.log("Payment session intent is " + selectedSessionIntent)
         if (paymentMethod.paymentMethodType === "KLARNA") {
           props.navigation.navigate('Klarna', { paymentSessionIntent: selectedSessionIntent });
+        } else if (paymentMethod.paymentMethodType === "STRIPE_ACH") {
+          props.navigation.navigate('HeadlessCheckoutStripeAchScreen');
         } else {
           await nativeUIManager.showPaymentMethod(SessionIntent.CHECKOUT);
         }
@@ -529,4 +540,4 @@ export const HeadlessCheckoutScreen = (props: any) => {
       {renderLoadingOverlay()}
     </View>
   );
-};
+};