API 能力清单:收款付款发卡与身份核验
官方开发者文档(docs 站点)把 API 按「收、付、卡、身份、多币种」组织。本页按原文结构整理能力清单,给技术选型做速查。
六大模块速查
- 收款(Collect Payments):
- Payment Links:托管收银台,一个链接聚合多个支付网关,买家自选支付方式(含美元支付,需申请)。
- Direct Payments(虚拟账户):为企业分配专属 NUBAN 账户号,客户从任意银行转账,款项统一落入钱包。
- 付款(Make Payments):
- Transfers:经 API 或商户后台向尼日利亚任意银行账户付款,面向金融服务商、商户与市场平台;非洲、欧洲、美国的更多国家在扩展中。
- Bill Payments:代售话费、流量、电费、有线电视订阅,每笔交易赚佣金,后台出报表。
- 卡(Cards):
- Virtual Cards:为客户发卡与充值,全生命周期管理——冻结、充值、提现、销卡。
- Physical Cards:实体借记卡发行、申请状态跟踪、激活、流水与 PIN 管理。
- 身份核验(Identity & Verification):
- BVN / NIN 核验:入网前对照国家身份数据库验证客户身份(分基础与高级模式)。
- Liveness Check:人脸活体检测,用于入网或高风险动作。
- Customers:创建与管理 KYC 分级(一级或全量)的终端用户。
- 多币种(Multi-Currency):
- Global Accounts:奈拉钱包之外持有与管理美元、欧元等币种余额。
- Sub-Accounts:一个主体下挂多个业务实体,适合平台型商户代自己的商家入驻。
- 权限(Access & Limits):多数接口在 API Key 之外还需申请服务授权(Service Grant),接卡、转账、身份类功能前先看文档的权限章节。
接入顺序建议
- 注册商户后台,获取 Public Key 与 Secret Key。
- 读文档的 Authentication 章节,完成第一个请求。
- 按业务申请对应服务授权。
- 沙箱验证后再切生产环境。
API 细节以官方开发者文档为准,接口与字段可能随版本演进。
相关阅读:Boldd 平台概览、插件接入。