更新时间：2025-06-09 14:54:09集成工具收藏订阅更新我的文档设置返回文档开通流程图说明：商家可在自有 app、小程序唤起支付宝官方提供的渲染页进行签约流程。渲染页将展示开通的业务信息，用户点击按钮并通过授权验证，进行签约确认。用户签约成功后支付宝将发送异步消息通知商家。第一步：获取用户授权商家可通过 用户授权 获取 user_id（open_id）用户支付宝 id。说明：●若只是获取用户的支付宝 user_id（open_id），可以不经过用户的授权确认，直接静默获取。●若还需获取用户其它支付宝信息，如手机号等，就需要弹出用户授权框，用户确认后才可获取。●从用户转化来讲，建议尽量只获取支付宝 user_id（open_id） 即可，用 user_id（open_id） 来绑定用户和商家会员之间的关系。第二步：签约预创单（可选）签约前可选步骤，商家拉起签约前可调用 提前传入请求号、业务时间、关键配置参数，返回预创单号。在正式拉起签约页时带入预创单号，关联到提前传入的配置。预创单作用：●提前传入签约阶段参数，简化拉起签约页参数和链接长度●后续依赖 传入动态模板配置的 template_id，实现模板配置，若无预创单则不支持。参数说明●入参详情可查看 。●商家需要保存接口返回的 preorder_no（预创单号）和 biz_type（业务身份），在拉起签约阶段传入。参数类型是否必填最大长度描述示例值preorder_nostring需要在拉起签约页阶段传入此参数64芝麻 go 预创建单号zmgo_aso2019071000020903940000062019partner_idstring必填16商家 id2088990000000000biz_typestring需要在拉起签约页阶段传入此参数64业务类型bizflag第三步：拉起签约页构造签约的 url商家 app 端传入必要参数给商家服务端，服务端调用 进行参数的加签并返回前端唤起支付宝小程序的需要的 url 参数。请求示例说明：建议使用 jsonobject 构造 bizcontent。其中 biz_content 中对应参数：参数名是否必填参数描述举例partner_id是商家 id，2088开头的商家唯一标识2088301600000000template_id是模板 id，模板配置成功后获取2019071000020903940000062019out_request_no特殊可选外部请求号，调用预创单不用传，不走预创单必传8077735255938032preorder_no特殊可选预创单号，调用预创单后，此参数必传，从预创单返回值中取；不进行预创单则不传。zmgo_aso2021012121312312312312biz_type特殊可选业务标识，调用预创单后，此参数必传，从预创单返回值中取bizflag注意：构造 request 的时候不能设置 notifyurl，否则后续签约流程会报错，暂时不支持自定义 notifyurl。响应示例拉起签约页支付宝小程序拉起签约页如果是商家支付宝小程序拉起签约页，需通过调用 my.navigatetominiprogram 跳转至官方小程序签约页。使用案例如下，按照以下示例直接进行对接即可：商家 app/h5拉起签约页如果是商家 app 拉起签约页，可构造 scheme 拉起支付宝签约页面：1判断是否安装支付宝客户端 首先判断客户端是否安装有支付宝客户端，有则打开，进入签约页面。判断有无支付宝客户端方法。○ios 平台：判断 scheme: alipays://是否能打开。○android 平台：判断 package name com.eg.android.alipaygphone 是否存在。2构造 scheme 链接上文 构造签约的 url > 响应示例 再加上前缀 alipays://platformapi/startapp?appid=2019062465587961&page=pages/hz-enjoy/pass/index?extradata=。 注意：此处 extradata 前面部分全部为固定值，不需要修改。完整 schema 示例增加签约失败的跳转链接scheme 链接还可增加 failedurl 参数，签约失败或者取消签约会跳转到对应的链接上。构造链接方式如下：failedurl 值可选项：1popwindow 失败情况下只关闭当前小程序 （不能与下文的 usepopwindow 共存）2http 链接 或者 app 的 scheme 失败情况下跳转对应链接，但是不关闭当前小程序签约成功后回跳商家 app 的唤端 url 格式说明唤端 url 即 returnurl/return_url，就像给服务器资源分配一个 url，以便外部去访问它一样，商家/服务商同样也可以给手机 app 分配一个特殊格式的 url，用来访问这个 app 或者这个 app 中的某个功能，从而实现通信。唤端 url 格式：[scheme:][//host:port][path][?query][#fragment]以 https://www.taobao.com 为例，scheme 为 https。app 得有一个标识，以便外部可以定位到它，它就是 url 的 scheme 部分。唤端淘宝 app 的url链接：taobao://www.taobao.com。因此要唤端模式接入的商家需要根据自己的 app 应用标识替换正常 url 链接中的 scheme 部分。说明：签约成功后如需回跳商家 app 指定页面，开发者需将 returnurl 替换为对应的内容。消息通知消息订阅注意事项●消息通知说明详情，可查看 from 蚂蚁消息通知。●若商家/服务商网络环境比较复杂，例如：通过统一网关间连互联网，推荐使用网络兼容性更好的标准 http(s) 协议进行对接。●该消息接口需商家进行 订阅消息。第一步：验签商家/服务商可使用支付宝 sdk 根据 数据验签 指引，使用应用密钥信息验证 异步通知消息 来源是否为支付宝。第二步：反馈消息接收结果收到异步通知并 通过验签 后，商家/服务商需返回 success 表示消息获取成功，支付宝就会停止发送异步通知。如果返回 fail 或其它值，表示消息获取失败，支付宝会根据 投递重试策略 重新发送消息到应用网关地址。说明：接收异步通知进行验签，如果验签成功输出 success；验签失败返回 fail，重新接收异步通知进行处理。响应值描述是否重试fail消息获取失败重试success消息获取成功不重试成功开通通知用户开通芝麻 go 成功后，支付宝将通过 推送签约通知至商家 应用网关 地址。消息通知示例通知参数说明商户需保存 agreement_id，后续的系统交互都以 agreement_id 识别用户身份，具体消息属性可查看 。跳转芝麻 go 管理页跳转芝麻 go 管理页链接示例：说明：商家需将字符串中 app_id、template_id、partner_id、agreement_no 替换为自己的数据。
