Taxes

Ce que Wajub calcule, ce qu'il enregistre et ce qu'il ne modifie jamais dans le montant.

Tax répond à une question sur demande : « Quel est le montant de la taxe due sur cette somme dans ce pays ? » Il conserve la réponse dans un registre pour chaque paiement réellement encaissé. Ce registre vous sert à établir vos déclarations.

En revanche, Tax ne modifie pas vos paiements. Son activation ne change aucun montant, n'ajoute aucune ligne à un débit et reste invisible pour le payeur, sauf si vous l'affichez vous-même.

La taxe n'est jamais ajoutée au montant débité

Votre client paie le montant défini lors de la création du paiement, plus les frais de plateforme si vous les lui répercutez. La taxe n'y est pas ajoutée. Si votre prix doit comprendre la taxe, vous devez définir vous-même le total : demandez d'abord le calcul de la taxe, puis créez le paiement avec la somme obtenue. Wajub enregistrera la taxe dans les deux cas, selon le montant réellement débité.

Trois opérations entourent un paiement. Une seule déplace de l'argent.

1Demandée, pas appliquée
Le calculateur répond à une question. Ignorer la réponse ne change rien à votre paiement.
2Rien n'est ajouté
Le débit reste du montant pour lequel vous l'avez créé. Un prix taxes comprises, c'est à vous de le calculer.
3Inscrite une fois payée
Une ligne par paiement encaissé, dans un registre dédié. C'est à partir de ce registre que vous déclarez.

La question posée avant le débit, le paiement lui-même et la ligne enregistrée après son encaissement. Le montant qui quitte le checkout est celui qui atteint votre solde. La taxe se trouve dans son propre registre.

Deux opérations sur deux calendriers

Tous les éléments de cette section appartiennent à l'une ou l'autre. Les confondre est à l'origine de la plupart des questions.

	Calcul	Enregistrement
Nature	La réponse à une question	Une ligne de votre registre fiscal
Moment	À votre demande, avant le débit	Automatiquement, après le crédit des fonds
Déclencheur	`POST /tax/calculate`	La fin du paiement
Dépend de vos paramètres	Non, sauf pour les règles du client	Oui, rien n'est enregistré lorsque Tax est désactivé
Modifie le paiement	Jamais	Jamais

Le calcul est une calculatrice. L'enregistrement est une opération comptable. Vous pouvez utiliser l'un sans l'autre : demander des calculs sans jamais activer Tax, ou activer Tax sans jamais appeler l'endpoint.

Pays d'application de la taxe

Tax suit le principe de consommation : le taux appliqué est celui du payeur, pas le vôtre. Trois étapes le déterminent dans cet ordre.

Étape	Source
1	Le pays déduit de l'adresse IP du payeur à l'ouverture de la page de paiement
2	Votre paramètre `default_country`
3	`CM`, le pays d'origine de la plateforme

La devise ne détermine jamais le pays. Le XAF est utilisé dans six pays et un payeur à Paris peut vous payer en XAF depuis une adresse IP française. Le taux français s'applique alors. Avec POST /tax/calculate, aucune déduction n'a lieu. Le champ country est obligatoire et constitue la seule information utilisée.

La première étape a lieu uniquement sur la page hébergée

Le pays du payeur est déterminé à l'ouverture du checkout hébergé. Un paiement entièrement débité depuis votre serveur, sans passage du payeur sur une page Wajub, ne contient aucun pays. Tous ses enregistrements utilisent donc votre default_country. Si votre propre interface encaisse dans plusieurs pays, définissez default_country sur le pays principal et rapprochez les autres à partir de vos propres données.

Contenu d'un enregistrement

Une ligne est créée par paiement encaissé, dans la devise du paiement.

Champ	Contenu
`country_code`	Le pays dont le taux a été appliqué
`tax_name`	Le nom local de la taxe : `TVA`, `VAT`, `IVA`, `GST`
`rate`	Le pourcentage appliqué
`taxable_amount`	La base à laquelle le taux a été appliqué
`tax_amount`	La taxe elle-même
`tax_inclusive`	Indique si la base a été extraite du montant ou ajoutée à celui-ci
`charged_at`	Le moment où le paiement a été crédité, utilisé pour regrouper les rapports

Un remboursement écrit une deuxième ligne avec les deux montants négatifs. Le registre calcule donc automatiquement le montant net. Consultez Rapports fiscaux.

Couverture

Deux cents pays possèdent un taux normal, maintenu par Wajub et mis à jour sans intervention de votre part.

Pays	Taxe	Taux
Cameroun	TVA	19,25 %
Côte d'Ivoire	TVA	18 %
Sénégal	TVA	18 %
Kenya	VAT	16 %
Ghana	VAT	15 %
Afrique du Sud	VAT	15 %
Nigeria	VAT	10 %
France	TVA	20 %

Seize pays ont un taux de 0 %, soit parce qu'ils ne prélèvent aucune taxe de ce type, soit parce que leur système ne possède aucun taux national unique. Les États-Unis en font partie. La taxe sur les ventes y est définie par État et par ville, ce que Wajub ne détermine pas.

Un taux normal par pays

Il n'existe actuellement aucun taux réduit, aucun taux réellement appliqué par produit et aucun taux propre à un État ou à une ville. Quel que soit le pays, le calcul applique son unique taux normal. Configuration fiscale décrit les deux exceptions qui modifient le résultat : un client exonéré et l'autoliquidation.

Uniquement en live et selon le plan

Tax est disponible avec Growth, Scale et Enterprise, ainsi que sous forme d'option payante avec les plans inférieurs.

Rien ne s'exécute dans la sandbox. Aucun enregistrement n'est créé pour un paiement de test et les endpoints refusent une clé de test. Vous ne pouvez donc pas simuler un exercice fiscal. Dans le Dashboard, la section Tax nécessite l'autorisation view_tax. La modification des paramètres nécessite manage_tax.

Les transactions d'approvisionnement de votre propre solde Wajub ne produisent jamais d'enregistrement. Le déplacement de votre propre argent n'est pas soumis à la TVA.

Les endpoints

Ils nécessitent tous votre clé privée et sont réservés au mode live.

Méthode	Endpoint	Utilisation
`GET` `PUT`	`/tax/settings`	L'interrupteur, votre pays, les prix TTC et votre immatriculation
`POST`	`/tax/calculate`	La taxe due sur un montant avant son débit
`GET`	`/tax/rates`	Le taux normal de chaque pays
`GET`	`/tax/reports`	Le registre, regroupé par pays et par devise
`GET`	`/tax/codes`	Le catalogue des codes fiscaux des produits
`GET`	`/tax/jurisdictions`	Les taux infranationaux lorsqu'ils existent
`GET` `POST` `PUT` `DELETE`	`/tax/registrations`	Les pays où vous êtes immatriculé, pour vos propres dossiers
`GET`	`/tax/thresholds`	Les seuils d'immatriculation et votre progression
`GET` `POST` `DELETE`	`/customers/{id}/tax_ids`	Les identifiants fiscaux d'un client et leur vérification

Pages associées