feat(POM-519): nAPM headless redirect

example/src/main/kotlin/com/processout/example/ui/screen/nativeapm/NativeApmFragment.kt

@@ -119,7 +119,9 @@ class NativeApmFragment : BaseFragment<FragmentNativeApmBinding>(
                         gatewayConfigurationId = uiModel.gatewayConfigurationId
                     ),
                     cancelButton = CancelButton(),
-                    returnUrl = Constants.RETURN_URL,
+                    redirect = RedirectConfiguration(
+                        returnUrl = Constants.RETURN_URL
+                    ),
                     paymentConfirmation = PaymentConfirmationConfiguration(
                         confirmButton = Button(),
                         cancelButton = CancelButton(disabledForSeconds = 3)
@@ -134,11 +136,15 @@ class NativeApmFragment : BaseFragment<FragmentNativeApmBinding>(
                         customerTokenId = uiModel.customerTokenId
                     ),
                     cancelButton = CancelButton(),
-                    returnUrl = Constants.RETURN_URL,
+                    redirect = RedirectConfiguration(
+                        returnUrl = Constants.RETURN_URL,
+                        enableHeadlessMode = true
+                    ),
                     paymentConfirmation = PaymentConfirmationConfiguration(
                         confirmButton = Button(),
                         cancelButton = CancelButton(disabledForSeconds = 3)
-                    )
+                    ),
+                    success = null
                 )
             )
             AUTHORIZE_LEGACY -> launcherLegacy.launch(
@@ -155,7 +161,9 @@ class NativeApmFragment : BaseFragment<FragmentNativeApmBinding>(
                         gatewayConfigurationId = uiModel.gatewayConfigurationId
                     ),
                     cancelButton = CancelButton(),
-                    returnUrl = Constants.RETURN_URL,
+                    redirect = RedirectConfiguration(
+                        returnUrl = Constants.RETURN_URL
+                    ),
                     paymentConfirmation = PaymentConfirmationConfiguration(
                         confirmButton = Button(),
                         cancelButton = CancelButton(disabledForSeconds = 3)

sdk/src/main/kotlin/com/processout/sdk/api/model/response/POImageResource.kt

@@ -1,29 +1,33 @@
 package com.processout.sdk.api.model.response
 
+import android.os.Parcelable
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
+import kotlinx.parcelize.Parcelize
 
 /**
  * Image resource for light/dark themes.
  *
  * @param[lightUrl] URL to image for light theme.
  * @param[darkUrl] URL to image for dark theme.
  */
+@Parcelize
 @JsonClass(generateAdapter = true)
 data class POImageResource(
     @Json(name = "light_url")
     val lightUrl: ResourceUrl,
     @Json(name = "dark_url")
     val darkUrl: ResourceUrl?
-) {
+) : Parcelable {
 
     /**
      * Image resource URL.
      *
      * @param[raster] URL to raster image.
      */
+    @Parcelize
     @JsonClass(generateAdapter = true)
     data class ResourceUrl(
         val raster: String
-    )
+    ) : Parcelable
 }

sdk/src/main/kotlin/com/processout/sdk/api/model/response/napm/v2/PONativeAlternativePaymentAuthorizationResponse.kt

@@ -1,8 +1,10 @@
 package com.processout.sdk.api.model.response.napm.v2
 
+import android.os.Parcelable
 import com.processout.sdk.api.model.response.napm.v2.PONativeAlternativePaymentAuthorizationResponse.Invoice
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
+import kotlinx.parcelize.Parcelize
 
 /**
  * Specifies details of native alternative payment.
@@ -13,25 +15,27 @@ import com.squareup.moshi.JsonClass
  * @param[elements] An ordered list of elements that needs to be rendered on the UI during native alternative payment flow.
  * @param[redirect] Indicates required redirect.
  */
+@Parcelize
 data class PONativeAlternativePaymentAuthorizationResponse(
     val state: PONativeAlternativePaymentState,
     val invoice: Invoice,
     val paymentMethod: PONativeAlternativePaymentMethodDetails,
     val elements: List<PONativeAlternativePaymentElement>?,
     val redirect: PONativeAlternativePaymentRedirect?
-) {
+) : Parcelable {
 
     /**
      * Invoice details.
      *
      * @param[amount] Invoice amount.
      * @param[currency] Invoice currency.
      */
+    @Parcelize
     @JsonClass(generateAdapter = true)
     data class Invoice(
         val amount: String,
         val currency: String
-    )
+    ) : Parcelable
 }
 
 @JsonClass(generateAdapter = true)

sdk/src/main/kotlin/com/processout/sdk/api/model/response/napm/v2/PONativeAlternativePaymentCustomerInstruction.kt

@@ -1,22 +1,25 @@
 package com.processout.sdk.api.model.response.napm.v2
 
