争议更新

事件分组事件标识
paymentspayments/update
当争议事件被更新时触发。
请求头
  • Content-Type string required
    字段值固定为 application/json; charset=utf-8。
  • X-Shopline-Topic string required
    事件的唯一标识。
    例子: orders/edited
  • X-Shopline-Hmac-Sha256 string required
    该请求的签名。收到请求后，你需要对该签名进行 验签 以验证数据的真实性和完整性。
    例子: XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM=
  • X-Shopline-Shop-Domain string required
    店铺的域名。
    例子: example.myshopline.com
  • X-Shopline-Shop-Id string required
    店铺 ID。
    例子: 1610418123456
  • X-Shopline-Merchant-Id string required
    商家 ID。
    例子: 2000001234
  • X-Shopline-API-Version string required
    API 版本号。
    例子: v20250601
  • X-Shopline-Webhook-Id string required
    该 Webhook 事件的 ID。
    例子: b54557e48a5fbf7d70bcd043
请求体
  • detailobject
    争议详情。
  • additional_dataobject
    附加信息。
  • arbitration_fee string
    拒付在仲裁阶段产生的手续费。仅当 dispute_type 为 CHARGEBACK 且拒付交易经历过 stage 为 ARBITRATION 时，此字段有值。
  • prearbitration_fee string
    拒付在预仲裁阶段产生的手续费。仅当 dispute_type 为 CHARGEBACK 且拒付交易经历过 stage 为 PRE_ARBITRATION 时，此字段有值。
  • amount string
    争议金额。数值保留到小数点后两位。
  • channel_dispute_id string
    SHOPLINE Payments 所使用的支付渠道的争议单号。
  • create_time string
    争议记录创建时间。格式：ISO 8601。
    例子: 2025-06-01T00:00:00+08:00
  • currency string
    争议币种。该字段值为三位币种码，遵循 ISO 4217 国际标准，例如 CNY。
  • dispute_evidence_update_deadline string
    商家提交抗辩资料的截止时间。格式：ISO 8601。
    例子: 2025-06-02T00:00:00+08:00
  • dispute_id string
    争议记录的唯一标识。
  • dispute_type string
    争议类型。有效枚举值包含：
    • CHARGEBACK：客户向其银行发起交易争议，争议金额将被银行暂扣。
    • PRE_CHARGEBACK：这表示在完整 CHARGEBACK 之前的一个初步阶段。发卡银行正在调查争议。
    • RETRIEVAL：收单方要求商家提供有关该交易的更多信息。
    • FRAUD_NOTIFICATION：这表明有关该交易的潜在欺诈活动通知。
  • exchangeobject
    换汇信息。
  • amount string
    基于实际支付金额进行换汇的金额。数值保留到小数点后两位。
  • currency string
    兑换币种。该字段值为三位币种码，遵循 ISO 4217 国际标准，例如 CNY。
  • rate string
    换汇汇率。格式为 争议币种/兑换币种 @汇率，汇率值保留到小数点后 10 位。
    例子: USD/USD @1.0000000000
  • fee string
    手续费。SHOPLINE Payments 收取商家手续费则显示为负，SHOPLINE Payments 退还商家手续费则显示为正。
  • fee_type string
    手续费类型。有效枚举值包含：
    • domestic：本地交易手续费，接受国内银行卡片刷卡时的手续费。
    • international：跨境交易手续费，接受国外银行卡片刷卡时的手续费。
  • payment_method string
    支付方式。
  • reason string
    争议的原因。
    当 dispute_type 为 CHARGEBACK 时，reason 的枚举值为：
    • fraudulent：欺诈交易。
    • unrecognized：不明交易。
    • duplicate：买家重复支付。
    • subscription canceled：买家取消交易。
    • product not received：买家未收到商品。
    • product unacceptable：买家对商品不满意。
    • credit not processed：买家未收到退款。
    • general：其他原因。
    当 dispute_type 为 PRE_CHARGEBACK 或 RETRIEVAL 或 FRAUD_NOTIFICATION 时，reason 的值为非枚举值。
  • seller_order_id string
    业务订单号。
  • stage string
    争议的当前阶段。仅当 dispute_type 为 CHARGEBACK 时该字段有值。有效枚举值包含：
    • CHARGEBACK：拒付阶段。
    • PRE_ARBITRATION：预仲裁阶段。
    • ARBITRATION：仲裁阶段。
  • stage_final_amount string
    争议结束金额。在各个阶段的终态时，若争议金额有变动，此字段会更新。
  • status string
    争议状态。
    当 dispute_type 为 CHARGEBACK 且 stage 为 CHARGEBACK 时，有效枚举值为：
    • EVIDENCE_RETURNED：材料已退回，退回原因可能是材料不完整，商家需要重新提交抗辩材料。
    • EVIDENCE_REQUIRED：待商家向 SHOPLINE Payments 提交审查资料。
    • MERCHANT_SUBMITTED：争议处理中（材料已提交）。
    • RESOLVED：已解决。争议中间状态，后续会变为 WON 或者 LOST。
    • CANCELED：已取消。争议中间状态，后续会变为 WON。
    • EVIDENCE_UNDER_REVIEW：争议处理中（SHOPLINE Payments 审核材料中）。
    • LOST：争议成立。买家获得款项。
    • WON：争议不成立。卖家获得款项。
    • EXPIRED：争议已过期。争议中间状态，后续大概率变为 LOST。
    • SLP_EXPIRED：商家超时未提供抗辩资料。后续会变为 EXPIRED。
    • ACCEPTED：已将商家接受争议的决定提交至卡组。争议中间状态，后面会变为 LOST。
    • MERCHANT_ACCEPTED：待将商家接受争议的决定提交至卡组。争议中间状态，后续会变为 ACCEPTED。
    当 dispute_type 为 CHARGEBACK 且 stage 为 PRE_ARBITRATION 时，有效枚举值为：
    • CREATED：预仲裁已创建。
    • EVIDENCE_RETURNED：材料已退回，退回原因可能是材料不完整，商家需要重新提交抗辩材料。
    • EVIDENCE_REQUIRED：待商家向 SHOPLINE Payments 提交审查资料。
    • MERCHANT_SUBMITTED：争议处理中（材料已提交）。
    • EVIDENCE_UNDER_REVIEW：争议处理中（SHOPLINE Payments 审核材料中）。
    • LOST：争议成立。买家获得款项。
    • WON：争议不成立。卖家获得款项。
    • SLP_EXPIRED：商家超时未提供抗辩资料。后续会变为 LOST。
    • MERCHANT_ACCEPTED：待将商家接受争议的决定提交至卡组。争议中间状态，后续会变为 LOST。
    当 dispute_type 为 CHARGEBACK 且 stage 为 ARBITRATION 时，有效枚举值为：
    • CREATED：仲裁已创建。
    • EVIDENCE_UNDER_REVIEW：争议处理中（SHOPLINE Payments 审核材料中）。
    • LOST：争议成立。买家获得款项。
    • WON：争议不成立。卖家获得款项。
    当 dispute_type 为 PRE_CHARGEBACK 时，有效枚举值包含：
    • PRE_CHARGEBACK_IN_ACCEPT：商家已回复接受。中间状态，商家手动选择或者自动接受退款，后续变成 PRE_CHARGEBACK_ACCEPTED。
    • PRE_CHARGEBACK_IN_REJECT：商家已回复拒绝。中间状态，商家手动选择拒绝退款，后续会变成 PRE_CHARGEBACK_REJECTED。
    • PRE_CHARGEBACK_IN_EXPIRE：商家超时未回复。中间状态，产生了预拒付，商家超过时间没操作，后续变成 PRE_CHARGEBACK_ACCEPTED 或 PRE_CHARGEBACK_REJECTED。
    • PRE_CHARGEBACK_ACCEPTED：商家已接受。是终态，商家接受退款，退款已完成。
    • PRE_CHARGEBACK_REJECTED：商家已拒绝。是终态，商家拒绝退款，后续有可能演变为拒付。
    当 dispute_type 为 RETRIEVAL 时，有效枚举值包含：
    • RETRIEVAL_FINISHED：调单完成。
    • RETRIEVAL_CANCELED：调单撤销。
  • trade_order_id string
    原始支付订单的唯一标识。
  • update_time string
    争议记录更新时间。格式：ISO 8601。当与此争议关联信息（如交易状态）更新时，此时间也会被更新。
    例子: 2025-06-01T00:00:00+08:00
  • event_id string
    争议事件的唯一标识，以此作为幂等判断，避免重复处理。
  • event_type string
    事件类型。固定值：slp_dispute/update_v2。
  • store_id string
    店铺 ID。
状态码
收到 SHOPLINE 发送的 Webhook 通知后，你需要按照如下 SHOPLINE 要求的格式进行响应。
HTTP/1.1 200 OK
关于如何订阅 Webhooks 及更多 Webhook 响应规则说明，请参考 Webhook 概述。
这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2026 SHOPLINE Limited.