チャージバックのアップロード

Send historical chargeback feedback to your anti-fraud providers through DEUNA.

Ask your DEUNA Technical Account Manager which environments, anti-fraud connections, file-delivery method, directories, and processing schedule are enabled for your merchant before sending production data. Not every dispute is evidence of fraud; include only the chargeback feedback agreed for the configured anti-fraud provider.

チャージバックの仕組み#

DEUNA enables you to upload received chargeback feedback by email or SFTP and forward it to the configured anti-fraud provider. This feedback can help the provider improve its risk models.

Without timely outcome feedback, an anti-fraud provider has less information with which to identify similar fraud patterns.

不正行為対策の改善

チャージバックが不正検知戦略にどのように役立つかを確認してください。

「誤検知」を修正

モデルの主な機能は、取引を評価することです。

When a chargeback represents confirmed fraud, it is a strong false-negative signal: the model treated the transaction as acceptable, but the later outcome showed that it was fraudulent.

By uploading agreed chargeback feedback, the provider can use those outcomes to identify patterns it previously missed.

パターン認識を強化

不正検知モデルは、数千のデータポイントを分析します。

チャージバックが発生した場合、モデルは、その失敗した取引に関連するすべてのデータを再評価します。

1. 使用されたメールアドレスは？
2. デバイスフィンガープリントは？
3. 配送先住所は？
4. 取引が行われた時間は？

モデルは、これまで見逃していた新しい、隠れたパターンを発見できます。たとえば、特定のIPアドレス範囲からの取引で、新しいメールアドレスを使用してデジタル商品を購入することが、以前よりもはるかにリスクが高いことを学習する可能性があります。

リンク分析機能を有効化

詐欺師は、メールアドレス、デバイス、または配送先住所を再利用することがあります。

チャージバックをアップロードすると、プロバイダーはトランザクション内のすべてのデータポイントにその詐欺を関連付けます。

1. 以前： 詐欺師のデバイス（Device_XYZ）は安全なものと見なされていました。
2. その後: そのトランザクションに対するチャージバックをアップロードします。 Device_XYZ が、高リスクとマークされます。
3. 結果: 次に、 Device_XYZ.

The provider can use the new signal when evaluating later transactions associated with the same risk indicators. The resulting decision still depends on the provider's model and your configured risk policy.

モデルを最新の状態に保つ

詐欺の手法は常に変化します。先月詐欺師に使用されていたパターンは、来月のパターンとは異なる可能性があります。

チャージバックのアップロードは、機械学習モデルが新しい手法に迅速に対応できるようにするための唯一の方法です。

要するに、チャージバックのアップロードは単なる管理作業ではなく、機械学習プロセスの核心です。

これにより、システムが賢くなり、お金を失うのを防ぐように教え、DEUNAはあなたを支援します。

必要なチャージバック情報

以下の情報は、不正防止プロバイダーに適切にフィードバックするために、各チャージバックイベントごとに必要です。

チャージバックオプション

DEUNA offers two options depending on the merchant's requirements, timing, and environment:

• チャージバックをCSVファイルとして、次の場所に送信します。 chargebacks@deuna.com

  • ただし、Productionトランザクションのみ。

  • CSVファイルのファイル名は、UUID-DDMMAA.csvという形式で指定してください。

    • DEUNA merchant ID (UUID): 37e21ead-3951-4cbc-b075-9c635f4b8933
    • 日付 (DDMMAA): 051225
    • 例：37e21ead-3951-4cbc-b075-9c635f4b8933-051225.csv

  • データ形式は以下の通りです。

    transaction_id	external_id	chargeback_identifier	chargeback_status	chargeback_reason_code	chargeback_case_id	merchant_chargeback_id	chargeback_amount	詳細	chargeback_date
    a596f725-e22b-411f-ac51-c94b2386b39b	merchant_test_5	chargeback_test_5	open	0003	cbk_test_5	merchant_cbk_test_5	2000	裁判中の状態	2025-10-30T11:20:00Z
    d3daecd7-6f3a-4cb4-98a8-c077cfd5b9d9	merchant_test_6	chargeback_test_6	lost	4837	cbk_test_6	merchant_cbk_test_6	550	商品/サービス未受領	2025-10-30T11:21:00Z

    
    
