Parcelas

Esse recurso divide o preço total a ser pago em vários valores menores e iguais a serem pagos em um período de tempo acordado, em vez de exigir que o cliente pague tudo adiantado em um único pagamento. Esse método é amplamente usado nos mercados da América Latina e permite que os clientes tenham maior flexibilidade, mas sua implementação depende da disponibilidade do suporte do cartão e deve estar em conformidade com as regulamentações regionais.

Abaixo estão as marcas de cartões disponíveis que aceitam parcelamento em cada país

Geração de ID de cotação

Ao implementar parcelamentos em Argentina e Chile mercados, será obrigatório cumprir o valor quote_id nas solicitações de parcelamento da API para que as transações possam ser processadas corretamente. Esse campo é usado para calcular taxas de juros, impostos e outros requisitos antes de uma autorização de pagamento.

Cálculos de taxas de juros Para esse processo, contamos com duas alternativas para comerciantes e parceiros, dependendo de suas necessidades:

• Calculado pelo usuário: o comerciante calcula as taxas de juros externamente e informa a API por meio do amount campo. Na API chama o quote_id deve ser gerado em no_interest
• Calculado pela GetNet: O comerciante confia nos cálculos das taxas de juros da GetNet, que contam com informações atualizadas do emissor/governo e, portanto, não precisará fazê-las externamente. Na API chama o quote_id deve ser gerado em with_interest

Parcelas na Argentina

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

• Planos do emissor: Os planos básicos de parcelamento são oferecidos pelo emissor/bancos.
• Planos governamentais (Cuota Simple /Plan Ahora): Opção oferecida pelo governo argentino geralmente com taxas de juros mais baixas do que o plano do emissor.

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

Parcelas no Brasil

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

• Planos emissores (Parcelado Emissor): O comerciante liquidará a transação apenas uma vez e o titular do cartão pagará o valor total e quaisquer taxas correspondentes aplicadas posteriormente.
• Parcelas comerciais (Parcelado Lojista): O comerciante liquidará as transações parceladas mês a mês (D+30), incluindo MDR e taxas de desconto, e o titular do cartão pagará o valor sem nenhuma taxa de juros.

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

Parcelas no Chile

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

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

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

Parcelas do México

Para o México, há apenas um tipo de opção de parcelamento oferecida em nível de país e, para estar disponível para o comerciante, ela precisa ser ativada e contratada durante o processo de integração:

• MSI (meses sem interesse): Os planos de parcelamento básicos são oferecidos pela PROSA, nos quais o banco pessoal do cliente é responsável pela cobrança dos pagamentos, enquanto o comerciante receberá uma liquidação exclusiva que inclui todas as taxas de dedução.

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

Parcelamentos no Uruguai

Para transações parceladas no Uruguai, duas condições devem ser atendidas na configuração da requisição. A propriedade transaction_type, localizada no objeto payments dentro da seção data do corpo da requisição, deve ser definida como "FULL". Embora outros valores como "INSTALL_NO_INTEREST" e "INSTALL_WITH_INTEREST" sejam aceitos em outros mercados, apenas o valor "FULL" é válido no Uruguai.

Além disso, um objeto installment deve ser incluído na seção additional_data. Esse objeto deve conter as seguintes propriedades:

• type: Identificador que representa o tipo de crédito.
• schema: Código que agrupa os créditos por categoria. Este valor é sempre fixo como "Q" na resposta.
• number: Número de parcelas disponíveis para o crédito. Os valores possíveis vão de 1 a 12 (em casos excepcionais, podem chegar a 24 parcelas mediante acordos comerciais específicos).
• code: Código único associado à oferta de crédito específica. Este valor é sempre fixo como "00" na resposta.

Os valores para esses campos devem ser obtidos previamente por meio do serviço POST /dpm/payments-gwproxy/v2/payments/quotes.

Exemplo:

"additional_data": {
  "installment": {
    "schema": "Q",
    "type": "00",
    "code": "00",
    "number": 2
  }
}

Observações ao usar a API de parcelamento

Solicitação inicial

A API GetNet espera receber os seguintes detalhes na solicitação:

• amount: Valor total a ser pago.
• bin: Primeiros 6 ou 9 dígitos do cartão (de preferência 9; no caso do Uruguai, são exigidos 16 dígitos).
• installment_type_filter: Propriedade opcional que só pode ter dois valores possíveis: no_interest ou with_interest.

Resposta

Você precisará extrair as seguintes propriedades recebidas no corpo da resposta HTTP 201 Created para serem usadas na próxima etapa:

• quote_id
• schema

Para mais detalhes, consulte a API reference

Criação de um pagamento

Depois que o cliente selecionar sua cotação preferida, a GetNet Api espera receber os seguintes detalhes no corpo da solicitação de pagamento:

• data: Objeto de primeiro nível.
• additional_data: Objeto de segundo nível (dentro de dados).
• installment: Objeto opcional de terceiro nível (dentro) additional_data) onde quote_id e schema deve ser colocado obrigatoriamente. Se installment Se o objeto estiver incluído, o pagamento será feito de acordo com o número de parcelas previamente definido, caso contrário, o pagamento será feito em uma única parcela.