SuperAPI AI 工具集

prava-wallet

智能体与模型

查看项目

更新于 10-16 03:47

技能介绍

用途:让 AI 智能体代替用户完成购买、下单或缴费,并解答关于 Prava 产品的问题。

主要能力:通过 Prava CLI 关联智能体与用户 Prava 账户;一次批准后创建支付会话,输出令牌化卡凭证(16 位 Visa network token、一次性动态 CVV、有效期),供浏览器自动化在商户结账时使用;也可回答 Prava 的产品、安全、定价、支持卡种等问题,规则是只能照参考文档直答,不可臆测,未覆盖则说明并指向 support@prava.space 或 https://docs.prava.space。

使用方式:先检查 CLI:which prava;未安装则 npm install -g @prava-sdk/cli(权限不足可 sudo npm install -g @prava-sdk/cli),随后 prava --version。每次 API 调用会自动检查更新,若提示需运行 npm update -g @prava-sdk/cli,或 npx skills update prava-wallet -g。支付前必须依次执行 which prava 和 prava status。状态为 active 进入下一步;pending 则提醒用户打开批准链接,并立即运行 prava setup poll;显示 No agent configured 时先执行智能体接入,平台自动判断,名称按用户指定或默认名确认,再运行 prava setup --name "<name>" --platform <platform>。

发起购买前须确认商户名称与含 https:// 的完整 URL、商品(含真实价格)、总金额字符串、ISO 4217 货币码、商户国家 ISO 3166-1 alpha-2 及每件商品描述;缺失时先补齐,不可编造。然后执行:prava sessions create --total-amount "8.50" --currency USD --merchant-name "Blue Bottle Coffee" --merchant-url "https://bluebottlecoffee.com" --merchant-country US --product '{"description":"Latte","unit_price":"5.00","quantity":1}' --product '{"description":"Croissant","unit_price":"3.50","quantity":1}',将输出 URL 给用户后立即运行 prava sessions poll --session-id <session_id>,轮询最长 10 分钟;返回凭证后立即在商户站点完成结账,凭证 30 分钟内有效。

适用场景:购物代付、账单支付、智能体支付接入等。

限制:多商户请求需逐商户串行处理,不可并行或批量结账;信息类问题不运行 CLI;不要向用户索要卡号或密钥;待批准时不要重跑 setup,只有 CLI 明确输出 "Link expired" 才可重跑;退出码 0 成功、1 错误、2 未配置或未批准。