Checkout.com
Checkout.com これは、自己管理型のコネクタであり、カタログ内で最も費用対効果の高いソリューションです。 決済の詳細と、各取引が実際にどれだけの費用がかかったかを分解した調整レポートの両方を活用します。 まずレポートを有効にしてください。そうしないと、決済の情報だけが得られ、費用に関する情報は得られません。
得られるもの#
決済とその結果、紛争、支払い、および調整に関する詳細（手数料と為替レートを含む）。 詳細は以下の場所に定義されています。 Athiaデータ辞書に定義されています.
手数料の分解において最も優れています。 他の決済プロバイダーと比較して、 Checkout.com 最も費用を細かく分解します。 具体的には、インターチェンジ手数料、スキーム手数料、ゲートウェイ手数料、ネットワークトークン手数料、チャージバック手数料、および為替レートが個別に表示されるため、承認された注文あたりの実際の費用を正確に把握できます。
単位の一貫性においては最も弱い。 決済は小単位で、調整レポートは小数で表示されます。
始める前に#
1. 調整レポートの有効化 上記 Checkout.com サイド。設定が完了するまで、コストデータは表示されません。ただし、認証の範囲設定は有効です。
2. アクセスキーのペアを作成する。 Hubで、以下の手順を実行してください。 開発者 → APIキー → 新しいAPIキーの作成。 この認証情報は、 Access key ID さらに API キーのシークレット; Athia はこれら両方が必要です。
3. カスタムスコープと、完全なスコープセットを選択します。 少なくとも gateway, vault および reports スコープファミリーを選択します。 gateway:payment-details (支払いおよびアクションの詳細) を選択し、 reports:read (レコメンデーションレポート)を含める必要がありますが、完全なリストではありません。このペアは、残高、Payout、およびAthiaが取り扱う財務アクションに関するデータを含みません。ファイルは唯一の完全なソースです。 401 エラーではなく、不完全なデータではなく。
4. 関連するエンティティを選択します。 このキーが適用されるエンティティを特定します。 エンティティ ID は、1 つのエンティティの接続と別のエンティティの接続を区別します。
5. 環境を明示的に選択します。 A テスト アカウントは サンドボックス; 1 つ リアルタイム アカウントは 本番環境誤った環境からのキーを使用すると、認証は行われ、認識できない情報が送信されません。
Athia が要求する認証情報#
| フィールド | 必須 | その内容 / どこで入手するか |
|---|---|---|
| 名前 | はい | この接続に対するラベル - どのエンティティをカバーするかを特定 |
| スケジュール | なし | Athiaが定期的にポーリングする頻度 Checkout.com |
| アクセスキー ID | はい | 次の Access key ID 「ペア」の作成元 開発者 → キー |
| アクセスキーシークレット | はい | 対応 API キーのシークレット |
| エンティティ ID | はい | 次の Checkout.com この接続で管理されるエンティティ |
接続の設定#
- 対比レポートの有効化、設定 「すべての処理チャネルを有効にする」 ～ ON、およびアクセスキーのペアを作成します。 カスタムスコープ および、適切なエンティティと環境における、完全な範囲の設定。
- 「 設定 → 接続、選択 + Agregar Conexión を選択して、 Checkout.com.
- On コネクタの設定、入力してください 名前 そして、選択肢から一つを選んでください。 スケジュール.
- On 認証情報を入力する、以下の情報を入力します。 アクセスキー ID, アクセスキーシークレット および エンティティ ID.
- Choose 接続の確認.
接続状態は以下のように表示されます。 ACTIVE 最初の同期が開始されます。複数のエンティティを運用している場合は、各エンティティに対して1つの接続を作成してください。 エンティティ ID これが、それらを区別する要素です。
Athia の Webhook を登録する#
支払いおよび紛争に関するイベントは、公開されている Checkout.com workflow.
- 接続ウィザードで、以下のものをコピーしてください。 Athia Webhook の宛先 URL.
- Hubで、以下の手順を実行してください。 設定 → ワークフロー → ワークフローの作成.
- イベントを選択
payment_captured,payment_approvedおよびdispute_created. - 「追加」機能を追加する ウェブフック 操作を実行し、貼り付け Athia Webhook の宛先 URL.
- 署名ヘッダーを設定し、テストを実行し、ワークフローを保存して有効にします。
同期頻度#
この接続には、2つのクロックがあります。1つは、トランザクションごとに決済の詳細を更新し、もう1つは、調整レポートを生成します。 Checkout.com'のレポート作成サイクルが遅いため、選択したスケジュールに関わらず、コストデータは常にそのサイクルに基づいて更新されます。
制限事項と注意点#
- 複数の金額単位のサポート。 支払い API の金額は 最小単位 （100で割る）; 調整レポートの金額は 小数点です。 Athia はインポート時に正規化されますが、金額が不正であると判断する前に、その金額がどこから来たかを確認してください。
- レポートを最初に有効にする必要がありますまたは、このコネクタが最も得意とする手数料の分解機能が利用できません。
- 完全なデータセットが必要です。 以下のキーを作成してください。 カスタムスコープ 少なくとも以下の内容をカバーする
gateway,vaultおよびreportsfamilies.gateway:payment-detailsおよびreports:read単独での利用では、残高、支払い、および財務に関するレポートのデータはカバーされません。また、限定的なデータのみを返すHTTPリクエストは、完全なデータセットとは異なります。401より詳細なデータが必要な場合は、完全なデータセットを要求する必要があります。 - カードデータは最小限に抑えられます。
トラブルシューティング#
| 表示される内容 | 考えられる原因 | 対処方法 |
|---|---|---|
| 決済が完了し、手数料や相互送金に関する詳細はありません。 | レポートが有効になっていない、または reports:read 該当なし | レポートの有効化、範囲の設定確認、再接続 |
HTTP 401 検証時または同期中に | キーを作成する際に、狭い範囲を設定 | キーを再作成するには カスタムスコープ および、完全な gateway, vault および reports 設定を使用 |
| 一部の決済が完了しない場合、エラーは報告されない | 「すべての処理チャネルを有効にする」 前の状態に戻る | 設定を ON キーの 処理チャネル セクションで設定し、再接続 |
| 接続は検証されるが、認識されないデータが含まれている | 誤った環境のキーを使用 | サンドボックス環境にはテストアカウントのキーを使用し、本番環境にはライブアカウントのキーを使用 |
| リアルタイム決済や紛争に関するイベントは発生しない | ワークフローが欠落している、無効になっている、または署名ヘッダーが設定されていない | ワークフローを再作成するには 設定 → ワークフロー、再度貼り付け、 Athia Webhook の宛先 URL、および署名ヘッダーを確認 |
関連#
その他のプロバイダーとインポートパスは、 Athia Connectorsに記載されています。ファイル転送や、直接コネクタの代替として、倉庫間でのデータ転送については、 Athiaとの統合.