Referência da API

Referência do SDK nativo (com.eagleix.softpos). Os wrappers React Native e Flutter expõem os mesmos conceitos com nomes equivalentes.

Eagle

Fachada global. Guarda a sessão corrente e delega a ela.

EagleSession

Uma sessão: configuração, estado e o vendedor ativo. Existe como instância — e não só como singleton — para que testes possam injetar um backend falso sem desfazer estado global.

val session = EagleSession(context, config)
val payments = EaglePayments(activity, session)

Expõe os mesmos métodos de Eagle, mais activation: ActivationResult? — o vendedor ativo, ou null antes de activateSeller.

EagleConfig

EagleConfig(
    apiKey: String,                        // credencial do tenant; não pode ser vazia
    environment: EagleEnvironment,         // SANDBOX | PRODUCTION
    backend: EagleBackend,                 // HttpEagleBackend ou implementação própria
    logger: EagleLogger = EagleLogger.NONE,
)

EaglePayments

EaglePayments(
    activity: ComponentActivity,
    session: EagleSession = Eagle.requireSession(),
)

startSale executa, em ordem: valida pré-condições → busca a configuração da transação no backend → dispara a Intent do m-SiTef → interpreta o retorno → relata a venda ao backend → devolve o resultado.

SaleRequest

amountInCents <= 0 ou installments < 1 lançam IllegalArgumentException na construção — validação acontece antes de qualquer chamada de rede.

PaymentMethod

SaleResult

Cada campo corresponde a um extra devolvido pelo m-SiTef:

ActivationResult

As credenciais SiTef em si não são expostas ao app.

EagleState

Emitido por Eagle.state para o app desenhar a própria UI.

EagleError

Hierarquia selada de exceções. Reservadas para falhas fora do fluxo transacional — recusa e cancelamento voltam como SaleResult.

EagleLogger

interface EagleLogger {
    fun debug(message: String)
    fun info(message: String)
    fun error(message: String, throwable: Throwable? = null)

    companion object { val NONE: EagleLogger }
}

EagleLogger.NONE é o padrão: silencioso.

TransactionConfig

Resolvida pelo backend a cada venda e usada apenas para montar a Intent. O app não a constrói nem deve cacheá-la; está aqui para referência de quem implementa um EagleBackend próprio.