Parcelamentos

Este recurso divide o preço total a pagar em várias quantias menores e iguais, com vencimento ao longo de um período de tempo acordado, em vez de exigir que o cliente pague tudo adiantado em um único pagamento. Esse método é amplamente utilizado nos mercados da América Latina (LATAM) e permite que os clientes tenham maior flexibilidade, mas sua implementação depende da disponibilidade de suporte do cartão e deve estar em conformidade com as regulamentações regionais.

Abaixo estão as bandeiras de cartão disponíveis que suportam parcelamentos em cada país

Requisição inicial

A API da Getnet espera receber os seguintes detalhes na requisição:

*No caso do Uruguai, são exigidos os 16 dígitos do cartão.

Exemplo:

"data" {
  "amount": 8900,
  "bin": "123412",
  "installment_type_filter": "no_interest",
  "number_token": "dfe05208b105578c070f806c80abd3a"
}

Resposta

Você precisará extrair as seguintes propriedades recebidas no corpo da resposta HTTP 201 Created para serem usadas na próxima etapa. Os valores para esses campos devem ser obtidos antecipadamente no serviço POST /dpm/payments-gwproxy/v2/payments/quotes.

Para mais detalhes, consulte a Referência da API

Criando um pagamento com parcelamentos

Assim que o cliente tiver selecionado sua cotação (quote) preferida, a API da Getnet espera receber os seguintes detalhes no corpo da requisição de pagamento:

| Atributo | Tipo | Descrição | Exemplo | |---|---|---| |data| object | Objeto de primeiro nível |-| |additional_data| object | Objeto de segundo nível (dentro de data) |-| |transaction_type| string | O tipo da transação de pagamento |FULL| |number_ installments| integer | Número de parcelas disponíveis para o crédito | 4 | |installment| object | Objeto opcional de terceiro nível (dentro de additional_data, onde quote_id e schema devem ser obrigatoriamente colocados). |-| |schema| string | Código que agrupa os créditos por categoria | PLAZOX | |type| string | Identificador que representa o tipo de crédito |no_interest| |quote_id| string | Quote ID a ser usado na consulta |06f256c8-1bbf-42bf-93b4-ce2041bfb87e|

Exemplo:

"additional_data": {
  "transaction_type": "PAYMENT",
  "number_ installments": 3,
  "installment": {
    "schema": "PLAZOX",
    "type": "no_interest",
    "quote_id": "4a29251d-41af-41fc-ac74-fa131e215e1b",
  }
}

Para mais detalhes, consulte a Referência da API

Particularidades

Ao criar parcelamentos nos mercados do Uruguai e da Espanha, existem algumas especificidades que devem ser aplicadas.

Uruguai

• O transaction_type deve ser definido como “INSTALL_NO_INTEREST”. Embora outros valores como FULL e INSTALL_WITH_INTEREST sejam suportados em outros mercados, apenas INSTALL_NO_INTEREST é válido para o Uruguai.
• Os valores possíveis para number_installments variam de 1 a 12 (em casos excepcionais, até 24 parcelas podem estar disponíveis por meio de acordos comerciais específicos).
• schema: este valor é sempre fixado como plan_al_eje.
• type: este valor é sempre fixado como no_interest.

Espanha

• O transaction_type deve ser definido como “PAYMENT” ou “PREAUTHORIZATION”. Embora outros valores sejam suportados em outros mercados, apenas esses dois valores são válidos para a Espanha.
• Os valores possíveis para number_installments são 3, 6, 9 e 12.
• schema: este valor é sempre fixado como PLAZOX.
• type: este valor é sempre fixado como no_interest.

Cálculos de taxas de juros

Para este processo, contamos com duas alternativas para estabelecimentos comerciais (merchants) e parceiros, dependendo de suas necessidades:

• Calculado pelo Usuário (Calculated by User): O estabelecimento comercial calcula as taxas de juros externamente e informa a API através do campo amount. Nas chamadas de API, o quote_id deve ser gerado sob no_interest.
• Calculado pela Getnet (Calculated by GetNet): O estabelecimento comercial depende dos cálculos de taxas de juros da Getnet, que contam com informações atualizadas do emissor/governo e, portanto, não precisará fazê-los externamente. Nas chamadas de API, o quote_id deve ser gerado sob with_interest.

Países disponíveis

As tabelas a seguir mostram por país os tipos de opções de parcelamento oferecidas. Consulte-as para verificar os parcelamentos oferecidos pelo seu país.

Parcelamentos na Argentina

Para a Argentina, existem três tipos principais de opções de parcelamento oferecidas em nível nacional, e só podem ser processadas com cartões nacionais ou domésticos:

• Planos do emissor (Issuer plans): Os planos básicos de parcelamento são oferecidos pelo emissor/bancos.
• Planos do governo (Government plans - Cuota Simple / Plan Ahora): Opção oferecida pelo governo argentino geralmente com taxas de juros mais baixas do que o plano do emissor.
• Getnet Integral (Cuota a Cuota): Plano oferecido pela Getnet no qual os estabelecimentos comerciais recebem mensalmente o valor correspondente à parcela paga pelo cliente.

