> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 拒付原因码与 Reported Fraud

> Waffo 识别的全部 Visa 与 Mastercard 争议原因码，按类别分组并说明每个码的主张内容；以及什么是 Reported Fraud、它与拒付有何不同、如何查询。

拒付分析（Chargeback Analytics）展示最常见的原因码以及一个 **Others** 桶，而单个案件的
详情显示它自己的那一个码。本页是这两者背后的完整列表，你可以据此查阅收到的任何码。针对
某个码应该*提交*什么，见
[拒付证据指南](/docs/zh/support/chargeback-evidence-guide)；案件自身的字段见
[拒付字段参考](/docs/zh/support/chargeback-field-reference)。

## 原因码是怎么组织的？

每个被识别的码都属于一个卡组织和五个类别之一。类别才是有用的东西：在你读码的文字之前，
它就告诉你该案件的关键落在三个抗辩维度中的哪一个。

| 类别 | 发卡行的主张，一句话概括 |
| - | - |
| **Fraud-related** | 持卡人声称自己没有授权这笔交易 |
| **Authorization Errors** | 这笔交易不应该以当时的方式被授权 |
| **Processing Errors** | 交易提交有误——金额、币种、日期或账户错误 |
| **Customer Disputes** | 持卡人授权了，但对所得不满意 |
| **Miscellaneous Chargebacks** | 区域性和剩余的其他情形 |

你收到的码如果不在下方表格中，会以 `0000/00` / *Not available* 的形式出现——
见本页最后一个问题。

## Visa 原因码

### Fraud-related

| 码 | 原因 |
| - | - |
| `10.1` | EMV 责任转移伪卡欺诈（EMV Liability Shift Counterfeit Fraud） |
| `10.2` | EMV 责任转移非伪卡欺诈（EMV Liability Shift Non-Counterfeit Fraud） |
| `10.3` | 其他欺诈——有卡环境（Other Fraud – Card Present Environment） |
| `10.4` | 其他欺诈——无卡环境（Other Fraud – Card Absent Environment） |
| `10.5` | Visa 欺诈监控计划（Visa Fraud Monitoring Program） |

`10.4` 是大多数线上商户最常见到的：持卡人否认一笔无卡交易。

### Authorization Errors

| 码 | 原因 |
| - | - |
| `11.1` | 卡片回收公告（Card Recovery Bulletin） |
| `11.2` | 授权被拒（Declined Authorization） |
| `11.3` | 未授权（No Authorization） |

### Processing Errors

| 码 | 原因 |
| - | - |
| `12.1` | 逾期提交（Late Presentment） |
| `12.2` | 交易码错误（Incorrect Transaction Code） |
| `12.3` | 币种错误（Incorrect Currency） |
| `12.4` | 账号错误（Incorrect Account Number） |
| `12.5` | 金额错误（Incorrect Amount） |
| `12.6` | 重复处理 / 已通过其他方式支付（Duplicate Processing / Paid by Other Means） |
| `12.7` | 数据无效（Invalid Data） |

当持卡人说自己被扣了两次时，`12.6` 是首先要核对的码——它往往仅凭两条授权记录就能答复。

### Customer Disputes

| 码 | 原因 |
| - | - |
| `13.1` | 未收到商品 / 服务（Merchandise / Services Not Received） |
| `13.2` | 已取消的周期性扣款（Cancelled Recurring） |
| `13.3` | 与描述不符或商品 / 服务有缺陷（Not as Described or Defective Merchandise / Services） |
| `13.4` | 假冒商品（Counterfeit Merchandise） |
| `13.5` | 虚假陈述（Misrepresentation） |
| `13.6` | 未处理退款（Credit Not Processed） |
| `13.7` | 已取消的商品 / 服务（Cancelled Merchandise / Services） |
| `13.8` | 原始退款交易未被接受（Original Credit Transaction Not Accepted） |
| `13.9` | 未收到现金或充值交易金额（Non-Receipt of Cash or Load Transaction Value） |

`13.2` 和 `13.7` 是订阅与取消相关的码：决定它们的是你的取消记录和买家接受的政策，
而不是交付证明。

## Mastercard 原因码

### Fraud-related

