Divida as taxas de processamento e o IVA

Dois controles para um pedido#

O controle de taxa de processamento aloca toda a taxa de aceitação, incluindo seus componentes percentual e fixo. O controle de IVA aloca apenas o imposto. Nenhum controle altera a tarifa, a alíquota de imposto ou o preço base do produto.

Totalmente à esquerda atribui o custo ao cliente; totalmente à direita atribui ao comerciante. Os rótulos mostram as porcentagens exatas de ambas as partes e os valores monetários. Os predefinidos Cliente, Dividir igualmente e Comerciante oferecem uma escolha rápida.

• A parcela do cliente é adicionada ao total do checkout.
• A parcela do comerciante é deduzida do preço base do pedido.
• SBP e criptomoeda têm IVA zero, então o controle de IVA não afeta o total deles.
• Botões e controles deslizantes funcionam com o teclado; animação não é necessária para entender o resultado.

Um preço base, dois custos separados#

Cartões internacionais e Alipay custam 10% do preço base mais $0,50, com IVA de 16% do preço base. SBP custa 8% e criptomoeda custa 4%; nenhum tem IVA sob o modelo de preços publicado.

O IVA é adicionado a partir do preço base, não extraído usando 16/116. A taxa não é recalculada sobre um total que inclui IVA ou a parcela da taxa do cliente. A comissão da Kevmi já está incluída na tarifa publicada; outros 5% não são adicionados.

fee = roundHalfUp(base × rate / 100) + fixed
vat = vatApplies ? roundHalfUp(base × 16 / 100) : 0
customerFee = roundHalfUp(fee × feeCustomerPercent / 100)
customerVat = roundHalfUp(vat × vatCustomerPercent / 100)
merchantFee = fee − customerFee
merchantVat = vat − customerVat
customerTotal = base + customerFee + customerVat
merchantNet = base − merchantFee − merchantVat

Alocando um pedido de cartão de $5#

Cada exemplo abaixo usa um preço base de $5,00, uma taxa total de cartão de $1,00 e IVA de $0,80. As porcentagens mudam apenas quem cobre esses custos.

Arredondamento sem perder um centavo#

Os valores são unidades monetárias menores inteiras. A taxa total e o IVA total são arredondados separadamente primeiro. Cada parcela do cliente usa então arredondamento para cima na metade, e o comerciante recebe o restante exato desse custo. As duas parcelas, portanto, sempre somam o valor original.

Para um custo de um centavo dividido 50/50, ao cliente é alocado um centavo e ao comerciante zero. A porcentagem permanece 50%, enquanto os valores monetários refletem a precisão disponível da moeda. O servidor rejeita cálculos com receita líquida negativa para o comerciante.

Defina a divisão pela API#

Envie vatCustomerPercent e feeCustomerPercent como inteiros de 0 a 100. Cada um se aplica à fatura que está sendo criada. Strings vazias, porcentagens fracionárias e números fora do intervalo são rejeitados.

Omitir feeCustomerPercent atribui toda a taxa ao comerciante. Omitir vatCustomerPercent usa o campo legado vatPayer ou o padrão da conta. Valores legados de cliente e comerciante correspondem a 100% e 0% de IVA do cliente. Não envie valores conflitantes de vatPayer e vatCustomerPercent.

As respostas descrevem uma parcela intermediária de IVA como vatPayer=shared. Use a porcentagem numérica para novas solicitações; shared não é aceito como valor de entrada legado vatPayer.

{
  "title": "Design project · order 1042",
  "description": "One-time payment for the agreed design work",
  "amountMinor": 500,
  "currency": "USD",
  "methods": [
    "card",
    "alipay"
  ],
  "vatCustomerPercent": 100,
  "feeCustomerPercent": 0,
  "orderId": "order-1042",
  "metadata": {
    "campaign": "autumn"
  }
}

Os termos permanecem com a fatura#

A fatura congela o valor, a moeda, os métodos e ambas as parcelas. Alterar preferências da loja não modifica links emitidos. Os controles deslizantes calculam a alocação; a execução ao vivo depende das capacidades do canal conectado.

Para um novo pagamento ao vivo com cartão ou Alipay, o gateway atual suporta apenas feeCustomerPercent=0 e vatCustomerPercent=100: o comerciante cobre toda a taxa de processamento e o IVA é adicionado integralmente para o cliente. Outras parcelas podem ser salvas e calculadas em uma fatura, mas a execução é bloqueada com unsupported_allocation. O servidor nunca altera silenciosamente os termos salvos. Pagamentos SBP e USDT cripto suportam todas as parcelas de taxa de processamento e não têm IVA.