Crie um pagamento parcelado com planos

Este guia mostra como processar pagamentos com cartão de crédito parcelados usando o Getnet Payment App. Você pode deixar o terminal calcular os juros (modo Manual) ou enviar o valor final já calculado pelo seu próprio sistema (modo Calculado).

Antes de começar

Antes de seguir os passos, você precisa de:

• Getnet Payment App instalado no terminal.
• Usar cartão de crédito como meio de pagamento (paymentMethod="1").
• O estabelecimento precisa estar autorizado para os planos de parcelamento específicos na configuração do seu Tax Engine.

Como funciona

Quando um cartão de crédito é detectado, o terminal valida o plano solicitado contra as configurações autorizadas do estabelecimento por meio de um Tax Engine. Entender essa validação ajuda você a prever o comportamento do terminal:

Passo 1: escolha o modo de operação

Antes de iniciar a transação, defina o operationMode. Esse parâmetro controla como os valores da transação são calculados:

Se o operationMode não for especificado, o terminal assume o modo manual ("0").

Passo 2: crie o pagamento parcelado

Para processar um pagamento parcelado, você precisa criar um Intent com a operação de pagamento e incluir os parâmetros específicos de parcelamento.

Como funciona a validação de plano e parcelas

O terminal faz uma validação em duas etapas contra o Tax Engine:

1. Validação do plano: se o planId que você envia corresponder aos planos autorizados do estabelecimento retornados pelo Tax Engine, o terminal pula a tela de seleção de plano.

2. Validação das parcelas: depois de validar o plano, se o valor de installments for compatível com a resposta do Tax Engine para aquele plano, o terminal também pula a tela de seleção de parcelas.

Somente quando as duas validações passam o terminal segue direto para a tela de confirmação. Se qualquer uma falhar, o terminal pede que o usuário selecione manualmente uma opção válida e autorizada.

A tabela abaixo lista os parâmetros que você pode enviar no Intent:

O bloco de código a seguir mostra um exemplo de como criar um pagamento parcelado:

private val REQUEST_CODE = 1001

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val intent = Intent(Intent.ACTION_VIEW, Uri.parse("getnet://payment/v1/payment"))
    
    // Mandatory for Payment
    intent.putExtra("amount", "10000") // $100.00
    intent.putExtra("originalAmount", "10000")
    intent.putExtra("callerId", "123456")
    intent.putExtra("receiptCode", "654321")
    
    // Specific for Installments and Plans
    intent.putExtra("installments", 5) 
    intent.putExtra("planId", "plan_emisor")
    intent.putExtra("interest", "false")
    intent.putExtra("operationMode", "1") // Calculated mode
    intent.putExtra("skipConfirmation", "false")
    
    startActivityForResult(intent, REQUEST_CODE)
}

Passo 3: trate a resposta

Depois que o cliente conclui a transação, o Getnet Payment App devolve os detalhes finais do plano confirmado para a sua aplicação via onActivityResult.

Parâmetros de resposta

A tabela a seguir lista os parâmetros de resposta que você recebe:

O bloco de código a seguir mostra um exemplo de tratamento da resposta:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    
    if (requestCode == REQUEST_CODE && resultCode == RESULT_OK) {
        val extras = data?.extras
        val result = extras?.getString("result")
        
        if (result == "0") {
            // SUCCESS: Extract transaction details
            val installments = extras?.getString("installments")
            val planId = extras?.getString("planId")
            val interest = extras?.getString("interest")
            val nsu = extras?.getString("nsu")
            val authCode = extras?.getString("authorizationCode")
            val amount = extras?.getString("amount")
            
            Log.d("Payment", "Payment approved with $installments installments")
            Log.d("Payment", "Plan: $planId, Interest: $interest")
            Log.d("Payment", "NSU: $nsu, Auth Code: $authCode")
        } else {
            // FAILURE: Handle error
            val errorDetails = extras?.getString("resultDetails")
            Log.e("Payment", "Payment failed: $errorDetails (Code: $result)")
        }
    }
}

Exemplo de resposta bem-sucedida:

{
  "result": "0",
  "resultDetails": "APPROVED",
  "amount": "10000",
  "installments": "5",
  "planId": "plan_emisor",
  "interest": "false",
  "callerId": "123456",
  "nsu": "57003",
  "authorizationCode": "004433"
}

Próximos passos

• Regras de parcelamento por país - os IDs de plano e as restrições de meio de pagamento por país.
• Estratégia de cálculo de juros - decida se o terminal ou a sua aplicação calcula os juros.