对接准备（以测试门店和测试服务为例）
1、 应用（如果还没有自己的应用，可见创建应用：[url]https://openclub.alipay.com/read.php?tid=1606&fid=25[/url]）
（1）如果是商户自己开发，需要添加口碑码战略、当面付功能，当面付需要签约，有BD请联系BD签约，如若没有BD,并且不清楚如何签约，可参考：[url]https://openclub.alipay.com/read.php?tid=276&fid=72[/url]
（2）如果是ISV代商户开发，需要ISV在自己的应用添加口碑码战略、第三方应用授权功能，商户签约当面付产品，商户第三方应用授权给ISV,建议ISV在回流数据的时候传入APP_auth_token参数，创建支付订单的时候必须传递APP_auth_token参数
注：我们强烈建议回流数据和APPID和创建支付订单的APPID是同一个，如若不是，请务必保证回流数据的APPID和创建支付订单的APPID同属一个PID
2、 测试服务（集成阶段建议使用测试服务，可参考测试服务创建办法:[url]https://openclub.alipay.com/read.php?tid=3988&fid=72[/url]）
3、 测试门店（集成阶段建议使用测试门店，可参考测试门店创建办法:[url]https://openclub.alipay.com/read.php?tid=4013&fid=71[/url]） ，测试门店默认有显示服务card的能力，正式门店需要扫码点菜验收通过后才露出显示服务card的能力
4、 测试门店订购并上架测试服务，上架测试服务之后，用户扫该门店的桌码或者门店码会跳转到门店服务card的欢迎页，底部插件区有“点餐”按钮，如图：
5、 点击服务card上面的“开始点菜”按钮或者插件区的“点餐”按钮会跳转测试服务的用户访问地址上面。（如果不清楚用户访问地址，请回到第2步）
6、 用户在点菜页面点菜下单之后，需要回流数据
（1） 回流11状态（用户下单、等待商家确认）数据，代码demo:
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", AlipayConfig.app_id,AlipayConfig.merchant_private_key,"json","GBK",AlipayConfig.alipay_public_key,"RSA2"); AlipayOfflineProviderUseractionRecordRequest request = new AlipayOfflineProviderUseractionRecordRequest(); //request.putOtherTextParam("app_auth_token","201801BB6b27c190986b4dac9e85e66d5aec7X35");第三方应用授权 request.setBizContent("{" + //集成阶段传递此参数，传递之后，在支付宝钱包-口碑tab-我-我的订单-服务订单中显示一条数据，正式环境默认有显示服务订单的能力，不用传递此参数 "\"is_test_user\":\"1\","+ "\"source\":\"alipay.com\"," + "\"action_type\":\"order_dishes\"," + "\"industry\":\"REPAST\"," + "\"order_type\":\"order_dish\"," +//扫码点菜场景此参数必填，传递order_dish参数标志这是一笔扫码点菜的数据 "\"user_id\":\"2088712969xxxxxx\","+//user_id以2088开头，建议传递，此参数会影响服务card的实时刷新，可通过用户信息授权接口获取 "\"date_time\":\"2018-01-26 14:24:30\"," + "\"action_detail\":{"+ "\"totalPrice\":\"11\","+ //总价，这里需要注意的是单位分 "\"discountPrice\":\"11\","+ //优惠金额，这里需要注意的是单位分 "\"realPrice\":\"11\","+ //实际支付，这里需要注意的是单位分 //从第三方平台进入开发者应用，后产生的数据，传入第三方平台域名，字段内容不做强制校验。 //比如当前数据是支付宝扫码后产生，传入支付宝域名alipay.com；微信传入微信域名weixin.qq.com；口碑传入口碑域名koubei.com；如果数据不是从第三方平台进入后产生的数据，设置自己的域名即可 "\"source\":\"alipay.com\","+ "\"status\":\"11\","+ //11 用户下单、等待商家确认 "\"outOrderId\":\"20180126145930111\","+ //外部订单号，这里需要注意的是，从用户下单，商家确认，待支付，支付完成，是一笔订单 "\"tableCode\":\"A05\","+ //桌号，此参数必填，该参数会影响该餐台的card更新 "\"people\":\"2\","+//消费人数，建议传递 //detailUrl参数必传，直接影响到支付宝钱包-口碑tab-我-我的订单-服务订单，点击一条数据后跳转的链接。此参数传递要求详见文档 "\"detailUrl\":\"http://17675wt546.iok.la:29682/pc/notify_url.jsp\","+ /*需要注意的是price参数的单位是分！！！*/ "\"dish\":[{\"goodsId\":\"216137\",\"price\":2,\"num\":1,\"goodsName\":\"酱爆茄子\"}],"+//菜品列表，需要注意的price参数是单位分 "\"statusDesc\":\"待商家确认\","+//状态文案说明，会影响card左上角的文案。请准确描述当前的状态 //行动点对象列表，每次更新全量覆盖,此参数会直接影响服务card上面的按钮显示。请准确描述当前的状态 //String name ; 行动名称（比如，去买单、加菜,查看详情，再来一单） //String actionUrl 跳转URL，建议ISV自行对该url进行加签验签，以避免被恶意程序拦截篡改 //String type URL类型（官方常量 addDish（加菜） pay （去买单），官方会根据类型做业务逻辑，如果不在官方说明，请设置为空） "\"actionUrlList\":[{\"name\":\"查看详情\",\"actionUrl\":\"http://www.ieasy360.com\",\"type\":\"\"}," + "{\"name\":\"加菜\",\"actionUrl\":\"http://www.ieasy360.com\",\"type\":\"pay\"}],"+ //与当前订单有关系的用户，传入json数组，此参数建议传递，也会直接影响到服务card的实时刷新 //如果不是支付宝用户不需要传入，如果order_channel是alipay，强制校验，必须要传入 //userId (支付宝用户ID) //type (用户ID行为类型),type 可以选择设置字符串value：pay，pushOrder，normal //type各value值含义说明： //pay：支付者 //pushOrder：下单的用户 //normal：普通用户，没有做特殊说明的都是普通用户 "\"realtionUserList\":[{\"userId\":\"2088712969xxxxxx\",\"type\":\"pushOrder\"}]"+ "}," + //店铺关联关系。标记当前接口涉及到的店铺信息，同时如果传入的数据在口碑不存在，口碑会建立一条shop_id+outer_id+type的关联数据 //传递之后，请不要再修改此参数 "\"outer_shop_do\":{"+ "\"shop_id\":\"20170803000770000000xxxxxxxx\","+//门店id "\"outer_id\":\"123456\","+//ISV系统中与口碑店铺shop_id关联的ISV店铺主键 "\"type\":\"http://17675wt546.iok.la:29682/pc/notify_url.jsp\""+//建议直接传入ISV的域名 "},"+ "\"entity\":\"user\"," + "\"action_outer_id\":\"20180126145930111\"," +//每次请求的唯一id，需开发者自行保证此参数值每次请求的唯一性 "\"order_channel\":\"isv\"" +//该字段建议填写。值定义：alipay、weixin、other、isv "}"); AlipayOfflineProviderUseractionRecordResponse response; try { response = alipayClient.execute(request); if (response.isSuccess()) { System.out.println("调用成功" + response.getBody()); } else { System.out.println("调用失败" + response.getBody()); } } catch (AlipayApiException e) { e.printStackTrace(); }finally { } }（2）回流13状态（待支付）数据，代码demo:
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", AlipayConfig.app_id,AlipayConfig.merchant_private_key,"json","GBK",AlipayConfig.alipay_public_key,"RSA2"); AlipayOfflineProviderUseractionRecordRequest request = new AlipayOfflineProviderUseractionRecordRequest(); //request.putOtherTextParam("app_auth_token","201801BB6b27c190986b4dac9e85e66d5aec7X35");第三方应用授权 request.setBizContent("{" + //集成阶段传递此参数，传递之后，在支付宝钱包-口碑tab-我-我的订单-服务订单中显示一条数据，正式环境默认有显示服务订单的能力，不用传递此参数 "\"is_test_user\":\"1\","+ "\"source\":\"alipay.com\"," + "\"action_type\":\"order_dishes\"," + "\"industry\":\"REPAST\"," + "\"order_type\":\"order_dish\"," +//扫码点菜场景此参数必填，传递order_dish参数标志这是一笔扫码点菜的数据 "\"user_id\":\"2088712969xxxxxx\","+//user_id以2088开头，建议传递，此参数会影响服务card的实时刷新，可通过用户信息授权接口获取 "\"date_time\":\"2018-01-26 14:38:30\"," + "\"action_detail\":{"+ "\"totalPrice\":\"33\","+ //总价，这里需要注意的是单位分 "\"discountPrice\":\"33\","+ //优惠金额，这里需要注意的是单位分 "\"realPrice\":\"33\","+ //实际支付，这里需要注意的是单位分 //从第三方平台进入开发者应用，后产生的数据，传入第三方平台域名， //比如当前数据是支付宝扫码后产生，传入支付宝域名alipay.com //是在微信打开后产生的数据，传入微信域名weixin.qq.com //是在口碑打开后产生的数据，传入口碑域名koubei.com //如果数据不是从第三方平台进入后产生的数据，设置自己的域名即可 //字段内容不做强制校验。 "\"source\":\"alipay.com\","+ "\"status\":\"13\","+ //13商家确认，用户待支付 //外部订单号，这里需要注意的是，从用户下单，商家确认，待支付，支付完成，是一笔订单 "\"outOrderId\":\"20180126145930111\","+ "\"tableCode\":\"A05\","+ //桌号，此参数必填，该参数会影响该餐台的card更新 "\"people\":\"2\","+//消费人数，建议传递 //detailUrl参数必传，直接影响到支付宝钱包-口碑tab-我-我的订单-服务订单，点击一条数据后跳转的链接 //传入要求参考文档要求 "\"detailUrl\":\"http://17675wt546.iok.la:29682/pc/notify_url.jsp\","+ //菜品列表 //goodsId菜品ID,自定义 //goodsName 菜品名称,自定义 //price 价格，单位为分,自定义 //num 点菜数量（int）,自定义 "\"dish\":[{\"goodsId\":\"216137\",\"price\":2,\"num\":1,\"goodsName\":\"酱爆茄子\"}],"+//菜品列表 "\"statusDesc\":\"待支付\","+//状态文案说明，会影响card左上角的文案。请准确描述当前的状态 //行动点对象列表，每次更新全量覆盖,此参数会直接影响服务card上面的按钮显示。请准确描述当前的状态 //String name ; 行动名称（比如，去买单、加菜,查看详情，再来一单） //String actionUrl 跳转URL，建议ISV自行对该url进行加签验签，以避免被恶意程序拦截篡改 //String type URL类型（官方常量 addDish（加菜） pay （去买单），官方会根据类型做业务逻辑，如果不在官方说明，请设置为空） "\"actionUrlList\":[{\"name\":\"查看详情\",\"actionUrl\":\"http://www.ieasy360.com\",\"type\":\"\"}," + "{\"name\":\"去支付\",\"actionUrl\":\"http://www.ieasy360.com\",\"type\":\"pay\"}," + "{\"name\":\"加菜\",\"actionUrl\":\"http://www.ieasy360.com\",\"type\":\"pay\"}],"+ //与当前订单有关系的用户，传入json数组 //如果不是支付宝用户不需要传入，如果order_channel是alipay，强制校验，必须要传入 //String userId (支付宝用户ID) //String type (用户ID行为类型),type 可以选择设置字符串value：pay，pushOrder，normal //type各value值含义说明： //pay：支付者 //pushOrder：下单的用户 //normal：普通用户，没有做特殊说明的都是普通用户 "\"realtionUserList\":[{\"userId\":\"2088712969xxxxxx\",\"type\":\"pushOrder\"}]"+ "}," + //店铺关联关系。标记当前接口涉及到的店铺信息，同时如果传入的数据在口碑不存在，口碑会建立一条shop_id+outer_id+type的关联数据 //传递之后，建议不要再修改此参数 "\"outer_shop_do\":{"+ "\"shop_id\":\"20170803000770000000xxxxxxxx\","+//门店id "\"outer_id\":\"123456\","+//ISV系统中与口碑店铺shop_id关联的ISV店铺主键 "\"type\":\"http://17675wt546.iok.la:29682/pc/notify_url.jsp\""+//建议直接传入ISV的域名 "},"+ "\"entity\":\"user\"," + "\"action_outer_id\":\"20180126145930222\"," +//每次请求的唯一id，需开发者自行保证此参数值每次请求的唯一性 "\"order_channel\":\"isv\"" +//该字段建议填写。值定义：alipay、weixin、other、isv"}"); AlipayOfflineProviderUseractionRecordResponse response; try { response = alipayClient.execute(request); if (response.isSuccess()) { System.out.println("调用成功" + response.getBody()); } else { System.out.println("调用失败" + response.getBody()); } } catch (AlipayApiException e) { // TODO Auto-generated catch block e.printStackTrace(); }（3）回流14状态（已支付）数据，并清台。代码demo:
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", AlipayConfig.app_id,AlipayConfig.merchant_private_key,"json","GBK",AlipayConfig.alipay_public_key,"RSA2"); AlipayOfflineProviderUseractionRecordRequest request = new AlipayOfflineProviderUseractionRecordRequest(); //request.putOtherTextParam("app_auth_token","201801BB6b27c190986b4dac9e85e66d5aec7X35");第三方应用授权 request.setBizContent("{" + //集成阶段传递此参数，传递之后，在支付宝钱包-口碑tab-我-我的订单-服务订单中显示一条数据，正式环境默认有显示服务订单的能力，不用传递此参数 "\"is_test_user\":\"1\","+ "\"source\":\"alipay.com\"," + "\"action_type\":\"order_dishes\"," + "\"industry\":\"REPAST\"," + "\"order_type\":\"order_dish\"," +//扫码点菜场景此参数必填，传递order_dish参数标志这是一笔扫码点菜的数据 "\"user_id\":\"2088712969xxxxxx\","+//user_id以2088开头，建议传递，此参数会影响服务card的实时刷新，可通过用户信息授权接口获取 "\"date_time\":\"2018-01-26 14:44:30\"," + "\"action_detail\":{"+ "\"totalPrice\":\"33\","+ //总价，这里需要注意的是单位分 "\"discountPrice\":\"33\","+ //优惠金额，这里需要注意的是单位分 "\"realPrice\":\"33\","+ //实际支付，这里需要注意的是单位分 //从第三方平台进入开发者应用，后产生的数据，传入第三方平台域名， //比如当前数据是支付宝扫码后产生，传入支付宝域名alipay.com //是在微信打开后产生的数据，传入微信域名weixin.qq.com //是在口碑打开后产生的数据，传入口碑域名koubei.com //如果数据不是从第三方平台进入后产生的数据，设置自己的域名即可 //字段内容不做强制校验。 "\"source\":\"alipay.com\","+ "\"status\":\"14\","+ //13商家确认，用户待支付 //下面三个参数在14状态下必传 "\"payTime\":\"\","+ //注意，这里是精确到毫秒，此参数传递错误，会影响清台后的服务card正常显示 "\"channel\":\"alipay\","+ "\"payOrderNo\":\"2018012321001004350510117761\","+ //外部订单号，这里需要注意的是，从用户下单，商家确认，待支付，支付完成，是一笔订单 "\"outOrderId\":\"20180126145930222\","+ "\"tableCode\":\"A05\","+ //桌号，此参数必填，该参数会影响该餐台的card更新 "\"people\":\"2\","+//消费人数，建议传递 //detailUrl参数必传，直接影响到支付宝钱包-口碑tab-我-我的订单-服务订单，点击一条数据后跳转的链接 //传入要求参考文档要求 "\"detailUrl\":\"http://17675wt546.iok.la:29682/pc/notify_url.jsp\","+ //菜品列表 //goodsId菜品ID,自定义 //goodsName 菜品名称,自定义 //price 价格，单位为分,自定义 //num 点菜数量（int）,自定义 "\"dish\":[{\"goodsId\":\"216137\",\"price\":2,\"num\":1,\"goodsName\":\"酱爆茄子\"}],"+//菜品列表 "\"statusDesc\":\"已支付\","+//状态文案说明，会影响card左上角的文案。请准确描述当前的状态 //代表是否清桌，默认0。1：清桌，代表桌位可以被他人使用。0：占用，代表座位正在被人使用（比如点菜中、订单没有完结，都认为是被占用中，其他人员无法再次下单） //对表现层的影响是，如果传了1，则只有支付用户和下单用户在传递的payTime参数内的半小时见realtionUserList参数）能看到card，其他用户为新的card。 //如果传了0，则所有用户扫桌码都会看到当前card。 "\"hasClosed\":\"1\","+ //行动点对象列表，每次更新全量覆盖,此参数会直接影响服务card上面的按钮显示。请准确描述当前的状态 //String name ; 行动名称（比如，去买单、加菜,查看详情，再来一单） //String actionUrl 跳转URL，建议ISV自行对该url进行加签验签，以避免被恶意程序拦截篡改 //String type URL类型（官方常量 addDish（加菜） pay （去买单），官方会根据类型做业务逻辑，如果不在官方说明，请设置为空） "\"actionUrlList\":[{\"name\":\"查看详情\",\"actionUrl\":\"http://www.ieasy360.com\",\"type\":\"pay\"}," + "{\"name\":\"再下一单\",\"actionUrl\":\"http://www.ieasy360.com\",\"type\":\"pay\"}],"+ //与当前订单有关系的用户，传入json数组 //如果不是支付宝用户不需要传入，如果order_channel是alipay，强制校验，必须要传入 //String userId (支付宝用户ID) //String type (用户ID行为类型),type 可以选择设置字符串value：pay，pushOrder，normal //type各value值含义说明： //pay：支付者 //pushOrder：下单的用户 //normal：普通用户，没有做特殊说明的都是普通用户 "\"realtionUserList\":[{\"userId\":\"2088712969xxxxxx\",\"type\":\"pay\"}]"+ "}," + //店铺关联关系。标记当前接口涉及到的店铺信息，同时如果传入的数据在口碑不存在，口碑会建立一条shop_id+outer_id+type的关联数据 //传递之后，建议不要再修改此参数 "\"outer_shop_do\":{"+ "\"shop_id\":\"2017080300077000000044490772\","+//门店id "\"outer_id\":\"123456\","+//ISV系统中与口碑店铺shop_id关联的ISV店铺主键 "\"type\":\"http://17675wt546.iok.la:29682/pc/notify_url.jsp\""+//建议直接传入ISV的域名 "},"+ "\"entity\":\"user\"," + "\"action_outer_id\":\"20180126145430111\"," +//每次请求的唯一id，需开发者自行保证此参数值每次请求的唯一性 "\"order_channel\":\"isv\"" +//该字段建议填写。值定义：alipay、weixin、other、isv "}"); AlipayOfflineProviderUseractionRecordResponse response; try { response = alipayClient.execute(request); if (response.isSuccess()) { System.out.println("调用成功" + response.getBody()); } else { System.out.println("调用失败" + response.getBody()); } } catch (AlipayApiException e) { // TODO Auto-generated catch block e.printStackTrace(); } }（4）回流15状态（一般这个状态是点餐过程中有异常情况，需要结束点餐流程的时候回流）数据。代码demo:
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", AlipayConfig.app_id,AlipayConfig.merchant_private_key,"json","GBK",AlipayConfig.alipay_public_key,"RSA2"); AlipayOfflineProviderUseractionRecordRequest request = new AlipayOfflineProviderUseractionRecordRequest(); //request.putOtherTextParam("app_auth_token","201801BB6b27c190986b4dac9e85e66d5aec7X35");第三方应用授权 request.setBizContent("{" + //集成阶段传递此参数，传递之后，在支付宝钱包-口碑tab-我-我的订单-服务订单中显示一条数据，正式环境默认有显示服务订单的能力，不用传递此参数 "\"is_test_user\":\"1\","+ "\"source\":\"alipay.com\"," + "\"action_type\":\"order_dishes\"," + "\"industry\":\"REPAST\"," + "\"order_type\":\"order_dish\"," +//扫码点菜场景此参数必填，传递order_dish参数标志这是一笔扫码点菜的数据 "\"user_id\":\"20887129xxxxxxxx\","+//user_id以2088开头，建议传递，此参数会影响服务card的实时刷新，可通过用户信息授权接口获取 "\"date_time\":\"2018-01-26 16:28:30\"," + "\"action_detail\":{"+ "\"totalPrice\":\"\","+ //总价，15状态可传空，但必传要传递此参数，否则接口调用会报错 "\"discountPrice\":\"\","+ //优惠金额，15状态可传空，但必传要传递此参数，否则接口调用会报错 "\"realPrice\":\"\","+ //实际支付，15状态可传空，但必传要传递此参数，否则接口调用会报错 //从第三方平台进入开发者应用，后产生的数据，传入第三方平台域名， //比如当前数据是支付宝扫码后产生，传入支付宝域名alipay.com //是在微信打开后产生的数据，传入微信域名weixin.qq.com //是在口碑打开后产生的数据，传入口碑域名koubei.com //如果数据不是从第三方平台进入后产生的数据，设置自己的域名即可 //字段内容不做强制校验。 "\"source\":\"alipay.com\","+ "\"status\":\"15\","+ //关闭点餐流程 //外部订单号，这里需要注意的是，从用户下单，商家确认，待支付，支付完成，是一笔订单 "\"outOrderId\":\"20180126145930222\","+ "\"tableCode\":\"A05\","+ //桌号，此参数必填，该参数会影响该餐台的card更新 //detailUrl参数必传，直接影响到支付宝钱包-口碑tab-我-我的订单-服务订单，点击一条数据后跳转的链接 //传入要求参考文档要求 "\"detailUrl\":\"http://17675wt546.iok.la:29682/pc/notify_url.jsp\","+ //与当前订单有关系的用户，传入json数组 //如果不是支付宝用户不需要传入，如果order_channel是alipay，强制校验，必须要传入 //String userId (支付宝用户ID) //String type (用户ID行为类型),type 可以选择设置字符串value：pay，pushOrder，normal //type各value值含义说明： //pay：支付者 //pushOrder：下单的用户 //normal：普通用户，没有做特殊说明的都是普通用户 "\"realtionUserList\":[{\"userId\":\"20887129xxxxxxxx\",\"
