Paystack 各支付方式对 NIN 的支持情况
结论：Paystack 绑卡/后续扣款与 WebPay 不要求、也不消费客户 NIN，因此 NIN 客户可正常使用，但不能据此认定 Paystack 已核验 NIN。对金融服务类商户，Paystack Dedicated Virtual Account 的公开客户校验仍要求 BVN 与该 BVN 关联的银行账户；当前没有公开依据表明 NIN 可替代 BVN。
1. 目标与适用范围
本文用于明确已完成 NIN KYC 的尼日利亚客户，在以下 Paystack 支付方式中的准入和处理规则：
- 银行卡绑定及后续 Authorization 扣款；
- Dedicated Virtual Account（专属虚拟账户）；
- WebPay / Hosted Checkout；
- 支付方式展示、失败降级、数据归属、埋点和验收。
本文不把支付通道当作 KYC 主系统，也不展开接口、报文、SDK 或代码实现。NIN 的采集、核验和保存仍归属 KYC / 风控体系。
2. 支持口径
| 口径 | 定义 |
|---|---|
| 原生支持 NIN | 供应商在该能力中有明确的 NIN 身份输入或账户关联规则 |
| 兼容 NIN 客户 | 该支付方式本身不需要 BVN/NIN，NIN 客户可使用，但供应商不消费或核验 NIN |
| NIN 不可替代 | 该能力明确要求 BVN 或其他身份材料，公开资料没有说明 NIN 可替代 |
| 待商务确认 | 公开能力存在，但当前商户号权限、费率、额度、银行覆盖或生产开通状态尚未确认 |
3. 能力结论
| 支付方式 | Paystack 模式 | 对 NIN 的结论 | NIN 客户能否使用 | 关键边界 |
|---|---|---|---|---|
| 绑卡 | 首次卡支付或卡授权后保存可复用 authorization | 兼容 NIN 客户，不原生消费 NIN | 可以 | 成功标准是实际获得可复用授权；不能用已采集 NIN 代替持卡人认证、3DS、OTP 或银行校验 |
| 后续扣款 | 使用可复用 Authorization 发起扣款 | 兼容 NIN 客户，不原生消费 NIN | 可以 | 仅对供应商明确返回可复用的授权发起；支付成功不等于 NIN 核验成功 |
| Dedicated Virtual Account | 客户校验后分配专属虚拟账户 | NIN 不可替代 BVN | NIN-only 客户不可以；具备合规 BVN 条件后可以 | 本业务属于金融服务场景，公开规则要求 BVN 与其关联银行账户完成客户校验 |
| WebPay | Hosted Checkout / Redirect | 兼容 NIN 客户，不原生消费 NIN | 可以 | 初始化和支付结果不依赖 NIN；跳回商户页面不代表支付成功，必须以可信支付结果为准 |
4. 产品决策
4.1 绑卡与 Authorization 扣款
- 用户 KYC 身份类型为 NIN 时，不因缺少 BVN 而隐藏或阻断 Paystack 绑卡入口。
- 绑卡前仍需取得用户对保存银行卡并用于后续扣款的明确授权。
- 只有供应商最终确认卡授权可复用时，才把该卡标记为“已绑定、可后续扣款”。
- 仅完成一次卡支付、页面返回成功、收到中间态或生成授权记录但不可复用，均不得视为绑卡成功。
- 后续扣款沿用原卡授权、客户和商户归属，不允许因为用户持有 NIN 而跨客户或跨业务线复用授权。
- NIN 不发送到支付备注、扩展信息、跳转地址或前端页面；支付链路只读取“已通过 KYC”及稳定的身份类型结果。
4.2 Dedicated Virtual Account
- 对 NIN-only 客户，不申请 Paystack Dedicated Virtual Account。
- 支付方式路由应优先提供支持 NIN 的 Monnify Reserved Account；若当前不可用，则继续提供银行卡或 WebPay，不伪造 Paystack 虚拟账户成功态。
- 客户同时具备有效 BVN 和与其关联的银行账户，并完成要求的客户校验后，才可进入 Paystack 虚拟账户分配流程。
- NIN 即使已采集、已核验，也不能替代上述 BVN 条件，除非 Paystack 后续提供正式书面能力说明并完成生产验证。
- 虚拟账户创建中的处理中、超时、失败或未收到最终结果，不得向用户展示可收款账户。
4.3 WebPay
- NIN 客户可正常进入 Paystack WebPay，不新增 NIN 输入项。
- WebPay 页面不得展示、拼接或透传 NIN。
- 用户从 Paystack 页面返回仅表示流程返回；订单支付结果以服务端确认的交易状态和金额为准。
- 支付失败、取消、处理中或未知结果时，保留原订单和原支付参考，不直接生成一笔新的跨通道支付。
5. 前置条件与状态规则
- KYC 已输出可信的身份类型和核验状态；支付系统不直接读取或二次核验 NIN 原文。
- 当前业务线和商户号已启用对应 Paystack 能力，且用户、订单、金额和支付方式均满足既有支付准入条件。
- 绑卡按“未发起—处理中—已绑定/失败”管理；只有可复用授权确认后进入“已绑定”。
- 虚拟账户按“未申请—校验中—分配中—可用/失败”管理；只有最终返回真实账户后进入“可用”。
- WebPay 按“待支付—处理中—成功/失败/取消/未知”管理；未知结果必须查询原交易，不得直接按失败重开。
- 任一支付状态都不得覆盖 KYC 状态；任一 KYC 状态也不得伪造支付成功。
6. 角色与责任边界
| 责任方 | 责任 |
|---|---|
| KYC / 风控 | 采集、核验并保存 NIN/BVN；输出身份类型、核验状态和可使用范围，不向前端支付埋点暴露证件原文 |
| 支付中台 | 根据支付方式和身份条件判断准入；保存 Paystack 实际支付/授权/虚拟账户结果；处理中不得按成功处理 |
| App / H5 | 展示可用支付方式、用户动作和最终结果；不采集或展示 Paystack 不需要的 NIN |
| 运营 / 客服 | 使用稳定失败分类解释原因；不得要求客户通过聊天、截图或日志补交完整 NIN |
7. 异常与边界场景
| 场景 | 处理规则 |
|---|---|
| NIN-only 客户进入还款页 | 展示 Paystack 绑卡/WebPay；不展示 Paystack 专属虚拟账户，存在 Monnify 可用账户时展示 Monnify |
| 已有 Paystack 虚拟账户的历史客户切换为 NIN KYC | 保留历史账户状态，重新核对其原客户校验依据；不得仅因 NIN 已通过就认定账户合规 |
| 授权不可复用 | 绑卡失败或不可用于后续扣款，引导重新绑卡或选择 WebPay，不保存为可扣款卡 |
| 支付成功但 NIN 未核验 | 支付按真实结果入账；KYC 仍保持未通过，两个状态不得相互覆盖 |
| 虚拟账户申请处理中或超时 | 不展示账户号；保留处理中并查询原申请结果，禁止重复创建 |
| Paystack 后续新增 NIN 能力 | 先取得官方文档或书面确认，再完成测试、风控和合规评审后更新本需求 |
8. 前端埋点要求
| 页面/场景与 owner | 关键事件 | 唯一触发时机 | 核心属性及来源 | 指标/漏斗 |
|---|---|---|---|---|
| 还款方式页，App/H5 | payment_method_view | 可用支付方式列表首次完整展示 | provider、payment_method、kyc_id_type、eligibility_result，来自服务端资格结果 | 各身份类型支付方式可见率 |
| 还款方式页，App/H5 | payment_method_select | 用户选中一种支付方式 | provider、payment_method、kyc_id_type，来自当前选择与服务端上下文 | 方式选择率 |
| 绑卡页，App/H5 | bind_card_submit | 用户确认提交绑卡且请求实际发出一次 | provider=paystack、kyc_id_type、session_id | 绑卡提交率 |
| 绑卡结果页，App/H5 | bind_card_result | 收到可信业务结果并首次展示 | provider=paystack、status、error_code、authorization_reusable，来自服务端结果 | 绑卡成功率、可复用率 |
| 支付结果页，App/H5 | payment_result | 服务端确认结果并首次展示 | provider=paystack、payment_method、status、error_code、真实 trace_id | WebPay 成功率、未知结果率 |
埋点不得包含 NIN 原文、BVN、卡号、账户号、OTP、姓名、原始错误文本、Authorization code 或供应商原始响应。event_name、event_page 均使用稳定值；支付成功/失败必须来自可信业务结果，不能用按钮点击或页面跳回代替。
9. 验收标准
- NIN-only 客户可进入 Paystack 绑卡并完成可复用授权，不被错误要求补 BVN。
- NIN-only 客户可使用 Paystack WebPay，页面和支付请求链路不新增 NIN 输入或透传。
- NIN-only 客户不能申请 Paystack Dedicated Virtual Account，并获得可用的替代支付方式。
- 同时具备合规 BVN 条件的客户仍可按既有规则申请 Paystack 虚拟账户，NIN 不改变该校验条件。
- 绑卡、WebPay、虚拟账户的处理中、失败、成功状态相互独立，支付结果不反写为 KYC 成功。
- 所有前端事件满足稳定命名、单次触发、属性来源明确和敏感信息不采集要求。
- 上线前已用当前商户号确认 Authorization、WebPay、Dedicated Virtual Account 的生产权限、额度、银行覆盖和回调能力。
10. 官方依据与待确认项
官方资料核对日期：2026-08-24。
- Paystack Charge Card
- Paystack Recurring Charges
- Paystack Accept Payments
- Paystack Dedicated Virtual Accounts
- Paystack Validate Customer
上线前仍需 Paystack 书面确认：当前商户主体是否开通相关能力；金融服务类 Dedicated Virtual Account 是否新增 NIN 替代路径；生产限额、费率、支持银行、授权复用范围和异常处理时效。未确认前按本文保守边界执行。