Rayure
Sur cette page
Une seule clé API restreinte donne à Athia votre activité Stripe de bout en bout : frais, approbations et refus, remboursements et litiges, et ce que Stripe vous a réglé et facturé.
Ce que vous obtenez#
Paiements et tentatives de paiement avec leurs résultats, remboursements, litiges et frais enregistrés pour chaque transaction.
Le plus puissant pour l’étendue d’un seul identifiant. Une clé restreinte couvre chaque domaine : il n'y a aucun rapport à activer en premier, ce qui en fait le connecteur le plus rapide à mettre en place.
Le plus faible pour la granularité des coûts. Les frais arrivent mélangé, de sorte que l'échange ne peut pas être séparé des composants du schéma et de la passerelle. Pour le travail au niveau de l'échange, ajoutez Adyen ou Checkout.com data.
Avant de commencer#
La version API de votre compte Stripe doit être 2019-02-19 ou version ultérieure.
Créer un clé API restreinte (rk_…) pour Athia dans la console Stripe — pas votre clé secrète standard :
- Aller à Développeurs → Clés API et choisissez Créer une clé restreinte.
- Choisissez Construire votre propre intégration et continuez.
- Nommez la clé - par exemple,
Athia Integration. - Définissez les autorisations ci-dessous.
- Créez la clé et copiez le jeton.
| Accès | Ressources |
|---|---|
| Lire | Solde, sources de transactions de solde, transferts de solde, frais, litiges, événements, fichiers, intentions de paiement, méthodes de paiement, paiements, produits, intentions de configuration, sources, jetons, notes de crédit, abonnements, SKU, exécutions de rapports, types de rapports. Si vous utilisez des comptes connectés, accordez également Lire sur les ressources Connect, y compris les liens de compte. |
| Écrire | Points de terminaison du webhook |
Il est facile de manquer trois subventions. On arrête net la connexion ; les deux autres échouent silencieusement.
| Subvention | Omettez-le et |
|---|---|
| Lire sur Événements | La connexion échoue carrément. |
| Lire sur les rapports — Exécutions de rapports et Types de rapports | Les données sur les frais de carte au niveau des transactions ne sont pas disponibles, sans cause évidente. |
| Lire sur les ressources Connect, y compris Liens de compte | Les données du compte connecté ne peuvent pas du tout être sélectionnées. |
Informations d'identification demandées par Athia#
| Champ | Obligatoire | Qu'est-ce que c'est / où le trouver |
|---|---|---|
| Nom | Oui | Votre label pour cette connexion — identifiez le compte Stripe qu'il couvre |
| Calendrier | Non | À quelle fréquence Athia interroge Stripe |
| Clé API | Oui | La clé restreinte créée ci-dessus |
| Période de synchronisation historique | Oui | Tout le temps ou Date limite — jusqu'où s'étend le remblai |
| Limite de synchronisation vers l'arrière | Avec Date limite | La date la plus ancienne atteinte par le remblai |
Configuration de la connexion#
- Dans Paramètres → Connexions, choisissez + Ajouter une connexion et sélectionnez Rayure.
- Sur Configurer le connecteur, entrez un Nom et choisis un Calendrier.
- Sur Entrez les informations d'identification, collez la clé dans Clé API, choisissez un Période de synchronisation historique, et définissez le Limite de synchronisation vers l'arrière date si Date limite en révèle un.
- Choisissez Vérifier la connexion.
- Copiez le URL de destination du webhook Athia affiché dans l'assistant.
- Dans Stripe, accédez à Développeurs → Webhooks → Ajouter un point de terminaison, collez cette URL et sélectionnez les événements
charge.succeeded,dispute.createdetpayout.paid. Testez, enregistrez et activez le point de terminaison.
La connexion s'affiche alors comme ACTIVE et la première synchronisation démarre. Pour chaque compte Stripe supplémentaire, y compris Comptes connectés - créer une clé restreinte distincte et une connexion distincte.
Cadence de synchronisation#
Choisissez un Calendrier cela correspond à la façon dont vous surveillez l'acceptation. Des sondages plus rapides n’améliorent pas les enregistrements de paiements et de frais, qui ne changent que lorsque Stripe règle le problème.
Limites et choses à savoir#
- La synchronisation historique est limitée à un an. Tout le temps remblaye toute l’année qu’Athia peut atteindre ; Date limite prend un Limite de synchronisation vers l'arrière date, qui ne peut être antérieure d’un an à aujourd’hui. Pour un historique plus ancien, chargez-le via un dépôt de fichier sécurisé (SFTP/S3) — voir Intégrer Athia.
- Les frais sont mixtes. L'échange granulaire n'est pas disponible via ce connecteur.
- Les montants sont des unités mineures - diviser par 100. Athia gère cela lors de l'ingestion ; cela est important lors du rapprochement avec une exportation Stripe brute.
- Les données de la carte sont minimisées. Pour savoir ce que contient chaque champ ingéré, voir Dictionnaire de données Athia.
Dépannage#
| Ce que tu vois | Cause probable | Que faire |
|---|---|---|
| La vérification réussit mais un domaine est vide | Lecture manquante sur cette ressource | Modifiez les autorisations de la clé, puis reconnectez-vous |
| Moins d'histoire que prévu | Le plafond d'un an | Charger l'ancien historique via un dépôt de fichier sécurisé |
Connexes#
- Connecteurs Athia — le catalogue complet des connecteurs.
- Intégrer Athia — les chemins d'intégration, y compris les dépôts de fichiers et l'entrepôt à l'entrepôt.
- Dictionnaire de données Athia — définitions au niveau du champ.