--- title: Dispute url: ja/amazon-pay-api-v2/ja-dispute.html --- * TOC {:toc} {::options toc_levels="3" /} *** サポートされる操作: ### 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
カテゴリ(領収書、署名など)
  • ProductDescription
  • Receipt
  • CancellationPolicy
  • CustomerSignature
  • TrackingNumber
  • CarrierName
  • DeviceId
  • DeviceName
  • DownloadDateTime
  • Other
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
ケースをサポートする証拠アイテムのリスト

  • 各証拠アイテムには、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 } ] } ``` #### Error codes Amazon Pay APIは標準的なHTTPステータスコードとエラーレスポンスを返します。エラーコードの完全なリスト、応答フォーマット、および処理ガイドラインについては、 エラー処理ドキュメント を参照してください。