Dispostivo/Terminal

1) Instanciando a PayOsSdkDevice

Obtendo a instância da SDK:

private val payOsSdkDeviceInstance = PayOsSdkDevice.instance

Interface exposta pela PayOsSdkDevice em terminais PAX - A960, A910S, A910:

interface PayOsSdkDevice {
    fun configure(context: Context)
    fun setRebootTime(time: String?): Result<Unit>
    fun getRebootTime(): Result<String?>
    fun setRebootTimeEnable(enable: Boolean): Result<Unit>
    fun getRebootTimeEnable(): Result<Boolean>
    fun reboot(): Result<Unit>
    fun getDeviceInfo(): Result<PayOsSdkDeviceInfo>
    fun getModel(): Result<String>
    fun getSerialNumber(): Result<String>
}

Interface exposta pela PayOsSdkDevice em terminais Nexgo - N62 e PagBank - A930, P2, GPOS780, A50, A50S:

interface PayOsSdkDevice {
    fun configure(context: Context)
    fun getDeviceInfo(): Result<PayOsSdkDeviceInfo>
    fun getModel(): Result<String>
    fun getSerialNumber(): Result<String>
}

Nesses terminais, as operações de agendamento e de reinicialização não fazem parte da interface pública. Chamá-las não compila.

1.1) Configuração

Para começar, é necessário chamar o método de configuração. O funcionamento de todos os outros métodos está atrelado à configuração, já que o context da aplicação é utilizado por todo o SDK.

É necessário que este método seja chamado apenas uma vez. Recomenda-se chamá-lo no lifecycle de onCreate da aplicação.

payOsSdkDeviceInstance.configure(applicationContext)

1.2) Exemplo

Ativa e agenda a reinicialização automática para todos os dias às 05h da manhã. Disponível somente em terminais PAX.

payOsSdkDeviceInstance.setRebootTimeEnable(true);
payOsSdkDeviceInstance.setRebootTime("05:00:00");

Obtém os dados do dispositivo. Disponível em todos os terminais.

val deviceInfo = payOsSdkDeviceInstance.getDeviceInfo().getOrNull()

2) Operações e valores

Sobre as operações da PayOsSdkDevice. Cada operação indica em quais terminais está disponível.

2.1) setRebootTimeEnable(enable: Boolean): Result<Unit>

Ativa ou desativa a funcionalidade de agendamento de horário de reinicialização.

Disponível somente em terminais PAX.

2.2) setRebootTime(time: String?): Result<Unit>

Define o horário no qual o dispositivo irá reinicializar automaticamente.

Disponível somente em terminais PAX.

2.3) getRebootTimeEnable(): Result<Boolean>

Obtém o valor da configuração da funcionalidade de agendamento de horário de reinicialização.

Disponível somente em terminais PAX.

2.4) getRebootTime(): Result<String?>

Obtém o horário de reinicialização que está agendado.

Disponível somente em terminais PAX.

2.5) reboot(): Result<Unit>

Realiza reinicialização manual do terminal.

Disponível somente em terminais PAX.

2.6) getDeviceInfo(): Result<PayOsSdkDeviceInfo>

Obtém dados do dispositivo e da SDK através de PayOsSdkDeviceInfo, que expõe model, serialNumber, sdkVersion e sdkVersionFormatted.

Disponível em terminais PAX, Nexgo e PagBank. Em terminais PagBank, o modelo e o número serial são lidos do PlugPag depois do init da PayOsSdkPayment.

2.7) getModel(): Result<String>

Obtém o modelo (MODEL) do dispositivo.

Disponível em terminais PAX, Nexgo e PagBank.

2.8) getSerialNumber(): Result<String>

Obtém o número serial (SN) do dispositivo.

Disponível em terminais PAX, Nexgo e PagBank.