メインコンテンツへスキップ
すべてのシステムが正常に動作しています変更履歴v1
ログイン

Chase

このページで

を参照してください。Chaseは、JP Morgan Chaseの商取引および決済業務です。その開発者ポータルとドキュメントでは、 JP Morgan Chaseデータは、AthiaがGlobal Payments and Reporting APIから支払いステータスとレポートを取得し、JPMCポータルに登録したWebhookでプッシュを受け取り、フォームベースの統合でSFTPバッチファイルを処理することで、Athiaに到達します。JP Morgan Chase Payments Developer PortalへのAPIアクセスと、JPMCの関係マネージャーに提出する必要があるDFRフォームなど、プロバイダー側の要件は、Athiaチームと連携して準備します。資格情報を取得したら、ご自身で接続を設定してください。

得られるもの#

  • 決済 — ステータスとリアルタイムの支払い情報。
  • 取引 — 取引の詳細と残高。
  • レポート — 販売、払い戻し、預金、手数料、事前および事後資金。
  • 通知 — イベントと推奨

カスタムレポートは、APIパラメータまたは、APIで提供されないレポートを定義するためのDFRフォームを通じて定義できます。

始める前に#

必要なアクセス権は JP Morgan Chase Payments 開発者ポータル 必要な権限（証明書生成、OAuth認証情報、APIキーの生成など）が付与されている状態で。

ポータル上で：

  1. アクセスをリクエストまたは設定する グローバル決済 および レポート APIs.
  2. 必要な機能を有効にする—例えば、リアルタイム決済と通知。
  3. Athiaが使用する認証情報を生成します。

認証情報の種類を選択

Оба варианта работают:

  • OAuth — クライアントIDとシークレットを生成し、スコープを設定 payments:read および reports:read両方のスコープは読み取り専用です。この資格情報は、資金の移動には使用できません。
  • 証明書ベース — ダウンロード .pem / .crt ポータルからファイルをダウンロードし、Athiaにアップロードします。

エンティティタイプにクレデンシャルを関連付けます。 会社 または Business Unit.

DFRフォーム

追加レポートには、 DFR (区切り文字形式のレポート) form. Он запрашивает 事業者名 および 法人番号, フォームを記入し、メールで提出してください。 JPMC担当者DFRフォームや初期設定に関するサポートが必要な場合は、Athiaのサポートチームにお問い合わせください。

Athia が要求する認証情報#

フィールド必須その内容 / どこで入手するか
名前はいこの接続に対するラベルを指定してください。この接続がカバーする Chase のエンティティを識別します。
スケジュールはいアthiaがChaseに情報を取得する頻度は、毎日または1時間ごとですか？
OAuth クライアント IDOAuthのみJPMC ポータルで生成した OAuth 認証情報から取得
OAuth クライアントシークレットOAuthのみThe matching secret for that client ID
証明書のアップロード証明書のみ次の .pem / .crt ポータルからダウンロードしたファイルを使用 - OAuth ペアの代わりに
法人番号はいJPMC のエンティティ識別子、DFR フォームで使用されている同じ番号

接続の設定#

  1. JPMC ポータルで、API アクセスを確認し、必要な機能を有効化し、OAuth ペアまたは証明書ファイルを生成します。 payments:read および reports:read または証明書ファイル。
  2. Athia で、以下の手順を実行します。 設定 → 接続 → + 接続を追加 を選択して、 Chase.
  3. On コネクタの設定、入力してください 名前 そして、選択肢から一つを選んでください。 スケジュール.
  4. On 認証情報を入力する、以下の情報を入力します。 OAuth クライアント ID および OAuth クライアントシークレット、または証明書ファイルをアップロードします。 .pem / .crt ファイルを選択し、その後、 法人番号.
  5. ネットワークと操作を定義 - グループを選択または作成し、この接続でカバーされる操作を追加します。
  6. Choose 接続の確認Athia は、API への軽量な支払いステータス ping を実行します。
  7. 以下の内容をコピーする Athia Webhook の宛先 URL ウィザードから設定し、JPMC ポータルで登録します - 詳細は後述

接続状態は以下のように表示されます。 ACTIVE 、および最初の同期を開始します。 複数のエンティティの場合は、個別の証明書を作成するか、サブ ID を使用し、エンティティごとに 1 つの接続を作成します。

Webhook#

Athia を通知先として登録し、支払いステータスの変更が、スケジュールされたポーリングではなく、リアルタイムで通知されるようにします。

  1. 以下の内容をコピーする Athia Webhook の宛先 URL 接続ウィザードから設定します。
  2. JP Morgan Chase Payments 開発者ポータルで、通知 / Webhook 設定を開きます。
  3. Athia の URL を貼り付け、必要なイベントを選択します - 支払いステータスの変更、および支払い更新や推奨事項 (使用する場合)
  4. Webhook を有効にし、ポータルから設定をテストします。

この手順をスキップすると、Athia はスケジュールされたポーリングの結果のみを確認します。

同期頻度#

毎日 または 1 時間ごと。 フォームベースの統合の場合、API ベースの統合と同様のデータが到着します。 SFTP バッチ処理 API 呼び出しの代わりに。

制限事項と注意点#

  • エンティティ番号は必須です。 これがないと、接続が正しい JPMC エンティティにスコープされません。
  • 1つの認証情報/エンティティあたり。 個別の証明書またはサブID、およびそれぞれ別の Athia 接続を使用してください。
  • DFR フォームは、担当者を通じて処理されます。 レポートが生成されるまでのリードタイムを設定してください。
  • 本番環境とテスト環境は分離されています。 本番環境でデータを取得するために使用する接続には、本番環境の認証情報を利用してください。
  • カードデータは最小限に抑えられます。 Athiaが保存しているデータの詳細な情報については、 Athiaデータ辞書に定義されています.

トラブルシューティング#

表示される内容考えられる原因対処方法
証明書のアップロード時に検証が失敗しました。誤ったファイルがエクスポートされたか、証明書がこのエンティティに関連付けられていません。JPMC ポータルから .pem / .crt を再ダウンロードし、再度アップロードしてください
OAuth認証での検証に失敗クライアントで必要なスコープが不足している追加 payments:read および reports:read ポータルに追加し、再度確認
決済は正常に処理されるが、レポートは空レポートへのアクセスが許可されていない、またはレポートにはDFRフォームが必要ですSolicite el acceso a la API de Informes en el portal; para informes adicionales, envíe el formulario DFR a su gerente de relaciones
接続は ACTIVE ただし、データは別のエンティティに属しています誤った 法人番号 接続設定エンティティ番号を修正し、再度確認
ポーリングの間、何も到着しませんWebhookが登録されていない、またはポータルで有効になっていません再度追加する Athia Webhook の宛先 URL、支払いステータス変更イベントを選択し、有効にします
最初の同期後にデータが一切表示されない本番環境の認証情報をテスト環境の接続で使用処理している環境で認証情報を再発行し、再度接続