API Reference

Documentação que explica exemplos de valores de como o split entre o Marketplace e os Sellers funciona

O Split de liquidações é a solução que divide uma transação em partes (recebedores) para que cada participante da venda receba seu respectivo valor. Essa funcionalidade faz sentido quando pensamos em modelos de negócio como o marketplace: plataforma que conecta diferentes lojistas à inúmeros compradores num único ambiente.

Como habilitá-lo?

  1. A empresa necessita estar cadastrada internamente na nossa plataforma como do tipo Marketplace.

VTEX

Para habilitar na VTEX é necessário ir em "Afiliações de gateway" e selecionar:

Exemplos

Uma situação será apresentada abaixo para explicar como um cálculo de split de liquidações é executado:

Neste exemplo haverá um Marketplace e dois Sellers cadastrados.

  1. O marketplace está cadastrado com taxa de serviço de 10% e 80 centavos de taxa de transação.
  2. O Seller X possuirá comissão registrada de 16%
  3. O Seller Y possuirá comissão registrada de 20%

O carrinho possuirá produtos do Seller X, Seller Y e do Marketplace. Então será enviado com os valores abaixo:

  • 69.90 para o Marketplace
  • 87.12 para o Seller X
  • 42.60 para o Seller Y

O valor total da compra será de 199.62

Exemplo onde todos estão configurados para pagarem as taxas

Captura

VendedorValor totalComissãoValor recipienteTaxa de serviço PagaleveValor intermediárioTaxa de transação PagaleveValor de repasse
Marketplace69.90-69.90 + (13.94 + 8.52) = 92.369.2483.12 (46,27%)0.3782.75
Seller X87.1213.9473.187.3265.86 (36,66%)0.2965.57
Seller Y42.608.5234.083.4130.67 (17,07%)0.1430.53

Total de taxa de serviço: 19.96
Total de taxa de transação: 0.80
Total de taxas Pagaleve: 20.76
Total de comissão pagos: 22.46

Reembolso

Neste exemplo o Seller X solicitou o reembolso de 10.00

VendedorValor totalComissãoValor recipienteTaxa de serviço PagaleveTaxa de transação PagaleveValor de repasse
Marketplace1.600.1601.44
Seller X10.001.608.400.8407.56

Variáveis de cobrança (chargeProcessingFee and chargebackLiable)

527

Exemplo de configuração das variáveis de cobrança na VTEX

As variáveis ​​de cobrança são as duas variáveis ​responsáveis ​​por habilitar ou desabilitar a cobrança de tarifas.

A chargeProcessingFee habilita/desabilita as cobranças em transações de pagamento e a chargebackLiable habilita/desabilita as cobranças em transações de reembolso.

Embora essas variáveis ​​possam desabilitar a cobrança de taxas para um destinatário específico, essas taxas devem ser cobradas de outro destinatário na mesma transação. Para permitir esse comportamento temos uma sequência de regras para avaliar quem é o destinatário cobrado. Veja abaixo as regras em ordem de prioridade:

  1. A primeira regra é tentar obter o marketplace (deve ter apenas um) que tenha a respectiva variável de cobrança habilitada. Novamente, se for uma transação de pagamento, avaliará o chargeProcessingFee, caso contrário, o chargebackLiable. Todos as taxas não pagas devem ser cobrados dele.

  2. Se um marketplace com a variável de cobrança habilitada não for encontrado a segunda regra tentará encontrar algum destinatário (um vendedor, pois o marketplace já foi avaliado) com este estado. Todos os impostos não pagos serão cobrados dele.

  3. Se as duas outras regras falharem, a última regra fará com que o primeiro destinatário da lista de lojistas seja o responsável pelas cobranças. Todos os impostos não pagos devem ser cobrados dele.

Exemplos com as variávies de cobrança em diferentes combinações (Captura)

O marketplace e apenas um vendedor pagam as taxas

VendedorValor totalComissãoValor recipienteTaxa de serviço PagaleveValor intermediárioTaxa de transação PagaleveValor de repasseResponsável pelas taxas
Marketplace69.90-69.90 + (13.94 + 8.52) = 92.369.2492.36 - 9.24 - 7.32 = 75.80 (42,19%)0.3475.80 - 0.34 - 0.32 = 75.14Sim
Seller X87.1213.9473.187.3273.18 (40,73%)0.3373.18Não
Seller Y42.608.5234.083.4134.08 - 3.41 = 30.67 (17,07%)0.1430.53Sim

Somente o marketplace paga as taxas

VendedorValor totalComissãoValor recipienteTaxa de serviço PagaleveValor intermediárioTaxa de transação PagaleveValor de repasseResponsável pelas taxas
Marketplace69.90-69.90 + (13.94 + 8.52) = 92.369.2492.36 - 9.24 - 7.32 - 3.41 = 72.39 (40,29%)0.3272.39 - 0.80 = 71.59Sim
Seller X87.1213.9473.187.3273.18 (40,73%)0.3373.18Não
Seller Y42.608.5234.083.4134.08 (18,97%)0.1534.08Não

Somente os sellers pagam as taxas

VendedorValor totalComissãoValor recipienteTaxa de serviço PagaleveValor intermediárioTaxa de transação PagaleveValor de repasseResponsável pelas taxas
Marketplace-13.94 + 8.52 = 22.4622.46 (19,28%)022.46Não
Seller X87.1213.9473.187.32 + 2.25 = 9.5773.18 - 7.32 - 2.25 = 63.61 (54,46%)0.5963.61 - 0.44 - 0.15 = 63.02Sim
Seller Y42.608.5234.083.4134.08 - 3.41 = 30.67 (26,26%)0.2130.67 - 0.21 = 30.46Sim

Exemplos com as variávies de cobrança em diferentes combinações (Reembolso)

VendedorValor totalComissãoValor recipienteTaxa de serviço PagaleveTaxa de transação PagaleveValor de repasseResponsável pelas taxas
Marketplace1.600.1601.60 - 0.16 - 0.84 = 0.60Sim
Seller X10.001.608.400.8408.40Não