Planos de taxas (beta)

Esta documentação destina-se exclusivamente a intermediadores que já têm o recurso de Planos de Taxas ativado.

Importante: para utilizar essa funcionalidade, é necessário que o intermediador solicite ao time da Barte a ativação prévia do recurso. Sem isso, chamadas à API poderão retornar erros.

Os Planos de Taxas são uma funcionalidade da Barte para otimizar a experiência de aplicação de taxas por intermediadores. O fluxo se inicia com a criação de um plano, que é sempre vinculado à company (intermediador) que o originou. A gestão completa — criação, atualização e recuperação — pode ser feita tanto via API quanto pelo Webapp.

Estrutura e regras do plano

• Os planos podem definir taxas para os métodos de pagamento: pix, boleto, débito e cartão de crédito.

• Para cartão de crédito, é obrigatório incluir os três tipos de pagamento: online, pos e tap. Eles podem ser enviados com valor zero, mas devem estar presentes.

• Cada tipo de pagamento para cartão pode ainda mapear taxas por bandeiras: default, mastercard, visa, hipercard, elo, discover e american_express. A bandeira default é obrigatória.

Lógica de cálculo

• As taxas definidas no plano correspondem ao markup que o payfac deseja receber.

• A composição da taxa final leva em conta também a taxa Barte.

• Para detalhes sobre o cálculo, consulte a interface do Webapp (tela de visualização/edição do plano).

Associação com vendedores

• Um plano pode ser associado a múltiplos vendedores.

Atenção: ao alterar a taxa de um plano, a modificação será refletida automaticamente em todos os vendedores vinculados a ele.

Glossário:

Glossário - Planos de Taxas

Usabilidade no Webapp:

Criando um plano de taxas:

Atualizar taxas de um plano:

Atualizar o plano de um vendedor