接入翼支付的php,翼支付商户接入规范.doc

翼支付商户接入规范

翼支付商户接入规范

条形码支付

修订历史记录

日期版本说明修订2015.06.081.0初稿林健，张善良2015.07.151.1新增2.1下单业务返回码

新增2.2查询接口

新增2.3退款http接口(含分账)

废弃2.5退款ws接口

废弃2.6分账退款ws接口

新增2.4冲正http接口

废弃2.7冲正ws接口刘永富

林健

韦家驹2015.07.201.2修订及完善查询接口相关文档韦家驹2015.07.211.3下单接口返回值调整。增加HTTP退款和冲正接口的相关文档韦家驹2015.12.211.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商户号n30M由翼支付网关平台统一分配subMerchantId子商户号ans30O由商户平台自己分配，在做支付时，可以一并发送过来，翼支付网关平台可以负责记录，如没有可以不填写barcode条形码号nM商户POS扫描用户客户端条形码orderNoan30M由商户平台提供，数字或字母组成orderReqNo订单请求交易流水号an30M由商户平台提供，数字或字母组成channel渠道n5M默认填05busiType业务类型a5M默认填01orderDate订单日期n20M由商户提供，长度14位

格式yyyyMMddhhmm