> ## 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.

# 上线后常见问题

> 按场景列出上线后运营期最常见的一线问题（数字钱包添加失败、绑卡失败、交易被拒、卡被冻结/阻止、退款未到账、争议/盗刷、KYC 卡审核、改寄送地址、屏蔽商户），每类给出接入机构可自助排查的步骤与需上报 DCS 的判定线。

## 📄 正文

上线只是开始。无论您是交易所、钱包还是平台方，持卡人都会陆续遇到加不进数字钱包、退款迟迟不到账、交易被拒等真实场景——本页把上线后最常见的问题按场景列出，并给出**接入机构可自助排查的步骤**与**需要上报 DCS 的判定线**，帮助您把大部分一线问题在自己的客服侧消化掉。

作为持牌、自有 BIN 的发卡机构，DCS 在生产环境为您持续提供发卡、授权转发、清算与对账能力；遇到需要 DCS 介入的情况，请按[问题上报与支持路径](./support-escalation)上报。

> 责任划分提示：在合作伙伴自管模式下，**消费额度由接入机构掌握、授权由接入机构决策**。因此「为什么这笔被拒」「余额够不够」这类问题，首先应在接入机构自身的授权逻辑与企业保证金中排查；DCS 负责发卡、转发与清算。

***

## 把卡加入数字钱包（Apple Pay 与 Google Pay）失败

当持卡人无法把卡加入手机钱包时，建议引导其依次排查：

1. **换一张卡试试**：先确认问题是「这张卡」还是「这个钱包/这部手机」。
2. **常见失败原因**：
   * 手机所在国家/地区与卡的发行地区不一致；
   * 手机被 Apple / Google 标记为高风险设备；
   * 短时间内反复添加多张卡，触发了钱包侧的频率限制。
3. **处理建议**：通常一部设备在 **24 小时内只能成功添加一张卡**，请引导持卡人间隔 24 小时后重试。

> 关于应用内一键绑卡的接入方式，请参阅[Apple Pay 与 Google Pay 绑卡](../how-to-use/cards/push-provisioning)。

## 把卡添加到商户（绑卡支付）失败

持卡人无法把卡绑定到某个商户或应用时：

* 部分商户对账单地址（Billing Address）校验较严，可建议持卡人在结账时尝试填写卡片发行地对应的地址信息；
* 若仍失败，请记录该笔**交易标识**（`transactionId` / `authId`）后按[上报路径](./support-escalation)上报 DCS 协查。

## 交易被拒怎么排查

每一笔授权请求都会经 DCS 以授权转发通知（POST 到您的 `authUrl`）实时转发给接入机构决策，被拒结果同样可在授权数据中看到。排查顺序建议：

1. **先看授权决策方是谁**：在合作伙伴自管模式下，绝大多数拒绝来自接入机构自身的决策（`approveFlag=D`）——优先检查接入机构的授权逻辑：用户额度是否用尽、企业保证金可用余额是否充足、是否命中接入机构自有的风控/MCC 规则。
2. **再看 DCS 侧前置校验**：DCS 在转发前会校验卡片状态（是否激活、是否冻结/被阻止）。若卡处于 `FROZEN` / `BLOCKED` / `INVALID`，授权不会成功，可调卡详情查 `status` 与 `statusReason`（见下「卡被冻结/阻止」）。
3. **常见拒绝原因**：余额/额度不足、卡状态异常、CVV/PIN 不匹配、命中受限 MCC 或商户。
4. **告知持卡人**：根据上述判定，向持卡人说明被拒原因。

> 拒绝原因的标准化取值与含义，请参阅[授权拒绝与错误码](../how-to-use/transactions/decline-codes)。授权字段（`approveFlag`、`direction`、`authType` 等）说明见[授权](../how-to-use/transactions/authorization)。

## 卡被冻结 / 阻止，如何区分与处理

通过卡详情接口（`GET /open-api/card/v1/detail`）返回的 `status` 与 `statusReason` 判断：

