PayPal Direct
Sur cette page
PayPal Direct est un connecteur libre-service : un identifiant client et un secret, deux étendues de lecture et cinq paramètres API activés sur l'application. Il s'agit de la meilleure source de litiges du catalogue, et il s'agit de rapports réglés, qui déterminent ce que vous pouvez et ne pouvez pas lui demander.
Ce que vous obtenez#
Transactions réglées, soldes et paiements, ainsi que dossiers de litiges avec leur cycle de vie.
Le plus fort pour les litiges. Les données de litige de PayPal sont plus complètes que la plupart des autres, ce qui en fait le connecteur sur lequel s'appuyer pour connaître le taux de litige par segment, les résultats des gains et des pertes, ainsi que le décalage entre une transaction et le litige qu'elle suscite. Les différends font surface 30 à 180 jours plus tard, c’est pourquoi une année complète d’histoire est importante ici.
Le plus faible pour l’analyse des échecs au niveau de la tentative. La recherche de transactions est un reporting réglé : elle vous indique ce qui est terminé, pas ce qui a été essayé. les codes de refus par tentative ne sont pas disponibles here.
Avant de commencer#
Votre compte marchand doit être activé pour les paiements directs. L'utilisation en direct nécessite l'approbation de PayPal : demandez-la avant de commencer.
Dans la console PayPal, créez un Application API REST pour Athia et notez son Client ID et Secret. C'est le chemin normal. Les anciens comptes de paiements directs utilisent à la place NVP/SOAP informations d'identification - Nom d'utilisateur, Mot de passe et Signature.
Attachez exactement deux étendues :
transactions:readpayouts:read
Ces deux étendues sont en lecture seule : cet identifiant ne peut pas capturer, rembourser ou envoyer de l'argent.
Activer les paramètres de l'API de l'application
Les chaînes de portée ne contrôlent pas les données à elles seules, mais les paramètres de l'API de l'application le font. Activez les cinq sur l'application :
| Paramètres de l'application | Qu'est-ce que ça ouvre |
|---|---|
| Accepter les paiements | Paiements, autorisations, captures, remboursements |
| Abonnements | Plans de facturation et enregistrements d'abonnement |
| Facturation | Enregistrements de factures |
| Litiges clients | Les litiges et leur cycle de vie |
| Recherche de transactions | Historique et soldes des transactions réglées |
Sans Facturation et Abonnements activé, les données de facture et de plan de facturation arrivent vides.
Créer un rôle en lecture seule
Connectez-vous au tableau de bord du développeur PayPal en tant qu'administrateur et créez un rôle personnalisé, par exemple Intégration Athia — avec des autorisations en lecture seule pour :
- Transactions (recherche, détails)
- Reporting (soldes, transactions)
- Paiements (détails)
- Abonnements
- Litiges
Production et Sandbox sont des connexions distinctes. Créez une application et une connexion Athia pour chaque environnement. Utilisez des informations d'identification en direct pour la connexion de production, sinon il ne vérifie et ne contient rien de ce que vous reconnaissez.
Informations d'identification demandées par Athia#
| Champ | Obligatoire | Qu'est-ce que c'est / où le trouver |
|---|---|---|
| Nom | Oui | Votre libellé pour cette connexion — identifiez le compte marchand PayPal |
| Calendrier | Non | À quelle fréquence Athia interroge PayPal |
| Identifiant client | Oui | Depuis l'application que vous avez créée pour Athia |
| Clé secrète | Oui | Le secret correspondant pour cette application |
| Nom d'utilisateur / Mot de passe / Signature | Héritage uniquement | Identifiants NVP/SOAP : utilisez-les à la place de l'identifiant client et de la clé secrète sur les anciens comptes de paiements directs. |
Configuration de la connexion#
- Créez l'application, activez les cinq paramètres de l'API et confirmez que les deux étendues sont attachées.
- Dans Paramètres → Connexions, choisissez + Ajouter une connexion et sélectionnez PayPal Direct.
- Sur Configurer le connecteur, entrez un Nom et choisis un Calendrier.
- Sur Entrez les informations d'identification, entrez le Identifiant client et Clé secrète.
- Choisissez Vérifier la connexion.
- Copiez le URL de destination du webhook Athia du sorcier.
- Dans la console PayPal, accédez à Mes applications et informations d'identification → sélectionnez votre application → Webhooks → Ajouter un Webhook, collez l'URL et sélectionnez
PAYMENT.CAPTURE.COMPLETED,DISPUTE.CREATEDetPAYOUTS.BATCH.PROCESSED. Enregistrez, puis activez le webhook.
La connexion s'affiche alors comme ACTIVE et la première synchronisation démarre. Pour plusieurs comptes marchands PayPal, créez une application et une connexion pour chacun.
Cadence de synchronisation#
Les rapports établis récompensent moins les interrogations fréquentes qu'un connecteur de passerelle, et une interrogation plus rapide ne produira pas de détails au niveau de la tentative que la source ne contient pas. Faites correspondre le calendrier à la fréquence à laquelle vous lisez réellement les données.
Limites et choses à savoir#
- Aucun code de refus par tentative. La recherche de transactions rapporte l'activité réglée ; les raisons du refus de la source proviennent d'un connecteur de passerelle.
- Les montants sont décimaux - ne divisez jamais par 100.
- Calendrier des litiges. Les litiges apparaissent bien après la transaction, de sorte que les taux de litiges des périodes récentes semblent toujours meilleurs qu'ils ne le seront en réalité. Comparez les cohortes qui ont eu le temps de mûrir.
- L'histoire remonte à trois ans. Transaction Search renvoie au maximum trois années de transactions. Pour tout ce qui est plus ancien, chargez les fichiers - voir Intégrer Athia.
- Les données de la carte sont minimisées. Détails au niveau du terrain sur les magasins Athia Dictionnaire de données Athia.
Dépannage#
| Ce que tu vois | Cause probable | Que faire |
|---|---|---|
| Les transactions arrivent mais aucun paiement | payouts:read non activé | Ajoutez la portée, puis reconnectez-vous |
| Aucune raison de refus nulle part | Attendu – déclaration réglée uniquement | Utiliser un connecteur au niveau de la passerelle pour les données de tentative |
| La vérification échoue juste après un changement de portée ou d'autorisation | Nouvelles autorisations pas encore appliquées | Attendez jusqu'à neuf heures, puis réessayez : ne réémettez pas les informations d'identification. |
| Les données de la facture ou du plan de facturation sont vides | Facturation ou Abonnements non activé sur l'application | Activez le paramètre de l'application, attendez qu'il s'applique, puis reconnectez-vous |
| Aucun événement de litige ou de paiement n'arrive entre les sondages | Webhook non enregistré ou non activé | Ajoutez à nouveau l'URL de destination du Webhook Athia sous Mes applications et informations d'identification → Webhooks et activez-le |
| Le taux de litiges semble inhabituellement bas | Les transactions récentes n’ont pas vieilli dans leur fenêtre de litige | Lire le taux de litiges sur les cohortes matures |
Connexes#
- Connecteurs Athia — le catalogue complet des connecteurs
- Dictionnaire de données Athia — définitions de champs
- Intégrer Athia — les suppressions de fichiers, les partages d'entrepôt et les autres chemins d'intégration