Cancelamento

Faz-se uso da classe mPOSVoidRequestBuilder.
Na voidTransactionCallback, deverá ser apresentada uma listagem de transações para o usuário. Neste ponto, uma transação deverá ser selecionada. Após a seleção, a transação deverá ser cancelada e notificada na messageCallback.

Observações

A transação é selecionada utilizando o método: response.select(transaction) no objeto VoidTransaction recebido na voidTransactionCallback
O tempo de seleção para transação de cancelamento é de 30 segundos, após, a operação será cancelada.

Exemplo de Cancelamento

    private fun void() {
        voidRequest = MPOSPlugin.createVoidRequestBuilder()
            .callback(object : Callback<mPOSVoidResponse>() {
                override fun onStart() {
                    state = state.copy(status = Status.MESSAGE, message = "Processando")
                }

                override fun onSuccess(response: mPOSVoidResponse) {
                    state = state.copy(status = Status.MESSAGE, message = "Cancelamento realizado")
                    voidTransaction = null
                }

                override fun onFail(error: Throwable) {
                    state = state.copy(
                        status = Status.MESSAGE,
                        message = error.message ?: "Falha na operação"
                    )
                    voidTransaction = null
                }

                override fun onComplete() {
                    state = state.copy(status = Status.FINISHED, message = "")
                }
            })
            .voidTransactionCallback(object : Callback<UserSelection<VoidTransaction>>() {
                override fun onSuccess(response: UserSelection<VoidTransaction>) {
                    voidTransaction = response
                    state = state.copy(
                        transactionsList = voidTransaction!!.items.toList(),
                        status = Status.DISPLAY_VOID_LIST
                    )
                }

                override fun onFail(error: Throwable) {
                }

            })
            .messageCallback(object : Callback<MessageCallbackRequestField.MessageData>() {
                override fun onSuccess(response: MessageCallbackRequestField.MessageData) {
                    state = state.copy(status = Status.MESSAGE, message = response.message)
                }

                override fun onFail(error: Throwable) {
                }
            })
            .userInputCallback(object : Callback<UserInput>() {
                override fun onFail(error: Throwable) {
//                    TODO("Not yet implemented")
                }

                override fun onSuccess(response: UserInput) {
                    if (response.type == UserInputType.PHONE_NUMBER) {
                        /* Aqui você deve enviar o número de telefone do cliente para o backend
                        uso:
                        response.input("11999999999")
                         */
                    }
                }
            })
            .build()
        Zoop.post(voidRequest!!)
    }

Callbacks

.callback

Responsável pelo fluxo do cancelamento, início, processamento, conclusão (sucesso/falha).
onStart -> Esta callback é sinalizada quando o fluxo do cancelamento começa, podendo ser sinalizado pela aplicação o início do processamento.
OnSuccess -> Neste momento, a transação foi cancelada, e você recebe o objeto MPOSVoidResponsecontendo um *TransactionData, contendo todos os dados da transação. Para utilizar o request de impressão, será necessário passar este objeto para o request de impressão
OnFail -> Falha no cancelamento, é recebido um exception, podendo ser do tipo:
- ZoopPaymentException -> Falha no fluxo do pagamento, neste caso, passamos a mensagem de erro, podendo ser acessada como exception.message
- ZoopTimeoutException -> Tempo excedido na operação
- ZoopClosedConnectionException -> Conexão interrompida
- ZoopNetworkException -> Falha de conexão
OnComplete -> Sinaliza o final do fluxo do cancelamento, tanto em casos de sucesso/falha.

Referência:

    TransactionData(
        val value: Int?, // Valor da transação em centavos
        val paymentType: Int?, // Tipo de pagamento
        val installments: Int?, // Parcelas
        val status: String?, // Status (approved/canceled)
        val brand: String?, // Marca do cartão ex: Visa
        val address: String?, // Endereço do seller
        val sellerName: String?, // Nome do seller
        val acquiring: String?, // Adquirente
        val pan: String?, // PAN do cartão
        val autoCode: String?, // Código de autorização
        val documentType: String?, // Tipo de documento, CPF/CNPJ
        val document: String?, // Documento
        val nsu: String?, // NSU
        val date: String?, // Data da transação
        val hour: String?, // Hora da transação
        val cv: String?, // CV
        val arqc: String?, // ARQC
        val aid: String?, // AID
        val sellerReceipt: String?, // Recibo do estabelecimento
        val customerReceipt: String?, // Recibo do cliente
        val approvalMessage: String? // Mensagem de aprovação ex: APROVADA PELO EMISSOR,
        val aidLabel: String? // Label do cartão,
        val transactionId: String? // Id da transação,
        val receiptId: String? = null // Id do recibo, caso aplicável (hoje, apenas transações Pix),
        val pixId: Strting? = null // Id do Pix
    )

.messageCallback

Responsável pelas mensagens no fluxo do cancelamento. ex: “Aproxime, insira ou passe o cartão”
OnSuccess -> Mensagem a ser exibida pela aplicação para o usuário, acessada como response.message
OnFail -> Não recebe nenhum dado, esta callback não é chamada.

.voidTransactionCallback

Responsável pela seleção da transação a ser cancelada, a partir de uma lista (a lista é forncida neste callback)
OnSuccess -> É recebido um objeto UserSelection<VoidTransaction> contendo um objeto iterable (acessada por response.items) a ser exibida pela aplicação para o usuário, a seleção de transação para cancelamento, é feita neste objeto. Cada item no objeto é uma transação.
OnFail -> Não recebe nenhum dado, esta callback não é chamada.

Referência:


public final data class VoidTransaction(
    val id: String,
    val amount: String,
    val option: Option,
    val cardBrand: CardBrand,
    val date: String,
    val time: String
)