| 码 | 原因 |
| - | - |
| `4837` | 无持卡人授权（No Cardholder Authorization） |
| `4849` | 可疑商户活动（Questionable Merchant Activity） |
| `4870` | 芯片责任转移（Chip Liability Shift） |
| `4871` | 芯片责任转移——遗失 / 被盗 / 未收到卡（NRI）欺诈（Chip Liability Shift – Lost / Stolen / Never Received Issue (NRI) Fraud） |

`4837` 是驱动拒付分析中 Mastercard 欺诈率卡片的那个码——见
[Portal 分析](/docs/zh/support/portal-analytics-faq)——因此它附带的是合规后果，
而不只是财务后果。

### Authorization Errors

| 码 | 原因 |
| - | - |
| `4808` | 授权相关拒付（Authorization-Related Chargeback） |

### Processing Errors

| 码 | 原因 |
| - | - |
| `4831` | 交互点（POI）错误（Point-of-Interaction (POI) Error） |

### Customer Disputes

| 码 | 原因 |
| - | - |
| `4841` | 已取消的周期性或数字商品交易（Canceled Recurring or Digital Goods Transactions） |
| `4850` | 分期账单争议——参与国家（Installment Billing Dispute – Participating Countries） |
| `4853` | 持卡人争议（Cardholder Dispute） |
| `4854` | 持卡人争议——未另行分类（Cardholder Dispute – Not Elsewhere Classified） |
| `4855` | 未提供商品或服务（Goods or Services Not Provided） |
| `4859` | 未到店 / 附加费 / ATM 争议（No Show / Addendum / ATM Dispute） |
| `4860` | 未处理退款（Credit Not Processed） |

### Miscellaneous

| 码 | 原因 |
| - | - |
| `4999` | 境内拒付争议（欧洲区域）（Domestic Chargeback Dispute (European region)） |

## 两个卡组织的码长得很像。我怎么正确读懂我的码？

始终把码**和案件上的卡组织一起**读。码只在同一卡组织内唯一，Waffo 正是按卡组织来解析码，
以避免歧义——所以对着错误的卡组织查码，会让你落到错误的主张和错误的证据上。案件记录
同时携带两者；请两者都用。

## 我的案件显示未知或没有帮助的原因。我该怎么办？

Waffo 无法识别的码，或者到达时没有携带码的案件，会表示为 `0000/00`，原因为
*Not available*。这是一种真实状态，不是数据错误——有些发起方不会把码传过来。

它对截止时间没有任何改变，对你抗辩的能力也没有任何改变。它改变的是你如何构建提交材料：
没有码可以瞄准时，发送
[拒付证据指南](/docs/zh/support/chargeback-evidence-guide) 中的兜底组合，并在可能的情况下，
在提交前搞清楚实际的主张是什么。

## 什么是 Reported Fraud？它和拒付是一回事吗？

不是——它们是各自独立的记录，一个并不意味着另一个。

| | Reported Fraud | 拒付 |
| - | - | - |
| 是什么 | 卡组织报告某笔交易被标记为欺诈 | 一项正式的争议，要求把钱要回去 |
| 钱会动吗？ | **不会** | 会——金额和费用会记在你的账上 |
| 你能抗辩吗？ | 没有可抗辩的东西 | 可以，在截止时间之内 |
| 显示在哪里 | Reported Fraud API；其计数汇入拒付分析中的 Visa 欺诈率卡片 | 拒付列表、拒付 API 和每日争议报告 |

一笔交易可能被报告为欺诈却从未被拒付，也可能被拒付却从未被报告。两者对合规比率都很重要，
其中一个比率卡片有意把两者合并——各卡片究竟统计什么，见
[Portal 分析](/docs/zh/support/portal-analytics-faq)。

实际要点：Reported Fraud 是一个**信号**，不是负债。它不会直接让你付出成本，对单条记录
也没有可采取的动作，但数量上升是拒付和监控计划问题即将到来的早期预警。把它当作趋势来读。

## 我如何查询 Reported Fraud？

通过 `/api/v1/fraud-report/list`——一个分页的 POST。Portal 中没有 Reported Fraud 列表
页面，所以 API 是获取单条记录的唯一途径。

