Chasse

Chase est l'activité d'acquisition de commerçants et de traitement des paiements de JP Morgan Chase - son portail de développement et sa documentation utilisent le nom JP Morgan Chase. Les données parviennent à Athia de trois manières : Athia interroge les API Global Payments and Reporting pour connaître l'état des paiements et les rapports, reçoit des push sur le webhook que vous enregistrez sur le portail JPMC et récupère les fichiers batch SFTP où l'intégration est basée sur un formulaire. Les conditions préalables côté fournisseur (accès à l'API sur le portail des développeurs de JP Morgan Chase Payments et tout formulaire DFR devant être adressé à votre gestionnaire de relations JPMC) sont définies avec votre équipe Athia. Une fois que vous détenez les informations d’identification, vous effectuez vous-même la connexion.

Ce que vous obtenez#

• Paiements — informations sur le statut et le paiement en temps réel.
• Opérations — détails des transactions et soldes.
• Rapports — ventes, remboursements, dépôts et frais, préfinancés et postfinancés.
• Notifications — événements et recommandations.

Les rapports personnalisés sont définis via les paramètres de l'API ou via un formulaire DFR où le rapport dont vous avez besoin n'est pas celui renvoyé par les API.

Avant de commencer#

Vous devez accéder au Portail des développeurs de paiements JP Morgan Chase avec l'autorisation de générer des certificats, des informations d'identification OAuth ou des clés API.

Dans le portail :

1. Demander ou configurer l'accès au Paiements mondiaux et Rapports APIs.
2. Activez les fonctionnalités dont vous avez besoin, par exemple les paiements et les notifications en temps réel.
3. Générez les informations d'identification qu'Athia utilisera.

Choisissez un type d'identifiant

L'un ou l'autre fonctionne :

• OAuth - générer un identifiant client et un secret, et définir les étendues payments:read et reports:read. Les deux étendues sont en lecture seule : cet identifiant ne peut pas déplacer d'argent.
• Basé sur un certificat — téléchargez le .pem / .crt fichiers du portail et téléchargez-les sur Athia.

Associez les informations d'identification à votre type d'entité – Entreprise ou Unité commerciale.

Le formulaire DFR

Des rapports supplémentaires nécessitent un DFR (rapport de fichiers délimités) forme. Il demande Nom de l'entreprise et Numéro d'entité, et vous envoyez le formulaire complété par courrier électronique à votre Responsable des Relations JPMC. Contactez votre équipe de compte Athia si vous souhaitez de l'aide avec les formulaires DFR ou avec la configuration initiale.

Informations d'identification demandées par Athia#

Configuration de la connexion#

1. Dans le portail JPMC, confirmez l'accès à l'API, activez les fonctionnalités dont vous avez besoin et générez soit la paire OAuth avec payments:read et reports:read ou les fichiers de certificat.
2. A Athia, rendez-vous à Paramètres → Connexions → + Ajouter une connexion et sélectionnez Chasse.
3. Sur Configurer le connecteur, entrez un Nom et choisis un Calendrier.
4. Sur Entrez les informations d'identification, entrez le ID client OAuth et Secret client OAuth, ou téléchargez le .pem / .crt fichiers, puis entrez votre Numéro d'entité.
5. Définissez le réseau et l'opération : sélectionnez ou créez un groupe et ajoutez les opérations couvertes par cette connexion.
6. Choisissez Vérifier la connexion. Athia exécute un ping léger de statut de paiement sur l'API.
7. Copiez le URL de destination du webhook Athia depuis l'assistant et enregistrez-le sur le portail JPMC - voir ci-dessous.

La connexion s'affiche alors comme ACTIVE et la première synchronisation démarre. Pour plusieurs entités, générez un certificat distinct ou utilisez des sous-ID et créez une connexion par entité.

Webhook#

Enregistrez Athia comme destination de notification afin que les changements de statut de paiement arrivent au fur et à mesure qu'ils se produisent plutôt qu'au prochain sondage.

1. Copiez le URL de destination du webhook Athia à partir de l'assistant de connexion.
2. Dans le portail des développeurs de JP Morgan Chase Payments, ouvrez la configuration des notifications/webhook.
3. Collez l'URL Athia et sélectionnez les événements souhaités - changements de statut de paiement, ainsi que des mises à jour de paiement et des recommandations si vous les utilisez.
4. Activez le webhook, puis testez la configuration depuis le portail.

Ignorez ceci et Athia ne verra que ce que renvoie le sondage programmé.

Cadence de synchronisation#

Quotidiennement ou horaire. Lorsque votre intégration est basée sur un formulaire plutôt que sur une API, les mêmes données arrivent Lot SFTP fichiers au lieu de sondages API.

Limites et choses à savoir#

• Le numéro d’entité est requis. Sans cela, la connexion ne peut pas être étendue à la bonne entité JPMC.
• Un identifiant par entité. Certificats ou sous-ID séparés et une connexion Athia distincte pour chacun.
• Les formulaires DFR transitent par votre gestionnaire de relations. Prévoyez un délai avant que les rapports qu’ils déverrouillent n’apparaissent.
• Les environnements de production et de test sont distincts. Utilisez les informations d'identification de production sur la connexion dans laquelle vous attendez les données de production.
• 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#

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