Skip to main content

📄 正文

开户、建员工、发卡,每类对象都有自己的状态机;冻结则是叠加在状态之上的能力域开关。本页把它们一次讲清,后续接口里的状态字段即可对号入座。

申请状态机

公司、员工、卡三类申请共用一套状态机,三个状态:PENDING / SUCCEED / REJECTED。被拒后可按同一申请单 ID 重提(详见合规与 KYC)。
申请状态机申请状态机

公司 / 员工状态机

呈现为一个合并状态字段:生命周期(ACTIVE / TERMINATED)叠加行为状态(FROZEN / SUSPENDED / RESTRICTED)。判断能否开卡 / 消费以是否 ACTIVE 为准。
公司 / 员工状态机公司 / 员工状态机

卡状态机

7 个状态,虚拟卡与实体卡采用同一套状态定义。每次状态变更系统都会推送卡状态变更通知(激活单独推送 CARD_ACTIVATED),事件名以 API 参考的 Webhook 事件表为准。
卡状态机卡状态机

冻结能力域

5 个能力域,适用于公司或员工。加状态即冻结、删状态即解冻,幂等集合语义;风控 / 监管 / 司法写入的受限态不可经此解除。 冻结的粒度有两级:冻结卡只停该卡,冻结员工则该主体名下所有卡拒绝交易。操作接口见公司状态与预警员工信息与状态

下一步