+import android.os.Parcelable
 import com.processout.sdk.api.model.response.POBarcode
 import com.processout.sdk.api.model.response.POImageResource
 import com.processout.sdk.core.annotation.ProcessOutInternalApi
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
+import kotlinx.parcelize.Parcelize
 
 /**
  * Specifies instruction for the customer, providing additional information and/or describing required actions.
  */
-sealed class PONativeAlternativePaymentCustomerInstruction {
+sealed class PONativeAlternativePaymentCustomerInstruction : Parcelable {
 
     /**
      * Customer instruction provided as a markdown text.
      *
      * @param[label] Optional label.
      * @param[value] Markdown text.
      */
+    @Parcelize
     @JsonClass(generateAdapter = true)
     data class Message(
         val label: String?,
@@ -28,6 +31,7 @@ sealed class PONativeAlternativePaymentCustomerInstruction {
      *
      * @param[value] Image resource.
      */
+    @Parcelize
     @JsonClass(generateAdapter = true)
     data class Image(
         val value: POImageResource
@@ -39,6 +43,7 @@ sealed class PONativeAlternativePaymentCustomerInstruction {
      * @param[rawSubtype] Raw barcode subtype.
      * @param[rawValue] Base64 encoded value.
      */
+    @Parcelize
     @JsonClass(generateAdapter = true)
     data class Barcode(
         @Json(name = "subtype")
@@ -59,6 +64,7 @@ sealed class PONativeAlternativePaymentCustomerInstruction {
      * Placeholder that allows adding additional cases while staying backward compatible.
      * __Warning:__ Do not match this case directly, use _when-else_ instead.
      */
+    @Parcelize
     @ProcessOutInternalApi
     data object Unknown : PONativeAlternativePaymentCustomerInstruction()
 }

sdk/src/main/kotlin/com/processout/sdk/api/model/response/napm/v2/PONativeAlternativePaymentElement.kt

@@ -1,27 +1,31 @@
 package com.processout.sdk.api.model.response.napm.v2
 
+import android.os.Parcelable
 import com.processout.sdk.api.model.response.napm.v2.PONativeAlternativePaymentElement.Form.Parameter
 import com.processout.sdk.core.annotation.ProcessOutInternalApi
 import com.processout.sdk.core.util.findBy
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
+import kotlinx.parcelize.IgnoredOnParcel
+import kotlinx.parcelize.Parcelize
 
 /**
  * Specifies an element that needs to be rendered on the UI during native alternative payment flow.
  */
-sealed class PONativeAlternativePaymentElement {
+sealed class PONativeAlternativePaymentElement : Parcelable {
 
     /**
      * A form element with the specified [parameterDefinitions].
      */
+    @Parcelize
     data class Form(
         val parameterDefinitions: List<Parameter>
     ) : PONativeAlternativePaymentElement() {
 
         /**
          * Payment parameter definition.
          */
-        sealed class Parameter {
+        sealed class Parameter : Parcelable {
 
             /** Parameter key. */
             abstract val key: String
@@ -41,6 +45,7 @@ sealed class PONativeAlternativePaymentElement {
              * @param[minLength] Optional minimum length.
              * @param[maxLength] Optional maximum length.
              */
+            @Parcelize
             @JsonClass(generateAdapter = true)
             data class Text(
                 override val key: String,
@@ -60,6 +65,7 @@ sealed class PONativeAlternativePaymentElement {
              * @param[required] Indicates whether the parameter is required.
              * @param[availableValues] Available values.
              */
+            @Parcelize
             @JsonClass(generateAdapter = true)
             data class SingleSelect(
                 override val key: String,
@@ -80,12 +86,13 @@ sealed class PONativeAlternativePaymentElement {
                  * @param[label] Value display label.
                  * @param[preselected] Indicates whether the value should be preselected by default.
                  */
+                @Parcelize
                 @JsonClass(generateAdapter = true)
                 data class AvailableValue(
                     val value: String,
                     val label: String,
                     val preselected: Boolean
-                )
+                ) : Parcelable
             }
 
             /**
@@ -95,6 +102,7 @@ sealed class PONativeAlternativePaymentElement {
              * @param[label] Parameter display label.
              * @param[required] Indicates whether the parameter is required.
              */
+            @Parcelize
             @JsonClass(generateAdapter = true)
             data class Bool(
                 override val key: String,
@@ -111,6 +119,7 @@ sealed class PONativeAlternativePaymentElement {
              * @param[minLength] Optional minimum length.
              * @param[maxLength] Optional maximum length.
              */
+            @Parcelize
             @JsonClass(generateAdapter = true)
             data class Digits(
                 override val key: String,
@@ -130,6 +139,7 @@ sealed class PONativeAlternativePaymentElement {
              * @param[required] Indicates whether the parameter is required.
              * @param[dialingCodes] Supported international dialing codes.
              */
+            @Parcelize
             @JsonClass(generateAdapter = true)
             data class PhoneNumber(
                 override val key: String,
@@ -146,12 +156,13 @@ sealed class PONativeAlternativePaymentElement {
                  * Corresponds to a two-letter ISO 3166-1 alpha-2 country code.
                  * @param[value] Dialing code value.
                  */
+                @Parcelize
                 @JsonClass(generateAdapter = true)
                 data class DialingCode(
                     @Json(name = "region_code")
                     val regionCode: String,
                     val value: String
-                )
+                ) : Parcelable
             }
 
             /**
@@ -161,6 +172,7 @@ sealed class PONativeAlternativePaymentElement {
              * @param[label] Parameter display label.
              * @param[required] Indicates whether the parameter is required.
              */
+            @Parcelize
             @JsonClass(generateAdapter = true)
             data class Email(
                 override val key: String,
@@ -177,6 +189,7 @@ sealed class PONativeAlternativePaymentElement {
              * @param[minLength] Optional minimum length.
              * @param[maxLength] Optional maximum length.
              */
+            @Parcelize
             @JsonClass(generateAdapter = true)
             data class Card(
                 override val key: String,
@@ -198,6 +211,7 @@ sealed class PONativeAlternativePaymentElement {
              * @param[minLength] Optional minimum length.
              * @param[maxLength] Optional maximum length.
              */
+            @Parcelize
             @JsonClass(generateAdapter = true)
             data class Otp(
                 override val key: String,
@@ -238,10 +252,16 @@ sealed class PONativeAlternativePaymentElement {
              * Placeholder that allows adding additional cases while staying backward compatible.
              * __Warning:__ Do not match this case directly, use _when-else_ instead.
              */
+            @Parcelize
             @ProcessOutInternalApi
             data object Unknown : Parameter() {
+                @IgnoredOnParcel
                 override val key = String()
+
+                @IgnoredOnParcel
                 override val label = String()
+
+                @IgnoredOnParcel
                 override val required = false
             }
         }
@@ -250,6 +270,7 @@ sealed class PONativeAlternativePaymentElement {
     /**
      * Specifies instruction for the customer, providing additional information and/or describing required actions.
      */
+    @Parcelize
     data class CustomerInstruction(
         val instruction: PONativeAlternativePaymentCustomerInstruction
     ) : PONativeAlternativePaymentElement()
@@ -260,6 +281,7 @@ sealed class PONativeAlternativePaymentElement {
      * @param[label] Optional group display label.
      * @param[instructions] Grouped instructions for the customer that provide additional information and/or describe required actions.
      */
+    @Parcelize
     data class CustomerInstructionGroup(
         val label: String?,
         val instructions: List<PONativeAlternativePaymentCustomerInstruction>
@@ -269,6 +291,7 @@ sealed class PONativeAlternativePaymentElement {
      * Placeholder that allows adding additional cases while staying backward compatible.
      * __Warning:__ Do not match this case directly, use _when-else_ instead.
      */
+    @Parcelize
     @ProcessOutInternalApi
     data object Unknown : PONativeAlternativePaymentElement()
 }

sdk/src/main/kotlin/com/processout/sdk/api/model/response/napm/v2/PONativeAlternativePaymentMethodDetails.kt

@@ -1,18 +1,21 @@
 package com.processout.sdk.api.model.response.napm.v2
 
+import android.os.Parcelable
 import com.processout.sdk.api.model.response.POImageResource
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
+import kotlinx.parcelize.Parcelize
 
 /**
  * Specifies payment method details.
  *
  * @param[displayName] Payment method display name.
  * @param[logo] Image resource for light/dark themes.
  */
+@Parcelize
 @JsonClass(generateAdapter = true)
 data class PONativeAlternativePaymentMethodDetails(
     @Json(name = "display_name")
     val displayName: String,
     val logo: POImageResource
-)
+) : Parcelable

sdk/src/main/kotlin/com/processout/sdk/api/model/response/napm/v2/PONativeAlternativePaymentRedirect.kt

@@ -1,15 +1,18 @@
 package com.processout.sdk.api.model.response.napm.v2
 
+import android.os.Parcelable
 import com.squareup.moshi.JsonClass
+import kotlinx.parcelize.Parcelize
 
 /**
  * Specifies native alternative payment redirect parameters.
  *
  * @param[url] Redirect URL.
  * @param[hint] A hint or description associated with the redirect URL.
  */
+@Parcelize
 @JsonClass(generateAdapter = true)
 data class PONativeAlternativePaymentRedirect(
     val url: String,
     val hint: String
-)
+) : Parcelable