| 状态             | 含义                                           | 谁能解除                |
| :------------- | :------------------------------------------- | :------------------ |
| `FROZEN`（已冻结）  | 由持卡人或接入机构发起的冻结，或验证失败自动冻结（如连续 3 次 CVV/PIN 错误） | 接入机构可自助解冻           |
| `BLOCKED`（已阻止） | 由发卡行/风控发起的冻结（如合规审查、安全风控）                     | 接入机构无法直接解除，需 DCS 处理 |
| `INVALID`（已注销） | 卡生命周期结束，永久失效                                 | 不可恢复                |

* **解冻自己冻结的卡**：调用 `POST /open-api/card/v1/freeze`，传 `freeze=false` 即可解冻（`freeze=true` 为冻结）。该接口以**布尔字段 `freeze` 区分冻结/解冻**，并非两个独立接口。
* **`BLOCKED` 状态**：请先读 `statusReason`（如 `COMPLIANCE_REVIEW`、`SECURITY_RESTRICTION` 等）了解原因，再按[上报路径](./support-escalation)联系 DCS 协助解除。

> 卡状态机、`statusReason` 全量取值与各状态可执行操作，详见[卡管理](../how-to-use/cards/card-management)。

## 退款 / 撤销迟迟未到账

退款与撤销在系统中表现为方向为 `INCOMING` 的授权（解冻已冻结资金）：

* 商户发起退款/撤销后，到账存在客观时延，请先告知持卡人耐心等待。
* 若长时间（明显超出合理周期）仍未到账，请带上该笔**原始交易标识**（`transactionId` / 关联的 `authId` / `originalAuthId`）按[上报路径](./support-escalation)上报 DCS 协查。

> 退款/撤销的具体到账时效以实际渠道处理为准；若明显超出合理周期仍未到账，请按上报路径上报 DCS 协查。`INCOMING` 授权的字段与场景见[授权](../how-to-use/transactions/authorization)。

## 持卡人对某笔交易有异议（争议 / 盗刷）

若持卡人主张某笔交易为未授权消费或与商户存在纠纷：

* 先核对交易明细（商户名 `cardAcceptorNameLocation`、金额、时间），排除本人遗忘或家庭成员消费；
* 确属争议/盗刷的，请按[争议处理](../how-to-use/disputes) 的流程发起，并按[上报路径](./support-escalation)联系 DCS 跟进。

> 当前争议（dispute / chargeback）处理以 DCS 运营协同为准，请按上报路径联系 DCS 跟进。

## 已发卡用户的 KYC 长时间处于审核中

若持卡人申请后 KYC 状态长时间未推进：

1. **先查证件质量与标注**：确认提交的证件清晰、未截图、且类型/正反面标注正确（如身份证正面、自拍是否标注无误）。可接受证件清单见 [KYC 证件说明](./faq-kyc-documents)。
2. **查当前状态**：调用查询 KYC 接口确认当前处于哪一阶段；若需补件，引导持卡人补充。
3. **等待合理时间后上报**：若证件无误仍长时间停留在审核中，请带上 `customerId` / `kycTicketId` 按[上报路径](./support-escalation)上报 DCS。

> 状态机与查询方式见[查询 KYC](../how-to-use/kyc/query-kyc)，拒绝原因见 [KYC 拒绝码](../how-to-use/kyc/kyc-reject-codes)。

## 修改实体卡寄送地址

实体卡寄送信息一经提交**通常无法在途修改**。如需更正：

1. 按[上报路径](./support-escalation)联系 DCS 注销该用户当前卡片；
2. 引导持卡人以正确地址重新申请新卡。

> 当前寄送地址更正的标准做法为注销当前卡片后以正确地址重新申请。寄送信息查询见[卡管理](../how-to-use/cards/card-management)（`GET /open-api/card/v1/shipping-info`）。

## 屏蔽可疑商户

如需对某商户做拦截：

* 在合作伙伴自管模式下，接入机构可在自身授权决策中对特定商户/MCC 直接返回拒绝（`approveFlag=D`），这是最快的自助方式；
* 若需在 DCS/卡组织层面做更彻底的屏蔽，请按[上报路径](./support-escalation)上报，并提供**商户标识与屏蔽原因**。

***

## 下一步

需要把问题上报给 DCS、或想了解各类问题的责任归属与响应路径，请前往[问题上报与支持路径](./support-escalation)。上线前的准备类问题见[上线前常见问题](./pre-go-live)。