Skip to main content

​
📄 正文

员工是最终持卡人，也是公司卡的托管人来源。创建员工会异步走 KYC 姓名筛查，通过后才能为其发卡。本页讲清创建、结果处理与信息维护的调用细节。

​
第一步：创建员工

POST /open-api-corp/customer/v1/apply（所属公司须 ACTIVE）。
唯一性规则：同一合作伙伴下，员工邮箱与手机号（区号 + 号码）跨公司唯一，占用后即使被拒也不释放（EMAIL_DUPLICATE / PHONE_DUPLICATE）。地址国家命中制裁名单返回 COUNTRY_SANCTIONED。

​
第二步：拿 KYC 结果

以 Webhook CUSTOMER_CREATED / CUSTOMER_REJECTED 为主，GET /open-api-corp/customer/v1/query-apply 兜底（按 customerApplyId 或您侧的 customerApplyRef 查）。status=SUCCEED 时返回 customerId（请落库）；REJECTED 时 rejectMessage 给出原因。 被拒后重提：POST /open-api-corp/customer/v1/resubmit，传 customerApplyId + 修正后的姓名三段，沿用同一申请重新送审；非 REJECTED 状态调用返回 STATUS_CONFLICT。

​
维护信息与状态

查询员工详情：GET /open-api-corp/customer/v1/query?companyId=e7c9a1f0-3b52-4d8e-9a67-1f2b3c4d5e6f&customerId=...，返回姓名、联系方式、状态与地址列表（未维护过为空）。 更新员工信息：四类信息各走一个接口，路径即意图： 冻结 / 解冻：POST /open-api-corp/customer/v1/update-restrictions，语义与公司完全一致（addRestrictions / removeRestrictions，仅限 5 个能力域码）。冻结员工后，该员工名下所有卡拒绝交易。

​
关联 Webhook

CUSTOMER_CREATED / CUSTOMER_REJECTED / CUSTOMER_STATUS_CHANGED（携 addRestrictions / removeRestrictions 与 remark）。

​
下一步