更新时间：2024-11-07 14:37:31配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档完成 后，商家和服务商可根据本文指引快速集成 小程序服务。说明：●小程序服务 仅支持自研商家/服务商通过 自研应用 或 第三方应用 代调用方式，调用 api 接入。●小程序服务 支持沙箱调试。流程概览名词解释服务：每一个有小程序页面承载，可以在支付宝客户端内分发，让用户在支付宝客户端内打开，并享受完整用户体验的产品功能都可以当做一个独立的服务。service_xml（服务 xml）：服务接入接口中服务 xml（service_xml）参数，在不同的行业申请接入服务时，有不同的参数接入标准要求（例如字符长度差异、可选值范围不同等），支付宝将针对入参要求进行校验，请务必按照规范进行接入。详情可查看 。各行业对应 服务类型、category_id（行业类目id） 参数 code 及 service_xml 模板可查看 ，部分行业需提供线下门店（shop_id）相关信息。serviceurl：明确的服务功能页 url。能在页面中明确呈现单一的功能内容，且点击后此功能可用，例如：线上类租机服务、线下类服务自提、外卖等，此类线下类服务页面需要页面可自行根据用户情况进行 lbs 路由。接入步骤获取类目 id商家/服务商需根据自身服务类型及行业，选择 中对应的 行业类目id（category_id）。查询服务 schema 规则商家/服务商可通过 查询对应行业类目服务提报的 service_xml，后续将作为服务提报的 service_xml 参数值使用。注意事项●不同行业 schema 内容不同，schema 规则详情可查看 。●为提升商家/服务商处理效率，支付宝提供了 java 及 php 版 ，协助商家/服务商完成 xml 文件的拼装，其它语言暂无。如需在线编辑 schema 内容可自行搜索“xml格式在线解析”进行操作。●若服务中需关联门店信息，例如：shopid（门店 id），需添加 蚂蚁门店管理 创建门店获取。service_xml 响应示例提报服务商家/服务商可调用 发起服务提报申请。注意事项●不同行业 schema 内容不同，提报的 schema 请按照 接口查询得到的格式，schema 规则详情可查看 。●为提升商家/服务商处理效率，支付宝提供了 java 及 php 版 ，协助商家/服务商完成 xml 文件的拼装，其它语言暂无。●单次提报 poi 最多 500 个。●提报的 url 中 & 需要转义为 &。●服务提交后由人工进行审核，审核时效一般在 1-3 个工作日，审核结果：○以 通知为准，可查看下文 消息通知 > 服务审核通知。○还可通过 ，传入 service_code 查询确认。●如果是 values 数据需要再其中加一组 value 例如 ，且 value 值前后不能有空白。填充内容后的 service_xml 示例首次提报服务首次提报服务场景，通过 category_id、service_xml 和 schemaversion 等信息创建服务。修改服务商家/服务商可调用 发起服务提报修改申请。通过 service_code 、schema_version、service_xml 修改指定服务内容。注意事项●支持修改 审核驳回，审核通过 状态的服务。●仅需传入要更新的 service_xml 部分，未传内容将保持不变。●需传入 service_code（服务编码）对指定的已提报服务做修改操作。填充内容后的 service_xml 示例查询服务商家/服务商可调用 ，通过 service_code 查询指定服务状态。响应 service_xml 示例批量查询服务商家/服务商可调用 查询当前账号 appid 下的服务列表，支持 service_name、category_id 维度的查询。删除服务商家/服务商可调用 传入 service_code 删除指定服务。消息通知第一步：验签商家/服务商可使用支付宝 sdk 根据 数据验签 指引，使用应用密钥信息验证 异步通知消息 来源是否为支付宝。第二步：反馈消息接收结果收到异步通知并 通过验签 后，商家/服务商需返回 success 表示消息获取成功，支付宝就会停止发送异步通知。如果返回 fail 或其它值，表示消息获取失败，支付宝会根据 投递重试策略 重新发送消息到应用网关地址。说明：在接收异步通知后进行验签，如果验签成功输出 success，验签失败返回 fail，重新接收异步通知进行处理。响应值描述是否重试fail消息获取失败重试success消息获取成功不重试服务审核通知提交服务申请后，支付宝将在审核通过或被驳回时使用 向商家/服务商 应用网关 地址发送审核结果通知。注意事项●消息通知说明详情，可查看 from 蚂蚁消息通知。●若商家/服务商网络环境比较复杂，如：通过统一网关间连互联网，推荐使用网络兼容性更好的标准 http(s) 协议进行对接。●本消息接口会在添加服务接入产品后自动订阅。消息通知示例
