# 분쟁

새 분쟁이 발생하거나 분쟁 상태가 변경되면 엑솔라는 해당 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)
    분쟁을 시작한 이유. 이유 그룹에 대한 설명은 [문서](/ko/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)
    사용자의 국가. [ISO 3166-1 alpha-2 standard](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)에 따른 2자로 된 국가 코드를 사용합니다.

  - `transaction.date_create` (string, required)
    결제일.

  - `transaction.external_id` (string)
    거래 외부 ID. 자세한 내용은 [FAQs](/ko/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)
    사용자 이메일.

  - `user.id` (string, required)
    사용자 ID.

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)

  - `error.message` (string)


## Response 204 fields

## Response 500 fields