争议

争议Webhook POST

提起新争议或争议状态发生变化时，艾克索拉会向Webhook URL发送一个包含dispute类型的Webhook。要接收该Webhook，请联系您的客户成功经理或发送电子邮件至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的三字母货币代码。

payment_method

required

string

支付方式。

Enum:	Description
credit_debit_card	信用卡或借记卡
paypal	PayPal

country_code

required

string

用户所在国家/地区。使用ISO 3166-1 alpha-2 标准规定的2字母组合表示国家/地区。

external_id

string

交易外部ID。详细信息请参阅常见问答。

required

object

包含自定义项目设置信息的对象。

project_id required	integer 项目编号。您可以在您的发布商帐户项目名称旁边。
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	第一次拒付。
2nd_time_chargeback	第二次拒付（仲裁前）。
arbitration	解决第一次拒付和第二次拒付被拒绝时发卡行与商户之间的争议。
chargeback	第一次拒付。
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"
}
}