用途：指导在 Paystack 测试模式下验证集成，避免使用真实密钥与真实扣款。环境配置使用 sk_test_ 与 pk_test_ 前缀密钥，测试模式不产生真实扣款，Webhook 发往测试地址，转账为模拟，卡片校验为模拟。测试卡号包括 4084 0840 8408 4081（成功，PIN 为 1234）、5060 6666 6666 6666 666（Verve 成功）、5078 5078 5078 5078 12（余额不足）、4000 0000 0000 0002（拒付）；PIN 为 1234，OTP 为 123456，电话 08012345678，生日 1999-12-31。
主要能力：提供 TypeScript/Vitest 形式的交易初始化与验证、客户创建与查询、计划与订阅、转账收款人与转账、银行卡解析与列表等接口测试示例，以及 Webhook 签名的校验与模拟测试。
使用方式：依赖 paystack-setup 的 paystackRequest 辅助函数调用 https://api.paystack.co 接口；本地测试 Webhook 可运行 npm run dev，再用 npx localtunnel --port 3000 或 ngrok http 3000 暴露端口，并在 Dashboard 设置测试 Webhook URL。Vitest 配置建议设置 testTimeout 为 30_000，并在 setup 中校验密钥必须以 sk_test_ 开头。
适用场景：Paystack 支付、订阅、转账与 Webhook 的集成测试。限制：资料仅覆盖测试模式；真实密钥、价格、收费、具体上线操作与生产环境细节暂未提供。上线前需确认所有测试通过、Webhook 签名三类用例通过、交易流程与错误响应、幂等性，并切换 sk_live_/pk_live_ 密钥、配置生产 Webhook URL，Webhook 来源 IP 为 52.31.139.75、52.49.173.169、52.214.14.220。