Stripe
単一の制限付きAPIキーにより、AthiaはStripeの活動に関するすべての情報を取得できます。具体的には、チャージ、承認、拒否、払い戻し、紛争、およびStripeが処理し、請求した金額に関する情報です。
得られるもの#
支払いとその結果、払い戻し、紛争、および各取引に記録された手数料。
単一の認証情報から最も広範な対応を実現します。 1つの制限付きキーがすべてのドメインに対応します。最初の設定が不要なため、これが最も迅速な接続となります。
コストの細分化においては、最も弱いオプションです。 手数料が発生します 混合型そのため、インターチェンジはスキームとゲートウェイのコンポーネントから分離できません。インターチェンジレベルの作業を行う場合は、Adyenを追加してください。 Checkout.com data.
始める前に#
StripeアカウントのAPIバージョンは 2019-02-19 以降である必要があります。.
Stripeコンソールで、Athia用の 制限された API キー (rk_…を作成してください（通常の秘密鍵ではなく）。
- [Go to] 開発者 → APIキー を選択してください。 制限付きのキーを作成.
- Choose 独自の統合を構築する そして続行
- キーの名前を定義します（例：
Athia Integration. - 以下の権限を設定します。
- キーを作成し、トークンをコピーします。
| 以下のリソースにアクセス | リソース |
|---|---|
| 読み取り | 残高、残高トランザクションソース、残高転送、チャージ、紛争、イベント、ファイル、PaymentIntents、PaymentMethods、Payouts、Products、SetupIntents、Sources、Tokens、クレジット、サブスクリプション、SKUs、レポート実行、レポートタイプ。 Connected Accountsを使用する場合は、アカウントリンクを含むConnectリソースへの読み取り権限も付与します。 |
| 書き込み | Webhook エンドポイント |
3つの権限を認識し忘れると、接続が中断されたり、エラーが発生したりすることがあります。
| 権限 | 省略し、 |
|---|---|
| 読み取り について イベント | 接続が完全に中断されます。 |
| 読み取り レポート機能に関する— レポートの実行状況を確認 および レポートの種類 | トランザクションレベルのカード手数料データが利用できません。 |
| 読み取り Connect リソースに関する— アカウントリンク | 接続されたアカウントのデータは選択できません。 |
Athia が要求する認証情報#
| フィールド | 必須 | その内容 / どこで入手するか |
|---|---|---|
| 名前 | はい | この接続に対するラベル — Stripe アカウントを特定 |
| スケジュール | なし | Athia が Stripe を定期的にポーリングする頻度 |
| API キー | はい | 上記の制限されたキー |
| 履歴同期期間 | はい | すべて または 日付制限 — バックフィルがどの範囲まで遡るか |
| Límite de sincronización inversa | With 日付制限 | バックフィルが到達する最も古い日付 |
接続の設定#
- 「 設定 → 接続、選択 + Agregar Conexión を選択して、 Stripe.
- On コネクタの設定、入力してください 名前 そして、選択肢から一つを選んでください。 スケジュール.
- On 認証情報を入力するに、キーを貼り付け、 API キーを選択し、 履歴同期期間を設定し、 Límite de sincronización inversa 日付を設定します。 日付制限 これにより、1つが有効になります。
- Choose 接続の確認.
- 以下の内容をコピーする Athia Webhook の宛先 URL ウィザードに表示されます。
- Stripeで、以下の手順を実行してください。 開発者 → Webhooks → エンドポイントの追加、そのURLを貼り付け、イベントを選択します。
charge.succeeded,dispute.createdおよびpayout.paid。テスト、保存、およびエンドポイントを有効にします。
接続状態は以下のように表示されます。 ACTIVE そして、最初の同期が開始されます。追加のStripeアカウント（例えば、 連携アカウント）ごとに、同期が開始されます。 — 独自の制限付きキーと接続を作成してください。
同期頻度#
適切な スケジュール これは、受け入れ状況の監視頻度によって異なります。頻繁なポーリングは、Stripeによる決済時にのみ更新される、給付と手数料の記録には影響しません。
制限事項と注意点#
- 過去の同期は1年までしか遡りません。 すべて 過去1年分の完全なデータを取り込みます。 日付制限 日付を指定する必要があります。この日付は、本日より1年以上前のものでなければなりません。過去のデータについては、安全なファイル転送 (SFTP/S3) を使用して取得してください。詳細は、 Límite de sincronización inversa を参照。 Athiaとの統合.
- 手数料は合算されます。 詳細なインターチェンジは、このコネクタでは利用できません。
- 金額は少額 — 100で割る。Athiaは、Stripeからの生のデータとの照合時に、この処理を行います。
- カードデータは最小限に抑えられます。 各入力フィールドが何を表すかについては、 Athiaデータ辞書に定義されています.
トラブルシューティング#
| 表示される内容 | 考えられる原因 | 対処方法 |
|---|---|---|
| 認証は成功したが、ドメインが空 | そのリソースへのアクセスが拒否されました | キーの権限を編集し、その後再接続 |
| 期待していたよりも少ない取引履歴 | 1年間の上限 | 安全なファイル転送を通じて、古い履歴を読み込む |
関連#
- Athia Connectors — すべてのコネクタカタログで、そのプロバイダーを表示します。
- Athiaとの統合 — ファイルのアップロード、および倉庫間の連携を含む、統合パス。
- Athiaデータ辞書に定義されています — 項目レベルの定義。