Dispute
For LLMs: see /docs/amazon-pay/llms.txt | Markdown: /ja/docs/amazon-pay-api-v2/ja-dispute.md
サポートされる操作:
Dispute オブジェクト
| フィールド
|
説明
|
| disputeId Type: string |
Disputeの一意な識別子 |
| releaseEnvironment Type: string |
作成環境（Sandbox／Live）
|
| chargeId Type: string |
対象チャージの識別子 |
| disputeType Type: disputeType [Enum] |
Dispute種別（現状「Chargeback」のみ）
|
| disputeAmount Type: price |
Dispute金額
|
| filingReason Type: filingReason [Enum] |
申立理由（例：不正取引、商品未着等）
|
| statusDetails Type: disputeStatusDetails |
Dispute状態、解決状況、理由
|
| merchantEvidences Type: list <Evidence> |
事業者が提出した証拠
|
| merchantResponseDeadline Type: dateTime |
事業者の対応期限
|
| resolutionAuthority Type: resolutionAuthority [Enum] |
解決機関（Amazon Pay等）
|
| creationTimestamp Type: dateTime |
作成日時（ISO 8601、UTC
|
Type: price
|
パラメータ |
説明 |
| amount Type: string |
取引金額 |
| currencyCode Type: string |
ISO4217形式の取引通貨コード 例：JPY |
Type: disputeStatusDetails
| フィールド
|
説明
|
| state Type: disputeState [Enum] |
現在の状態: UnderReview、ActionRequired、Resolved、Closed
|
| reasonCode Type: reasonCode [Enum] |
ステータスの理由(状態遷移を参照)
|
| reasonDescription Type: string |
人が読める形式のステータス説明
|
| resolution Type: resolution [Enum] |
結果: BuyerWon、MerchantWon、NoFault (Resolved/Closed状態の場合)
|
| lastUpdatedTimestamp Type: dateTime |
最終ステータス変更時刻(UTC)
|
Type: Evidence
| フィールド
|
必須
|
説明
|
サポートされる値
|
| evidenceType Type: EvidenceType [Enum] |
Yes
|
カテゴリ(領収書、署名など)
|
|
| fileId Type: String |
No
|
アップロードされた証拠ファイルのID
|
有効なファイルID
|
| evidenceText Type: string |
No
|
テキストベースの証拠
|
自由形式のテキスト
|
Enums
disputeType
| 値
|
説明
|
| Chargeback
|
支払いチャージバック紛争
|
filingReason
| 値
|
説明
|
| ProductNotReceived
|
購入者が商品を受け取っていない
|
| ProductUnacceptable
|
商品が購入者にとって受け入れられない(例:部品の欠落)
|
| ProductNoLongerNeeded
|
購入者がもはや商品を必要としていない
|
| CreditNotProcessed
|
購入者が商品を返品したがクレジットが処理されていない
|
| Overcharged
|
購入者に過剰請求された
|
| Fraudulent
|
購入者が取引に責任を持っていない
|
| SubscriptionCancelled
|
サブスクリプションのキャンセル後に購入者に請求された
|
| DuplicateCharge
|
購入者に二重請求された
|
| Unrecognized
|
購入者が取引を認識していない
|
| Other
|
その他の理由
|
disputeState
| 値
|
説明
|
| UnderReview
|
調査中
|
| ActionRequired
|
事業者/購入者のアクションが必要
|
| Resolved
|
決定済み(異議申立可能)
|
| Closed
|
最終状態(変更不可)
|
resolution
| 値
|
説明
|
| BuyerWon
|
購入者側の勝訴
|
| MerchantWon
|
事業者側の勝訴
|
| NoFault
|
どちらの当事者にも責任なし
|
evidenceType
| 値
|
説明
|
| ProductDescription
|
商品の詳細と仕様
|
| Receipt
|
注文の領収書
|
| CancellationPolicy
|
キャンセルポリシー文書
|
| CustomerSignature
|
顧客の署名文書
|
| TrackingNumber
|
配送追跡番号
|
| CarrierName
|
配送業者名
|
| DeviceId
|
デジタル商品のデバイスID
|
| DeviceName
|
デジタル商品のデバイス名
|
| DownloadDateTime
|
デジタル商品のダウンロード日時
|
| Other
|
その他の証拠タイプ
|
resolutionAuthority
| 値
|
説明
|
| AmazonPay
|
Amazon Payが紛争解決の権限を持つ
|
Dispute 状態遷移
| 状態
|
説明
|
解決
|
理由コード
|
| UnderReview
|
調査進行中
|
なし
|
なし
|
| ActionRequired
|
事業者または購入者の待機中
|
なし
|
MerchantResponseRequired: 紛争の受け入れまたは異議申し立て MerchantAdditionalEvidencesRequired:さらなる証拠の提供 BuyerAdditionalEvidencesRequired:購入者の証拠待ち |
| Resolved
|
決定済み(異議申立可能)
|
BuyerWon
|
MerchantAcceptedDispute: 事業者が受け入れ MerchantResponseDeadlineExpired: 応答期限切れ InvestigatorResolved: 調査完了 |
| Resolved
|
決定済み(異議申立可能)
|
MerchantWon
|
BuyerCancelled: 購入者が紛争をキャンセル InvestigatorResolved: 調査完了 ChargebackFiled: 購入者がAmazon Pay A-to-z保証請求以外のチャージバックを提出 |
| Closed
|
最終状態(変更不可)
|
BuyerWon
|
Resolved状態と同じ
|
| Closed
|
最終状態(変更不可)
|
MerchantWon
|
Resolved状態と同じ
|
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"
}
Error codes
Amazon Pay APIは標準的なHTTPステータスコードとエラーレスポンスを返します。エラーコードの完全なリスト、応答フォーマット、および処理ガイドラインについては、 エラー処理ドキュメント を参照してください。
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タイムスタンプ。
|
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": "MerchantAcceptedDispute",
"reasonDescription": "Merchant accepted the dispute request",
"resolution": "BuyerWon",
"lastUpdatedTimestamp": "20190716T156500Z"
},
"resolutionAuthority": "AmazonPay",
"closureTimestamp": "20190716T155300Z",
"releaseEnvironment": "Live"
}
Error codes
Amazon Pay APIは標準的なHTTPステータスコードとエラーレスポンスを返します。エラーコードの完全なリスト、応答フォーマット、および処理ガイドラインについては、 エラー処理ドキュメント を参照してください。
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
|
ケースをサポートする証拠アイテムのリスト
|
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
}
]
}
Error codes
Amazon Pay APIは標準的なHTTPステータスコードとエラーレスポンスを返します。エラーコードの完全なリスト、応答フォーマット、および処理ガイドラインについては、 エラー処理ドキュメント を参照してください。
