通用场景
ant.merchant.expand.shop.create 中创建商户,创建拒绝后通过本接口返回结果
公共请求参数
参数 | 类型 | 是否必选 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
notify_id | string | 必选 | 50 | 通知id | 5608cccc09ddb39d41c2e3c06e3d9fejh2 |
utc_timestamp | string | 必选 | 13 | 消息发送时的服务端时间 | 1514210452731 |
msg_method | string | 必选 | 100 | 消息接口名称 | ant.merchant.expand.shop.save.rejected |
app_id | string | 必选 | 20 | 消息接受方的应用id | 2014060600164699 |
version | string | 必选 | 5 | 版本号(1.1版本为标准消息) | 1.0或者1.1 |
biz_content | string | 必选 | 消息报文 | 参见消息属性 | |
sign | string | 必选 | 签名 | wco t3d8kg71dtlkwn7r9pzuoxeabjwp8/fousxcuskxsovyxbpsaidpryscjhcjmaglncjokjqlj28/asl93jotw39fx6i07lxhnbpknezalwmvpdnqui01hzszf9v1i6ggzjbiad5lg8bzttxzoj87ub2i9guj3nr/nuc9vey= | |
sign_type | string | 必选 | 10 | 签名类型 | rsa2 |
charset | string | 必选 | 10 | 编码集,该字符集为验签和解密所需要的字符集 | utf-8 |
消息属性
order_id|申请单id必选string(32)
【描述】申请单id
【示例值】2018011900502000000005124744
reason|拒绝原因必选string(256)
【描述】拒绝原因
【示例值】资料有问题,拒绝
shop_id|门店id必选string(32)
【描述】支付宝侧门店id,门店创建成功后支付宝返回的店铺 id。
【示例值】2020081400077000000001112602
shop_name|门店名称必选string(128)
【描述】店铺名称
【示例值】支付宝(西溪路店)
out_biz_no|外部订单号可选string(36)
【描述】外部业务号,前四位为约定的系统标识符,四位以后部分为外围传入的外部单号
【注意事项】仅部分直付通场景可用
【示例值】0001119901210328000565010000
store_id|外部门店编号可选string(32)
【描述】商家侧门店编号,创建门店时由商家自定义传入的编号值。
【示例值】no0001
消息示例
默认示例
curl -x post 'notify_url' \
--header 'content-type: application/x-www-form-urlencoded; charset=utf-8' \
--data-urlencode 'charset=utf-8' \
--data-urlencode 'biz_content={
"order_id":"2018011900502000000005124744",
"reason":"资料有问题,拒绝",
"shop_id":"2020081400077000000001112602",
"shop_name":"支付宝(西溪路店)",
"out_biz_no":"0001119901210328000565010000",
"store_id":"no0001"
}' \
--data-urlencode 'utc_timestamp=${now}' \
--data-urlencode 'sign=${sign}' \
--data-urlencode 'app_id=${appid}' \
--data-urlencode 'version=1.1' \
--data-urlencode 'sign_type=rsa2' \
--data-urlencode 'notify_id=${notify_id}' \
--data-urlencode 'msg_method=ant.merchant.expand.shop.save.rejected'
说明:notify_url是开发者在开放平台控制台上设置的应用网关地址
通知应答
响应报文 | 描述 | 是否重试 | 是否区分大小写 |
---|---|---|---|
success | 消息处理成功 | 否 | 否 |
fail | 消息处理失败 | 是 | 否 |
说明:消息服务会根据响应报文判断商户系统是否已经成功处理消息。如果http同步响应报文返回 success 字符串,消息服务则认为消息已经处理成功,停止投递,如果返回 fail ,表示消息获取失败,支付宝会根据投递重试策略重新发送消息到应用网关地址;
投递重试策略:一般情况下,25 小时以内完成 8 次通知,除了第一次是实时投递外,后续的每次重试都会间隔一段时间,间隔频率一般是:2m、10m、10m、1h、2h、6h、15h(第二次消息投递是在第一次投递失败后的 2 分钟;第三次投递是在第二次投递失败后的 10 分钟,以此类推)
接口工具
消息服务文档
获取sdk