Criar um Pagamento com Parcelamento

Este guia orienta você no processamento de uma transação de pagamento parcelado usando a aplicação Get Smart. O pagamento parcelado (Fraccionamento) permite que os clientes dividam uma compra de alto valor em várias parcelas mensais. Este recurso está sujeito à elegibilidade do cartão do cliente e à configuração do seu perfil de estabelecimento.

Requisitos

Antes de começar, certifique-se de que você possui:

• Conta de estabelecimento com o recurso de parcelamento habilitado - Entre em contato com o suporte da Get Smart para verificar se sua conta suporta transações parceladas.
• Cliente com um cartão de crédito suportado - Nem todos os cartões são elegíveis para planos de parcelamento.
• Aplicação Get Smart instalada e configurada no dispositivo Android.

Processo de Pagamento Parcelado

Esta seção orienta você no processo de criação e execução de uma transação de pagamento parcelado com a integração Get Smart App2App. Diferente das vendas padrão, a aplicação Get Smart apresentará ao cliente uma tela de seleção de parcelas durante a transação.

Passo 1: Criar e Lançar o Intent de Parcelamento

Uma transação de pagamento parcelado permite que os clientes dividam o valor total em pagamentos mensais. Você deve criar um Intent com o tipo de transação 7 para iniciar um pagamento parcelado. A aplicação Get Smart gerencia a interface de seleção de parcelas e processa o pagamento de acordo.

A tabela abaixo lista os parâmetros que você precisa incluir em seu Intent de parcelamento:

O exemplo de código a seguir mostra como criar e lançar um Intent de pagamento parcelado:

// Define o código de requisição para o tratamento do resultado
static final int REQUEST_CODE_INSTALLMENT = 3001;

// Inicializa o Intent com a ação Get Smart
Intent intent = new Intent("es.android.redsys.mPOS.movil.tpvAndroid_PAYMENT_REQUEST");

// Adiciona os parâmetros de pagamento parcelado
intent.putExtra("amount", 600.00);
intent.putExtra("type", 7); // 7 = Parcelamento (Venta Fraccionada)
intent.putExtra("invoice", "ORDER-FRAC-123");

// Lança o Intent
try {
    startActivityForResult(intent, REQUEST_CODE_INSTALLMENT);
} catch (ActivityNotFoundException e) {
    // Trata a ausência da aplicação Get Smart
    new AlertDialog.Builder(this)
        .setTitle("App Get Smart não encontrado")
        .setMessage("Por favor, instale e configure a aplicação Get Smart.")
        .setPositiveButton("OK", null)
        .show();
}

Passo 2: Tratar a Seleção do Cliente e o Resultado da Transação

Após o lançamento do Intent, a aplicação Get Smart apresenta ao cliente uma tela de seleção para escolher o número de parcelas com base nas promoções disponíveis e na elegibilidade do cartão. Opções comuns incluem 3, 6 ou 12 pagamentos mensais, embora os planos disponíveis variem de acordo com o emissor do cartão e as promoções vigentes.

Assim que o cliente seleciona um plano de parcelamento e conclui o pagamento, a aplicação Get Smart devolve o controle ao seu método onActivityResult. A resposta inclui os dados padrão de pagamento, além de campos específicos detalhando o plano de parcelas escolhido pelo cliente. O comprovante impresso incluirá automaticamente o detalhamento do parcelamento.

O exemplo de código a seguir mostra como tratar o resultado do pagamento parcelado:

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    
    if (requestCode == REQUEST_CODE_INSTALLMENT) {
        if (resultCode == RESULT_OK && data != null) {
            // Transação bem-sucedida - extrair dados da resposta
            String authCode = data.getStringExtra("AUTHORIZATION");
            String orderId = data.getStringExtra("ORDER");
            
            // Extrair informações específicas do parcelamento, se disponíveis
            // Armazene esses detalhes em seus registros digitais
            
            // O comprovante impresso incluirá o detalhamento das parcelas
            // Certifique-se de que seu sistema também registre isso como um pagamento fracionado
        } else {
            // Transação cancelada ou falhou
            // Tratar erro apropriadamente
        }
    }
}

Próximos Passos

Agora que você processou com sucesso uma transação de pagamento parcelado, você pode explorar mais recursos da integração Get Smart App2App:

• Tratar Resultados da Transação - Guia completo sobre o processamento de respostas de transação
• Estornar um Pagamento - Aprenda como reverter transações
• Referência de Parâmetros de Requisição - Especificações completas de parâmetros