Getnet DocsGetnet Docs

Pagamentos parcelados e estratégias de juros

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Este guia explica como realizar pagamentos parcelados com um POS Integrado usando a operação Sale. O parcelamento se comporta de forma idêntica em conexões USB e Rede. As regras e os planos dependem do país e da bandeira do cartão.

O que são pagamentos parcelados

Os pagamentos parcelados dividem o valor da transação em várias cobranças. O sistema de automação envia Sale com Installments, PlanId e Interest (e, opcionalmente, OperationMode) para que o terminal aplique o plano e os juros corretos. Se um parâmetro for omitido, o POS pode exibir a seleção de plano e de parcelas na tela. A disponibilidade depende da configuração do comércio e do terminal.

Antes de começar

Antes de realizar um pagamento parcelado:

  • Um Connector deve ser criado e validado com Polling
  • O Modo POS Integrado deve estar ativo
  • O comércio e o terminal devem estar habilitados para transações parceladas

Passo 1: Execute uma venda parcelada

Para realizar um pagamento parcelado, chame a operação Sale com os parâmetros adequados. Se um valor necessário não for informado, o POS pede que o operador selecione o plano ou as parcelas manualmente.

ParâmetroTipoObrigatórioDescrição
AmountLongNãoValor da transação na moeda local.
SaleTypeEnumNãoDeve ser Card para pagamentos parcelados.
InstallmentsIntNãoNúmero de parcelas.
PlanIdStringNãoIdentificador do plano de parcelamento (por exemplo, Argentina). Consulte Planos de Parcelamento e IDs de Plano.
InterestEnumNãoSe o plano inclui juros: OnPosSelection, Interest ou NoInterest.
OperationModeEnumNãoQuem calcula o valor final: CalculatedGetnet (o terminal calcula) ou CalculatedISV (sua aplicação calcula e envia o valor final).
CallerIdStringNãoID gerado pelo sistema de automação, necessário para consultar a transação depois com o Check Status. Sem caracteres especiais ou Unicode.

As regras de parcelamento, os planos permitidos e as opções de juros dependem do país e da bandeira do cartão, e são validados pelo POS. Para a Argentina, consulte o anexo de Plan Ids. Se PlanId for plan_emisor ou plan_emisor_accelerated e o estabelecimento tiver “Plan Cuotas”, a resposta pode conter plan_getnet_simple em PlanId.

Esses parâmetros de parcelamento valem somente para vendas com cartão. Em vendas com QR Code, Installments, PlanId, Interest, OperationMode e Tip são ignorados — a carteira aplica o próprio parcelamento. Consulte Pagamento com QR Code.

O exemplo a seguir mostra como chamar uma venda com 3 parcelas e com juros:

var saleRequest = new SaleRequest
{
    Amount = 120000,
    SaleType = SaleType.Card,
    Installments = 3,
    PlanId = "plan_emisor_accelerated",
    Interest = InterestType.Interest
};

var saleResult = await connector.SaleAsync(saleRequest);

Depois que a requisição é iniciada, o POS conduz o fluxo da transação e a interação com o portador do cartão.

Passo 2: Trate a resposta

Uma venda parcelada bem-sucedida retorna a estrutura de resposta padrão de Sale. Veja abaixo um exemplo de resposta completa para uma venda parcelada:

{
  "Code": 0,
  "Message": "APPROVED",
  "OperationMode": "CalculatedGetnet",
  "AuthorizationCode": "551437",
  "Amount": 120000,
  "OriginalAmount": 120000,
  "AccountingDate": "2025-08-25T16:11:23.0000000Z",
  "RealDate": "2025-08-25T13:11:50.8570000-03:00",
  "SaleType": "Card",
  "CommerceCode": "1234567890",
  "TerminalId": "GET00123",
  "PlanId": "plan_emisor_accelerated",
  "Interest": "Interest",
  "Installments": 3,
  "CallerId": "123456-789000",
  "CardBin": "84168075"
}

Como mostrado acima, a resposta traz o plano final e os detalhes de juros aplicados pelo POS. Sempre verifique o parâmetro Code antes de processar o resultado.

Juros e modo de operação

Os parâmetros Interest e OperationMode controlam quem calcula e aplica os juros.

Valores de Interest:

  • OnPosSelection: O usuário escolhe no POS se o plano inclui juros.
  • Interest: O plano inclui cobrança de juros.
  • NoInterest: O plano não inclui juros.

Valores de OperationMode:

  • CalculatedGetnet: O terminal calcula o valor final e os juros. O cálculo usa regras de negócio internas e dados coletados em tempo real durante o fluxo de pagamento. Esse é o padrão quando OperationMode é omitido. Portanto, o valor enviado pode mudar conforme PlanId, Interest e Installments.
  • CalculatedISV: Sua aplicação calcula e envia o valor final a ser cobrado; o terminal não o altera.

Em qualquer um dos modos, a resposta sempre retorna o valor final cobrado, o Installments usado e os demais campos que descrevem as condições de pagamento confirmadas.

Comportamento com cartão de crédito

Quando um cartão de crédito é detectado, o terminal valida quais planos e configurações de juros o estabelecimento permite. Isso resulta em três comportamentos:

  1. Nenhum dado de parcelamento enviado (OperationMode, PlanId, Interest, Installments) — o terminal pede que o operador selecione o plano e o número de parcelas no dispositivo.
  2. Dados enviados, mas não permitidos para o estabelecimento ou para o cartão — o terminal deixa o usuário escolher outra opção, porque as condições solicitadas não são autorizadas.
  3. Dados enviados e válidos — o terminal pula as telas de seleção de plano, juros e parcelas e vai direto para a confirmação do pagamento.

Combinações de parâmetros

A combinação de PlanId, OperationMode, Interest e Installments determina o resultado:

PlanIdOperationModeInterestInstallmentsResultado
contadoCalculatedISVNoInterest1 (ou nenhum)Processa a transação com uma única parcela.
contadoCalculatedISVNoInterest2–99Erro — contado não permite mais de uma parcela.
contadoCalculatedISVInterestqualquerErro — CalculatedISV não permite parcelamento com juros.
contadoCalculatedGetnetNoInterest1 (ou nenhum)Processa a transação com uma única parcela.
contadoCalculatedGetnetNoInterest2–99Erro — contado não permite mais de uma parcela.
contadoCalculatedGetnetInterest1Erro — contado não permite transações com juros.
contadoCalculatedGetnetInterest2–99Erro — contado não permite mais de uma parcela.
Outros planosCalculatedISVNoInterestnenhumSolicita as parcelas na tela.
Outros planosCalculatedISVNoInterest1–99Verifica se o número de parcelas é permitido; se não for, solicita na tela.
Outros planosCalculatedISVInterestqualquerErro — CalculatedISV não permite parcelamento com juros.
Outros planosCalculatedGetnetNoInterestnenhumSolicita as parcelas na tela.
Outros planosCalculatedGetnetNoInterest1–99Verifica se o número de parcelas é permitido; se não for, solicita na tela.
Outros planosCalculatedGetnetInterestnenhumSolicita as parcelas na tela.
Outros planosCalculatedGetnetInterest1–99Verifica se o número de parcelas é permitido; se não for, solicita na tela.

A disponibilidade também depende do plano selecionado, do país e da bandeira do cartão. Consulte Planos de Parcelamento e IDs de Plano.

Próximos passos