Início rápido

Este tutorial leva você do SDK inicializado até a sua primeira venda no terminal.

Antes de começar

Conclua os Pré-requisitos e o guia Adicione o SDK ao seu projeto.

Passo 1: Inicialize o SDK

Inicialize o SDK uma única vez, durante a inicialização do seu aplicativo, com ApoloSdk.Builder. A chamada build() inicia o warm-up, que carrega a configuração do terminal e autentica nos serviços de pagamento.

ApoloSdk.Builder(applicationContext)
    .setCredentials(
        clientId = "your_client_id",
        clientSecret = "your_client_secret",
        terminalCode = "your_terminal_code",
        partnerName = "your_partner_name",
        partnerPackageName = "com.yourcompany.app",
    )
    .setOnWarmUpStatus { status ->
        when (status) {
            WarmUpStatus.Loading -> { /* keep the UI in a waiting state */ }
            WarmUpStatus.Success -> { /* the SDK is ready to operate */ }
            is WarmUpStatus.Failure -> { /* show the cause; recover with shutdown() + build() */ }
        }
    }
    .build()

Aguarde WarmUpStatus.Success antes de iniciar qualquer operação. Um Failure traz a causa — por exemplo, um 401 de credenciais inválidas. Para se recuperar, chame ApoloSdk.shutdown() e depois build() novamente.

Passo 2: Obtenha o cliente

Depois de um warm-up bem-sucedido, obtenha o cliente inicializado:

val apolo = ApoloSdk.getClient()

Passo 3: Execute sua primeira venda

Inicie uma venda direta no crédito com um valor fixo em centavos. O terminal conduz a captura do cartão, a senha e a confirmação, e o resultado chega no callback.

apolo.initSale(
    context = activity,
    saleSetup = BrSaleSetup.Credit(amountInCents = 1000L), // R$ 10.00
    onPaymentResult = { result ->
        // result.result == "00" indicates an approved transaction
    },
)

Verifique a integração

Próximos passos

• Processe uma venda — todos os meios de pagamento e modalidades.
• Processe um estorno — reverta uma transação aprovada.
• Referência de inicialização — o conjunto completo de opções do Builder.