• Send chargebacks in JSON format through SFTP by following the guide below.
  • SandboxおよびProduction環境の両方に対応しています。
  • Processing begins after the file is received. Confirm the expected schedule with your DEUNA Technical Account Manager.

要件

このプロセスを完了するには、以下の情報が必要です。

• あなたの Merchant ID (DEUNAによって提供されます)
• あなたの SSHプライベートキー 認証に使用します（後述）
• 次の JSONファイル アップロードしたい

SFTPファイルアップロード#

Chargebacksを当社のSFTPサーバーにアップロードしてください。

1. SSHキーを作成

コンピュータのSSHキーを生成

1. ターミナルアプリを開く (Windows 10, Windows 11)

2. 以下のコマンドを実行 ssh-keygen -t rsa -b 4096

3. パスワードの代わりに、求められた際に4桁または6桁の数字のPINを入力し、Enterキーを押してください（ヒント：入力しているキーは表示されません）。

4. パスキーを入力し、Enterキーを押す

5. 以下の画像のようにキーの確認が表示されます

展開

6. SSHキーを取得するには、以下の情報を入力してください。 cat ~/.ssh/id_rsa.pub 、以下の形式で応答が返されます。

展開

2. DEUNAへのSSHキー登録

Register your computer key with DEUNA.

1. SSHキーをコピーする
2. それをDeunaのTPMに共有する: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQC8YDqXwxnvJkXOK5Dne0Fzcmt/f5MlD5WpcICgJxVtOYYGP1M+zn+Z2e3EHcssxblOPykFmBax/WBtVbcgtxUxMypTUMqsKtUtbg9D9DSMIKPbk7+BpQpG1dAx/SPmK7v/Zq0tUdw5np8z3KFnyH7q1Bw4NFd9jk48/CqOftEJn28lprJRus8/K8Jy+3S2vyTl2g8YuVHYvznl59aVKKCtm//D79OjPKKsdN3upCN6mo8FTCf0Ku+KS/F6kCIXn/gwKtRNuMwffJq+g7/qaMmo3FGBiaw9DCTbL5D+INgvAlbfpruqOa7GsmPreq7371+Om5BsQz2I79WvJtbPwrv+YrbOm2FVaaeKg4LKs8uqlcgs/DXaRBNtdQLQVGND37dvxVNc6ZsFagdQF+OKRxPc5MsIwDZH1Fd6m9qAN/Vxgfl8a5gg57ovkd2yJC40Blmn1nRAFxTdVceV+9c0a6qG7RTMyli9se8PzSS4Ckk/IL5TBzzNyimDYYtQWZ7INPNiFxRUKBTAeqwI+5Xava2hWHA35WmPh+5kl/J9gS3noALSBe/DT4ie9IXP68r7Ril2vPkvY8ONIc2usTsyIRmVCIss3Ww7ekMYwfpx/D8lroWoqC8Go6eI5lMCKYXkkzz0nsWwASTVG8jhbDWs7sebxzX5EmWup3Rf/0fokJfN9w== admin@DESKTOP-T7IE9FG

登録後、キーはコンピュータに保存され、キーの生成および登録に関する追加の手順は不要になります。

3. DEUNA SFTPサーバーへの接続

1. ターミナルアプリを開きます

2. サンドボックス環境

   1. 次のコマンドを入力してください sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.sandbox.deuna.io

3. 本番環境

   1. 次のコマンドを入力してください sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.prod.deuna.io

4. 次の応答を受け取ります。 Are you sure you want to continue connecting (yes/no/[fingerprint])?:

展開

