feat(POM-472): (Card Tokenization & DC) Preferred scheme selection

example/src/main/kotlin/com/processout/example/ui/screen/card/payment/DefaultCardTokenizationDelegate.kt

@@ -24,7 +24,7 @@ class DefaultCardTokenizationDelegate(
         if (invoice == null) {
             return ProcessOutResult.Failure(
                 code = Generic(),
-                message = "Failed to create an invoice."
+                localizedMessage = "Failed to create an invoice."
             )
         }
         return invoices.authorize(

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

@@ -0,0 +1,301 @@
+package com.processout.sdk.api.model.response
+
+/**
+ * Supported card schemes and co-schemes.
+ */
+enum class POCardScheme(
+    val rawValue: String,
+    val displayName: String
+) {
+
+    /** American Express is a key credit card around the world. */
+    AMEX(
+        rawValue = "american express",
+        displayName = "American Express"
+    ),
+
+    /** Atos Private Label is a private label credit card that is branded for Atos. */
+    ATOS_PRIVATE_LABEL(
+        rawValue = "atos private label",
+        displayName = "Atos Private Label"
+    ),
+
+    /** Bancontact is the most popular online payment method in Belgium. */
+    BANCONTACT(
+        rawValue = "bancontact",
+        displayName = "Bancontact"
+    ),
+
+    /** BC Global is a South Korean domestic card brand with international acceptance. */
+    BC_GLOBAL(
+        rawValue = "global bc",
+        displayName = "BC Global"
+    ),
+
+    /** Cabal is a local credit and debit card payment method based in Argentina. */
+    CABAL(
+        rawValue = "cabal",
+        displayName = "Cabal"
+    ),
+
+    /** Carnet is a leading brand of Mexican acceptance, with more than 50 years of experience. */
+    CARNET(
+        rawValue = "carnet",
+        displayName = "Carnet"
+    ),
+
+    /** Carte Bancaire is France's local card scheme and the most widely used payment method in the region. */
+    CARTE_BANCAIRE(
+        rawValue = "carte bancaire",
+        displayName = "Carte Bancaire"
+    ),
+
+    /** Cirrus is a worldwide interbank network that provides cash to Mastercard cardholders. */
+    CIRRUS(
+        rawValue = "cirrus",
+        displayName = "Cirrus"
+    ),
+
+    /** Cielo is a domestic debit and credit card brand of Brazil. */
+    CIELO(
+        rawValue = "cielo",
+        displayName = "Cielo"
+    ),
+
+    /** Comprocard is a domestic debit and credit card brand of Brazil. */
+    COMPROCARD(
+        rawValue = "comprocard",
+        displayName = "Comprocard"
+    ),
+
+    /** Dankort is the national debit card of Denmark. */
+    DANKORT(
+        rawValue = "dankort",
+        displayName = "Dankort"
+    ),
+
+    /** DinaCard is a national payment card of the Republic of Serbia. */
+    DINA_CARD(
+        rawValue = "dinacard",
+        displayName = "DinaCard"
+    ),
+
+    /** Diners charge card. */
+    DINERS_CLUB(
+        rawValue = "diners club",
+        displayName = "Diners Club"
+    ),
+
+    /** Diners charge card. */
+    DINERS_CLUB_CARTE_BLANCHE(
+        rawValue = "diners club carte blanche",
+        displayName = "Diners Club Carte Blanche"
+    ),
+
+    /** Diners charge card. */
+    DINERS_CLUB_INTERNATIONAL(
+        rawValue = "diners club international",
+        displayName = "Diners Club International"
+    ),
+
+    /** Diners charge card. */
+    DINERS_CLUB_UNITED_STATES_AND_CANADA(
+        rawValue = "diners club united states & canada",
+        displayName = "Diners Club United States & Canada"
+    ),
+
+    /** Discover is a credit card brand issued primarily in the United States. */
+    DISCOVER(
+        rawValue = "discover",
+        displayName = "Discover"
+    ),
+
+    /** Elo is a domestic debit and credit card brand of Brazil. */
+    ELO(
+        rawValue = "elo",
+        displayName = "Elo"
+    ),
+
+    /** An Electron debit card. */
+    ELECTRON(
+        rawValue = "electron",
+        displayName = "Electron"
+    ),
+
+    /** GE Capital is the financial services division of General Electric. */
+    GE_CAPITAL(
+        rawValue = "ge capital",
+        displayName = "GE Capital"
+    ),
+
+    /** A Girocard payment method. */
+    GIROCARD(
+        rawValue = "girocard",
+        displayName = "Girocard"
+    ),
+
+    /** Giropay is an Internet payment system in Germany. */
+    GIROPAY(
+        rawValue = "giropay",
+        displayName = "Giropay"
+    ),
+
+    /** Hipercard is a domestic debit and credit card brand of Brazil. */
+    HIPERCARD(
+        rawValue = "hipercard",
+        displayName = "Hipercard"
+    ),
+
+    /** An iD payment card. */
+    ID_CREDIT(
+        rawValue = "idCredit",
+        displayName = "iD Credit"
+    ),
+
+    /** An Interac payment method. */
+    INTERAC(
+        rawValue = "interac",
+        displayName = "Interac"
+    ),
+
+    /** JCB is a major card issuer and acquirer from Japan. */
+    JCB(
+        rawValue = "jcb",
+        displayName = "JCB"
+    ),
+
+    /** Maestro is a brand of debit cards and prepaid cards owned by Mastercard. */
+    MAESTRO(
+        rawValue = "maestro",
+        displayName = "Maestro"
+    ),
+
+    /** Mada is the national payment scheme of Saudi Arabia. */
+    MADA(
+        rawValue = "mada",
+        displayName = "Mada"
+    ),
+
+    /** Mastercard is a market leading card scheme worldwide. */
+    MASTERCARD(
+        rawValue = "mastercard",
+        displayName = "Mastercard"
+    ),
+
+    /** A Meeza payment card. */
+    MEEZA(
+        rawValue = "meeza",
+        displayName = "Meeza"
+    ),
+
+    /** A Mir payment card. */
+    MIR(
+        rawValue = "nspk mir",
+        displayName = "Mir"
+    ),
+
+    /** A Nanaco payment card. */
+    NANACO(
+        rawValue = "nanaco",
+        displayName = "Nanaco"
+    ),
+
+    /** UK Credit Cards issued by NewDay. */
+    NEWDAY(
+        rawValue = "newday",
+        displayName = "NewDay"
+    ),
+
+    /** NYCE is an interbank network connecting the ATMs of various financial institutions in the United States and Canada. */
+    NYCE(
+        rawValue = "nyce",
+        displayName = "NYCE"
+    ),
+
+    /** Ourocard is a domestic debit and credit card brand of Brazil. */
+    OUROCARD(
+        rawValue = "ourocard",
+        displayName = "Ourocard"
+    ),
+
+    /** A Bancomat payment card. */
+    PAGO_BANCOMAT(
+        rawValue = "pagoBancomat",
+        displayName = "PagoBancomat"
+    ),
+
+    /** A PostFinance AG payment card. */
+    POST_FINANCE(
+        rawValue = "postFinance",
+        displayName = "PostFinance"
+    ),
+
+    /** Private Label is a type of credit card that is branded for a specific retailer or brand. */
+    PRIVATE_LABEL(
+        rawValue = "private label",
+        displayName = "Private Label"
+    ),
+
+    /** RuPay is an Indian multinational financial services and payment service system. */
+    RUPAY(
+        rawValue = "rupay",
+        displayName = "RuPay"
+    ),
+
+    /** Sodexo is a company that offers prepaid meal cards and other prepaid services. */
+    SODEXO(
+        rawValue = "sodexo",
+        displayName = "Sodexo"
+    ),
+
+    /** A Suica payment card. */
+    SUICA(
+        rawValue = "suica",
+        displayName = "Suica"
+    ),
+
+    /** A T-money payment card. */
+    T_MONEY(
+        rawValue = "tmoney",
+        displayName = "T-money"
+    ),
+
+    /** TROY (acronym of Türkiye’nin Ödeme Yöntemi) is a Turkish card scheme. */
+    TROY(
+        rawValue = "troy",
+        displayName = "TROY"
+    ),
+
+    /** UnionPay is the world’s biggest card network with more than 7 billion cards issued. */
+    UNION_PAY(
+        rawValue = "china union pay",
+        displayName = "UnionPay"
+    ),
+
+    /**
+     * V Pay is a Single Euro Payments Area (SEPA) debit card for use in Europe, issued by Visa Europe.
+     * It uses the EMV chip and PIN system and may be co-branded with various national debit card schemes such as the German Girocard.
+     */
+    V_PAY(
+        rawValue = "vpay",
+        displayName = "V Pay"
+    ),
+
+    /** Verve is Africa's most successful card brand. */
+    VERVE(
+        rawValue = "verve",
+        displayName = "Verve"
+    ),
+
+    /** Visa is the largest global card network in the world by transaction value, ubiquitous worldwide. */
+    VISA(
+        rawValue = "visa",
+        displayName = "Visa"
+    ),
+
+    /** A WAON payment card. */
+    WAON(
+        rawValue = "waon",
+        displayName = "WAON"
+    )
+}

sdk/src/main/kotlin/com/processout/sdk/api/repository/ApiFailureMapper.kt

@@ -26,7 +26,11 @@ internal class ApiFailureMapper(
                 append(" | Reason: $it")
             }
         }
-        return ProcessOutResult.Failure(failureCode, message, apiError?.invalidFields)
+        return ProcessOutResult.Failure(
+            code = failureCode,
+            message = message,
+            invalidFields = apiError?.invalidFields
+        )
     }
 
     private fun failureCode(statusCode: Int, errorType: String): POFailure.Code {

sdk/src/main/kotlin/com/processout/sdk/core/ProcessOutResult.kt

@@ -18,6 +18,7 @@ sealed class ProcessOutResult<out T : Any> {
     data class Failure(
         val code: POFailure.Code,
         val message: String? = null,
+        val localizedMessage: String? = null,
         val invalidFields: List<POFailure.InvalidField>? = null,
         val cause: Exception? = null
     ) : ProcessOutResult<Nothing>()

sdk/src/main/kotlin/com/processout/sdk/ui/nativeapm/NativeAlternativePaymentMethodViewModel.kt

@@ -94,8 +94,8 @@ internal class NativeAlternativePaymentMethodViewModel private constructor(
 
         private fun Options.validate() = copy(
             paymentConfirmationTimeoutSeconds =
-            if (paymentConfirmationTimeoutSeconds in 0..MAX_PAYMENT_CONFIRMATION_TIMEOUT_SECONDS)
-                paymentConfirmationTimeoutSeconds else DEFAULT_PAYMENT_CONFIRMATION_TIMEOUT_SECONDS
+                if (paymentConfirmationTimeoutSeconds in 0..MAX_PAYMENT_CONFIRMATION_TIMEOUT_SECONDS)
+                    paymentConfirmationTimeoutSeconds else DEFAULT_PAYMENT_CONFIRMATION_TIMEOUT_SECONDS
         )
     }
 
@@ -322,9 +322,9 @@ internal class NativeAlternativePaymentMethodViewModel private constructor(
             val invalidFields = uiModel.inputParameters.mapNotNull { it.validate() }
             if (invalidFields.isNotEmpty()) {
                 val failure = ProcessOutResult.Failure(
-                    Validation(POFailure.ValidationCode.general),
-                    "Invalid fields.",
-                    invalidFields
+                    code = Validation(POFailure.ValidationCode.general),
+                    message = "Invalid fields.",
+                    invalidFields = invalidFields
                 )
                 handlePaymentFailure(uiModel, failure, replaceToLocalMessage = false)
                 return@doWhenUserInput
@@ -620,8 +620,13 @@ internal class NativeAlternativePaymentMethodViewModel private constructor(
     fun onViewFailure(failure: PONativeAlternativePaymentMethodResult.Failure) {
         with(failure) {
             dispatch(
-                DidFail(ProcessOutResult.Failure(code, message, invalidFields)
-                    .also { POLogger.warn("View failed: %s", it, attributes = logAttributes) })
+                DidFail(
+                    ProcessOutResult.Failure(
+                        code = code,
+                        message = message,
+                        invalidFields = invalidFields
+                    ).also { POLogger.warn("View failed: %s", it, attributes = logAttributes) }
+                )
             )
         }
     }