SuperAPI AI 工具集

paystack-terminal

编程与开发

查看项目

更新于 10-16 07:59

技能介绍

用途:通过 Paystack Terminal API 构建线下面对面支付体验,面向使用 Paystack POS 终端的场景。该技能依赖 paystack-setup 提供的 paystackRequest 辅助函数。

主要能力(接口):POST /terminal/:terminal_id/event 发送事件;GET /terminal/:terminal_id/event/:event_id 查询事件送达状态;GET /terminal/:terminal_id/presence 检查终端可用性;GET /terminal 列出终端;GET /terminal/:terminal_id 获取终端详情;PUT /terminal/:terminal_id 更新终端;POST /terminal/commission_device 激活终端;POST /terminal/decommission_device 停用终端。

发送事件参数:type 必填,取 invoice 或 transaction;action 必填,invoice 用 process 或 view,transaction 用 process 或 print;data 必填,为事件数据对象。发票处理需传发票 id 与离线 reference,交易打印需传交易 id。

使用方式:发送事件前应先检查终端可用性,确认 presence 返回的 online 与 available 均为真后再发送。发送事件后可用事件 id 查询 delivered 状态确认送达。列表接口使用游标分页,通过 meta.next 与 meta.previous 翻页。终端详情包含 id、serial_number、terminal_id、name、address、status。激活与停用需提供 serial_number。

适用场景:线下收款、门店发票处理、交易凭证打印、终端状态与可用性检查、终端信息维护及设备启用停用管理。

限制:全部接口依赖 paystack-setup 的 paystackRequest 辅助函数;事件不得在终端离线或不可用时发送;具体收费、价格、平台及更多端到端步骤资料暂未提供。