Braintree
このページで
Braintreeは、商 ID、公開鍵、およびプライベート鍵を基盤とした、自己管理型のコネクタです。APIユーザーに付与するアクセス権の種類が正しくないと、接続が機能せず、すべてのドメインが空になる可能性があります。
得られるもの#
マスクされた決済データ、定期支払い、サブスクリプション記録、紛争、顧客および支払い方法の記録、検証、およびステートメントとレポートデータを含むトランザクション。フィールドレベルの定義は、次の場所にあります。 Athiaデータ辞書に定義されています.
サブスクリプションに最適。 Braintreeは、多くのカードコネクタが扱わない定期支払いの詳細を保持しており、これにより、更新の成功と、失敗した再支払いの結果としての強制的な解約を追跡することが可能になります。
アクセス権が制限されている場合に、最も弱い。 カバー範囲は、割り当てた役割によって直接的に決まります。紛争や顧客に関するサポートが不足しやすい領域です。
始める前に#
Braintreeコンソールで、 アクセス制限付きの役割を作成してください。 Athia 用に設定し、API ユーザーに割り当てます。このロールには、以下の権限が必要です。
- トランザクション: トランザクションのダウンロード（支払いデータはマスキング）
- レポート機能: レポートの作成、実行、およびダウンロード。ダッシュボードのグラフの表示
- サブスクリプション決済: サブスクリプション記録のダウンロード、変更の確認、サブスクリプションプランの確認、サブスクリプションの確認、サブスクリプションの検索
- 紛争管理: 紛争の確認、管理、および異議申し立て
- Webhooks: Webhookの管理（追加/編集/削除）
- 請求書: 請求書の表示
- 読み取り専用アクセス： 住所の表示、顧客の表示、商社アカウントの表示、支払い方法の表示、トランザクションの表示、検証の表示、ファイルのダウンロード
- 検索: トランザクションの検索、検証の検索
住所を表示 および 顧客の表示 が最もよく省略される項目です。これらが省略されると、住所と顧客テーブルが空になり、エラーは発生しません。
APIユーザーを すべて 商社アカウント – Braintree は、各商社アカウントごとにアクセス権を付与します。したがって、省略されたアカウントは何も貢献しません。
API ユーザーとキーの作成#
- Braintree Control Panel に管理者としてログインし、上記の役割を作成します。
- 新しいユーザーを作成し、有効化する API へのアクセス そのユーザーに対して。
- 作成した制限付きのアクセス権を割り当てます。
- すべての商用アカウントを選択します。
- **新しいユーザーとしてログアウトし、再度ログインします。**その後、Merchant ID を生成し、コピーします。 Merchant ID, 公開鍵 および ファイル。.
Athia が要求する認証情報#
| フィールド | 必須 | その内容 / どこで入手するか |
|---|---|---|
| 名前 | はい | この接続に対するラベル - Braintree の商用アカウントを特定します。 |
| スケジュール | なし | Athia が Braintree に対して定期的にポーリングを行う頻度 |
| Merchant Id | はい | この接続でカバーされる Braintree の商取引 ID |
| 公開鍵 | はい | API ユーザーに発行されます — Braintree のドキュメントで確認できます |
| ファイル。 | はい | その API ユーザーに対応するプライベートキー |
接続の設定#
- ロールを作成し、API ユーザーに割り当て、そのユーザーをすべての商取引アカウントに割り当てます。
- 「 設定 → 接続、選択 + Agregar Conexión を選択して、 Braintree.
- On コネクタの設定、入力してください 名前 そして、選択肢から一つを選んでください。 スケジュール.
- On 認証情報を入力する、以下の情報を入力します。 Merchant Id, 公開鍵 および ファイル。.
- Choose 接続の確認.
接続状態は以下のように表示されます。 ACTIVE そして、最初の同期を開始します。紛争と顧客が実際に作成されていることを確認してください。これが、ロールが正しいことを確認する最も迅速な方法です。
Athia の Webhook を Braintree に登録#
Braintreeは、宛先が登録されると、リアルタイムでトランザクション、サブスクリプション、および紛争に関する更新をAthiaに送信します。
- 接続ウィザードで、以下のものをコピーしてください。 Athia Webhook の宛先 URL.
- Braintreeコントロールパネルにログイン 制限されたアクセスユーザーとして y cree un webhook.
- AthiaのURLを入力してください。 宛先URL.
- 「設定」セクションの下 通知として、以下の項目を有効にします。 すべて 通知イベントのオプション。
- テストと保存を行い、その後、Webhookを有効にします。
同期頻度#
適切な スケジュール を選択してください。選択したオプションは、受け入れ状況のモニタリング頻度と一致している必要があります。サブスクリプションと紛争に関するレコードは、Braintreeの独自の請求および紛争サイクルに基づいて進行します。
制限事項と注意点#
- 権限がない場合、ドメインは空になります。エラーは発生しません。 読み取り権限がない場合、紛争と顧客の情報は同期されません。ただし、検証は正常に完了します。
- カバー範囲は、商取引アカウントの割り当てに基づいて決定されます。 APIユーザーに割り当てられていないアカウントは、存在しません。
- 本番環境とサンドボックス環境は、それぞれ別の接続です。 各環境は、独自の商取引IDとキーペアを発行します。環境ごとに1つの接続を作成し、それらを混在させないでください。
- 決済と送金フィールドは、取引から最大2日遅れることがあります。 決済額は、決済が完了した日に確認してください。今日の日付ではなく、決済が完了した日に確認してください。
- 金額は小数点 100で割らないでください。
- カードデータは最小限に抑えられます。 上記の役割は、マスクされた支払いデータのみを許可します。
トラブルシューティング#
| 表示される内容 | 考えられる原因 | 対処方法 |
|---|---|---|
| Disputesや顧客が同期後に空になる | 紛争管理または読み取り専用権限がない役割 | 必要な権限を追加し、再度接続してください。 |
関連#
その他のプロバイダーとインポートパスは、 Athia Connectorsに記載されています。ファイル転送や、直接コネクタの代替として、倉庫間でのデータ転送については、 Athiaとの統合.