更新时间：2024-10-31 11:20:14收藏订阅更新我的文档设置返回文档1 简介完成接入准备后，服务商可根据如下步骤，获取商家代运营授权。说明：代报名返佣政策无需获取代运营授权，但间连商家需完成下文 补全商家信息 及 绑定商家支付宝账号。后续接入详见 代报名返佣政策。2 补全商家信息适用商家：仅间连商家 需补全商家信息至 m3，详情参见 间连分级商户入驻接入指南。3 绑定商家支付宝账号（可选）适用商家：仅间连商家服务商需代未绑定支付宝账号的间连商家，完成商家账户与对应支付宝账号的绑定操作。若商家账户已绑定支付宝账号或已完成代运营授权可忽略本步骤。注意：升级绑定的支付宝账号，需要与商户营业执照上的法人一致（或企业认证绑定时需要与间连商户提供的营业执照一致），否则可能无法绑定。3.1 pc 端代绑定服务商登录 服务商平台 > 服务商运营 > 商家管理 > ，点击 详情 进入商家详情页。点击 立即绑定 按要求填入需绑定支付宝账号提交申请。被绑定支付宝账户登录 查看并确认绑定申请。3.2 接口代绑定间连商户场景下，服务商通过接口发起支付宝账号代绑定申请支持申请 授权二维码 引导商家通过支付宝账号扫码，或者线下收集支付宝账号后 直接申请 绑定两种方式。3.2.1 发起代绑定申请直接申请服务商可通过线下收集需商家需绑定的支付宝账号信息，调用 alipay.open.sp.operation.apply（向商户发起代运营操作）接口，代商家绑定支付宝账号。说明：服务商调用本接口成功发起代绑定申请后，支付宝将向代绑定账号发送 push 通知，被绑定账号确认后即可绑定成功。服务商可根据下文调用查询接口，查询绑定结果。示例代码：重要参数说明：●operate_type：必填，string，代运营操作类型。枚举支持：○account_bind：代表绑定支付宝账号，仅对于间连商户。○operation_auth：代表代运营授权，支持间连和直连商户，其中间连场景包含绑定支付宝账号。●access_product_code：必填，string，接入的产品编号。绑定操作固定为 openapi_bind_default。●merchant_no：支付宝商户号。○间连场景，必填，传入商户 smid，特别注意仅支持 2088 开头的间连商户。○直连场景，merchant_no 与 alipay_account 不能同时为空（同时传入优先取 merchant_no）。传入商户支付宝 pid。●alipay_account：必填，string，支付宝登录账号。通常为手机号或者邮箱。○间连场景必填。○直连场景，merchant_no 与 alipay_account 不能同时为空（同时传入优先取 merchant_no）。授权二维码服务商可调用 alipay.open.sp.operation.qrcode.query（查询代运营授权或者账号绑定二维码）接口，获取代绑定支付宝账号二维码，引导商家使用被绑定账号扫码。示例代码重要参数说明：●operate_type：必填，string，代运营操作类型。枚举支持：○account_bind：账号绑定，仅支持间连商户。○operation_auth：代运营授权，支持间、直连商户。●access_product_code：必填，string，接入的产品编号。○openapi_bind_default：绑定账号。○openapi_auth_default：代运营授权。●merchant_no：string，支付宝商户号。注意仅支持 2088 开头的间连商户。○若被代运营者是间连商户，则 merchant_no 必填。○若为直连商户，则 merchant_no 和 alipay_account 不能同时为空，都有值优先取 merchant_no。●alipay_account：必填，string，支付宝登录账号。通常为手机号或者邮箱。○若被代运营者是间连商户，该字段无需填写。○若为直连商户，则 merchant_no 和 alipay_account 不能同时为空，都有值优先取 merchant_no。3.2.2 查询绑定结果服务商可调用 alipay.open.sp.operation.result.query（查询服务商代运营操作结果）接口，查询代商家绑定申请结果。本接口提供两种查询方式：●方式一：operate_type batch_no，提供基于操作批次的精确查询，只查询本操作批次的代运营操作结果，不反映最终代运营操作结果。 ●方式二：operate_type access_product_code merchant_no alipay_account 参数组合，可以查询代运营操作最终结果，任意一个操作批次成功都会体现在最终结果中。注意：该接口仅用于查询本次授权操作结果，请勿用于是否存在代运营授权关系的校验。（该接口与服务商平台新版基于产品颗粒度进行授权的“代操作授权”逻辑不兼容，在新版完成某个产品代操作授权后，通过该接口查询不到授权关系）。说明：●方式一查询方式优先级更高，且查询方式入参不可同时为空。●对同一个用户存在多次绑定/授权时：○batch_no 返回针对该批次操作的结果。○merchant_no alipay_account 返回针对用户维度绑定/授权最终结果，如：绑定/授权 2 次，第一次用户未确认导致不成功，但是第二次绑定成功，通过本参数组合查询返回的结果为成功。示例代码重要入参说明：●operate_type：必填，string，代运营操作类型。服务商代间连商家绑定支付宝账号时固定为 account_bind。●batch_no：string，支付宝操作批次号。服务商在上一步中发起代绑定申请时接口返回 batch_no。●access_product_code：接入的产品编号。未传 batch_no 时必填，枚举如下：○openapi_bind_default：操作类型为账号绑定。 ○openapi_auth_default：操作类型为代运营授权。●merchant_no：支付宝商户号。支持间连、直连商户，值为 2088 开头。未传 batch_no 时需注意：○若查询间连商户则 merchant_no 必填。○若查询直连商户，则 merchant_no 和 alipay_account 不能同时为空，都有值优先取 merchant_no。●alipay_account：支付宝登录账号，通常为手机号或者邮箱。未传 batch_no 时需注意：○当查询 merchant_no 为间连商户时：■若 operate_type=account_bind，则 alipay_account 必填。■若 operate_type=operation_auth，则 alipay_account 无需传入。○当查询 merchant_no 为直连商户时：■merchant_no 和 alipay_account 不能同时为空，都有值优先取 merchant_no。4 代运营授权4.1 移动端发起授权服务商登录支付宝 app 搜索 服务商助手 小程序，选择 代运营商家 完成代运营授权（授权后自动绑定支付宝账号）。●获取商家授权过程中会完成账号绑定，也可以单独完成账号绑定操作。●移动端适用于服务商到店完成，建议通过维护操作员，请地推员工到店作业。4.2 接口发起授权4.2.1 发起代运营授权接口发起代运营授权支持申请 授权二维码 引导商家通过支付宝账号扫码，或者线下收集支付宝账号后 直接申请 代运营授权两种方式。政策代报名场景，建议通过接口完成，结合上文移动端发起绑定商家代运营授权流程。直接申请服务商可通过线下收集需获取代运营的支付宝账号信息，调用 alipay.open.sp.operation.apply（向商户发起代运营操作）接口，申请商家代运营授权。说明：服务商调用本接口成功发起代运营申请后，支付宝将向对应商家账号发送 push 通知，商家确认后即可授权成功。服务商可根据下文调用查询接口，查询代运营授权结果。流程图示例代码重要参数说明：●operate_type：必填，string，代运营操作类型。枚举支持：○account_bind：代表绑定支付宝账号，仅对于间连商户。○operation_auth：代表代运营授权，支持间连和直连商户，其中间连场景包含绑定支付宝账号。●access_product_code：必填，string，接入的产品编号。代运营授权操作固定为 openapi_auth_default。●merchant_no：支付宝商户号。○间连场景，必填，传入商户 smid，特别注意仅支持 2088 开头的间连商户。○直连场景，merchant_no 与 alipay_account 不能同时为空（同时传入优先取 merchant_no）。传入商户支付宝 pid。●alipay_account：必填，string，支付宝登录账号。通常为手机号或者邮箱。○间连场景必填。○直连场景，merchant_no 与 alipay_account 不能同时为空（同时传入优先取 merchant_no）。授权二维码服务商可调用 alipay.open.sp.operation.qrcode.query（查询代运营授权或者账号绑定二维码）接口，获取代运营授权二维码，引导商家使用授权账号扫码。服务商可根据下文调用查询接口，查询代运营授权结果。流程图示例代码重要参数说明：●operate_type：必填，string，代运营操作类型。枚举支持：○account_bind：账号绑定，仅支持间连商户。○operation_auth：代运营授权，支持间、直连商户。●access_product_code：必填，string，接入的产品编号。○openapi_bind_default：绑定账号。○openapi_auth_default：代运营授权。●merchant_no：string，支付宝商户号。注意仅支持 2088 开头的间连商户。○若被代运营者是间连商户，则 merchant_no 必填。○若为直连商户，则 merchant_no 和 alipay_account 不能同时为空，都有值优先取 merchant_no。●alipay_account：必填，string，支付宝登录账号。通常为手机号或者邮箱。○若被代运营者是间连商户，该字段无需填写。○若为直连商户，则 merchant_no 和 alipay_account 不能同时为空，都有值优先取 merchant_no。4.2.2 查询授权结果服务商可调用 alipay.open.sp.operation.result.query（查询服务商代运营操作结果）接口，查询代运营申请结果。本接口提供三种查询方式：●方式一：operate_type batch_no，提供基于操作批次的精确查询，只查询本操作批次的代运营操作结果，不反映最终代运营操作结果。 ●方式二：operate_type access_product_code merchant_no alipay_account 参数组合，可以查询代运营操作最终结果，任意一个操作批次成功都会体现在最终结果中。●方式三：operate_type isv_scene_permissions merchant_no alipay_account 参数组合，可以查询代运营操作最终结果，任意一个操作批次成功都会体现在最终结果中（仅支持授权结果查询）。注意：该接口仅用于查询本次授权操作结果，请勿用于是否存在代运营授权关系的校验。（该接口与服务商平台新版基于产品颗粒度进行授权的“代操作授权”逻辑不兼容，在新版完成某个产品代操作授权后，通过该接口查询不到授权关系）。说明：●方式一查询方式优先级更高，且查询方式入参不可同时为空。●对同一个用户存在多次绑定/授权时：○batch_no 返回针对该批次操作的结果。○merchant_no alipay_account 返回针对用户维度绑定/授权最终结果，如：绑定/授权 2 次，第一次用户未确认导致不成功，但是第二次绑定成功，通过本参数组合查询返回的结果为成功。示例代码重要入参说明：●operate_type：必填，string，代运营操作类型。服务商发起代运营授权时固定为 operation_auth。●batch_no：string，支付宝操作批次号。服务商在上一步中发起代运营授权申请时接口返回 batch_no。●access_product_code：接入的产品编号。未传 batch_no 时必填，枚举如下：○openapi_bind_default：操作类型为账号绑定。○openapi_auth_default：操作类型为代运营授权。●merchant_no：支付宝商户号。支持间连、直连商户，值为 2088 开头。未传 batch_no 时需注意：○若查询间连商户则 merchant_no 必填。○若查询直连商户，则 merchant_no 和 alipay_account 不能同时为空，都有值优先取 merchant_no。●alipay_account：支付宝登录账号，通常为手机号或者邮箱。未传 batch_no 时需注意：○当查询 merchant_no 为间连商户时：■若 operate_type=account_bind，则 alipay_account 必填。■若 operate_type=operation_auth，则 alipay_account 无需传入。○当查询 merchant_no 为直连商户时：■merchant_no 和 alipay_account 不能同时为空，都有值优先取 merchant_no。响应示例重要响应说明：●handle_status：代运营操作结果。枚举支持：○success：代表成功。○process：待商家确认中。○no_permission：表示当前商家支付宝账号无权限操作。需要提醒商家切换成发起授权时指定的支付宝账号。○none：表示不存在代运营绑定或授权关系。○none_account：间连商家推荐支付宝账号列表为空。即发起申请时传入 smid 没有对应的支付宝账号。●bind_user_id：商户支付宝 pid。仅间连场景，且存在绑定关系时返回值。●merchant_no：支付宝商户号。○间连场景为商户 smid。○直连场景为商户支付宝 pid。5 消息通知服务商可在 > 控制台 > 对应应用详情页中 开发设置 > 消息服务 选项中订阅 alipay.open.sp.operation.result.notify（服务商代运营操作结果通知接口），商户在确认服务商提交的账号绑定/代运营授权申请后，支付宝将向服务商 应用网关 地址发送异步通知，反馈服务商代运营操作（代运营授权/账号绑定）的结果。说明：from 支付宝异步通知详情参见 from 蚂蚁消息服务使用。5.1 消息触发条件服务商发起代运营操作，商户通过支付宝 push 通知或扫码完成确认时触发（无论同意与否）。重复授权不会再次发送通知。5.2 消息示例消息参数说明：●operate_type：代运营操作类型。枚举支持：○account_bind：代表绑定支付宝账号，仅对于间连商户。○operation_auth：代表代运营授权，支持间连和直连商户，其中间连场景包含绑定支付宝账号。●batch_no：支付宝批次号。●out_biz_no：外部操作流水，发起代运营操作时传入的 out_biz_no。●handle_status：代运营操作结果。枚举支持：○success：商家确认操作成功。○no_permission：表示当前商家支付宝账号无权限操作，请确认商家支付宝账号是否在推荐账号列表中。○none_account：间连商家推荐支付宝账号列表为空。即发起申请时传入 smid 没有对应的支付宝账号。●merchant_no：被代运营的商户号。●bind_user_id：当被代运营者（merchant_no）为间连商户，且商家确认成功时有值，返回间连商户绑定的支付宝账号。
