SuperAPI AI 工具集

paystack-dedicated-accounts

编程与开发

查看项目

更新于 10-16 07:59

技能介绍

用途:通过 Paystack Dedicated Virtual Account(DVA)API,为商户客户创建并管理唯一虚拟银行账号,用于收款与对账。面向尼日利亚和加纳商户。依赖 paystack-setup 提供的 paystackRequest 辅助函数;分账场景可参考 paystack-subaccounts 与 paystack-splits。

主要能力与端点:POST /dedicated_account 为已有客户创建 DVA;POST /dedicated_account/assign 一步创建客户并分配 DVA;GET /dedicated_account 列出账户;GET /dedicated_account/:id 获取单个账户;GET /dedicated_account/requery 重新查询新交易;DELETE /dedicated_account/:id 停用账户;POST /dedicated_account/split 为 DVA 交易添加分账;DELETE /dedicated_account/split 移除分账;GET /dedicated_account/available_providers 列出可用银行提供方。

使用方式:先检查可用提供方,例如调用 paystackRequest("/dedicated_account/available_providers"),返回 provider_slug、bank_id、bank_name(如 wema-bank、Wema Bank)。创建 DVA 时必填 customer(客户 ID 或代码),可选 preferred_bank(银行 slug,如 wema-bank、access-bank)、subaccount、split_code、first_name、last_name、phone。一步分配需提供 email、first_name、last_name、phone、preferred_bank、country(NG 或 GH),可选 account_number、bvn、bank_code、subaccount、split_code。列表支持 active、currency(NGN 或 GHS)、provider_slug、bank_id、customer 过滤。完整流程通常为:查提供方、创建或复用客户、创建 DVA、向用户展示账号用于银行转账、通过 charge.success webhook 确认支付。

限制:资料未提供收费、价格、额度或具体平台限制;仅支持尼日利亚与加纳相关货币与银行提供方,需依赖 paystack-setup helper,且分账需通过 subaccount 或 split_code 配置。