F253333: SAQ-A Native Components

access-checkout-react-native-sdk/.prettierrc.json

@@ -4,6 +4,5 @@
   "tabWidth": 2,
   "trailingComma": "es5",
   "useTabs": false,
-  "arrowParens": "avoid",
-  "bracketSameLine": true
+  "printWidth": 120
 }

access-checkout-react-native-sdk/README.md

@@ -7,18 +7,27 @@ Create your own uniquely styled and branded checkout form by integrating our Rea
 This SDK is the first step to integrate with our Access Worldpay APIs into a React Native app.
 It is designed to simplify the integration of the following functionality in your checkout form:
 - validating the format of the card details entered by a customer
-- generating a session (short-lived token representing a customer's card details)  
+- generating a session (short-lived token representing a customer's card details)
 
 ## Documentation
 
-You can find the detailed documentation explaining how to integrate the SDK and use a session to take a payment starting with the [React Native section](https://developer.worldpay.com/docs/access-worldpay/checkout/react-native) of the [Access Worldpay documentation](https://developer.worldpay.com).
+You can find the detailed documentation explaining how to integrate the SDK and use a session to take a payment starting with the [React Native section](https://developer.worldpay.com/docs/access-worldpay/checkout/react-native) of the [Access Worldpay Checkout documentation](https://developer.worldpay.com).
 
 ## Compatibility
 
 - `React Native 0.70.0` and above
 - `React 18.1.0` and above
 - `Cocoapods` only for iOS dependencies
 
+## SAQ-A Compliance
+
+To support SAQ-A compliance when using our React Native SDK, we have created a new component called AccessCheckoutTextInput:
+It has been designed so that it does not expose any methods or properties to retrieve the text entered by the end user to ensure our merchants applications do not have direct access to card details and are SAQ-A compliant.
+
+## AccessCheckoutTextInput
+
+You can find detailed documentation about our new component [AccessCheckoutTextInput](https://developer.worldpay.com/docs/access-worldpay/checkout/react-native/optional-configuration) within the [React Native section](https://developer.worldpay.com/docs/access-worldpay/checkout/react-native) of the [Access Worldpay Checkout documentation](https://developer.worldpay.com).
+
 ## How to install
 
 Refer to [Get our SDK](https://developer.worldpay.com/docs/access-worldpay/checkout/react-native#get-our-sdk) in the React Native section of the [Access Worldpay documentation](https://developer.worldpay.com)

access-checkout-react-native-sdk/android/access-checkout-react-native-sdk-android-bridge/build.gradle

@@ -48,6 +48,8 @@ dependencies {
     testImplementation 'junit:junit:4.13.2'
     testImplementation 'org.assertj:assertj-core:3.21.0'
     testImplementation 'org.robolectric:robolectric:4.4'
+    testImplementation 'org.mockito:mockito-core:5.8.0'
+
 
     instrumentedTestsImplementation 'androidx.test:core:1.4.0'
     instrumentedTestsImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.2'

access-checkout-react-native-sdk/android/access-checkout-react-native-sdk-android-bridge/src/androidTestInstrumentedTests/java/com/worldpay/access/checkout/reactnative/session/SessionsInstrumentedTests.kt

@@ -3,15 +3,18 @@ package com.worldpay.access.checkout.reactnative.session
 import android.content.Context
 import androidx.test.core.app.ActivityScenario
 import androidx.test.platform.app.InstrumentationRegistry
-import com.github.tomakehurst.wiremock.client.WireMock.*
+import com.github.tomakehurst.wiremock.client.WireMock.equalTo
+import com.github.tomakehurst.wiremock.client.WireMock.postRequestedFor
+import com.github.tomakehurst.wiremock.client.WireMock.urlEqualTo
+import com.github.tomakehurst.wiremock.client.WireMock.verify
 import com.worldpay.access.checkout.reactnative.services.AccessServicesRootStub
 import com.worldpay.access.checkout.reactnative.services.MockServer
 import com.worldpay.access.checkout.reactnative.services.MockServer.startStubServices
 import com.worldpay.access.checkout.reactnative.services.MockServer.stopStubServices
 import com.worldpay.access.checkout.reactnative.services.SessionsStub
-import com.worldpay.access.checkout.reactnative.session.SessionsTestFixture.Companion.CARD
-import com.worldpay.access.checkout.reactnative.session.SessionsTestFixture.Companion.CVC
-import com.worldpay.access.checkout.reactnative.session.SessionsTestFixture.Companion.sessionsTextFixture
+import com.worldpay.access.checkout.reactnative.utils.TestFixture.Companion.CARD
+import com.worldpay.access.checkout.reactnative.utils.TestFixture.Companion.CVC
+import com.worldpay.access.checkout.reactnative.utils.TestFixture.Companion.testFixture
 import org.awaitility.Awaitility.await
 import org.junit.After
 import org.junit.Before
@@ -20,11 +23,11 @@ import java.util.concurrent.TimeUnit.MILLISECONDS
 
 
 class SessionsInstrumentedTests {
-    private val timeOutInMs = 5000L
+    private val timeOutInMs = 500000L
 
     @Before
     fun setup() {
-        sessionsTextFixture().clear()
+        testFixture().clear()
 
         val context: Context = InstrumentationRegistry.getInstrumentation().context
         startStubServices(context, MockServer.PORT)
@@ -41,11 +44,10 @@ class SessionsInstrumentedTests {
     @Test
     fun testShouldBeAbleToGenerateACardSession() {
         SessionsStub.stubSessionsCardSuccess("my-session")
-        sessionsTextFixture().pan("4444333322221111")
+        testFixture().pan("4444333322221111")
             .expiryDate("12/34")
             .cvc("123")
             .sessionsTypes(listOf(CARD))
-            .reactNativeSdkVersion("1.0.0")
 
         val scenario = ActivityScenario.launch(SessionsInstrumentedTestsActivity::class.java)
 
@@ -58,11 +60,10 @@ class SessionsInstrumentedTests {
         SessionsStub.stubSessionsCardSuccess("my-session")
         SessionsStub.stubSessionsPaymentsCvcSuccess("my-other-session")
 
-        sessionsTextFixture().pan("4444333322221111")
+        testFixture().pan("4444333322221111")
             .expiryDate("12/34")
             .cvc("123")
             .sessionsTypes(listOf(CARD, CVC))
-            .reactNativeSdkVersion("1.0.0")
 
         val scenario = ActivityScenario.launch(SessionsInstrumentedTestsActivity::class.java)
 
@@ -77,10 +78,8 @@ class SessionsInstrumentedTests {
     fun testShouldBeAbleToGenerateACvcOnlySession() {
         SessionsStub.stubSessionsPaymentsCvcSuccess("my-other-session")
 
-        sessionsTextFixture()
-            .cvc("123")
+        testFixture().cvc("123")
             .sessionsTypes(listOf(CVC))
-            .reactNativeSdkVersion("1.0.0")
 
         val scenario = ActivityScenario.launch(SessionsInstrumentedTestsActivity::class.java)
 
@@ -99,38 +98,22 @@ class SessionsInstrumentedTests {
         SessionsStub.stubSessionsCardSuccess("my-session")
         SessionsStub.stubSessionsPaymentsCvcFailure(errorName, message)
 
-        sessionsTextFixture()
-            .pan("4444333322221111")
+        testFixture().pan("4444333322221111")
             .expiryDate("12/34")
             .cvc("123")
             .sessionsTypes(listOf(CARD, CVC))
-            .reactNativeSdkVersion("1.0.0")
 
         val scenario = ActivityScenario.launch(SessionsInstrumentedTestsActivity::class.java)
 
         assertExceptionIs(scenario, expectedException)
     }
 
-    @Test
-    fun testShouldBeAbleToGiveErrorWhenSessionsTypeContainsCvcAndANullCvcIsPassed() {
-        val exception = RuntimeException("Expected cvcValue to be provided but was not")
-
-        sessionsTextFixture()
-            .cvc(null)
-            .sessionsTypes(listOf(CVC))
-            .reactNativeSdkVersion("1.0.0")
-
-        val scenario = ActivityScenario.launch(SessionsInstrumentedTestsActivity::class.java)
-
-        assertExceptionIs(scenario, exception)
-    }
-
     @Test
     fun testShouldSetNativeSdkWpSdkHeaderWithAccessCheckoutReactNativeVersion() {
         SessionsStub.stubSessionsCardSuccess("my-session")
         SessionsStub.stubSessionsPaymentsCvcSuccess("my-other-session")
 
-        sessionsTextFixture().pan("4444333322221111")
+        testFixture().pan("4444333322221111")
             .expiryDate("12/34")
             .cvc("123")
             .sessionsTypes(listOf(CARD, CVC))
@@ -147,7 +130,7 @@ class SessionsInstrumentedTests {
         verify(
             postRequestedFor(urlEqualTo("/sessions/payments/cvc"))
                 .withHeader("X-WP-SDK", equalTo("access-checkout-react-native/1.2.3"))
-        );
+        )
     }
 
     private fun assertSessionsAre(

access-checkout-react-native-sdk/android/access-checkout-react-native-sdk-android-bridge/src/androidTestInstrumentedTests/java/com/worldpay/access/checkout/reactnative/validation/CardValidationInstrumentedTests.kt

@@ -10,9 +10,14 @@ import com.worldpay.access.checkout.reactnative.services.CardBrandsStub.Companio
 import com.worldpay.access.checkout.reactnative.services.MockServer
 import com.worldpay.access.checkout.reactnative.services.MockServer.startStubServices
 import com.worldpay.access.checkout.reactnative.services.MockServer.stopStubServices
-import com.worldpay.access.checkout.reactnative.validation.CardValidationTestFixture.Companion.validationTestFixture
+import com.worldpay.access.checkout.reactnative.utils.TestFixture
+import com.worldpay.access.checkout.reactnative.utils.TestFixture.Companion.testFixture
 import org.awaitility.Awaitility.await
-import org.junit.*
+import org.junit.After
+import org.junit.AfterClass
+import org.junit.Before
+import org.junit.BeforeClass
+import org.junit.Test
 import java.util.concurrent.CopyOnWriteArrayList
 import java.util.concurrent.TimeUnit.MILLISECONDS
 
@@ -38,13 +43,7 @@ class CardValidationInstrumentedTests {
 
     @Before
     fun setUp() {
-        validationTestFixture()
-            .clear()
-            .panId(CardValidationInstrumentedTestsActivity.panId)
-            .expiryDateId(CardValidationInstrumentedTestsActivity.expiryDateId)
-            .cvcId(CardValidationInstrumentedTestsActivity.cvcId)
-
-        CardValidationInstrumentedTestsActivity.clearActions()
+        TestFixture().clear()
     }
 
     @After
@@ -55,7 +54,7 @@ class CardValidationInstrumentedTests {
     @Test
     fun shouldRaiseEventWhenPanBecomesValid() {
         startActivity().use { scenario ->
-            CardValidationInstrumentedTestsActivity.run { activity ->
+            scenario.onActivity { activity ->
                 activity.setPan("4444333322221111")
             }
 
@@ -71,7 +70,7 @@ class CardValidationInstrumentedTests {
     @Test
     fun shouldRaiseEventWhenPanBecomesInvalid() {
         startActivity().use { scenario ->
-            CardValidationInstrumentedTestsActivity.run { activity ->
+            scenario.onActivity { activity ->
                 activity.setPan("4444333322221111")
                 activity.setPan("4")
             }
@@ -92,7 +91,7 @@ class CardValidationInstrumentedTests {
     @Test
     fun shouldRaiseEventWhenExpiryDateBecomesValid() {
         startActivity().use { scenario ->
-            CardValidationInstrumentedTestsActivity.run { activity ->
+            scenario.onActivity { activity ->
                 activity.setExpiryDate("12/30")
             }
 
@@ -108,7 +107,7 @@ class CardValidationInstrumentedTests {
     @Test
     fun shouldRaiseEventWhenExpiryDateBecomesInvalid() {
         startActivity().use { scenario ->
-            CardValidationInstrumentedTestsActivity.run { activity ->
+            scenario.onActivity { activity ->
                 activity.setExpiryDate("12/30")
                 activity.setExpiryDate("12/3")
             }
@@ -129,7 +128,7 @@ class CardValidationInstrumentedTests {
     @Test
     fun shouldRaiseEventWhenCvcBecomesValid() {
         startActivity().use { scenario ->
-            CardValidationInstrumentedTestsActivity.run { activity ->
+            scenario.onActivity { activity ->
                 activity.setCvc("123")
             }
 
@@ -145,7 +144,7 @@ class CardValidationInstrumentedTests {
     @Test
     fun shouldRaiseEventWhenCvcBecomesInvalid() {
         startActivity().use { scenario ->
-            CardValidationInstrumentedTestsActivity.run { activity ->
+            scenario.onActivity { activity ->
                 activity.setCvc("123")
                 activity.setCvc("12")
             }
@@ -166,7 +165,7 @@ class CardValidationInstrumentedTests {
     @Test
     fun shouldRaiseEventWhenAllFieldsBecomeValid() {
         startActivity().use { scenario ->
-            CardValidationInstrumentedTestsActivity.run { activity ->
+            scenario.onActivity { activity ->
                 activity.setPan("4444333322221111")
                 activity.setExpiryDate("12/30")
                 activity.setCvc("123")
@@ -184,7 +183,7 @@ class CardValidationInstrumentedTests {
     @Test
     fun shouldRaiseEventWhenRecognisingCardBrand() {
         startActivityWithCardBrandRules().use { scenario ->
-            CardValidationInstrumentedTestsActivity.run { activity ->
+            scenario.onActivity { activity ->
                 activity.setPan("4")
             }
 
@@ -211,10 +210,10 @@ class CardValidationInstrumentedTests {
 
     @Test
     fun shouldRaiseAnInvalidPanEventWhenCardBrandIsNotAcceptedByMerchant() {
-        validationTestFixture().acceptedCardBrands(listOf("jcb"))
+        testFixture().acceptedCardBrands(listOf("jcb"))
 
         startActivityWithCardBrandRules().use { scenario ->
-            CardValidationInstrumentedTestsActivity.run { activity ->
+            scenario.onActivity { activity ->
                 activity.setPan("4")
             }
 

access-checkout-react-native-sdk/android/access-checkout-react-native-sdk-android-bridge/src/androidTestInstrumentedTests/java/com/worldpay/access/checkout/reactnative/validation/CvcOnlyValidationInstrumentedTests.kt

@@ -8,9 +8,11 @@ import com.worldpay.access.checkout.reactnative.react.EventMock
 import com.worldpay.access.checkout.reactnative.services.MockServer
 import com.worldpay.access.checkout.reactnative.services.MockServer.startStubServices
 import com.worldpay.access.checkout.reactnative.services.MockServer.stopStubServices
-import com.worldpay.access.checkout.reactnative.validation.CvcOnlyValidationTestFixture.Companion.cvcOnlyValidationTestFixture
 import org.awaitility.Awaitility.await
-import org.junit.*
+import org.junit.After
+import org.junit.AfterClass
+import org.junit.BeforeClass
+import org.junit.Test
 import java.util.concurrent.CopyOnWriteArrayList
 import java.util.concurrent.TimeUnit.MILLISECONDS
 
@@ -34,15 +36,6 @@ class CvcOnlyValidationInstrumentedTests {
     }
 
 
-    @Before
-    fun setUp() {
-        cvcOnlyValidationTestFixture()
-            .clear()
-            .cvcId(CvcOnlyValidationInstrumentedTestsActivity.cvcId)
-
-        CvcOnlyValidationInstrumentedTestsActivity.clearActions()
-    }
-
     @After
     fun tearDown() {
         WireMock.reset()
@@ -51,7 +44,7 @@ class CvcOnlyValidationInstrumentedTests {
     @Test
     fun shouldRaiseEventWhenCvcBecomesValid() {
         startActivity().use { scenario ->
-            CvcOnlyValidationInstrumentedTestsActivity.run { activity ->
+            scenario.onActivity { activity ->
                 activity.setCvc("123")
             }
 
@@ -67,7 +60,7 @@ class CvcOnlyValidationInstrumentedTests {
     @Test
     fun shouldRaiseEventWhenCvcBecomesInvalid() {
         startActivity().use { scenario ->
-            CvcOnlyValidationInstrumentedTestsActivity.run { activity ->
+            scenario.onActivity { activity ->
                 activity.setCvc("123")
                 activity.setCvc("12")
             }
@@ -88,7 +81,7 @@ class CvcOnlyValidationInstrumentedTests {
     @Test
     fun shouldRaiseEventWhenAllFieldsBecomeValid() {
         startActivity().use { scenario ->
-            CvcOnlyValidationInstrumentedTestsActivity.run { activity ->
+            scenario.onActivity { activity ->
                 activity.setCvc("123")
             }