# 異議申立

新しい異議申立が行われ、または異議申立のステータスが変更された時、エクソーラは「dispute」タイプのウェブフックをウェブフックURLに送信します。このウェブフックを受信するには、カスタマーサクセスマネージャーにご連絡いただくか、csm@xsolla.comまで電子メールでお問い合わせください。

Endpoint: POST dispute
Version: 1.0

## Request fields (application/json):

  - `action` (string, required)
    アクションのタイプ。
    Enum: "adding", "updating"

  - `dispute` (object, required)
    異議申立に関する情報を含むオブジェクト。

  - `dispute.incoming_date` (string, required)
    [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339)標準に基づく紛争の開始日。

  - `dispute.reason` (string, required)
    紛争手続きを開始する理由。理由のグループの説明については、[ドキュメンテーション](/ja/solutions/payments/anti-fraud/chargeback/#payments_chargeback_reasons) を参照してください。
    Enum: "non_receipt", "not_as_described", "duplicate_processing", "paid_by_other_means", "incorrect_amount", "credit_not_processed", "general", "fraud", "cancelled_recurring", "cancelled_merchandise", "late_presentment", "no_authorization", "problem_with_remittance", "other"

  - `dispute.status` (string, required)
    紛争の状況。
    Enum: "new", "accepted", "no_actions_required", "won", "lost"

  - `dispute.type` (string, required)
    紛争のタイプ。
    Enum: "1st_time_chargeback", "2nd_time_chargeback", "arbitration", "retrieval", "representment", "chargeback_reversal", "representment_reversal", "reimbursement", "dispute", "chargeback", "claim", "reimbursement_reversal", "inquiry", "other"

  - `notification_type` (string, required)
    通知タイプ。

  - `settings` (object, required)
    カスタムプロジェクト設定に関する情報を含むオブジェクト。

  - `settings.merchant_id` (integer, required)
    マーチャントID。

  - `settings.project_id` (integer, required)
    プロジェクトID。このパラメータは、[ドメインページ](https://publisher.xsolla.com/)のプロジェクト名の横にあります。

  - `transaction` (object, required)
    トランザクションに関する情報を含むオブジェクト。

  - `transaction.country_code` (string, required)
    ユーザーの国。2文字の国コード（大文字）は、[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)に従って使用されます。

  - `transaction.date_create` (string, required)
    支払日。

  - `transaction.external_id` (string)
    取引external ID。詳細について[よくある質問](/ja/doc/pay-station/references/faq/#faq_payments_q_new_transaction_external_id)を参照してください。

  - `transaction.id` (integer, required)
    トランザクションID。

  - `transaction.payment_method` (string, required)
    決済方法。
    Enum: "credit_debit_card", "paypal"

  - `transaction.total` (object, required)
    異議申立に関する情報を含むオブジェクト。

  - `transaction.total.amount` (number, required)
    支払金額。

  - `transaction.total.currency` (string, required)
    通貨。[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)に基づく3文字の通貨コード。

  - `user` (object, required)
    ユーザーに関する情報を含むオブジェクト。

  - `user.email` (string)
    ユーザーのEメール。

  - `user.id` (string, required)
    ユーザーID。

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)

  - `error.message` (string)


## Response 204 fields

## Response 500 fields