Skip to content

Credentials

The MerchantData object holds the credentials used to initialize the SDK. Pass it to the MPOSFinix constructor.

MerchantData shape

class MerchantData(
    val merchantId: String,
    val mid: String,
    val deviceId: String,
    val currency: Currency = Currency.USD,
    val env: Environment = Environment.SB,
    val userId: String,
    val password: String
)
FieldTypeDescription
merchantIdStringYour Finix Merchant ID (MU...).
midStringMerchant identifier number. Pass an empty string if not required.
deviceIdStringThe Finix Device ID (DV...) created during device setup.
currencyCurrencyTransaction currency. Defaults to Currency.USD.
envEnvironmentEnvironment.SB for sandbox, Environment.PROD for production.
userIdStringYour Finix user ID (US...).
passwordStringYour Finix API password.

Sandbox and Production

Sandbox and production

Set env to match the environment your device is designated for. Devices cannot switch environments after designation.

class MerchantData(
    val merchantId: String,
    val mid: String,
    val deviceId: String,
    val currency: Currency = Currency.USD,
    val env: Environment = Environment.SB,
    val userId: String,
    val password: String
)

// Sandbox
val mpos = MPOSFinix(context, MerchantData(
    merchantId = "MUxxxxxx",
    mid = "",
    deviceId = "DVxxxxx",
    env = Environment.SB,
    userId = "USxxxxxxxxx",
    password = ""
))

// Production
val mpos = MPOSFinix(context, MerchantData(
    merchantId = "MUxxxxxx",
    mid = "",
    deviceId = "DVxxxxx",
    env = Environment.PROD,
    userId = "USxxxxxxxxx",
    password = ""
))