Aller au contenu principal
Sur cette page

L'acceptation ne représente que la moitié d'une décision de paiement ; l’autre moitié correspond à ce que vous coûte l’approbation. Les données de coûts parviennent à Athia sous forme de téléchargement CSV plutôt que de connexion API, car les tarifs contractés, les prix par méthode et les barèmes de frais sont des conditions commerciales contenues dans des accords et des feuilles de calcul – la plupart des fournisseurs n'exposent aucune API pour eux. Un fichier est la seule source complète.

Une fois les données de coûts chargées, Athia peut passer de « quel fournisseur approuve le plus » à « quel fournisseur approuve le plus par unité de coût », fixer le prix d'un changement d'itinéraire avant de l'effectuer et séparer une augmentation de frais que vous avez acceptée de celle que vous n'avez pas acceptée.

Les deux connexions de coûts#

ConnexionCe qu'il transporteModèle
Frais de paiement par carteVos tarifs de traitement de carte et grille tarifairecard-payment-fees-template.csv
Frais de paiement sans carteTarifs et frais pour tout ce qui n'est pas une carte : virements bancaires, portefeuilles, espèces et méthodes localesnon-card-payment-fees-template.csv

Gardez-les séparés même lorsqu'un seul fournisseur gère les deux. Les frais de carte se décomposent différemment des frais hors carte, et le modèle de coûts d'Athia les traite comme des objets différents.

Avant de commencer#

Il n'y a aucune condition préalable à la console du fournisseur ni aucune information d'identification pour ce connecteur : il s'agit d'un téléchargement de fichier, pas d'une connexion API. Ce dont vous avez besoin avant d'ouvrir l'assistant :

  • Le modèle CSV Athia. Téléchargez-le depuis l'étape 2 de l'assistant ("Besoin d'aide sur le format ? Téléchargez notre modèle CSV pour voir la structure attendue.") et remplissez-le. Le modèle définit les colonnes attendues par Athia, dans l'ordre où il les attend. Il s'agit de la définition de format faisant autorité : un fichier assemblé à partir de la mémoire ou à partir d'une exportation par un fournisseur échouera généralement à la validation.
  • La grille tarifaire elle-même, comme convenu : vos tarifs contractés, votre tarification par méthode et votre grille tarifaire pour la période couverte par le dossier.
  • Les régions d'intervention auquel l’accord s’applique.

Champs de configuration#

ChampObligatoireQu'est-ce que c'est / où le trouver
Nom de la connexionOuiVotre étiquette pour cette grille tarifaire. Nommez-le en fonction de l'accord qu'il représente, y compris la période d'effet, afin que la personne suivante puisse distinguer deux grilles tarifaires.
Régions d'exploitationOuiUne ou plusieurs des régions suivantes : Mexique, États-Unis et Asie-Pacifique. Les régions auxquelles l’accord s’applique. En cliquant Suivant sans région sélectionnée est bloqué avec un message de validation.
Fichier CSVOuiVotre copie complétée du modèle Athia. Seulement .csv est accepté.

Configuration#

L'assistant comporte trois étapes : Configuration → Télécharger le fichier → Valider.

  1. Aller à Paramètres → Connexions et choisissez + Ajouter une connexion.
  2. Sous Données sur les coûts, sélectionnez Frais de paiement par carte ou Frais de paiement sans carte.
  3. Étape 1, Configurer le connecteur: entrez un Nom de la connexion et cochez un ou plusieurs Régions d'exploitation. Les deux sont nécessaires.
  4. Étape 2, Télécharger le fichier CSV: téléchargez le modèle si ce n'est pas déjà fait, puis déposez votre fichier sur la dropzone ou utilisez Parcourir les fichiers.
  5. Choisissez Valider les données.

La validation vérifie le fichier par rapport à la structure attendue avant que quoi que ce soit ne soit ingéré, de sorte qu'un fichier mal formé est rejeté lors du téléchargement plutôt que d'apparaître plus tard sous forme de numéros de coût erronés dans une réponse. Si la validation échoue, corrigez le fichier et téléchargez-le à nouveau : aucun élément partiel n'est conservé.

Cadence de synchronisation#

Les données de coûts sont un instantané d’un accord commercial, elles deviennent donc obsolètes dès que vos prix changent. Téléchargez un nouveau fichier chaque fois que vous :

  • renégocier les tarifs,
  • ajouter un fournisseur ou un mode de paiement,
  • entrer sur un nouveau marché, ou
  • recevoir une grille tarifaire révisée.

Traitez-le comme un élément d'examen trimestriel, même si rien d'évident n'a changé : les changements de transmission et de frais de système arrivent sans conversation.

Limites et choses à savoir#

  • Seulement .csv les fichiers sont pris en charge. Pas de classeurs Excel, pas d'archives compressées.
  • Le modèle est la spécification de format. Les colonnes obligatoires sont définies par le modèle téléchargeable plutôt que documentées dans le produit. Les limites de taille de fichier, de nombre de lignes et de colonnes ne sont pas publiées.
  • Le téléchargement est tout ou rien. Un fichier dont la validation échoue est rejeté dans son intégralité ; il n’y a pas d’ingestion partielle.
  • Le comportement de remplacement n’est pas indiqué dans le produit. Le fait qu'un nouveau téléchargement remplace les tarifs précédents ou soit conservé à côté d'eux n'est pas défini dans l'assistant. Nommez chaque téléchargement pour l'accord et la période qu'il couvre, et confirmez avec votre équipe Athia quelle grille tarifaire est en vigueur avant de vous fier à un chiffre de coût qui s'étend sur un changement de prix.
  • Une grille tarifaire n’est pas une facture. Il dit à Athia ce que tu devrait être facturé, pas ce que vous étaient chargé. Les enregistrements réels de règlement et de frais proviennent des connecteurs du fournisseur, et la granularité de leurs frais varie : Checkout.com et Adyen proposent les frais les plus détaillés, tandis que Stripe rapporte des frais mélangés, sans échange granulaire. Le chargement à la fois de vos tarifs contractuels et des enregistrements de frais réels de votre fournisseur est ce qui rend possible l'analyse des écarts de frais. Voir Connecteurs Athia pour le catalogue de connecteurs de fournisseur.

Dépannage#

SymptômeCause probableCorriger
Suivant est bloqué à l'étape 1Aucune région opérationnelle sélectionnéeCochez au moins une des options suivantes : Toutes les régions, Mexique, États-Unis, Asie-Pacifique.
Le fichier est refusé à la dropzoneLe fichier n'est pas un .csv — généralement un .xlsx ou un zipExportez au format CSV et téléchargez le fichier brut
La validation échoueLe fichier ne correspond pas à la structure attendue, généralement parce qu'il a été créé à partir d'une exportation du fournisseur ou à partir de la mémoire plutôt que du modèle.Téléchargez le modèle de l'étape 2, transférez-y vos tarifs et téléchargez-le à nouveau.
Les chiffres des coûts semblent erronés lors d'un changement de prixAmbiguïté sur la grille tarifaire en vigueur pour la périodeConfirmez la grille tarifaire active auprès de votre équipe Athia ; assurez-vous que chaque téléchargement porte le nom de son accord et de sa période d'effet
Les frais déclarés ne correspondent pas à la grille tarifaireLa grille tarifaire correspond aux prix contractuels et non aux montants facturés.Comparez avec les enregistrements de règlement et de frais du fournisseur provenant des connecteurs du fournisseur ; attendez-vous à des frais mixtes de Stripe