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

# 常见问题

> 上线前后最常遇到的问题：开户时效、KYB/KYC 被拒重提、信息唯一性、卡数量上限、卡号获取、托管人、实体卡升级、资金模式选择与 Webhook 兜底。

## 📄 正文

本组问题来自合作伙伴在接入与运营期的高频咨询。若您的问题不在其中，请联系 DCS 团队。

## 常见问题

**Q1. 提交公司开户后多久出结果？**

先完成 KYB 再调用接口创建公司。公司开户是异步流程：接口只同步返回申请单 ID 与 `PENDING`。结果经 `ORGANIZATION_CREATED` / `ORGANIZATION_REJECTED` 推送，也可按申请单 ID 轮询查询。受理成功不等于开户成功，拿到 `organizationApplyId` 后不要直接开卡，公司创建成功后按照[快速开始](../getting-started/quickstart)中的流程进行下一步。

**Q2. KYB / KYC 被拒还能再提交吗？**

能。用 resubmit 沿用同一申请单 ID 重新送审，支持再次修正后重新提交。只有当前为 `REJECTED` 时才允许，在途或已成功会返回状态冲突。

**Q3. 邮箱、手机号能复用吗？**

不能。同一合作伙伴下公司邮箱、员工邮箱、员工手机号、公司注册号都唯一，且占用后即使被拒也不释放。想换这些信息走 resubmit 或「更新员工信息」，不要用新的外部 ID 重申。

**Q4. 员工改名字会重新做 KYC 吗？**

会。若已有在途 KYC 返回 `KYC_IN_REVIEW`，待出结果后重试。

**Q5. 一个公司 / 员工能开几张卡？**

有上限，分公司级与持卡人级两档，活卡与在途申请合并计数，超限返回 `CARD_LIMIT_EXCEEDED`。具体数值对接时与支持人员确认。

**Q6. 什么时候能拿到卡号？能拿完整卡号吗？**

建卡成功（`CARD_CREATED`）后即可查询，但常规接口只返回前 6 与后 4 位。需要完整卡号 / CVV2 / 有效期走 retrieve-secure-card 接口查询，前提是持有 PCI DSS 资质。

**Q7. 为什么申请公司卡一定要传托管人？**

托管人是卡片联系人，须为本公司在职（ACTIVE）员工。卡片有问题时联系托管人处理；消费遇 3DS 挑战需托管人完成验证。

**Q8. 虚拟卡转实体卡之后我这边的卡 ID 和绑定关系要改吗？**

不用。虚拟卡转实体卡是同号升级，`cardId`、卡号、有效期、CVV2 都不变，始终是同一个卡对象。激活后按实体卡生效。

**Q9. 公司资金池模式和独立余额模式该选哪个？**

要「多卡统一花、集中记账」选公司资金池；要「一卡一预算、花完为止、账目隔离」选独立余额卡。

**Q10. 余额不够怎么第一时间知道？**

给公司配置余额不足预警：按币种设阈值，跌破即推送 `LOW_BALANCE`，配了邮箱还额外发邮件；通知一天一次，直至余额回补。

**Q11. 异步接口怎么知道最终结果？**

两条通道都用：主通道 Webhook 事件，兜底通道查询接口按申请单 ID 或外部唯一标识轮询。凡同步返回 `PENDING` / `PROCESSING` 的都进本地待办队列定时轮询；资金划拨返回 `PROCESSING` 时必须轮询确认。

**Q12. Webhook 没收到怎么办？**

重试窗口只有约 3 分钟（最多 4 次投递），回调服务停机超过此窗口会漏事件，务必用查询接口进行兜底。事件不保证顺序，以 `webhookId`（雪花 id，单调递增）+ 资源当前状态为准。

**Q13. 请求签名失败怎么排查？**

按错误码定位。验签失败最常见是待签名串拼错：GET 用原始查询串（无参数则空串），POST 用请求体原文（勿重新序列化），按 `apiKey + timestamp + nonce + payload` 拼接，HMAC 取小写 Hex。Webhook 验签是另一套（先字段名字典序排序再紧凑序列化）。

## 下一步

* 签名与 Webhook 的完整规范：[快速开始](../getting-started/quickstart)
* 按业务域组织的使用指南：[管理公司](../how-to-use/managing-companies)、[管理卡片](../how-to-use/managing-cards)