接入指南 -凯发app官方网站

第三方应用产品

第三方应用授权

三方开发基础

代开发核心api包

应用aes密钥管理

商家费率申请

服务市场基础

api 列表

服务商代运营基础

spi 三方服务

更新时间：2024-08-01 11:38:53

文档更新记录 >

订阅更新

我的文档

设置

简介

完成

接入准备

后，服务商可根据本文指引快速集成服务市场基础包功能，调用接口管理订单及服务。

订单状态的流转示意图：

注意

：

●

文档中的示例代码是用来阐述 api 基本使用方法的，仅针对大众场景，供服务商参考，特殊情况还请服务商自行扩展，确保符合自身业务需求。

●

能力政策答疑、签约审核超时、签约申请被驳回等问题，可拨打 4007585858 咨询。

调用接口

服务市场发送订购通知

商家订购服务后，服务市场会推送订单通知

alipay.open.servicemarket.order.notify（服务市场商户确认订购通知接口）

给第三方应用的应用网关，实际收到的是 post 请求，参数在请求参数中。

订购通知示例

https://www.merchant.com/receive_notify.htm?notify_type=servicemarket_order_notify¬ify_id=91722adff935e8cfa58b3aabf4dead6ibe¬ify_time=2017-02-16 21:46:15&sign_type=rsa2&sign=wco t3d8kg71dtlkwn7r9pzuoxeabjwp8/fousxcuskxsovyxbpsaidpryscjhcjmaglncjokjqlj28/asl93jotw39fx6i07lxhnbpknezalwmvpdnqui01hzszf9v1i6ggzjbiad5lg8bzttxzoj87ub2i9guj3nr/nuc9vey=&commodity_order_id=null&order_time=null&title=null&name=null&merchant_pid=null&contactor=null&phone=null&order_item_num=null&total_price=null&biz_type=null&item_code=am011501000000079408&specifications=套餐一&package_count=1000&period_day=180&order_ticket=201603bb189131e708054fc589c9b2b5188cdd00&service_code=00000000&isv_ticket=0ba634751542795277522707125886&consumer_miniappid=2018112160475050&merchant_shop_id=2019081500502000000025130577&miniapp_release_bundle=1032,1096&promoter_master_name=某某服务商名称&promoter_master_pid=2088xxxxx

通知中的参数说明

参数	是否必传	描述	示例值
commodity_order_id	是	订单编号。用于订单明细回查使用，回查接口 alipay.open.servicemarket.order.query（服务市场订单明细查询接口）。	-
order_time	是	订购时间。	-
title	是	服务名称。	-
name	是	商户名称。	-
merchant_pid	是	商户的 uid。	2088xxxxx
contactor	是	联系人。	张xx
phone	是	联系电话。	13550xxxxxx
order_item_num	是	门店数。	-
total_price	是	订单价格。	-
biz_type	是	所属业务分类（例如排队）。	-
item_code	否	服务 itemcode。	am011501000000079408
specifications	否	规格名称。	套餐一
package_count	否	套餐数量。	1000
period_day	否	订购周期（天）。	180
order_ticket	否	订单授权码。	201603bb189131e708054fc589c9b2b5188cdd00
service_code	否	服务码。	00000000
isv_ticket	否	服务商透传的商户标识，此处回传服务商在拼接线下推广授权链接时填入的 ticket 的值。	0ba634751542795277522707125886
consumer_miniappid	否	小程序的 appid。	2019112100000050
merchant_shop_id	否	商家门店 id。	2019081500502000000025130577
miniapp_release_bundle	否	小程序发布的端信息，支持多个端时使用英文逗号分隔。 1032=支付宝，1033=钉钉，1034=高德，1050=淘宝，1051=天猫精灵，1053=香港版支付宝，1055=mpaas，1096=支付宝 iot，3727=阿里车。	1032,1096
promoter_master_name	否	订购关联推广商主账号名称。	某某服务商名称
promoter_master_pid	否	订购关联推广商主账号 pid。	2088xxxxx

服务市场订单状态变更消息通知

服务市场订单状态变更，通知服务商订单消息。服务商可以通过通知的消息内容回查该订单明细。回查接口

alipay.open.servicemarket.order.query（服务市场订单明细查询接口）

。

消息示例

消息属性

参数中文名	参数英文名	类型	是否必选	最大长度	描述	示例值
订单编号	order_no	string	必选	24	订单中主订单号。	202211220000000008715778
子订单编号	order_line_no	string	必选	24	子订单唯一编号。	202211220000000008698650
商品 code	item_code	string	必选	20	订购商品 code。	am010101000000113908
下单时间	order_time	string	必选	32	订购时间。	2022-11-22 15:07:47.531303
订单状态变更时间	operate_time	string	必选	32	订单状态变更操作时间，例如取消订单，取消操作时间。	2022-11-22 15:08:14.970142
订单状态	status	string	必选	32	merchant_orded（待服务商接单），wait_for_payment（待支付），isv_accepted（服务商已接单），merchant_checking（实施待确认），confirmed（订单确认），wait_for_submit_confirm（下单待确认），done（已完成），merchant_cancelled（商家取消），isv_rejected（服务商回绝），isv_cancelled（服务商取消）。	merchant_cancelled
取消原因	cancel_memo	string	可选	256	订单被取消时，取消原因。	未按时实施
订单取消主体	cancel_operator_type	string	可选	10	merchant：商户 isv：服务商	merchant
订单取消时间	cancel_time	string	必选	32	订单被取消时的操作时间。	2022-11-22 15:08:14.970142