用途:通过 Interswitch Payment Links API 在 Quickteller Business 平台创建可分享的支付链接,让客户在托管支付页完成付款,无需自行构建结账 UI。链接可经邮件、短信、WhatsApp 分享,支持卡(Verve、Visa、Mastercard)、银行转账、USSD、二维码等非卡支付方式,并可自定义金额、描述与到期时间,跟踪链接状态和收款情况。
主要接口:POST /api/v1/payment-links 创建;GET /api/v1/payment-links 列表;GET /api/v1/payment-links/{linkId} 详情;PUT /api/v1/payment-links/{linkId} 更新;DELETE /api/v1/payment-links/{linkId} 停用。创建请求字段包括 name、description、amount(以 kobo 计的固定金额,0 表示可变金额)、currency('NGN')、type('ONE_TIME' 或 'REUSABLE')、redirectUrl、customerEmail、expiryDate、metadata 及 customFields(字段类型 TEXT、EMAIL、PHONE、NUMBER)。响应含 linkId、url、status(ACTIVE、EXPIRED、DEACTIVATED)、paymentCount、totalCollected 等。
典型场景:发票支付链接(固定金额、一次性、带到期时间)、捐赠页(amount 为 0 的可变金额、可复用)、活动门票(可复用并带自定义字段)。支付链接事件通过 webhook 发送,如 PAYMENT_LINK.CREATED 与 PAYMENT_LINK.COMPLETED。
使用要求:需先获取认证头(getAuthHeaders()),并配置环境变量 INTERSWITCH_BASE_URL;调用使用 fetch 与 JSON。文档建议:一次性链接设置到期时间;用 metadata 关联业务记录;停用过期或未用链接;重定向后务必在服务端验证支付;用 totalCollected 和 paymentCount 做统计。
限制:资料未提供具体认证流程、价格、速率限制及错误码说明,暂未提供。