1. 争议管理
TrustPay
zh
  • en
  • zh
  • 接入说明
  • 签名计算
  • 支付风控接口 - 商户接入指南
  • 支付网关
    • 枚举类型说明
    • 支付回调说明
    • C21 支持区域
      • TrustPay API 与 Checkout 支持的国家和 US/CA 州省
    • 白名单管理
      • 添加卡白名单
      • 导入任务查询
      • 查询卡白名单
    • 卡直付
      POST
    • 收银台
      POST
    • 订单退款
      POST
    • 支付回调通知
      POST
    • 订单查询
      POST
    • 余额查询
      POST
    • 费率查询
      POST
    • 退款查询
      POST
  • 争议管理
    • 争议枚举
    • 争议预警
    • 争议预警回调
    • 争议预防(RDR)
    • 争议管理(Chargeback)
    • Chargeback 回调
  • 信用卡开卡
    • 查询可用卡类型
      POST
    • 开通虚拟卡
      POST
    • 开卡/充值回调通知
      POST
    • 获取虚拟卡详情
      POST
    • 虚拟卡充值
      POST
    • 订单列表查询
      POST
    • 虚拟卡列表查询
      POST
    • 卡片列表
      POST
    • 流水查询
      POST
    • 费率查询
      POST
  • 实体卡
    • 创建持卡人
    • 持卡人列表
    • 绑定持卡人
    • 持卡人绑定列表
    • 查询实体卡余额
    • 查询交易记录
    • 查询账户
    • 实体卡充值
  • Payment Gateway
  • Schemas
    • VCardDetail
    • VOrderDetail
  1. 争议管理

争议管理(Chargeback)

正式争议响应、裁决和资金处理的客户说明。

文档目的#

争议管理用于处理已经创建的正式争议。它不同于正式争议前的争议预警,也不同于 RDR 自动预防结果。
客户可查看案件金额、原因、响应截止时间、案件状态和响应状态。对于支持的案件,客户可以接受争议,或上传证据并提交申诉。

案件状态#

status含义
pending尚未收到最终裁决
won商户胜诉
lost商户败诉

响应状态#

response_status含义客户操作
needs_response等待商户响应接受争议,或上传证据并申诉
responded已提交申诉等待服务商裁决
accepted商户已接受争议并放弃抗辩等待服务商最终确认
no_response_allowed不允许继续响应无法继续提交证据或申诉
unknown暂时无法确认服务商响应状态刷新状态或联系支持团队
只有同时满足以下条件时,门户才开放响应操作:
status = pending;
response_status = needs_response。

方式一:接受争议#

接受争议表示商户放弃抗辩。
TrustPay 将接受动作发送到支持在线争议处理的渠道。
response_status 更新为 accepted。
在服务商给出最终结果前,案件仍可能保持 pending。
最终结果通常进入 lost。
接受后不应继续上传证据或提交申诉。

方式二:提交证据#

商户认为交易真实有效时:
1.
在 respond_by 截止时间前准备证据。
2.
上传证据文件。
3.
等待至少一个文件上传成功。
4.
提交申诉。
5.
关注服务商最终裁决。
当前证据限制:
最多 8 个文件;
每个文件不超过 2 MB;
支持 JPG、JPEG、PNG、PDF;
至少一个证据文件上传成功后才能提交;
提交后等待最终裁决期间不能继续补充证据。
建议证据包括:
订单和交易信息;
持卡人授权;
物流签收;
服务使用记录;
退款和取消政策;
客户沟通记录。

当前渠道范围#

在线接受、上传证据、提交申诉和服务商状态同步当前适用于支持该能力的 C24 Finix 案件。
C21 通过报告导入的是已确认败诉案件,状态为:
status = lost;
response_status = no_response_allowed。
这类 C21 案件不支持在线抗辩。

资金处理#

不同渠道的扣款时点不同。

C24 实时正式争议#

案件创建时,TrustPay:
暂扣争议本金;
收取配置的争议处理费;
创建一笔 processing 状态的争议退款占位记录。
占位记录只表示资金正在等待最终裁决,不是再次向银行卡退款,也不会重复扣款。

C21 报告确认的正式争议#

导入案件确认进入 lost 时,TrustPay 扣除争议本金和配置的争议处理费。

最终裁决#

结果资金处理
won返还此前扣除的争议本金并回滚占位记录;已收取的争议处理费不返还。
lost确认争议损失;若案件创建时已完成暂扣,不再次扣除本金;占位记录完成为 success。

普通退款限制#

当订单争议投影处于以下状态时,系统阻止普通退款:
chargeback_pending;
chargeback_lost。
这样可以避免客户主动退款与争议扣款同时退回同一笔交易。

正式争议回调#

正式争议生命周期通知使用:
type = 4;
dispute_status = chargeback_pending / chargeback_lost / chargeback_won;
dispute_id;
response_status;
expiration_date;
dispute_fee;
balance_amount。
独立回调契约和示例请查看《正式争议回调》。

相关文档#

《争议枚举》
《正式争议回调》
《争议预警》
《争议预防(RDR)》
Modified at 2026-08-06 16:13:02
Previous
争议预防(RDR)
Next
Chargeback 回调
Built with