5. 「Enter」キーを押して yes を入力してください
6. 次の質問が表示されます: Enter passphrase for key 'C:\Users\Admin/.ssh/id_rsa’
7. パスキーを入力し、「Enter」キーを押してください
8. 確認メッセージを受け取ります Connected to [transfer-sftp.chargebacks.sandbox.deuna.io](http://transfer-sftp.chargebacks.sandbox.deuna.io/)

展開

4. chargebackのエントリーを含むJSONファイルを作成する

1. The JSON file must have the following structure (example for two entries):

   JSONコピー

   {
   "version" : "1.0",
   "records" : [
           {
               "transaction_id": "a596f725-e22b-411f-ac51-c94b2386b39b", 
               "external_id" : "merchant_test_5",
               "chargeback_identifier":"chargeback_test_5",
               "chargeback_status": "open" ,
               "chargeback_reason_code": "0003", 
               "chargeback_case_id": "cbk_test_5", 
               "merchant_chargeback_id": "merchant_cbk_test_5",
               "chargeback_amount": 2000, 
               "detail": "En proceso judicial",
               "chargeback_date": "2025-10-30T11:20:00Z"
           },
           {
               "transaction_id": "d3daecd7-6f3a-4cb4-98a8-c077cfd5b9d9", 
               "external_id" : "merchant_test_6",
               "chargeback_identifier":"chargeback_test_6",
               "chargeback_status": "lost",
               "chargeback_reason_code": "4837", 
               "chargeback_case_id": "cbk_test_6", 
               "merchant_chargeback_id": "merchant_cbk_test_6",
               "chargeback_amount": 550, 
               "detail": "Goods/Services not received",
               "chargeback_date": "2025-10-30T11:21:00Z"
           }
       ]
   }

2. ボディは、"field"という名前のフィールドで構成され、定数値 version を持つ 1.0、それに"array"という名前の配列 records.

3. が含まれます。

4. ファイル名をYYYYMMDD_HHMMSSというTIMESTAMPで保存してください。 例 20251104_193100.json
5. Store it in an easy-to-access folder, for example C:\Deuna_chargebacks\.

展開

5. SFTP接続のテスト

SFTP接続を使用して、サンドボックス環境でファイルを送信します。

1. サンドボックス環境にアクセスするには: cd /deuna-chargebacks-sbx

2. 選択した環境のSFTPサーバーディレクトリに、ファイルのアップロードコマンドを入力します。 put {{route/to/file/in/pc-local}}/{{chargeback file name}} inbound/merchants/{{merchant_id}}

3. 例： put C:\Deuna_chargebacks\20251104_193100.json inbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57

4. 進捗状況と結果に関するメッセージを受け取ります。

展開

5. 次のメッセージが表示された場合は、 Couldn’t send packet: Broken pipeSFTPへの再接続には、次のコマンドを使用してください。 sftp -i ~/.ssh/id_rsa [developer@transfer-sftp.chargebacks.sandbox.deuna.io](mailto:developer@transfer-sftp.chargebacks.sandbox.deuna.io) および、キーのパスフレーズとしてパスキーを入力し、その後、1から開始してファイルのアップロードを再試行してください。
6. 次のコマンドで切断してください。 bye.

6. テスト結果ファイルを参照

必要に応じて、以下の手順で結果ファイルを取得できます。

1. SFTP サーバーへの接続を、次のコマンドで再度実行してください。 sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.sandbox.deuna.io and enter your SSH key passphrase.
2. サンドボックス環境にアクセスします。 cd /deuna-chargebacks-sbx
3. Navigate to the outbound merchant folder with cd /outbound/merchants/{{merchant_id}}.
4. 例 cd /outbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57
5. 入力 get YYYYMMDD_HHMMSS_output.json、ここで YYYYMMDD_HHMMSS は、以前アップロードされたチャージバックファイルのタイムスタンプです。
6. ファイルは、チャージバックファイルの保存場所にダウンロードされます。
7. 例 get 20251104_193100_output.json
8. 必要に応じて、ファイルのダウンロード先を指定することも可能です。 get YYYYMMDD_HHMMSS_output.json /path/to/local/destination/

7. 開発環境でファイルを送信

SFTP接続を使用して、開発環境でファイルを送信します。

1. 選択した環境のSFTPサーバーディレクトリに、ファイルのアップロードコマンドを入力します。 put {{route/to/file/in/pc-local}}/{{chargeback file name}} inbound/merchants/{{merchant_id}}

2. 例： put C:\Deuna_chargebacks\20251104_193100.json inbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57

3. 進捗状況と結果に関するメッセージを受け取ります。

展開

1. If you receive Couldn’t send packet: Broken pipe, reconnect with sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.prod.deuna.io, enter your SSH key passphrase, and retry the upload from step 1.

2. 次のコマンドで切断してください。 bye

8. 開発環境の結果を確認

必要に応じて、結果ファイルがダウンロードできます。

1. SFTP サーバーへの接続を、次のコマンドで再度実行してください。 sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.prod.deuna.io and enter your SSH key passphrase.
2. Navigate to the outbound merchant folder with cd /outbound/merchants/{{merchant_id}}.
3. 例 cd /outbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57
4. 入力 get YYYYMMDD_HHMMSS_output.json、ここで YYYYMMDD_HHMMSS は、以前アップロードされたチャージバックファイルのタイムスタンプです。
5. ファイルは、チャージバックファイルの保存場所にダウンロードされます。
6. 例 get 20251104_193100_output.json
7. 必要に応じて、ファイルのダウンロード先を指定することも可能です。 get YYYYMMDD_HHMMSS_output.json /path/to/local/destination/

トラブルシューティング#

Learn how to troubleshoot common issues.

Connection refused

接続の問題が発生した場合は、以下の手順に従ってください。

• プライベートキーのアクセス権が正しいことを確認してください。 chmod 600 /path/to/private_key
• 正しいプライベートキーファイルを使用していることを確認してください。
• IPアドレスが許可リストに登録されていることを確認してください（必要に応じてサポートにお問い合わせください）。

アクセス権がない

If you have permission problems, check the following:

• Verify you're using the correct Merchant ID
• アカウントがこのディレクトリへのアップロード権限を持っていることを確認してください。
• 問題が解決しない場合は、サポートにお問い合わせください。

ファイルは既に存在します。

ファイルのエラーが発生した場合は、以下の手順に従ってください。

• 各アップロードには一意のタイムスタンプを使用してください。
• 以下のディレクトリを確認してください。 ls アップロード前に

結果ファイルが見つかりません

ファイルが見つからない場合、以下の手順に従ってください。

• 処理時間に十分な時間を確保してください（一般的な処理時間：[ご自身のSLAを指定]）。
• Verify you're checking the correct outbound directory for your Merchant ID
• 入力ファイル名が完全に一致していることを確認してください（タイムスタンプも一致する必要があります）。
• ファイルが予想される時間内に表示されない場合は、サポートにお問い合わせください。

結果ファイルのダウンロードができません。

ファイルダウンロードに関する問題が発生した場合は、以下の手順に従ってください。

• 出力ディレクトリへの読み取り権限があることを確認してください。
• ファイル名が正しいことを確認してください。 _output.json 拡張子
• ダウンロードに必要な十分なローカルディスク容量があることを確認してください。

サポート

問題が発生した場合やご質問がある場合は、以下の情報を提供してください：

• メール: support@deuna.io
• 商人のIDと、問題の詳細を記載してください。

セキュリティに関するベストプラクティス

以下のセキュリティ対策を遵守してください：

• 秘密鍵を安全に保管し、決して共有しないでください。
• 秘密鍵に対する適切なファイル権限を設定してください。chmod 600)
• ファイルは、スケジュールされた処理ウィンドウ中にのみアップロードしてください。
• アップロードする前にファイルのコンテンツを確認してください。