Répartir les frais de traitement et la TVA

Deux contrôles pour une commande#

Le contrôle des frais de traitement répartit la totalité des frais d'acceptation, y compris leurs composantes en pourcentage et fixes. Le contrôle de TVA répartit uniquement la taxe. Aucun contrôle ne modifie le tarif, le taux de taxe ou le prix de base du produit.

Entièrement à gauche attribue le coût au client ; entièrement à droite l'attribue au marchand. Les étiquettes affichent les pourcentages exacts et les montants monétaires des deux parties. Les préréglages Client, Répartition égale et Marchand offrent un choix rapide.

• La part du client est ajoutée au total du paiement.
• La part du marchand est déduite du prix de commande de base.
• SBP et la cryptomonnaie ont une TVA nulle, donc le contrôle de TVA n'affecte pas leur total.
• Les boutons et les curseurs fonctionnent avec le clavier ; l'animation n'est pas nécessaire pour comprendre le résultat.

Un prix de base, deux coûts séparés#

Les cartes internationales et Alipay coûtent 10 % du prix de base plus 0,50 $, avec une TVA de 16 % du prix de base. SBP coûte 8 % et la cryptomonnaie 4 % ; aucun n'a de TVA selon le modèle tarifaire publié.

La TVA est ajoutée à partir du prix de base, non extraite en utilisant 16/116. Les frais ne sont pas recalculés sur un total qui inclut la TVA ou la part des frais du client. La commission de Kevmi est déjà incluse dans le tarif publié ; 5 % supplémentaires ne sont pas ajoutés.

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

Répartition d'une commande par carte de 5 $#

Chaque exemple ci-dessous utilise un prix de base de 5,00 $, des frais de carte totaux de 1,00 $ et une TVA de 0,80 $. Les pourcentages changent uniquement qui couvre ces coûts.

Arrondi sans perdre un centime#

Les montants sont en unités monétaires mineures entières. Les frais totaux et la TVA totale sont arrondis séparément d'abord. Chaque part du client utilise ensuite un arrondi au demi supérieur, et le marchand reçoit le reste exact de ce coût. Les deux parts s'additionnent donc toujours au montant d'origine.

Pour un coût d'un centime réparti 50/50, le client se voit attribuer un centime et le marchand zéro. Le pourcentage reste 50 %, tandis que les montants monétaires reflètent la précision disponible de la devise. Le serveur rejette les calculs avec des produits marchands négatifs.

Définir la répartition via l'API#

Envoyez vatCustomerPercent et feeCustomerPercent comme entiers de 0 à 100. Chacun s'applique à la facture en cours de création. Les chaînes vides, les pourcentages fractionnaires et les nombres hors plage sont rejetés.

Omettre feeCustomerPercent attribue la totalité des frais au marchand. Omettre vatCustomerPercent utilise le champ hérité vatPayer ou le défaut du compte. Les valeurs héritées client et marchand correspondent à 100 % et 0 % de TVA client. N'envoyez pas de valeurs conflictuelles vatPayer et vatCustomerPercent.

Les réponses décrivent une part de TVA intermédiaire comme vatPayer=shared. Utilisez le pourcentage numérique pour les nouvelles demandes ; shared n'est pas accepté comme valeur d'entrée héritée 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"
  }
}

Les conditions restent avec la facture#

La facture fige le montant, la devise, les méthodes et les deux parts. Modifier les préférences de la boutique ne modifie pas les liens émis. Les curseurs calculent la répartition ; l'exécution en direct dépend des capacités du canal connecté.

Pour un nouveau paiement en direct par carte ou Alipay, la passerelle actuelle ne prend en charge que feeCustomerPercent=0 et vatCustomerPercent=100 : le marchand couvre la totalité des frais de traitement et la TVA est ajoutée intégralement pour le client. D'autres parts peuvent être enregistrées et calculées sur une facture, mais l'exécution est bloquée avec unsupported_allocation. Le serveur ne modifie jamais silencieusement les conditions enregistrées. Les paiements crypto SBP et USDT prennent en charge toutes les parts de frais de traitement et n'ont pas de TVA.