### 紛争通知の受信
紛争が作成されたり、その状態が変更されたりすると、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": "MerchantAcceptedDispute",
"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": "MerchantAcceptedDispute",
"reasonDescription": "Merchant accepted the dispute request"
},
"closureTimestamp": "20190716T162300Z"
}
```
#### Request parameters
| 名前
|
ロケーション
|
説明
|
| StatusDetails (required) Type: DisputeStatusDetails |
Body
|
紛争状態（Resolved/Closed）、解決方法（BuyerWon/MerchantWon/NoFault）、理由コードを指定します。すべてのフィールドは必須です。
|
| ClosureTimeStamp (required) Type: dateTime |
Body
|
"Closed "の場合のみ必要。ISO 8601形式のUTCタイムスタンプ。
|
| 名前
|
ロケーション
|
説明
|
| merchantEvidences (required) Type: list <Evidence > |
Body
|
ケースをサポートする証拠アイテムのリスト
|
| 名前
|
ロケーション
|
説明
|
| x-amz-pay-idempotency-key (required) Type: String |
Header
|
重複アップロードを防ぐための一意のキー。idempotencyキーの作成と使用に関する詳しいガイダンスについては、別途idempotencyを参照してください。
|
| type Type: String |
Body
|
ファイルフォーマット(jpg, png, pdf)
|
| purpose Type: String |
Body
|
アップロード理由(disputeEvidence)
|
| ファイルタイプ |
説明 |
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) |
curl "YOUR_PRESIGNED_URL" \
-X PUT \
-H "Content-Type: application/pdf" \
-T "/path/to/file"
ファイル要件：
* 最大サイズ：2MB
* ファイルは紛争の証拠として関連性があるものでなければなりません
アップロード後、Upload File APIのレスポンスにある fileId を使用します。