TrustPay 争议页面、API 和回调使用的专用枚举。
回调通知类型#
| 值 | 常量 | 说明 |
|---|
4 | chargeback | 正式争议生命周期回调 |
7 | dispute_alert | 争议预警回调 |
争议预警来源#
| 值 | 说明 |
|---|
ethoca | Ethoca 预警 |
rdr | Rapid Dispute Resolution 处理结果 |
cdrn | CDRN 预警 |
争议预警分类#
| 值 | 说明 |
|---|
fraud | 欺诈预警 |
dispute | 交易争议预警 |
争议预警匹配状态#
| 值 | 说明 |
|---|
matched | 唯一匹配到一笔客户订单 |
unmatched | 未匹配到客户订单 |
ambiguous | 找到多笔可能的订单 |
只有 matched 预警才会向客户展示、计费和发送回调。争议预警匹配方式#
| 值 | 说明 |
|---|
arn | 通过 Acquirer Reference Number 匹配 |
card_amount_time | 通过脱敏卡号、金额、币种和交易时间匹配 |
none | 未唯一匹配到订单 |
争议预警通知状态#
| 值 | 说明 |
|---|
not_applicable | 该预警不需要通知 |
missing_url | 原订单没有可用的 notify_url |
pending | 等待发送 |
sending | 正在发送 |
retrying | 上一次发送失败，等待重试 |
succeeded | 客户返回 HTTP 200 |
failed | 已用尽通知重试策略 |
争议预警计费状态#
| 值 | 说明 |
|---|
not_applicable | 不需要收取客户预警费 |
pending | 等待计费 |
processing | 正在计费 |
retrying | 计费失败，等待重试 |
succeeded | 客户预警费已成功记录 |
failed | 已用尽计费重试策略 |
争议预防枚举#
| 字段 | 值 | 说明 |
|---|
method | rdr | Rapid Dispute Resolution |
prevention_status | prevented | 案例已被阻止升级为正式争议 |
refund_status | refunded | 服务商已完成自动退款 |
action_required | false | 不需要客户响应 |
正式争议案件状态#
| 值 | 说明 |
|---|
pending | 等待最终裁决 |
won | 客户胜诉 |
lost | 客户败诉 |
正式争议响应状态#
| 值 | 说明 |
|---|
needs_response | 等待客户处理 |
responded | 已提交证据申诉 |
accepted | 客户已接受争议并放弃抗辩 |
no_response_allowed | 不允许继续响应 |
unknown | 暂时无法确认服务商响应状态 |
订单争议投影#
| 值 | 说明 |
|---|
| 空字符串 | 没有争议投影 |
rdr_refunded | 已通过 RDR 退款 |
chargeback_pending | 正式争议已创建，资金暂扣并等待裁决 |
chargeback_lost | 正式争议败诉 |
chargeback_won | 正式争议胜诉 |
chargeback_* 是订单和回调当前使用的机器值，客户可见文档统一称为正式争议状态。机器字段兼容性#
客户可见名称统一使用“争议预警”。当前 type = 7 回调仍保留以下历史机器标识：event_type = chargeback_alert.created
Modified at 2026-07-30 04:31:30