| 参数 | 是否必填 | 说明 |
| - | - | - |
| `merchantId` | 是 | 你的 Waffo 商户 id |
| `startDate`、`endDate` | 是 | `yyyy-MM-dd`，两端均包含，跨度最多三个月——这是欺诈**报告**日期，不是交易日期 |
| `pageNum` | 是 | 从 1 开始 |
| `pageSize` | 是 | 1–100 |
| `paymentMethod` | 否 | 卡组织数组（`VISA`、`MASTERCARD`）；多个值为 OR 关系，为空表示全部 |
| `acquiringOrderId` | 否 | 查询单笔交易 |

日期范围按欺诈被报告的时间过滤，这**晚于**——往往远晚于——交易发生的时间。对于你确知
有欺诈的时段，窗口看起来为空，通常是因为窗口对准的是交易日期。

## 每条 Reported Fraud 记录包含什么？

| 字段 | 它给你什么 |
| - | - |
| `acquiringOrderId` | Waffo 订单，你可以据此找到交易 |
| `paymentRequestId` | 你自己的请求 id——一次性支付时有值，订阅时为空 |
| `subscriptionId` / `merchantSubscriptionId` | 订阅支付时有值，一次性支付时为空 |
| `merchantUserId` | 你自己为付款人设定的用户标识 |
| `transactionDateTime` | 原始交易发生的时间（UTC） |
| `fraudReportDate` | 报告到达的时间 |
| `fraudAmount` / `fraudCurrency` | 被报告为欺诈的金额 |
| `orderAmount` / `orderCurrency` | 原始订单金额 |
| `fraudReason` | 发起方自己的措辞，例如 *Account takeover* |
| `fraudReasonCode` | 卡组织自己的欺诈码，例如 `VI:6`、`MC:5` |
| `paymentMethod` | 卡组织 |
| `cardType` | Credit / Debit / Prepaid / Unknown |
| `cardMaskedNo` | 发起方提供的掩码卡号 |

基于它开发时要注意两点。`fraudReasonCode` 是**卡组织的欺诈分类体系**，与本页的拒付
原因码是不同的码空间——不要拿一个去另一个的表里查。而哪个标识有值告诉你交易来自哪个
流程：`subscriptionId` 有值而 `paymentRequestId` 为空的记录是订阅扣款，这通常意味着
有用的证据是订阅的同意记录和账单历史，而不是单笔订单。

## 为什么我的某个案件没有 Defend 按钮？

争议行上的操作只有在以下两条同时成立时才显示为 **Defend**，否则显示为 **View**：

1. **案件处于接受回应的状态**——`EVIDENCE_REQUIRED`、`ACTION_REQUIRED` 或
   `SECOND_CYCLE_RESPONSE_REQUIRED` 之一。处于终态的案件、已过期的案件，以及仍在
   `UNDER_REVIEW` 的案件都显示 View。
2. **你的 Portal 用户拥有争议更新权限。** 没有它，无论案件处于什么状态都显示 View。
   这是人们容易忽略的原因——如果同事能抗辩某个案件而你不能，那是权限问题，不是案件
   问题。请联系你的账户管理员。

第三种情形有它自己的状态：到达时信息不足、无法正常开立的拒付，会停留在 `INCOMPLETE`，
直到 Waffo 将其补全。`INCOMPLETE` 不是可回应状态，所以显示 View——案件会在你不做任何
操作的情况下转为 `ACTION_REQUIRED` 变为可抗辩，或被关闭。处于不完整状态期间，它的
截止时间计时不会开始。

## 什么决定了我能否自己关闭一个客户争议？

两个条件，都在案件上：

* 状态仍是接受操作的状态——`UNDER_REVIEW`，或某个需要回应的状态。
* **Compulsory Channel Review 为 false。** 当发起方要求案件必须经过其自身审核时，
  你不能自己关闭它；不会提供 Close 操作。Compulsory Channel Review 的含义见
  [拒付字段参考](/docs/zh/support/chargeback-field-reference)。

回复是另一回事，也更宽松：客户争议在 `UNDER_REVIEW`、在需要回应的状态，甚至在
`CLOSED` 状态下都可以回复，只要案件本身允许回复。这就是为什么一个已关闭的客户争议
仍可能显示未读计数。

***

找不到某个码，或者某条 Reported Fraud 记录无法关联到订单？
请附上 `acquiringOrderId` [联系客服](mailto:support@waffo.com)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.