Skip to main content
Com o repasse de taxa, o cliente paga a taxa do cartão de crédito, inclusive os juros do parcelamento, e você recebe o preço cheio do produto. Vale à vista e parcelado, no checkout e no link de pagamento.

Quando usar o repasse

Use quando a taxa do parcelamento come a sua margem, como em produtos de ticket alto vendidos em 12x. Sem repasse, a taxa de cada parcela sai do que você recebe (veja Parcelamento no cartão).

Como funciona o repasse de taxa

  • O acréscimo cobre a sua taxa. Em cada opção, de 1x até o máximo de parcelas, o cliente paga o menor valor que, descontada a taxa da sua conta, cobre o preço.
  • Ele muda com as parcelas, porque a taxa muda. Ele também depende do seu prazo de recebimento. As taxas da sua conta estão em Perfil → Taxas.
  • Só o cartão tem acréscimo. Pix, boleto, Apple Pay e Google Pay cobram o preço normal.
  • Com cupom, o acréscimo é calculado sobre o valor com desconto, e o cartão é cobrado à vista.
  • Vale no checkout e no link de pagamento. Assinatura não aceita repasse.
  • É definido na criação. Não dá para ligar o repasse num checkout que já existe: crie outro.
  • No reembolso, o cliente recebe de volta tudo o que pagou, com o acréscimo. A taxa do cartão não é devolvida, como em qualquer reembolso. Veja Reembolsos.
O repasse depende de a sua conta estar habilitada para ele. Se a opção não aparece no dashboard, ou se a API responde card.passFeesToCustomer requires card payments through Rinne, fale com o suporte.

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. Se quiser parcelar, escolha o máximo em Parcelas no cartão.
  4. Ligue Repassar a taxa do cartão ao cliente (“O cliente paga a taxa de cada parcela e você recebe o valor cheio”). A opção só fica ativa com Cartão selecionado.
  5. Salve.
No checkout, o campo Parcelas no cartão mostra o valor de cada parcela e o total da opção, já com o acréscimo. Abaixo, aparece a linha Total no cartão, com o valor da taxa do cartão separado.

Pela API

Envie card.passFeesToCustomer: true ao criar o checkout. O objeto card sempre leva maxInstallments: use 1 para só à vista, ou o máximo de parcelas para repassar em todas as opções.
Para um link de pagamento, mande o mesmo corpo para Criar link de pagamento. No checkout transparente, a cobrança é sempre do valor que você envia em amount.

Onde ler o acréscimo

Depois de um pagamento no cartão, o acréscimo vem em customerFee, em centavos: No webhook, amount menos customerFee é o preço do produto, já com o desconto se houve cupom. Em pagamentos por Pix ou boleto, não há acréscimo.

Erros do repasse

Notificações

O checkout.completed de um pagamento no cartão traz o amount com o acréscimo e o customerFee. Na venda parcelada, é um único evento com o total da venda.

Testar no Modo Teste

O repasse funciona no Modo Teste como em produção: crie o checkout com passFeesToCustomer, abra o link e confira o total de cada parcela. Pague com um cartão de teste e veja o customerFee no webhook.

Perguntas frequentes

Não. A API responde card.passFeesToCustomer is not available for subscriptions.
O acréscimo é calculado sobre o valor com desconto, e o cartão é cobrado à vista.
Não. Só o cartão de crédito digitado tem acréscimo. Pix, boleto, Apple Pay e Google Pay cobram o preço normal.
O repasse só existe no cartão. Inclua CARD em methods.
Não. O repasse é definido na criação. Crie um checkout novo com o campo.
A taxa do cartão da sua conta para o número de parcelas escolhido, no seu prazo de recebimento. Ela está em Perfil → Taxas.
O cliente recebe de volta tudo o que pagou, com o acréscimo, e a taxa do cartão não é devolvida. Veja Reembolsos.