Referência do resultado da transação

O TransactionResultCallback entrega o resultado de initSale e initRefund. Ele é chamado uma vez por operação, imediatamente antes de a Activity do SDK ser fechada. O contrato não lança exceções para o integrador — as falhas aparecem no valor e na mensagem do resultado.

Campos do resultado

Códigos de resultado

Trate "00" como aprovação e qualquer outro valor como não aprovação, exibindo resultMessage quando disponível. Terminais mais antigos ainda podem retornar o prefixo legado "4-*" para erros de host — trate "4-*" e "33-*" como equivalentes. Para o catálogo completo de erros, consulte a Referência de códigos de erro; para saber como reagir a cada falha, consulte Solução de problemas.

Payload por operação

Faça o cast de payload para o tipo que corresponde à operação. Acessar campos sem o cast pode lançar um ClassCastException.

Pagamentos — IPaymentResponse

Retornado por initSale (crédito, débito, voucher, Pix). Campos principais:

Estornos — ICancelPaymentResponse

Retornado por initRefund. Campos principais:

Exemplo

val onResult = TransactionResultCallback { result ->
    when (result.result) {
        "00" -> when (val payload = result.payload) {
            is IPaymentResponse -> { /* handle an approved payment */ }
            is ICancelPaymentResponse -> { /* handle an approved refund */ }
            else -> { /* ... */ }
        }
        else -> { /* non-approval — show result.resultMessage */ }
    }
}