翼支付商户接入规范-条码支付分册V1.4(2)选读.doc

翼支付商户接入规范 条形码支付 修订历史记录 日期 版本 说明 修订 2015.06.08 1.0 初稿 林健，张善良 2015.07.15 1.1 新增2.1下单业务返回码 新增2.2查询接口 新增2.3退款http接口（含分账） 废弃2.5退款ws接口 废弃2.6分账退款ws接口 新增2.4冲正http接口 废弃2.7冲正ws接口 刘永富 林健 韦家驹 2015.07.20 1.2 修订及完善查询接口相关文档 韦家驹 2015.07.21 1.3 下单接口返回值调整。增加HTTP退款和冲正接口的相关文档 韦家驹 2015.12.21 1.4 查询接口增加退款标志，及支付账户号 韦家驹 目录 1. 引言 7 1.1 编写目的 7 1.2 编写原则 7 1.3 读者对象 7 1.4 需求来源 7 1.5 术语定义 7 2. 条码支付 7 2.1 下单支付 7 2.1.1 接口描述 7 2.1.2 接口地址 8 2.1.3 接口参数 8 2.1.4 接口响应 9 2.1.5 响应示例 10 2.1.6 接口说明 10 2.1.7 客户端测试用例 11 2.2 查询 13 2.2.1 接口描述 13 2.2.2 接口地址 13 2.2.3 接口参数 14 2.2.4 接口响应 14 2.2.5 响应示例 15 2.2.6 接口说明 15 2.2.7 客户端测试用例 16 2.3 退款 16 2.3.1 接口描述 16 2.3.2 接口地址 16 2.3.3 接口参数 17 2.3.4 接口响应 18 2.3.5 响应示例 18 2.3.6 接口说明 18 2.3.7 客户端测试用例 19 2.4 冲正 20 2.4.1 接口描述 20 2.4.2 接口地址 20 2.4.3 接口参数 20 2.4.4 接口响应 21 2.4.5 响应示例 22 2.4.6 接口说明 22 2.4.7 客户端测试用例 22 2.5 退款【建议使用2.3】 23 2.5.1 接口描述 23 2.5.2 接口地址 23 2.5.3 接口参数 24 2.5.4 接口响应 24 2.5.5 响应示例 24 2.5.6 接口说明 25 2.5.7 客户端测试用例 25 2.6 分账退款【建议使用2.3】 26 2.6.1 接口描述 26 2.6.2 接口地址 26 2.6.3 接口参数 26 2.6.4 接口响应 27 2.6.5 响应示例 27 2.6.6 接口说明 27 2.6.7 客户端测试用例 28 2.7 冲正【建议使用2.4】 28 2.7.1 接口描述 28 2.7.2 接口地址 29 2.7.3 接口参数 29 2.7.4 接口响应 30 2.7.5 响应示例 30 2.7.6 接口说明 30 2.7.7 客户端测试用例 30 2.8 交易结果通知接口 31 2.8.1 接口描述 31 2.8.2 接口地址 31 2.8.3 接口定义 32 2.8.4 接口说明 33 3. 条码支付交互流程 34 4. 权限申请 35 5. 响应码说明 35 6. 商品信息填写说明 43 引言 编写目的 本文档的目的是为翼支付条码产品定义一个标准接口规范，以帮助外部商户更好的接入翼支付网关平台系统。 编写原则 根据翼支付系统管理规范，从业务人员的角度对需求的阐述，以及对需求描述的细化程度。此文档将在开发过程随着需求的变更而更改和修订。 读者对象 本手册的读者对象默认为:接入翼支付条码产品的商户开发人员。 需求来源 产品部门 术语定义 条码支付 下单支付 接口描述 接口名称 商户下单支付 接口描述 商户请求翼支付网关，生成订单且支付 HTTPS 传输方式 Post 数据编码 Utf-8 接口提供者 翼支付网关平台 接口使用者 商户 接口地址 生产地址 /barcode/placeOrder 接口参数 属性 含义 类型 长度 必填 备注 merchantId 商户号 n 30 M 由翼支付网关平台统一分配 subMerchantId 子商户号 ans 30 O 由商户平台自己分配，在做支付时，可以一并发送过来，翼支付网关平台可以负责记录，如没有可以不填写 barcode 条形码号 n M 商户POS扫描用户客户端条形码 orderNo an 30 M 由商户平台提供，数字或字母组成 orderReqNo 订单请求交易流水号 an 30 M 由商户平台提供，数字或字母组成 channel 渠道 n 5 M 默认填05 busiType 业务类型 a 5 M 默认填01 orderDate 订单日期 n 20 M 由商户提供，长度14位 格式yyyyMMddhhmmss orderAm