PayPal Direct
PayPal Directは、クライアントID、シークレット、2つの読み取り権限、およびアプリで有効になっている5つのAPI設定を備えた、自己完結型のコネクターです。これは、カタログ内で最も優れた紛争解決手段であり、報告に基づく解決方法であり、このコネクターからどのような情報を取得できるかを決定します。
得られるもの#
決済済み取引、残高、支払い、および紛争記録とそのライフサイクルを管理します。
紛争解決に最も適しています。 PayPalの紛争データは、他のほとんどのデータよりも詳細であり、これにより、セグメントごとの紛争率、成功/失敗の結果、および取引と紛争の間の遅延に関する情報を取得できるため、このコネクターが最も適しています。紛争は30〜180日後に発生するため、1年分の履歴が重要です。
試行レベルでのエラー分析には不向き。 トランザクション検索は、完了したトランザクションに関するレポートを提供し、試行されたトランザクションに関する情報を提供しないため、 「1回の試行ごとに拒否コードを取得することはできません」 here.
始める前に#
貴社の商用アカウントは、 **直接決済機能が有効になっている必要があります。**実際の利用には、PayPalの承認が必要です。開始する前に、申請してください。
PayPalコンソールで、 REST API アプリを作成し、 Athia 用として、その Client ID および **シークレットを記録してください。**これは通常のパスです。従来のDirect Paymentsアカウントでは、代わりに NVP/SOAP 認証情報を設定してください。 ユーザー名, パスワード および 署名.
以下の2つのスコープを添付してください:
transactions:readpayouts:read
これらの2つのスコープは読み取り専用です。この資格情報は、資金の回収、払い戻し、送金を行うことができません。
アプリのAPI設定を有効にする
スコープ文字列は、それ自体でデータを制限するものではありません。アプリのAPI設定がそれを制御します。アプリで以下の5つすべてを有効にします。
| アプリ設定 | 制限する内容 |
|---|---|
| 支払いを受け付ける | 支払い、承認、決済、払い戻し |
| サブスクリプション | 請求プランとサブスクリプション記録 |
| 請求書発行 | 請求書記録 |
| 顧客からの異議申し立て | 紛争とそのライフサイクル |
| 取引検索 | 取引履歴と残高の確認 |
（アカウント連携なしで） 請求書発行 および サブスクリプション 有効化後、請求書および請求プランのデータが空で返されます。
読み取り専用ロールの作成
PayPal Developer Dashboardに管理者としてログインし、カスタムロールを作成してください。例えば Athiaとの統合 — 読み取り専用権限で:
- トランザクション（検索、詳細）
- レポート（残高、トランザクション）
- 支払い（詳細）
- サブスクリプション
- 紛争
本番環境とサンドボックス環境は、それぞれ別の接続です。 環境ごとに、アプリとAthiaとの接続を作成してください。 ライブ環境では、ライブの認証情報を使用してください。そうしないと、認証が確認され、認識できる情報が送信されません。
Athia が要求する認証情報#
| フィールド | 必須 | その内容 / どこで入手するか |
|---|---|---|
| 名前 | はい | この接続用のラベル - PayPalの商用アカウントを特定 |
| スケジュール | なし | AthiaがPayPalをどのくらいの頻度でポーリングするか |
| クライアント ID | はい | Athia で作成したアプリケーションから |
| シークレットキー | はい | そのアプリケーションに対応するシークレット |
| ユーザー名 / パスワード / 署名 | レガシー環境のみ | NVP/SOAP 認証 – レガシーの Direct Payments アカウントでは、クライアント ID とシークレットキーの代わりにこれを使用してください。 |
接続の設定#
- アプリケーションを作成し、5 つの API 設定を有効にし、両方のスコープが添付されていることを確認してください。
- 「 設定 → 接続、選択 + Agregar Conexión を選択して、 PayPal Direct.
- On コネクタの設定、入力してください 名前 そして、選択肢から一つを選んでください。 スケジュール.
- On 認証情報を入力する、以下の情報を入力します。 クライアント ID および シークレットキー.
- Choose 接続の確認.
- 以下の内容をコピーする Athia Webhook の宛先 URL ウィザードから。
- PayPal コンソールで、次の手順を実行します。 My Apps & Credentials → 自分のアプリを選択 → Webhooks → Webhookの追加にアクセスし、URL を貼り、
PAYMENT.CAPTURE.COMPLETED,DISPUTE.CREATEDおよびPAYOUTS.BATCH.PROCESSED。保存し、その後、Webhookを有効にします。
接続状態は以下のように表示されます。 ACTIVE を選択すると、最初の同期が開始されます。 複数の PayPal merchant アカウントの場合、それぞれにアプリケーションと接続を作成してください。
同期頻度#
Settled レポートは、ゲートウェイコネクターよりも頻繁なポーリングを行うため、ポーリングの頻度を調整してください。 頻繁なポーリングは、ソースが持っていない詳細なレベルの情報を取得することになりません。 実際のデータ読み取り頻度に合わせてスケジュールを設定してください。
制限事項と注意点#
- 1 つのトランザクションあたりの拒否コードは提供されません。 トランザクション検索は、ゲートウェイコネクターから決済完了の状況と、拒否理由に関する情報を取得します。
- 金額は小数点 100で割らないでください。
- 紛争の発生タイミング。 紛争はトランザクション後に発生するため、最近の期間の紛争率は、実際よりも良く見えます。成熟したグループを比較してください。
- トランザクション履歴は3年まで遡ります。 トランザクション検索は、最大3年分のトランザクションを返します。それ以前のデータについては、ファイルから読み込む必要があります（詳細は参照）。 Athiaとの統合.
- カードデータは最小限に抑えられます。 Athiaが保存しているデータの詳細な情報については、 Athiaデータ辞書に定義されています.
トラブルシューティング#
| 表示される内容 | 考えられる原因 | 対処方法 |
|---|---|---|
| トランザクションは到着するが、支払いが行われない | payouts:read 無効 | スコープを追加し、再接続 |
| 拒否理由がどこにもありません | 期待される動作：決済完了の状況のみのレポート | 試行データについては、ゲートウェイレベルのコネクターを使用 |
| スコープまたは権限の変更後、検証が失敗する | 新しい権限がまだ適用されていない | 最大9時間待ってから再試行してください。資格情報を再発行しないでください |
| 請求書または請求プランのデータが空 | 請求書発行 または サブスクリプション アプリで無効 | アプリの設定を有効にし、設定が適用されるのを待ってから再接続 |
| 紛争または支払いに関するイベントがポーリングの間には到着しない | Webhookが登録されていない、または無効 | Athia Webhookの宛先URLを、以下の場所に再追加してください My Apps & Credentials（マイアプリと認証情報）→ Webhooks および有効にする |
| 紛争率が異常に低い | 最近のトランザクションが紛争期間内にない | 成熟したグループにおける紛争率の確認 |
関連#
- Athia Connectors —完全なコネクタカタログ
- Athiaデータ辞書に定義されています — データの定義
- Athiaとの統合 —ファイル配信、倉庫共有、およびその他の統合パス