Adyen
Adyenは、プロバイダーコンソールで必要な作業を行う必要があります。Athiaが取り込むほとんどのデータは、スケジュールされたレポートファイルとして到着するため、それらのレポートは最初に存在する必要があります。そうすれば、Adyenは、最も多くのプロバイダーが公開していないレベルで、決済とコストの最高のソースになります。
得られるもの#
詳細な決済と集計決済、支払い会計、受け取った支払い詳細、インターチェンジおよびスキーム手数料の詳細、紛争トランザクションの詳細、3D Secure認証の結果。
決済と手数料の詳細に最適です。 Adyenは、ほとんどのプロバイダーが公開していないレベルで決済されたものとコストを分離します。これは、承認された注文あたりのコストに関する参照ソースになります。
La más débil en el contexto de la suscripción、これはここで薄いです—この画像はどこかから来ています。
始める前に#
1. レポートを有効にし、スケジュールします。 左上から、アカウントを選択 → レポート 左側のナビゲーション → 各レポートを検索し設定 → クリック 生成 → 選択 自動 (スケジュールに基づいて生成) → 選択 .CSV を ファイル形式として→ 次の設定を行います:
- 3D Secure認証
- 3DS認証
- 集約された決済詳細
- 紛争取引の詳細
- インターチェンジおよびスキーム手数料
- 決済会計
- 受信した決済の詳細
- 決済詳細
これらのレポートの自動生成を設定します。 法人アカウント レベルだけでなく、個々の加盟店アカウントごとに設定を行う場合でも、会社レベルのレポートは生成されません。
最初の加盟店アカウント設定後、レポートをブックマークして、残りのレポートの生成を高速化します。
2. レポートサービス用のユーザーを作成します。 「切り替え」 会社レベルでの表示、クレデンシャルを作成し、選択する ユーザーレポート機能 を 認証情報の種類。 ユーザー名 ~から 一般的な設定、その後、生成する パスワード をクリック サーバー設定 → 基本認証・この認証情報を、 会社アカウントおよびすべての商用アカウントに紐付け Athiaで必要な認証情報を設定します。設定された認証情報は、特定の口座のみに適用され、他の口座は除外されます。
3. ウェブサービス API の認証情報を作成します。 Adyen の顧客管理画面で、 会社レベルで、[リンク]にアクセス 開発者 → API認証情報 および、Webサービス用の認証情報を作成し、その認証情報を生成してコピーします。 APIキー.
4. WebサービスAPI認証情報に役割を割り当てます。 これだけでは不十分です。 権限 → 役割、付与 Management API - Accounts read および Management API - Webhooks read and write。 アカウント、関連付けます 、および関連する商社アカウント.
Athia が要求する認証情報#
| フィールド | 必須 | その内容 / どこで入手するか |
|---|---|---|
| 名前 | はい | この接続に対するラベル - 会社アカウントまたは地域を特定 |
| スケジュール | なし | Athia が新しいデータとレポートファイルをチェックする頻度 |
| Web Service API キー | はい | Athia に作成した API キー |
| レポート サービス API キー | はい | 会社レベルのレポート サービスユーザーの認証情報 |
接続の設定#
- 「 設定 → 接続、選択 + Agregar Conexión を選択して、 Adyen.
- On コネクタの設定、入力してください 名前 そして、選択肢から一つを選んでください。 スケジュール.
- On 認証情報を入力する, 次の操作を選択してください。 Web Service API キー と レポート サービス API キー.
- Choose 接続の確認.
接続状態は以下のように表示されます。 ACTIVE および最初の同期を開始します。
追加のMIDを使用する場合は、同じ認証情報を再利用します。すでにMID用のレポートが設定されている場合は、Adyenの設定を変更する必要はありません。
AdyenでAthiaのWebhookを登録する#
以下の内容をコピーする Athia Webhook の宛先 URL 接続ウィザードから設定し、その後 Adyen で設定します。
- [Go to] 開発者 → Webhooks → 新しい Webhook の作成 → 標準通知 → 追加.
- 開きます サーバー設定の編集 および、以下の内容を貼り付け Athia Webhook の宛先 URL.
- 「設定」セクションの下 商社アカウントで、必要なMID(Merchant ID)を選択してください。これらのMIDは、レポート作成に使用したMIDと一致している必要があります。
- 「設定」セクションの下 追加設定として、以下の項目を有効にします。 3Dセキュア (3D Secureの結果とバージョンを含む)、 決済機関 (決済機関の結果と参照情報を追加) カード (カードのBIN情報と、詳細なカードBIN情報を含みます)。
- Webhookのテストを行い、保存した後、有効化します。
会社レベルのレポートイベントについては、引き続きこのページの先頭にあるAdyenサポートへのリクエストが必要です。
同期頻度#
あなたの スケジュール は、Athiaが新しいレポートファイルをどれくらいの頻度で確認するかを制御しますが、Adyenがそれらを生成する速度とは異なります。 決済データは、Adyenがバッチを完了したときにのみ更新されます。
制限事項と注意点#
- レポート依存。 Adyen でレポートが無効化されている場合、または手動モードになっている場合、そのデータは Athia に到達せず、ドメインが空の状態でも検証が成功する可能性があります。
- 金額は小数点 — Stripe と異なり、100 で除算しない。
- カードデータは最小限に抑えられます。 各入力フィールドが何を表すかについては、 Athiaデータ辞書に定義されています.
- 参照してください。 Adyen から返されるレポートの数によって、過去のデータが制限されるため、非常に古い期間のデータは取得できない場合があります。そのため、Adyen の「顧客エリア」で、 レポート → レポートを選択 → カスタムの日付範囲実現可能な期間を確認してから、バックフィル期間を約束する。
トラブルシューティング#
| 表示される内容 | 考えられる原因 | 対処方法 |
|---|---|---|
| ある商社アカウントが欠落している | ユーザーアカウントとの関連付けが確認できない | アカウントごとに認証情報を関連付ける |
| 決済データは受信されるが、手数料データは受信されない | インタチェンジおよびスキーム手数料のレポートが無効になっている | 有効化し、次のレポート生成を待つ |
| 認証は成功したが、新しいデータは受信しない | Adyenは、会社レベルのレポートに関するウェブフックイベントを送信していない | Adyenサポートに連絡し、ウェブフックを有効化し、ウェブフックが有効になっていること、およびMIDがレポート用のMIDと一致することを確認する |
関連#
- Athia Connectors — すべてのコネクタカタログで、そのプロバイダーを表示します。
- Athiaとの統合 — ファイルのアップロード、および倉庫間の連携を含む、統合パス。
- Athiaデータ辞書に定義されています — 項目レベルの定義。