Abaixo estão os possíveis valores de plano da API por bandeira de cartão na Argentina

Parcelamentos no Brasil

Para o Brasil, existem dois tipos principais de opções de parcelamento oferecidas em nível nacional:

• Planos do emissor (Parcelado Emissor): O estabelecimento comercial fará a liquidação da transação (Settlement) apenas uma vez, e o portador do cartão pagará o valor total e quaisquer taxas correspondentes aplicadas posteriormente.
• Parcelamentos do estabelecimento (Parcelado Lojista): O estabelecimento comercial fará a liquidação (Settlement) das transações parceladas mês a mês (D+30), incluindo MDR e taxas de desconto, e o portador do cartão pagará o valor sem taxas de juros.

Abaixo estão os possíveis valores de plano da API por bandeira de cartão no Brasil

Parcelamentos no Chile

Para o Chile, existem dois tipos principais de opções de parcelamento oferecidas em nível nacional:

• Planos do emissor (Issuer plans): Os planos básicos de parcelamento são oferecidos pelo emissor/bancos com opções que variam de 2 a 48. O estabelecimento comercial fará a liquidação da transação (Settlement) apenas uma vez, e o portador do cartão pagará o valor total e quaisquer taxas correspondentes aplicadas posteriormente.
• Parcelamentos do estabelecimento (Cuota Comercio): Plano sem taxas oferecido pelo estabelecimento comercial com opções que variam de 2 a 12. O estabelecimento comercial fará a liquidação da transação várias vezes, dependendo do plano selecionado.

Abaixo estão os possíveis valores de plano da API por bandeira de cartão no Chile

Parcelamentos na Colômbia

Para a Colômbia, há um tipo de opção de parcelamento oferecida em nível nacional:

• Planos do emissor (Issuer plans): O estabelecimento comercial fará a liquidação da transação apenas uma vez e o portador do cartão pagará o valor total e quaisquer taxas correspondentes aplicadas posteriormente.

Abaixo estão os possíveis valores de plano da API por bandeira de cartão na Colômbia

Parcelamentos no México

Para o México, existe apenas um tipo de opção de parcelamento oferecida em nível nacional e, para estar disponível para o estabelecimento comercial, requer ativação e contratação durante o processo de onboarding:

• MSI (Meses sin interés): Os planos de parcelamento base são oferecidos pela PROSA, nos quais o banco pessoal do cliente é responsável pela cobrança dos pagamentos, enquanto o estabelecimento comercial receberá uma liquidação (Settlement) única que inclui quaisquer taxas de dedução.

Abaixo estão os possíveis valores de plano da API por bandeira de cartão no México

Parcelamentos no Uruguai

Para o Uruguai, existem dois tipos principais de opções de parcelamento oferecidas em nível nacional:

Sem Juros (Sin Recargo): Você pode vender (ou comprar) em até 6 parcelas sem nenhum custo adicional acrescido ao preço final. O estabelecimento comercial geralmente absorve o custo padrão de financiamento em sua taxa de serviço, de forma que o cliente paga o “Preço à vista” (Cash Price) dividido pelo número de meses. Com Sobretaxa (Con Recargo): Para planos mais longos, um coeficiente de sobretaxa é aplicado ao valor total da venda. Se você for um estabelecimento comercial, deve multiplicar o valor da venda por um fator específico (coeficiente) antes de processar o cartão.

Abaixo estão os possíveis valores de plano da API por bandeira de cartão no Uruguai

Parcelamentos na Espanha

Para a Espanha, há apenas um tipo de opção de parcelamento oferecida em nível nacional e, para estar disponível para o estabelecimento comercial, é necessário garantir que seu terminal Getnet tenha o serviço Plazox ativado.

• Plazox: Para processar transações parceladas na Espanha, utiliza-se o Plazox, uma solução de pagamento que permite aos clientes dividir suas compras com cartão de crédito em 3, 6, 9 ou 12 meses, tanto em lojas físicas quanto online. A experiência é simples e não exige formalidades adicionais: na loja física, o próprio terminal oferece a opção de escolher o número de parcelas após a inserção do cartão e PIN, enquanto online a seleção é feita no checkout com um único clique. Para os estabelecimentos comerciais, a operação não envolve custos ou riscos, pois eles recebem o valor total da venda imediatamente, enquanto o banco emissor assume o financiamento do cliente. O Plazox é habilitado automaticamente para cartões elegíveis e se aplica a compras a partir de um valor mínimo de 60 euros, com a possibilidade de aumentar esse limite para até 500 euros dependendo dos acordos comerciais. É um mecanismo apoiado por bancos espanhóis que garante fluidez, simplicidade e confiança tanto para o cliente quanto para o estabelecimento comercial.

Abaixo estão os possíveis valores de plano da API por bandeira de cartão na Espanha