用途:在 Paystack 集成中创建与管理客户记录。客户在首次扣款时会自动创建,也可显式创建。该技能依赖 paystack-setup,用于提供 paystackRequest 辅助函数与环境配置。
主要能力与端点:客户管理方面,POST /customer 创建客户,GET /customer 列出客户(支持 perPage、page、from、to),GET /customer/:email_or_code 获取客户详情(含 transactions、subscriptions、authorizations),PUT /customer/:code 更新客户。身份与风控方面,POST /customer/:code/identification 通过银行账户验证客户身份,返回 202 异步处理,需监听 customeridentification.success 或 customeridentification.failed webhook;POST /customer/set_risk_action 可将客户设为白名单(allow)、黑名单(deny)或默认(default)。授权与直接借记方面,POST /customer/authorization/initialize 创建可复用授权码,GET /customer/authorization/verify/:reference 验证授权,POST /customer/:id/initialize-direct-debit 关联银行账户,PUT /customer/:id/directdebit-activation-charge 触发激活扣款,GET /customer/:id/directdebit-mandate-authorizations 获取授权委托,POST /customer/authorization/deactivate 永久停用已保存授权。
使用方式:创建客户需 email 必填,first_name、last_name、phone、metadata 可选;在博彩、金融服务或通用服务类别下分配专用虚拟账户时,姓名与电话变为必填。身份验证必填 country、type(仅支持 bank_account)、account_number、bvn、bank_code、first_name、last_name。授权初始化必填 email 与 channel(仅支持 direct_debit)。
限制:身份验证为异步,需通过 webhook 获取结果;authorization/initialize 的 channel 仅支持 direct_debit;identification 的 type 仅支持 bank_account;相关调用均通过 paystackRequest 发出,需先完成 paystack-setup 依赖配置。其余未在资料中说明的事项暂未提供。