# 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.

<Callout type="warning">

Pagamentos parcelados exigem uma configuração específica na conta do estabelecimento. Verifique com a Get Smart se sua conta está habilitada para este recurso antes da implementação.

</Callout>

## 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:

| Parâmetro | Tipo | Obrigatório | Descrição |
| :---- | :---- | :---- | :---- |
| `amount` | double | Sim | O valor total a ser cobrado |
| `type` | int | Sim | Definido como `7` para pagamentos parcelados (Venta Fraccionada) |
| `invoice` | String | Não | Número do pedido ou identificador opcional para rastreamento |

<Callout type="tip">

Informe ao cliente que ele está iniciando um plano de parcelamento antes de entregar o terminal. Isso garante que ele esteja preparado para selecionar o número de parcelas durante o processo de pagamento.

</Callout>

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

```java
// 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:

```java
@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
        }
    }
}
```

<Callout type="note">

O comprovante impresso inclui automaticamente o detalhamento completo das parcelas. Certifique-se de que seus registros digitais também registrem que este foi um pagamento fracionado para uma conciliação adequada e suporte ao cliente.

</Callout>

### 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](/pt/get-smart/get-smart-app2app/transaction-guides/transactions/handle-transaction-results) - Guia completo sobre o processamento de respostas de transação
* [Estornar um Pagamento](/pt/get-smart/get-smart-app2app/transaction-guides/transactions/refund-a-payment) - Aprenda como reverter transações
* [Referência de Parâmetros de Requisição](/pt/get-smart/get-smart-app2app/reference/request-parameters) - Especificações completas de parâmetros