用途:该技能封装 Paystack Payment Requests(发票)API,用于为商品和服务创建和管理发票,向客户发送付款请求。它依赖 paystack-setup 提供的 paystackRequest 辅助方法;客户代码可参考 paystack-customers。
主要能力与端点:POST /paymentrequest 创建付款请求;GET /paymentrequest 列出;GET /paymentrequest/:id_or_code 获取;PUT /paymentrequest/:id_or_code 更新;GET /paymentrequest/verify/:code 验证;POST /paymentrequest/notify/:code 发送通知;GET /paymentrequest/totals 获取汇总指标;POST /paymentrequest/finalize/:code 将草稿定稿;POST /paymentrequest/archive/:code 归档。创建参数包括 customer(必填)、amount(子单位,无行项目时用)、due_date(ISO 8601)、description、line_items(name/amount/quantity)、tax(name/amount)、currency(默认 NGN)、send_notification(默认 true)、draft(默认 false)、has_invoice、invoice_number、split_code。
使用方式:通过 paystackRequest 发起调用,例如创建含行项目与税费的发票时传 customer、description、due_date、line_items、tax 等;草稿发票设 draft: true 不发送通知。列表可带 status、currency、perPage 查询参数。定稿时可传 { send_notification: true }。返回示例中 request_code 形如 PRQ_1weqqsn2wwzgft8;totals 返回 pending/successful/total 按币种汇总。
适用场景:需要程序化开具发票、跟踪待付与已付金额、补发通知、管理草稿和归档记录的场景。
限制:金额以子单位表示;默认货币为 NGN,可指定 currency;实际费用、价格、地区支持等资料未提供;需先完成 paystack-setup 配置。