Skip to main content

📄 正文

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

常见问题

Q1. 提交公司开户后多久出结果? 先完成 KYB 再调用接口创建公司。公司开户是异步流程:接口只同步返回申请单 ID 与 PENDING。结果经 ORGANIZATION_CREATED / ORGANIZATION_REJECTED 推送,也可按申请单 ID 轮询查询。受理成功不等于开户成功,拿到 organizationApplyId 后不要直接开卡,公司创建成功后按照快速开始中的流程进行下一步。 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 验签是另一套(先字段名字典序排序再紧凑序列化)。

下一步