用途:让 AI 代理代表用户完成支付。用户授权一次后,代理即可创建支付会话并获取令牌化卡凭证,用于在商户网站结账。
主要能力:通过 Prava CLI 完成代理与用户账户的关联、状态检查、创建支付会话并轮询获取卡凭证。返回的凭证包括 16 位 Visa 网络令牌(用作卡号)、3 位一次性动态 CVV(用作 CVV)和令牌有效期,凭证 30 分钟内有效。
必要用法:先确认 CLI 是否安装,which prava;未安装则运行 npm install -g @prava-sdk/cli(权限失败可用 sudo),安装后验证 prava --version。CLI 每次 API 调用会自动检查更新;若提示严重更新需先执行 npm update -g @prava-sdk/cli,技能更新用 npx skills update prava-agent-payments -g。
支付流程:1)运行 prava status,active 则继续,pending 则让用户打开审批链接并立即运行 prava setup poll,未配置则运行 prava setup 并展示链接,随后立即 poll;2)创建会话前确认商户名称与 URL、商品及真实价格、总额字符串、币种、商品描述,不得编造;3)运行 prava sessions create 并附参数,命令会打印支付 URL 和 session ID,退出后立即运行 prava sessions poll --session-id <id>(轮询最长 10 分钟),用户同时在浏览器打开支付 URL;4)拿到凭证后立即通过浏览器自动化在商户站完成结账,期间不要再询问用户。
常用命令:prava setup --name "<name>" [--description "<desc>"]、prava setup poll、prava status、prava sessions create 与 prava sessions poll。stdout 为可读输出,stderr 为错误文本;退出码 0 成功,1 错误,2 代理未配置或未批准。
限制与注意:不要猜测金额、币种或购买上下文;不要向用户索要密钥、卡号或凭证(认证在本地处理);不要在获取凭证后暂停结账。资料未提供支持的币种范围、地区限制、收费标准与具体商户覆盖信息。