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. 争议管理

争议预警

客户版|基于当前 TrustPay 实现整理|更新日期:2026-07-30

文档目的#

争议预警是在持卡人的投诉升级为正式争议前收到的风险提醒,使客户有时间核对交易、在必要时停止履约、保留证据,或根据自身风险政策通过正常退款流程主动退款。
争议预警不是正式争议,也不代表已经完成退款。

当前支持的预警来源#

当前系统支持:
ethoca
cdrn
RDR 使用同一套预警基础能力,但它表示已经完成的自动预防结果。请查看《争议预防(RDR)》。

订单匹配#

TrustPay 尝试将预警关联到原支付订单:
1.
优先使用 ARN 匹配。
2.
ARN 无法匹配时,使用脱敏卡号、金额、币种和交易时间组合匹配。
3.
只有唯一匹配到一笔订单时,才将预警归属给客户。
未匹配或匹配不唯一的预警会保留供内部核查,但不会:
向客户展示;
向客户计费;
向客户回调地址发送通知。
当前自动匹配范围为已配置支持该能力的 C21 Markup Payin 订单。

匹配成功后#

TrustPay 会:
1.
保存预警和订单关联;
2.
根据配置记录单笔客户预警费;
3.
在计费成功后,向原订单 notify_url 发送 type = 7 回调;
4.
在客户门户展示预警、费用和通知状态。
同一预警只计费一次,回调重试不会重复计费。
预警费从客户可用余额扣除,当前实现允许余额变为负数。回调失败不会冲正已经成功记录的预警费。

争议预警不会自动执行什么#

争议预警本身不会:
自动退款;
创建正式 Dispute;
修改订单的正式争议状态;
扣除正式争议本金或正式争议处理费;
自动向预警服务商反馈客户处理结果。
客户如决定主动退款,应使用现有退款流程,并先确认订单尚未进入正式争议。

客户建议操作#

1.
核对订单、金额、脱敏卡号、ARN、原因码和交易时间。
2.
确认商品或服务是否已经交付。
3.
对明显欺诈、重复扣款或持卡人不认可的交易,判断是否停止履约并通过正常流程退款。
4.
保留订单、授权、沟通、物流和服务使用证据。
5.
使用 alert_id 对预警回调做幂等处理。

相关文档#

《争议预警回调》——完整 type = 7 回调契约。
《争议枚举》——预警来源、分类、匹配、计费和通知状态。
《争议预防(RDR)》——已经自动预防和退款的案例。
《争议管理》——正式争议响应和裁决流程。
Modified at 2026-07-30 04:29:46
Previous
争议枚举
Next
争议预警回调
Built with