SuperAPI AI 工具集

check-ebt-balance

编程与开发

查看项目

更新于 10-16 03:17

技能介绍

用途:引导开发者调用 Payroc API 的 POST /v1/cards/balance 端点,查询 EBT 卡可用余额(SNAP 食品券或现金福利)。该技能仅覆盖余额查询,不处理或扣减 EBT 账户;实际支付需改用 POST /v1/payments,属于另一技能范围。

主要能力:构建并发送余额查询请求,解析响应中的 balances[](benefitCategory、amount、currency),处理响应码(如 A 批准、D 拒绝、E 待处理、P 部分授权、R 联系发卡行、C 没收卡)及 RFC 7807 错误。请求支持原始卡数据(type 为 card)或单次令牌(type 为 singleUseToken);entryMethod 取值包括 icc、swiped、keyed、raw。ebtDetails.benefitCategory 仅两个合法值:cash 与 foodStamp,不可用 snap、food 等变体。一次请求只查一个福利类别,查两类需发两次请求。

必要用法:先通过身份服务获取 Bearer 令牌(UAT 为 POST https://identity.uat.payroc.com/authorize,生产为 https://identity.payroc.com/authorize,头 x-api-key),令牌有效期 3600 秒。查询端点 UAT 为 https://api.uat.payroc.com/v1/cards/balance,需头 Authorization: Bearer <token> 与 Content-Type: application/json。该端点不需要 Idempotency-Key。金额为最低货币单位(如 USD 美分,12500 即 $125.00)。

适用场景:UAT 或生产环境集成 EBT 余额查询功能。

限制:终端必须由 Payroc 配置进 EBT 共享组,普通终端会返回 400,需联系 Payroc Integrations 团队;凭据须来自环境变量或密钥管理,不可硬编码;令牌需刷新逻辑;responseCode 可选,balances[] 可能缺失;响应返回掩码卡号,不可记录完整 PAN。技能自身含版本检查步骤。具体要求与结构详见本地 references/ 文件与官方文档。