payment 模板¶
建议基于 agreements/payment/<version>/agreement.json。
典型商户侧能力分组:
- 支付方式发现
- 支付单创建
- 支付单状态查询
- 支付单关闭
- 退款请求创建
- 退款状态查询
推荐建模规则:
- 协议层保持 provider-neutral
- 由商户服务通过
provider和actionType暴露可用付款方式 - provider-specific 的执行细节不要进入协议层
- 支付动作可使用
cashier_url、payment_required、redirect_url、qr_code、deeplink、form_post等类型
推荐拆分:
- 商户服务实现
payment协议 - 用户侧 agent 决定自己是否已经安装了匹配的 provider 插件或 skill
- 例如支付动作返回
provider = alipay时,agent 可以调用已安装的 Alipay 插件或 skill 完成 provider-specific 的执行步骤