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

# 问题上报与支持路径

> 本页说明运营期的问题上报路径：何时上报、通过哪个 DCS 客户成功渠道上报、需要提供哪些参考信息（transactionId/authId/outsId/panLast4/cardId/customerId/kycTicketId 等），以及争议和盗刷的当前处理方式与自查参考码索引。

## 📄 正文

无论您遇到的是某笔交易迟迟未到账、KYC 卡在审核，还是持卡人报告可疑扣款，DCS 都有一条清晰的上报路径，帮助您快速定位并交由对口团队处理。本页说明**何时上报、向谁上报、上报时该带哪些信息**，让排查一次到位。

作为持牌发卡机构，DCS 由专属客户成功团队为接入机构提供上线后支持；涉及发卡渠道（卡组织）、清算和争议的事项，由 DCS 统一对接渠道方处理，您无需自行联系卡组织。

## 如何上报

接入机构请通过与 DCS 约定的**客户成功对接渠道**（专属客户成功对接人 / 对接邮箱 / 项目沟通群）提交问题。为帮助 DCS 团队更快定位，请在上报时**尽量带上以下参考信息**：

| 信息                  | 字段来源                                                                    | 谁提供  |
| ------------------- | ----------------------------------------------------------------------- | ---- |
| 交易流水 ID             | 交易报表 / Webhook 的 `transactionId`                                        | 接入机构 |
| 授权 ID               | 授权报表 / 授权 Webhook 的 `authId`                                            | 接入机构 |
| 账单 ID               | 串联授权与清算的 `outsId`                                                       | 接入机构 |
| 卡号后 4 位             | 卡详情的 `panLast4`（卡详情接口字段，详见[卡管理](../how-to-use/cards/card-management)）   | 接入机构 |
| 卡 ID                | `cardId`                                                                | 接入机构 |
| 用户 ID               | `customerId`（如与用户相关）                                                    | 接入机构 |
| 授权拒绝码（decline code） | 授权 Webhook / 报表中的拒绝码（参见[拒付码](../how-to-use/transactions/decline-codes)） | 接入机构 |
| 错误日志 / 报文截图         | 出错请求与响应的原始报文                                                            | 接入机构 |

<Tip>
  交易类问题，`transactionId` + 卡号后 4 位通常即可定位；KYC 类问题请附上 `customerId` 与 `kycTicketId`；接口报错请附上完整的请求/响应报文（含统一响应结构中的 `code` 与 `messageDetail`）。
</Tip>

## 何时上报

出现下列情况，建议尽快向 DCS 客户成功团队上报：

* **退款长时间未到账**：商户已退款，但持卡人账户长时间（建议超过 30 个工作日）仍未反映退款。
* **KYC 申请卡住**：KYC 工单停留在审核中的时长明显超出承诺审核时效（约 2–3 个工作日）。在上报前，请先确认提交的证件清晰、正反面与自拍标注正确（参见 [KYC 证件说明](./faq-kyc-documents)）。
* **持卡人报告可疑/未授权交易**：持卡人称某笔扣款非本人发起，疑似盗刷或错扣。
* **需要拦截可疑商户**：发现某商户存在风险，希望对其拦截。
* **接口持续报错且自查无法定位**：在核对[鉴权配置](../integration-resources/authentication)、错误码与请求报文后仍无法解决。

## 争议与盗刷处理

持卡人遇到**未授权交易、错误扣款、商户未履约**等情况需要发起交易争议（Dispute / Chargeback）时：

* **当前**：通过上述客户成功对接渠道提交，由 DCS 协助对接卡组织发起争议、跟进处理结果。请提供 `transactionId`、卡号后 4 位、争议原因与可用证据（订单截图、与商户的沟通记录等）。
* **盗刷应急**：如确认为盗刷，请同时通过[冻结卡接口](../how-to-use/cards/card-management)（`POST /open-api/card/v1/freeze`，`freeze=true`）冻结涉事卡片，或注销该卡，避免进一步损失。

<Note>
  目前争议与盗刷处理通过 DCS 客户成功对接渠道协助提交并跟进。系统内自助发起争议 / 上传证据 / 查询争议进度的接口能力正在规划中（参见 [争议处理](../how-to-use/disputes)），上线后本页将更新为自助流程。
</Note>

## 排查参考码在哪查

上报前，建议先用以下数据字典自查，很多问题可据此自助定位：

| 场景        | 参考码 / 字典                                                                                      |
| --------- | --------------------------------------------------------------------------------------------- |
| 卡片消费被拒    | 授权拒绝码 → [授权拒绝与错误码](../how-to-use/transactions/decline-codes)                                  |
| 开卡失败      | 卡订单错误码（`FAILED` 状态 `errorCode`）→ [卡申请错误码](../how-to-use/cards/card-order-codes)               |
| KYC 失败    | KYC 拒绝码 → [KYC 拒绝码](../how-to-use/kyc/kyc-reject-codes)                                       |
| 接口调用报错    | 统一 API 响应错误码（`code` 字段）→ [授权拒绝与错误码](../how-to-use/transactions/decline-codes)                 |
| 授权/交易类型理解 | 授权字典（`authType` / `transactionType`）→ [授权与清算](../how-to-use/transactions/auth-and-settlement) |

## 下一步

上报前不妨先翻一翻 [上线后常见问题](./post-go-live)，很多常见问题（数字钱包添加失败、退款延迟、申请挂起等）已给出自助处理建议。