El SDK PaymePOS v1.0.0 requiere la instalación de determinadas dependencias y la habilitación de ViewBinding para su correcto funcionamiento.

Plugins Requeridos

Agregue los siguientes plugins en el archivo de configuración de su proyecto Android:

plugins {
    id 'kotlin-android'
    id 'kotlin-parcelize'
}

Habilitar ViewBinding

El SDK requiere que la característica ViewBinding se encuentre habilitada.

android {
    buildFeatures {
        viewBinding = true
    }
}

Dependencias Requeridas

Agregue las siguientes dependencias en el módulo donde será integrado el SDK:

dependencies {
    implementation("androidx.core:core-ktx:1.6.0")
    implementation("androidx.appcompat:appcompat:1.7.0")
    implementation("org.jetbrains.kotlin:kotlin-stdlib:1.9.0")
    implementation("androidx.constraintlayout:constraintlayout:2.1.4")
    implementation("com.squareup.retrofit2:retrofit:2.3.0")
    implementation("com.squareup.retrofit2:converter-gson:2.3.0")
    implementation("com.squareup.retrofit2:converter-scalars:2.5.0")
    implementation("com.squareup.okhttp3:logging-interceptor:3.10.0")
    implementation("com.squareup.okhttp3:okhttp:3.10.0")
    implementation("com.google.code.gson:gson:2.8.8")
    implementation project(':PaymePOS')
    implementation project(':Wiseasy')
    implementation project(':MasterCardSonic')
    implementation project(':VisaSensoryBranding')
}

Utilice las versiones indicadas en esta documentación. El uso de versiones diferentes podría generar incompatibilidades durante la compilación o ejecución del SDK.

Inicializar el SDK

Antes de utilizar cualquier funcionalidad del SDK, es necesario realizar una inicialización para obtener la configuración del dispositivo POS y del comercio asociado. La inicialización debe ejecutarse al iniciar la aplicación y antes de invocar cualquier otra funcionalidad del SDK.

Requisitos Previos

<Info> Para que la inicialización sea exitosa, el dispositivo POS debe encontrarse previamente registrado y configurado en Pay-me. </Info>

Inicialización

Para inicializar el SDK, invoque la función initializeSDK del objeto PaymeClient.

Parámetros

Parámetro	Tipo	Descripción
`context`	Context	Contexto de la aplicación o actividad actual.
`environment`	PaymeEnvironment	Ambiente donde se realizará la inicialización.
`listener`	PaymeInitializationListener	Callback que permite recibir el resultado de la inicialización.

Ejemplo

PaymeClient.initializeSDK(
    this,
    environment = PaymeEnvironment.PRODUCTION,
    listener = object : PaymeInitializationListener {

        override fun onInitSuccess() {
            Toast.makeText(
                this@MainActivity,
                "PaymePOS se inició correctamente",
                Toast.LENGTH_LONG
            ).show()
        }

        override fun onInitFail(
            errorCode: String,
            errorMessage: String
        ) {
            Toast.makeText(
                this@MainActivity,
                "PaymePOS falló al iniciar - $errorMessage",
                Toast.LENGTH_LONG
            ).show()
        }
    }
)

Resultado de la Inicialización

El resultado de la inicialización es informado mediante la interfaz PaymeInitializationListener.

onInitSuccess

Se ejecuta cuando la inicialización finaliza correctamente.

Parámetro	Tipo	Descripción
N/A	N/A	No retorna parámetros.

onInitFail

Se ejecuta cuando ocurre un error durante la inicialización.

Parámetro	Tipo	Descripción
`errorCode`	String	Código del error producido.
`errorMessage`	String	Descripción del error producido.

Se recomienda esperar la ejecución de onInitSuccess() antes de permitir al usuario realizar operaciones de consulta, pago, extorno o impresión mediante el SDK.

​Plugins Requeridos

​Habilitar ViewBinding

​Dependencias Requeridas

​Inicializar el SDK

​Requisitos Previos

​Inicialización

​Parámetros

​Ejemplo

​Resultado de la Inicialización

​onInitSuccess

​onInitFail

Plugins Requeridos

Habilitar ViewBinding

Dependencias Requeridas

Inicializar el SDK

Requisitos Previos

Inicialización

Parámetros

Ejemplo

Resultado de la Inicialización

onInitSuccess

onInitFail