服务商代运营操作结果通知接口
公共参数
公共请求参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
notify_id | String | 是 | 50 | 通知ID | 5608cccc09ddb39d41c2e3c06e3d9fejh2 |
utc_timestamp | String | 是 | 13 | 消息发送时的服务端时间 | 1514210452731 |
msg_method | String | 是 | 100 | 消息接口名称 | alipay.open.sp.operation.result.notify |
app_id | String | 是 | 20 | 消息接受方的应用id | 2014060600164699 |
msg_type | String | 否 | 5 | 消息类型。目前支持类型:sys:系统消息;usr,用户消息;app,应用消息 | sys |
msg_uid | String | 否 | 20 | 消息归属的商户支付宝uid。用户消息和应用消息时非空 | 2088102165945162 |
msg_app_id | String | 否 | 20 | 消息归属方的应用id。应用消息时非空 | 2016032301002387 |
version | String | 是 | 5 | 版本号(1.1版本为标准消息) | 1.0或者1.1 |
biz_content | String | 是 | 消息报文 | 参见具体的消息接口文档 | |
sign | String | 是 | 签名 | WcO+t3D8Kg71dTlKwN7r9PzUOXeaBJwp8/FOuSxcuSkXsoVYxBpsAidprySCjHCjmaglNcjoKJQLJ28/Asl93joTW39FX6i07lXhnbPknezAlwmvPdnQuI01HZsZF9V1i6ggZjBiAd5lG8bZtTxZOJ87ub2i9GuJ3Nr/NUc9VeY= | |
sign_type | String | 是 | 10 | 签名类型 | RSA2 |
encrypt_type | String | 否 | 10 | 加密算法 | AES |
charset | String | 是 | 10 | 编码集,该字符集为验签和解密所需要的字符集 | UTF-8 |
notify_type | String | 否 | 20 | [1.0版本老协议参数]通知类型,1.1接口没有该参数 | trade_status |
notify_time | String | 否 | 19 | [1.0版本老协议参数]通知时间,北京时区,时间格式为:yyyy-MM-dd HH:mm:ss,如果服务器部署在国外请注意做时区转换。若version=1.1则可以使用utc_timestamp识别时间 | 1970-01-01 00:00:00 |
auth_app_id | String | 否 | 20 | [1.0版本老协议参数]授权方的应用id | 2016032301002387 |
消息属性
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
operate_type | String | 必选 | 32 | 代运营操作类 型。 ACCOUNT_BIND:代表绑定支付宝账号,仅对于间连商户。 OPERATION_AUTH:代表代运营授权,支持间连和直连商户,其中间连场景包含绑定支付宝账号。 | ACCOUNT_BIND |
batch_no | String | 必选 | 64 | 支付宝批次号 | 20202314234243 |
out_biz_no | String | 必选 | 64 | 外部操作流水,发起代运营操作时传入的out_biz_no。 | 2020124234523465636345634 |
handle_status | String | 必选 | 32 | 代运营操作结果。 SUCCESS:商家确认操作成功。 NO_PERMISSION:表示当前商家支付宝账号无权限操作,请确认商家支付宝账号是否在推荐账号列表中。 NONE_ACCOUNT:间连商家推荐支付宝账号列表为空。 | SUCCESS |
merchant_no | String | 必选 | 32 | 被代运营的商户号 | 2088XX |
bind_user_id | String | 特殊可选 | 32 | 当被代运营者(merchant_no)为间连商户,且商家确认成功时有值,返回间连商户绑定的支付宝账号。 | 2088XX |
响应值
响应值 | 描述 | 是否重试 |
---|---|---|
fail | 消息获取失败 | 是 |
success | 消息获取成功 | 否 |
触发通知示例
ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"operate_type":"ACCOUNT_BIND","batch_no":"20202314234243","out_biz_no":"2020124234523465636345634","handle_status":"SUCCESS","merchant_no":"2088XX","bind_user_id":"2088XX"
}
&msg_method=alipay.open.sp.operation.result.notify&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2¬ify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==
修改于 2023-11-23 09:23:47