분쟁

분쟁Webhook POST

새 분쟁이 발생하거나 분쟁 상태가 변경되면 엑솔라는 해당 dispute 유형이 포함된 웹훅을 웹훅 URL로 보냅니다. 이 웹훅을 수신하려면 고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요.

Request

Request Body schema: application/json

notification_type

required

string

알림 유형.

action

required

string

작업 유형입니다.

Enum:	Description
adding	새로운 분쟁이 발생했습니다.
updating	분쟁 상태가 변경되었습니다.

required

object

거래에 대한 정보가 있는 개체입니다.

required

integer

트랜잭션 ID.

date_create

required

string

결제일.

required

object

거래 금액에 대한 정보가 있는 개체입니다.

amount required	number <float> 결제 금액입니다.
currency required	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.

payment_method

required

string

결제 방식.

Enum:	Description
credit_debit_card	신용 카드 또는 직불 카드
paypal	PayPal

country_code

required

string

사용자의 국가. ISO 3166-1 alpha-2 standard에 따른 2자로 된 국가 코드를 사용합니다.

external_id

string

거래 외부 ID. 자세한 내용은 FAQs를 참조해 주세요.

required

object

사용자 정의 프로젝트 설정에 대한 정보가 있는 개체입니다.

project_id required	integer 프로젝트 ID. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.
merchant_id required	integer 판매자 ID입니다.

required

object

사용자에 대한 정보가 있는 개체입니다.

id required	string 사용자 ID.
email	string 사용자 이메일.

required

object

분쟁에 대한 정보가 있는 개체입니다.

incoming_date

required

string

RFC 3339 표준에 따른 분쟁 시작 날짜.

reason

required

string

분쟁을 시작한 이유. 이유 그룹에 대한 설명은 문서를 참조해 주세요.

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"

type

required

string

분쟁 유형.

Enum:	Description
1st_time_chargeback	1차 지불 거절.
2nd_time_chargeback	2차 지불 거절(사전 중재).
arbitration	1차 지불 거절 및 2차 지불 거절이 거부된 경우 발급 은행과 판매자 간의 분쟁 해결.
chargeback	1차 지불 거절.
chargeback_reversal	지불 거절이 취소되었습니다.
claim	PayPal에서 고객과 판매자 간의 분쟁.
dispute	카드 소유자가 은행에 결제 세부 정보를 요청했습니다.
inquiry	카드 소유자가 은행에 결제 세부 정보를 요청했습니다.
other	다른 유형에 포함되지 않는 지불 거절 유형에 사용됨.
reimbursement	환불이 완료되었습니다.
reimbursement_reversal	지불 거절이 취소되었습니다.
representment	지불 거절 관리 팀에서 증거를 결제 시스템으로 보냈습니다.
representment_reversal	지불 거절이 취소되었습니다.
retrieval	카드 소유자가 은행에 결제 세부 정보를 요청했습니다.

status

required

string

분쟁 상태.

Enum:	Description
accepted	수락됨
lost	분실
new	신규
no_actions_required	진행 중
won	승소

Responses

204

성공적인 처리 표시를 반환합니다.

400

제공된 정보에 오류가 있는 경우 반환합니다(예: 필수 매개변수 누락, 인증 실패 등).

500

서버에 일시적인 오류가 있음을 표시하려면 돌아가세요.

Request samples

CURL
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Authorization: Signature 32c64a80d2527dc08906ae1891bac4489509b9f6' \
-d '{
  "notification_type": "dispute",
  "action": "adding",
  "transaction": {
    "id": 123456789,
    "date_create": "2023-08-24T10:21:00+04:00",
    "total": {
      "amount": 1,
      "currency": "EUR"
    },
    "payment_method": "credit_debit_card"
  },
  "settings": {
    "project_id": 18404,
    "merchant_id": 2340
  },
  "user": {
    "id": "1234567",
    "email": "email@example.com",
    "country_code": "US"
  },
  "dispute": {
    "incoming_date": "2024-01-25T01:02:03+04:00",
    "reason": "not_as_described",
    "type": "retrieval",
    "status": "new"
  }
}'

Response samples

application/json

{"error": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}