Parcelamento

Escopo regional: As especificações e os requisitos detalhados nesta página se aplicam exclusivamente a integrações Host-to-Host para operações de Pinpad na Argentina.

A Getnet oferece um endpoint especializado para consultar planos de parcelamento (cuotas), que aplica automaticamente os juros e as promoções vigentes. Esta seção descreve os procedimentos obrigatórios para tratar transações parceladas no mercado argentino.

Consulta de parcelamento e QUOTE ID

Em muitos esquemas de parcelamento, o Sistema Host precisa chamar o endpoint de parcelamento da Getnet antes de iniciar a transação. Esse processo é essencial para obter um QUOTE ID, um identificador único que rastreia a transação parcelada em todo o ecossistema Getnet. A Getnet retorna o QUOTE ID na resposta, associado ao plano e ao número de parcelas selecionados.

Matriz de requisitos

A tabela a seguir indica se um esquema de parcelamento específico exige consulta obrigatória ao endpoint para obter um QUOTE ID:

Esquema de parcelamento	Consulta obrigatória?
`plan_emisor`	Sim
`plan_emisor_accelerated`	Sim
`plan_ahora`	Sim
`cuota_simple`	Sim
`plan_n`	Sim
`pago_en_cuota`	Sim
`plan_amex`	Sim
`plan_z`	Não
`alphanumeric`	Não
`sin_interes`	Não
`con_interes`	Não
`plan_normal`	Não
`plan_diferido`	Não
`plan_especial`	Não
`plan_convenio`	Não
`plan_1`	Não
`plan_2`	Não
`plan_3`	Não
`plan_4`	Não
`cuotas`	Não

Se um plano não exigir consulta, o parceiro envia a transação diretamente, sem quote_id.

Juros e promoções

O Sistema Host tem duas opções para gerenciar os cálculos financeiros:

Cálculos autogerenciados: se o sistema do parceiro calcula juros e promoções internamente, ele ainda precisa fazer uma consulta “SIN INTERESES” (sem juros) ao endpoint para obter o QUOTE ID necessário.
Cálculos gerenciados pela Getnet: se o parceiro preferir que a Getnet faça os cálculos automaticamente, ele precisa fazer uma consulta (“SIN INTERESES” ou “CON INTERESES”) conforme o método de pagamento escolhido durante a venda.

Seleção e conversão de parcelas

A Getnet espera receber na requisição da API o plano de pagamento exato e o número de parcelas que o usuário selecionou.

Conversor de parcelas

Quando o Sistema Host usa uma “quantidade de parcelas” específica para identificar um plano, você precisa desenvolver e aplicar um conversor antes de enviar a requisição para a Getnet.

Exemplo: um sistema pode usar “11 parcelas” como código para identificar um Plan Emisor em 6 parcelas.
Ação: quando o operador digita “11” no sistema, o Sistema Host converte esse valor para “Plan Emisor 6 parcelas” e cria a requisição com esses valores.

Parcelamento com código QR

Nas transações com código QR, o fluxo é diferente dos pagamentos com cartão:

Você gera as transações sem nenhum cálculo prévio de impostos ou juros.
O cliente seleciona as parcelas desejadas diretamente na carteira digital.
A resposta da transação retorna ao Ponto de Venda (PDV) todas as informações necessárias, conforme a seleção do cliente.

Próximos passos

Processar Pagamentos com Cartão: envie os valores de parcelamento na inicialização padrão Y19.
Processar Pagamentos com Código QR: execute o fluxo de carteira em que o cliente escolhe as parcelas.
Tabelas de Códigos: consulte os códigos de tipo de transação e de tipo de conta usados nas requisições.