3. 服务市场订购及获得预授权
服务市场订购即预授权
商户端通过小程序服务市场(钱包小程序搜索「蚂蚁服务市场」)订购服务之后。支付宝会向该服务的第三方应用网关发送一条订购通知。通知中订单授权凭证字段为:order_ticket,该字段作为后续创建事务、代创建小程序、代签约及提交事务接口的入口参数传递。ISV可以根据该通知实施该服务。
服务市场商户确认订购通知
接口名称:alipay.open.servicemarket.order.notify接口说明:该接口为异步通知接口。当商户在服务市场订购了服务商的产品时,支付宝会以POST请求方式向服务商应用网关发送订单通知。服务商可以通过通知的消息内容回查该订单明细,回查接口为alipay.open.servicemarket.order.query。开发者在接受到异步通知后,需要对收到的内容进行验签,验证是否是支付宝发送的,验签请使用SDK中的rsaCheckV2。注意:通知接口处理需要注意幂等性校验,因网络等问题通知可能会重发。
通知参数
参数 | 类型 | 长度 | 描述 | 范例 |
---|---|---|---|---|
notify_type | String | 64 | 通知的类型。 | servicemarket_order_notify |
app_id | String | 32 | 支付宝分配给开发者的应用Id | 2017122701358951 |
method | String | 128 | 接口名 | alipay.open.servicemarket.order.notify |
version | String | 3 | 调用的接口版本,固定为:1.0 | 1.0 |
notify_id | String | 128 | 通知校验ID | cb27759ec6f02a068679eb3c9daace7lse |
timestamp | String | 19 | 格式"yyyy-MM-dd HH:mm:ss" | 2018-01-07 17:02:40 |
notify_time | String | 19 | 通知的发送时间。格式为yyyy-MM-dd HH:mm:ss | 2018-01-07 17:02:40 |
sign_type | String | 10 | 商户生成签名字符串所使用的签名算法类型,RSA2 | RSA2 |
sign | String | 256 | 签名结果 | TexpUQ/Fc2oazKx13VdZNAbA3K… |
charset | String | 10 | 编码格式,如utf-8、gbk、gb2312等 | UTF-8 |
commodity_order_id | String | 22 | 订单编号(用于订单明细回查使用) | 2016022900000000747857 |
order_time | String | 19 | 订购时间 | 2016-01-01 00:00:01 |
title | String | 128 | 服务名称 | XX服务 |
name | String | 64 | 商户名称 | 张三 |
merchant_pid | String | 16 | 商户ID | 2088411964574193 |
contactor | String | 64 | 联系人 | 王五 |
phone | String | 32 | 联系电话 | 18000000000 |
order_item_num | String | 7 | 门店数量 | 1 |
total_price | String | 10 | 总价格 | 5000.00 |
order_ticket | String | 64 | 订单授权码,用于事务创建接口中的入参 | 201603BB189131e708054fc589c9b2b5188cdD00 |
service_code | String | 32 | 服务码,用于商户和ISV匹配订单 | 00000000 |
收到通知后响应的参数
程序执行完后必须打印输出“success”(不包含引号,并且不要输出换行符)。如果商户反馈给支付宝的字符不是"success"这7个字符,支付宝服务器会不断重发通知,直到发送8次通知(通知的间隔频率一般是:4m,10m,10m,10m,1h,5h,10h)。