Skip to main content
Com o parcelamento, o cliente divide a compra no cartão de crédito em até 12 parcelas. Você define o máximo, o cliente escolhe na hora de pagar, e o banco aprova a venda inteira de uma vez.

​
Onde o parcelamento funciona

​
Como funciona o parcelamento

  • De 2 a 12 parcelas. Uma parcela é o pagamento à vista.
  • **Mínimo de R10,00porparcela.∗∗Paraoferecer3x,ototalprecisaserdepelomenosR 10,00 por parcela.** Para oferecer 3x, o total precisa ser de pelo menos R 30,00; para 12x, de R$ 120,00.
  • O valor da compra é o total. O cliente vê o valor de cada parcela, e as parcelas podem variar alguns centavos por arredondamento.
  • A venda é aprovada de uma vez, no limite do cartão do cliente. Para você, cada parcela entra no saldo por conta própria.
  • Sem cupom. Quando o cliente aplica um cupom, o cartão é cobrado à vista.

​
Quem paga os juros do parcelamento

A taxa do cartão aumenta com o número de parcelas, e quem paga é você: o cliente paga o preço dividido nas parcelas, sem acréscimo, e a taxa sai do valor que você recebe. As taxas de cada parcela estão em Perfil → Taxas e na página de preços. Se preferir que o cliente pague, ligue o repasse de taxa: o checkout soma a taxa de cada opção de parcela ao total, e você recebe o preço cheio.

​
Pelo dashboard

  1. Vá em Sua Loja → Cobranças e clique em Criar cobrança, ou em Sua Loja → Links de pagamento e clique em Criar link de pagamento.
  2. Em Métodos de pagamento, selecione Cartão.
  3. Em Parcelas no cartão, escolha o máximo. A lista só vai até onde o mínimo de R$ 10,00 por parcela permite para os produtos escolhidos.
  4. Salve.
O campo Parcelas no cartão aparece quando a sua conta tem o parcelamento liberado, o que vem com a ativação do cartão. No checkout, quando o cliente escolhe Crédito, aparece o campo Parcelas no cartão, com o valor de cada opção (por exemplo, 3x de R$ 33,33). Depois da venda, a lista de Sua Loja → Cobranças mostra o número de parcelas abaixo do valor (em 3x). Nos detalhes da cobrança, a seção Parcelas lista cada uma com o seu status: A receber, Liquidada, Antecipada, Estornada ou Em disputa.

​
Pela API

Envie card.maxInstallments, de 1 a 12, ao criar o checkout ou o link de pagamento. CARD precisa estar em methods.
O checkout mostra as opções de 1x até o máximo. Para aceitar só cartão, tire PIX de methods. Depois do pagamento, o campo installmentsCount traz o número de parcelas escolhido, em Buscar checkout e no webhook. Ele fica null antes do pagamento, no pagamento à vista e em Pix ou boleto.

​
No checkout transparente

Envie installmentCount, de 1 a 12, em Criar cobrança Cartão. O amount é o total da venda.
A resposta traz o id da primeira parcela, o amount com o total da venda e os campos do parcelamento:
Os campos só aparecem quando a venda tem mais de uma parcela.

​
Erros do parcelamento

​
Notificações

Uma venda parcelada gera um único evento, quando a venda inteira é aprovada:
  • No checkout e no link de pagamento, chega um checkout.completed com o amount da venda inteira e o installmentsCount.
  • No checkout transparente, chega um transparent.completed com o id da primeira parcela, o amount da venda inteira e os campos installmentCount, installmentAmount, installmentNumber e installmentGroupId.

​
Testar no Modo Teste

No Modo Teste, crie o checkout com maxInstallments, escolha as parcelas na tela de pagamento e pague com um dos cartões de teste. Nada é cobrado de verdade.

​
Perguntas frequentes

Não. O cliente paga o preço dividido nas parcelas, e a taxa do parcelamento sai do que você recebe. Para que o cliente pague a taxa, use o repasse de taxa.
Ou o máximo definido é menor, ou o total não chega a R10,00porparcela.UmprodutodeR 10,00 por parcela. Um produto de R 50,00 parcela em até 5x.
Não. Assinaturas são cobradas à vista a cada ciclo.
Não. Com cupom, o cartão é cobrado à vista.
Não. Chega um único evento por venda, com o total e o número de parcelas.
O reembolso é da venda inteira: todas as parcelas são estornadas, e o extrato mostra um estorno por parcela. Veja Reembolsos.