feat(POM-491): Support new alternative payment endpoints

sdk/src/main/kotlin/com/processout/sdk/api/model/request/napm/v2/PONativeAlternativePaymentAuthorizationRequest.kt

@@ -0,0 +1,79 @@
+package com.processout.sdk.api.model.request.napm.v2
+
+import com.processout.sdk.core.annotation.ProcessOutInternalApi
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+
+/**
+ * Request parameters for native alternative payment authorization.
+ *
+ * @param[invoiceId] Invoice identifier.
+ * @param[gatewayConfigurationId] Gateway configuration identifier.
+ * @param[parameters] Payment parameters.
+ */
+/** @suppress */
+@ProcessOutInternalApi
+data class PONativeAlternativePaymentAuthorizationRequest(
+    val invoiceId: String,
+    val gatewayConfigurationId: String,
+    val parameters: Map<String, Parameter>? = null
+) {
+
+    /**
+     * Payment parameter.
+     */
+    data class Parameter internal constructor(
+        internal val value: Value
+    ) {
+
+        companion object {
+            /**
+             * Arbitrary string parameter.
+             */
+            fun string(value: String) = Parameter(Value.String(value))
+
+            /**
+             * Phone number parameter.
+             *
+             * @param[dialingCode] International dialing code.
+             * @param[number] The rest of the number without dialing code.
+             */
+            fun phoneNumber(
+                dialingCode: String,
+                number: String
+            ) = Parameter(
+                Value.PhoneNumber(
+                    dialingCode = dialingCode,
+                    number = number
+                )
+            )
+        }
+
+        internal sealed class Value {
+            data class String(
+                val value: kotlin.String
+            ) : Value()
+
+            @JsonClass(generateAdapter = true)
+            data class PhoneNumber(
+                @Json(name = "dialing_code")
+                val dialingCode: kotlin.String,
+                val number: kotlin.String
+            ) : Value()
+        }
+    }
+}
+
+@JsonClass(generateAdapter = true)
+internal data class NativeAlternativePaymentAuthorizationRequestBody(
+    @Json(name = "gateway_configuration_id")
+    val gatewayConfigurationId: String,
+    @Json(name = "submit_data")
+    val submitData: SubmitData?
+) {
+
+    @JsonClass(generateAdapter = true)
+    data class SubmitData(
+        val parameters: Map<String, Any>
+    )
+}

sdk/src/main/kotlin/com/processout/sdk/api/model/request/napm/v2/PONativeAlternativePaymentRequest.kt

@@ -0,0 +1,16 @@
+package com.processout.sdk.api.model.request.napm.v2
+
+import com.processout.sdk.core.annotation.ProcessOutInternalApi
+
+/**
+ * Request parameters for native alternative payment.
+ *
+ * @param[invoiceId] Invoice identifier.
+ * @param[gatewayConfigurationId] Gateway configuration identifier.
+ */
+/** @suppress */
+@ProcessOutInternalApi
+data class PONativeAlternativePaymentRequest(
+    val invoiceId: String,
+    val gatewayConfigurationId: String
+)

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

@@ -0,0 +1,53 @@
+package com.processout.sdk.api.model.response.napm.v2
+
+import com.processout.sdk.api.model.response.napm.v2.PONativeAlternativePaymentAuthorizationResponse.State
+import com.processout.sdk.core.annotation.ProcessOutInternalApi
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+
+/**
+ * Specifies details of native alternative payment.
+ *
+ * @param[state] State of native alternative payment.
+ * @param[nextStep] Next required step in the payment flow.
+ * @param[customerInstructions] Instructions for the customer that provide additional information and/or describe required actions.
+ */
+/** @suppress */
+@ProcessOutInternalApi
+data class PONativeAlternativePaymentAuthorizationResponse(
+    val state: State,
+    val nextStep: PONativeAlternativePaymentNextStep?,
+    val customerInstructions: List<PONativeAlternativePaymentCustomerInstruction>?
+) {
+
+    /**
+     * State of native alternative payment.
+     */
+    @JsonClass(generateAdapter = false)
+    enum class State {
+        /** Next step is required to proceed. */
+        NEXT_STEP_REQUIRED,
+
+        /** Payment is ready to be captured. */
+        PENDING_CAPTURE,
+
+        /** Payment is captured. */
+        CAPTURED,
+
+        /**
+         * Placeholder that allows adding additional cases while staying backward compatible.
+         * __Warning:__ Do not match this case directly, use _when-else_ instead.
+         */
+        @ProcessOutInternalApi
+        UNKNOWN
+    }
+}
+
+@JsonClass(generateAdapter = true)
+internal data class NativeAlternativePaymentAuthorizationResponseBody(
+    val state: State,
+    @Json(name = "next_step")
+    val nextStep: NativeAlternativePaymentNextStep?,
+    @Json(name = "customer_instructions")
+    val customerInstructions: List<PONativeAlternativePaymentCustomerInstruction>?
+)

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

@@ -0,0 +1,78 @@
+package com.processout.sdk.api.model.response.napm.v2
+
+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
+
+/**
+ * Specifies instruction for the customer, providing additional information and/or describing required actions.
+ */
+/** @suppress */
+@ProcessOutInternalApi
+sealed class PONativeAlternativePaymentCustomerInstruction {
+
+    /**
+     * Customer instruction provided as a markdown text.
+     *
+     * @param[label] Optional instruction display label.
+     * @param[value] Markdown text.
+     */
+    @JsonClass(generateAdapter = true)
+    data class Text(
+        val label: String?,
+        val value: String
+    ) : PONativeAlternativePaymentCustomerInstruction()
+
+    /**
+     * Customer instruction provided as an image resource.
+     *
+     * @param[value] Image resource.
+     */
+    @JsonClass(generateAdapter = true)
+    data class Image(
+        val value: POImageResource
+    ) : PONativeAlternativePaymentCustomerInstruction()
+
+    /**
+     * Customer instruction provided via barcode.
+     *
+     * @param[rawSubtype] Raw barcode subtype.
+     * @param[rawValue] Base64 encoded value.
+     */
+    @JsonClass(generateAdapter = true)
+    data class Barcode(
+        @Json(name = "subtype")
+        val rawSubtype: String,
+        @Json(name = "value")
+        val rawValue: String
+    ) : PONativeAlternativePaymentCustomerInstruction() {
+
+        /** Barcode value. */
+        val value: POBarcode
+            get() = POBarcode(
+                rawType = rawSubtype,
+                rawValue = rawValue
+            )
+    }
+
+    /**
+     * Group of customer instructions.
+     *
+     * @param[label] Optional group display label.
+     * @param[instructions] Grouped instructions for the customer that provide additional information and/or describe required actions.
+     */
+    @JsonClass(generateAdapter = true)
+    data class Group(
+        val label: String?,
+        val instructions: List<PONativeAlternativePaymentCustomerInstruction>
+    ) : PONativeAlternativePaymentCustomerInstruction()
+
+    /**
+     * Placeholder that allows adding additional cases while staying backward compatible.
+     * __Warning:__ Do not match this case directly, use _when-else_ instead.
+     */
+    @ProcessOutInternalApi
+    data object Unknown : PONativeAlternativePaymentCustomerInstruction()
+}