O CieloWebViewSDK define uma hierarquia de exceções específicas para representar falhas durante o uso do SDK. Todas as exceções herdam da classe base CieloWebViewSdkException.

Android

abstract class CieloWebViewSdkException(
    message: String,
    cause: Throwable,
) : Exception(message, cause)

iOS

public protocol CieloWebViewSdkException: Error, Equatable {
    var message: String { get }
}

Exceções em geral

As seguintes exceções podem ser lançadas durante a configuração e uso do SDK:

CieloWebViewSdkAuthException

Exceção lançada durante o processo de autenticação com os serviços da Cielo. Essa exceção é específica e representa falhas relacionadas à geração do token de acesso com base no token do parceiro. Diferente das demais exceções da SDK, esta classe inclui atributos adicionais que detalham o erro ocorrido.

Android

            
class CieloWebViewSdkAuthException(
    val httpStatus: Int,       // Código HTTP retornado pela API
    val errorCode: String,     // Código específico do erro fornecido pela Cielo
    val errorMessage: String,  // Mensagem descritiva do erro
) : CieloWebViewSdkException()

iOS

CieloWebViewSdkAuthException: CieloWebViewSdkException {
    var httpStatus: Int? { get }        // Código HTTP retornado pela API
    var errorCode: String? { get }      // Código específico do erro fornecido pela Cielo
    var errorMessage: String? { get }   // Mensagem descritiva do erro
}