チャージバックフィードのアップロード
承認された過去のチャージバックの結果を、安全なスキーマと検証ワークフローを備えたメールまたはSFTPで、不正行為防止プロバイダーに送信してください。
過去のチャージバックの結果をDEUNAを経由して送信し、設定された不正行為防止プロバイダーが確認された結果から学習できるようにします。これは、 モデルとフィードバックのワークフロー; これは、プロセッサとの紛争の発生、証拠の提出、またはアクティブなチャージバックケースの管理をトリガーしません。 紛争管理 アクティブな紛争に関する情報
フィードバックのライフサイクル#
始める前に#
以下の内容について、TAM（テクニカルアカウントマネージャー）に確認してください：
- フィードバックを消費する不正検知機能。
- メール、SFTP、または両方のいずれかが有効になっているか。
- 各チャネルで受け入れられる環境とトランザクションの種類。
- 提供されたSFTPホスト名、ポート、ユーザー名、サーバーホストキーフィンガープリント、および商社ディレクトリ。
- 結果ファイルが生成されるかどうか、およびアカウントでの通常処理にかかる時間。
- 承認された暗号化、保持、およびエスカレーション要件。
DEUNAのトランザクションIDを、すべてのレコードに対して必ず提供してください。注文トークン、プロセッサのトランザクションID、または商社のチャージバックIDは使用しないでください。
レコードスキーマ#
| フィールド | 必須 | フォーマット | 意味 |
|---|---|---|---|
transaction_id | はい | Existing DEUNA transaction ID | DEUNAを通じて評価された支払いに関連する結果を関連付けます。 |
chargeback_date | はい | ISO 8601タイムスタンプ | チャージバックが最初に報告された時間。明示的なオフセットを送信するか、 Z |
external_id | なし | アルファ数字、最大50文字 | 商社側のレコード参照 |
chargeback_identifier | なし | アルファ数字、最大50文字 | ゲートウェイまたはアキュイアーからの識別子 |
chargeback_status | なし | open, won、または lost | 合意された現在のチャージバックの状態（フィードバック用） |
chargeback_reason_code | なし | アルファ数字、最大20文字 | プロセッサまたはアキュイアーによって報告された理由コード |
chargeback_case_id | なし | アルファ数字、最大50文字 | 発行者またはゲートウェイの紛争識別子 |
merchant_chargeback_id | なし | アルファ数字、最大50文字 | 商社側のチャージバック識別子 |
chargeback_amount | なし | 整数、最大10桁 | 支払通貨の最小単位での、異議申し立て金額 |
detail | なし | 文字列、最大2,500文字 | フィードバックプロセスに関連する、適切なコンテキスト |
オプション A: 承認済みメール配信#
このオプションは、DEUNAが特定の環境に対してメールワークフローを承認した場合にのみ使用してください。
- スキーマテーブルのフィールド名を含むCSVをエクスポートします。
- ご自身の商取引識別子と合意された日付形式を使用して名前を付けます。自動化の構築時にはプレースホルダーを使用します。例：
YOUR_MERCHANT_ID-DDMMYY.csv. - すべての必須値を検証し、CSVが一貫してエンコードされていることを確認します。
- 承認されたビジネスメールボックスを通じて、アカウントで確認された受信者にのみ送信します。
- ポリシーで要求される、送達および照合の証拠を保持します。
transaction_id,external_id,chargeback_identifier,chargeback_status,chargeback_reason_code,chargeback_case_id,merchant_chargeback_id,chargeback_amount,detail,chargeback_date
DEUNA_TRANSACTION_ID,MERCHANT_RECORD_ID,ACQUIRER_REFERENCE,open,REASON_CODE,PROVIDER_CASE_ID,MERCHANT_CASE_ID,2000,Confirmed fraud outcome,2026-10-30T11:20:00ZDEUNA_TRANSACTION_ID これは明示的なプレースホルダーです。保護されたエクスポートプロセスから取得した実際のトランザクションIDで置き換えてください。例示的な識別子を本番環境にコピーしないでください。
オプションB：SFTPによる提供#
SFTPの使用は、DEUNAがアカウントを作成し、承認されたチャネルを通じて必要な接続値を指定した後に行う必要があります。
1. 専用のSSHキーを作成する
信頼できるマシンまたはワークロードで、最新のキーペアを生成します。
ssh-keygen -t ed25519 -a 100 -f ./deuna_chargeback_uploadワークロードに適したセキュリティ設定で、プライベートキーを保護し、共有してください。 のみ deuna_chargeback_upload.pub 承認されたオンボーディングチャネルを通じて。 秘密鍵をチケット、チャット、ドキュメント、リポジトリ、またはクライアントアプリケーションにコピーしないでください。
2. 割り当てられたサーバーの確認
初回接続の前に、サーバーのホストキーフィンガープリントを、DEUNAから別途提供された値と比較してください。予期しないキーを受け入れることは避けてください。
sftp -i ./deuna_chargeback_upload YOUR_SFTP_USER@YOUR_SFTP_HOSTYOUR_SFTP_USER および YOUR_SFTP_HOST はプレースホルダーです。 意図された環境（サンドボックスと本番環境）に対応する値を必ず使用してください。
3. JSON形式のバッチを作成
JSON の本文には、スキーマのバージョンと、 records 配列:
{
"version": "1.0",
"records": [
{
"transaction_id": "DEUNA_TRANSACTION_ID",
"external_id": "MERCHANT_RECORD_ID",
"chargeback_identifier": "ACQUIRER_REFERENCE",
"chargeback_status": "open",
"chargeback_reason_code": "REASON_CODE",
"chargeback_case_id": "PROVIDER_CASE_ID",
"merchant_chargeback_id": "MERCHANT_CASE_ID",
"chargeback_amount": 2000,
"detail": "Confirmed fraud outcome",
"chargeback_date": "2026-10-30T11:20:00Z"
}
]
}独自の YYYYMMDD_HHMMSS.json ファイル名を指定してください。ただし、提供された契約で異なる命名規則が指定されている場合は、その規則に従ってください。ファイル名をUTCで生成し、バッチ処理の関連性を明確にしてください。
4. 指定されたインバウンドディレクトリにアップロード
接続後、環境で割り当てられた正確なディレクトリにファイルがアップロードされていることを確認してください。
sftp> cd YOUR_ASSIGNED_INBOUND_DIRECTORY
sftp> put 20261030_112000.json
sftp> ls
sftp> bye商 ID からディレクトリを作成しないでください。ただし、提供された指示で明示的に要求されている場合にのみ。 put 成功した転送は、レコードの受け取りを意味しません。
5. 結果の照合
アカウントが結果ファイルを出力する場合、割り当てられたアウトバウンドディレクトリからファイルを取得し、入力バッチと比較します。ファイル名とレスポンススキーマは、提供された契約によって異なる場合があります。オンボーディング時に提供された値を参照してください。
sftp> cd YOUR_ASSIGNED_OUTBOUND_DIRECTORY
sftp> ls
sftp> get YOUR_RESULT_FILE.json
sftp> byeすべてのレコードを「受け入れ済み」、「拒否済み」、または「未解決」のいずれかに分類します。拒否されたレコードは再送信する前に修正し、DEUNAサポートからの指示がない限り、受け入れられた結果を再実行しないでください。
検証と冪等性#
転送前にバッチの検証:
versionは有効な値1.0JSONのアップロードの場合;recordsは、空でない配列です。- すべての
transaction_idは、意図する商社および環境に属し、 - すべての
chargeback_dateは、タイムゾーンを含む有効な ISO 8601 タイムスタンプです。 - すべての金額は、小単位の整数であり、元の支払い通貨を使用します。
-
- 列挙値と最大長はスキーマと一致します。
- ファイル名は一意であり、以前のバッチを上書きしません。
- このファイルには、承認された契約に記載されていない列や属性は含まれていません。
商用側のバッチ記録に、ファイルチェックサム、作成時間、環境、転送時間、およびレコードごとの結果を含める。これにより、拒否されたデータを無闇に再送信するのではなく、必要に応じて再試行が可能になります。
トラブルシューティング#
| 症状 | チェックする | 安全な次の操作 |
|---|---|---|
| ホストキーが変更されました | 提示されたフィンガープリントを承認済みフィンガープリントと比較する | 接続を停止し、DEUNAに連絡してください。検証を回避しないでください |
| アクセス権がない | ユーザー名、キーパス、キー登録、プライベートキーの権限、およびIPアドレスの許可リスト | ローカル設定を修正するか、DEUNAサポートにプロビジョニングの確認を依頼してください |
| アップロードディレクトリが拒否されました | 環境と正確なインバウンドパス | 別の商用ディレクトリを推測しないでください。プロビジョニングされたパスを確認してください |
| ファイルは既に存在します。 | ファイル名の一意性と、以前のアップロードが完了したかどうか | 新しいユニークな名前のファイルを作成する前に、元のバッチを再調和してください |
| 結果ファイルが存在しません | 結果が有効かどうか、割り当てられたアウトバウンドパス、およびアカウント固有の処理ウィンドウ | バッチを解決せずに、合意されたウィンドウ後にエスカレーション |
| 記録が拒否されました | 必要なフィールド、トランザクションの所有権、形式、enum、およびフィールドの長さ | 誤ったレコードを修正し、元のバッチとの関連性を維持する |
| 接続の切断 | ネットワークパス、許可リスト、Keep-Aliveポリシー、および部分的な転送状態 | 再接続、リモートディレクトリの検査、および重複したアップロードの回避 |
エスカレーション時に、商社ID、環境、ファイル名、チェックサム、転送タイムスタンプ、およびサニタイズされたエラーテキストを含める。プライベートキー、プロバイダの秘密キー、生のカードデータ、または未加工の顧客エクスポートは添付しない。
稼働確認リスト#
- DEUNAは、ターゲットプロバイダ、環境、転送チャネル、およびアカウントの権限を確認します。
- セキュリティは、キーの管理、ホストキーの検証、許可リスト、暗号化、アクセス、および保持を検証します。
- サンドボックスバッチは、受け入れおよび拒否されたレコードの処理を検証します。
- すべての入力レコードを、処理結果と関連付けることができます。
- 転送の欠落、拒否されたレコード、および解決されていないバッチに関する監視アラート。
- 本番環境の運用手順には、所有者と承認されたエスカレーションチャネルが記載されています。