ログイン
ログイン

紛争を管理する

購入者はクレジットカード会社にチャージバックを申請することで紛争（Dispute）が作成されます。この方法では、セラーセントラルの代わりに Dispute API を通じてプログラムで処理できる紛争管理プロセスが開始します。API エンドポイントを通じて、紛争の詳細の取得、証拠の提出、状態の追跡、チャージバックへの対応が可能となります。

Dispute API を使用した事業者インテグレーションフロー図

紛争通知の受信

紛争が作成されたり、その状態が変更されたりすると、Amazon Pay は設定されたエンドポイントにインスタント支払通知（IPN）を送信します。IPN メッセージには以下が含まれます。

{
    "MerchantID": "事業者識別子",
    "ObjectType": "CHARGEBACK",
    "ObjectId": "S03-0000000-0000000-B000000",
    "ChargePermissionId": "S03-0000000-0000000",
    "NotificationType": "STATE_CHANGE",
    "NotificationId": "9b4155a0-c396-46d0-83f7-te1st2xx1234",
    "NotificationVersion": "V2"
}

chargeback IPN notification の詳細を参照する。

Get Dispute 詳細

ユニークなDispute ID を指定して、特定の紛争に関する詳細情報を取得します。このAPIは、紛争タイプ、金額、ステータス、関連する証拠や文書など、包括的な紛争データを返します。特定の紛争の詳細を確認したり、紛争ステータスを追跡したり、紛争解決のための情報を収集したりする必要がある場合は、 Get Dispute API コールを使用してください。Dispute ID を提供することで、特定の紛争に関する詳細情報を取得できます。このエンドポイントは、紛争の種類、金額、状態、関連する証拠や文書を含む包括的な紛争データを返します。

Request

Response Format

APIは以下を含むDisputeオブジェクトを返します：

  • 基本的な紛争情報（ID、タイプ、金額、申し立て理由）
  • トランザクションの詳細（チャージ ID、タイムスタンプ）
  • ステータス情報（状態、解決、理由コード）
  • 証拠の提出（加盟店の文書およびファイル）
{
    "disputeId": "P03-1111111-1111111-B123456",
    "chargeId": "P03-1111111-1111111-C123456",
    "disputeType": "Chargeback",
    "disputeAmount":  {
        "amount": "400",
        "currencyCode": "JPY" 
    },
    "filingReason": "Fraudulent",
    "filingTimestamp": 20190714T155300Z,
    "resolutionAuthority": "AmazonPay",
    "statusDetails":  {
        "state": "Resolved",
        "reasonCode": "MerchantAccepted",
        "reasonDescription": "Merchant accepted the dispute request",
        "resolution": BuyerWon,
        "lastUpdatedTimestamp": 20190716T156500Z 
    },
    "resolutionAuthority": "AmazonPay",
    "merchantEvidences": [
        {
            "evidenceType" : "TrackingNumber",
            "fileId" : null,
            "evidenceText": "raw text supporting merchant evidence",
        },
        {
            "evidenceType": "CustomerSignature",
            "fileId": "customer_signature_file_id",
            "evidenceText": null
        }
    ],
    "closureTimestamp": "20190716T155300Z",
    "releaseEnvironment": "Live"
}

Update Dispute 詳細

購入者のチャージバックが有効であることに同意する場合、Update Dispute API を通じて応答を提出して紛争を受け入れることができます。

Request

Request body

{
    "statusDetails": {
        "resolution": "BuyerWon",
        "state": "Resolved",
        "reasonCode": "MerchantAccepted",
        "reasonDescription": "Merchant accepted the dispute request "
    },
    "closureTimestamp": "20190716T162300Z"
}

Request parameters

名前
ロケーション
説明
StatusDetails
(required)

Type: DisputeStatusDetails
Body
紛争状態（Open/Closed）、解決方法（BuyerWon/SellerWon）、理由コードを指定します。すべてのフィールドは必須です。
ClosureTimeStamp
(required)

Type: dateTime
Body
"Closed "の場合のみ必要。ISO 8601形式のUTCタイムスタンプ。

Response

API は以下を含む更新された Dispute オブジェクトを返します:

  • 基本的な紛争情報（ID、タイプ、金額、申し立て理由）
  • トランザクションの詳細（チャージ ID、タイムスタンプ）
  • 更新されたステータス情報（状態、解決、理由コード）
  • 証拠の提出（加盟店の文書およびファイル）
{
    "disputeId": "P03-1111111-1111111-B123456",
    "chargeId": "P03-1111111-1111111-C123456",
    "disputeType": "Chargeback",
    "disputeAmount":  {
        "amount": "400",
        "currencyCode": "JPY" 
    },
    "filingReason": "Fraudulent",
    "filingTimestamp": 20190714T155300Z,
    "resolutionAuthority": "AmazonPay",
    "statusDetails":  {
        "state": "Resolved",
        "reasonCode": "MerchantAccepted",
        "reasonDescription": "Merchant accepted the dispute request",
        "resolution": BuyerWon,
        "lastUpdatedTimestamp": 20190716T156500Z 
    },
    "resolutionAuthority": "AmazonPay",
    "closureTimestamp": "20190716T155300Z",
    "releaseEnvironment": "Live"
}

Contest Dispute 詳細

根拠となる証拠や書類を提出することで、チャージバックの異議申し立てを行うことができます。このエンドポイントを利用することで、事業者は出荷確認、購入者とのコミュニケーション、または製品ドキュメントなどの関連証拠を提出することで、正式に異議申し立てを行うことができます。 Contest Dispute API コールは、購入者のチャージバックに対して異議申し立てをする正当な根拠があり、レビューのために裏付けとなる証拠を提出したい場合にご利用ください。

Request

Request body

{
    "merchantEvidences":  [
        {
            "evidenceType" : "TrackingNumber",
            "fileId": null,
            "evidenceText": "raw text supporting merchant evidence" 
        },
        {
            "evidenceType": "CustomerSignature",
            "fileId: "customer_signature_file_id",
            "evidenceText": null
     }
   ]
}

Request parameters

名前
ロケーション
説明
merchantEvidences
(required)

Type: list <Evidence >
Body
ケースをサポートする証拠アイテムのリスト

  • 各証拠アイテムには、fileIdまたはevidenceTextのいずれかが必要です
  • サポートされる値については、エビデンス・タイプの表を参照してください。

Response

API は以下を含む更新された Dispute オブジェクトを返します:

{
    "disputeId": "P03-1111111-1111111-B123456", 
    "chargeId": "P03-1111111-1111111-C123456",
    "disputeType": "Claim",
    "disputeAmount": { 
        "amount": "400", 
        "currencyCode": "JPY" 
        },
    "filingReason": "ProductNotReceived",
    "filingTimestamp": 20190714T155300Z,
    "statusDetails": {
        "state": "UnderReview",
       "reasonCode": null,
        "reasonDescription": null
        "resolution": null, 
        "lastUpdatedTimestamp": 20190714T156500Z
    },
    "resolutionAuthority": "AmazonPay",
    "releaseEnvironment": "Live",
    "merchantEvidences": [
    {
        "evidenceType" : "TrackingNumber",
        "fileId" : null,
        "evidenceText": "raw text supporting merchant evidence",
    },
    {
        "evidenceType": "CustomerSignature",
        "fileId": "customer_signature_file_id",
        "evidenceText": null
    }
    ]
}

Upload File 詳細

紛争証拠やその他の文書作成に必要なファイルをアップロードして管理します。 Upload File APIは、一般的なファイル形式をサポートし、安全なアップロードURLを提供します。APIは、ファイルを安全にアップロードするための2段階のプロセスを提供します。

Step 1: Upload URL取得

まず安全なアップロードURLをリクエストします。:

Request

Request body

{
    "type" : "jpg",
    "purpose" : "disputeEvidence"
}

Request parameters

名前
ロケーション
説明
x-amz-pay-idempotency-key
(required)

Type: String
Header
重複アップロードを防ぐための一意のキー。idempotencyキーの作成と使用に関する詳しいガイダンスについては、別途idempotencyを参照してください。
type

Type: String
Body
ファイルフォーマット(jpg, png, pdf)
purpose

Type: String
Body
アップロード理由(disputeEvidence)

Supported file types

ファイルタイプ
 説明
 Content-Type
csv
 CSV files
 text/csv
pdf
 PDF documents
 application/pdf
xls/xlsx
 Excel spreadsheets
 application/vnd.ms-excel (xls)
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (xlsx)
doc/docx
 Word documents
 application/msword (doc)
application/vnd.openxmlformats-officedocument.wordprocessingml.document (docx)
ods
 OpenDocument spreadsheets
 application/vnd.oasis.opendocument.spreadsheet
jpg/png
 Image files
 image/jpeg (jpg)
image/png (png)

Response

The API returns:

{
    "id": "file_sdcjscbjckndjhckj", 
    "type" : "jpg",
    "purpose": "disputeEvidence",
    "uploadTimestamp": 20190714T155300Z,
    "url": "https://pay-api.amazon.jp/v1/files/file_sdcjscbjckndjhckj/contents",
    "urlExpirationTimeStamp: 20190714T155300Z
}

Step 2: ファイルアップロード

レスポンスにあるURLにファイルを送信します：:

curl "YOUR_PRESIGNED_URL" \
-X PUT \
-H "Content-Type: application/pdf" \
-T "/path/to/file"

ファイル要件：

  • 最大サイズ：2MB
  • ファイルは紛争の証拠として関連性があるものでなければなりません

アップロード後、Upload File APIのレスポンスにある fileId を使用します。