服务热线:0755-23996640

阅读对象


该文档面向开发工程师,研发工程师,测试工程师,系统运维工程师。

开发人员请仔细阅读商务接入流程、签名机制、API列表、交易返回码。

商务接入流程


一.商户准备资料

企业营业执照 法人身份证(正反面) 组织机构代码证
开许户可证 税务登记证 租赁合同/房屋产权证明
法人对私银行卡(非必交) ICP许可证 办公前台(带logo)/办公区域照片
其它相关资质(SP证、网络文化经营许可证)(非必交)
注:
1、无卡产品需签订《中茂恒润支付合作业务承诺函》、其它产品需签订《中茂恒润支付合作业务告知函》。
2、所有文件一式两份,均需加盖公章和骑缝章。

二.签署协议

签署合作协议,约定业务产品、费率、结算周期,缴纳保证金。
注:
1、所需签署协议:《中茂恒润代收付协议》、《中茂恒润技术服务协议(互联网支付)》。
2、商户接入微信、支付宝需要进行报件,详见[ 报件流程 ]。

三.技术对接联调

提供开发文档、测试参数,专业团队提供技技术支持,配合接口对接联调。
注:前往下载中心下载文档、demo,里面包含测试参数,调试接口时结合文档及demo。

四.开通生产商户号和产品

1、测试环境测试通过后,前往下载中心下载《开户信息表》,填写完成后,发送至service@zhongmaopay.com。
2、获取生产商户号后,自行登录商户后台下载证书,替换测试环境的证书,同时注意替换通讯地址(详见接口规则、通讯)。

五.上线运营

正式上线运营,专人负责上线后的维护,业务监控,保证业务通畅。

微信和支付宝子商户进件


一、微信子商户进件说明
(一)、商户到微信公众平台 https://mp.weixin.qq.com/ 以企业主体注册微信服务号,需对公打款进行验证和开发者资质认证,获取APPID。
(二)、验证通过,填写进件表格,发送至service@zhongmaopay.com,邮件主题备注与中茂签约主体的公司名称。
1、上传模板参数说明
项目 说明
商户名称 商户必须具有认证公众号的商户公司主体的工商注册名称,提交的时候请参考如下核验公众号帐号主体,用于申请注册商户。例如:

特别说明:
所提供的商户名称必须与下面的子商户公众号APPID一致,比如这里我们提供的帐号主体是“中国民生银行股份有限公司广州分行”,则我们在下面的子商户公众号APPID也必须是以中国民生银行股份有限公司广州分行”为帐号主体的公众号的appid
商户简称(必填) 填写商户名称的摘要简称,用户出现在c端用户支付界面上,可以自定义商户简称比如品牌名称或者店铺名称,以便提高持卡人的辨识度降低投诉。严禁写入其他银行名称作为简称!
是否使用民生 受理公众号 (取值 'Y'或'N') 默认取值:'N'。
受理公众号ID (必填) wx5d236520a4bf0eaa
子商户公众号 ID(必填) 需准确填写商户名称对应主体的公众号APPID,在使用公众号支付等,需传入子商户以下对应类型的APPID,以获取 sub_openid。
特别说明:
1.检查公众号主体是否与商户名称一致
2.获取方式:登录mp.weixin.qq.com
查看:【开发】->【基本配置】

支付授权目录 (必填) 所有使用js api方式发起支付请求的链接地址,都必须在支付授权目录之下;最多设置3个支付授权目录,且域名必须通过icp备案,使用多个时,要求使用”|“分隔。 头部要包含http或https,须细化到二级或三级目录, 以左斜杠“/”结尾。
特别说明:
结尾必须是左斜杠“/”结尾的目录,不能是具体到某个页面
经营类目ID (必填) 请参照类目指引的文档,填写商户的对应的类目ID, 注意市场价为非0.6%或特定行业的时候,会引起费率的套用及结算时间问题,谨慎选择。特殊商户,特殊 选择。
客服电话(必 填) 准座机需填写区号,如有分机也一并填写,例如:0755-8376777-0000,客服电话请保持畅通,否则影响你的服务质量和被客户直接投诉到微信,建议填写商家的客服电话。
联系人(必 填) 虽为非必填,但是要求填,微信支付将会第一时间联系该负责人,在差错处理、客户投诉的时候,微信支付会使用。建议填写服务商自己的联系方式
联系手机(必填) 注意填写手机号码格式,要求纯数字,否则报错,必须能够联系到的服务商客服人员。
联系邮箱(必填) 虽为非必填,但是要求填,在差错处理、客户投诉的 时候,微信支付会使用。建议填写服务商的。
渠道类型(必 填,取值 'WEIXIN'或 'ALIPAY') WEIXIN(目前批量进件子商户只有微信支付)
联系人微信账号(必填,联系人微信号) 必须填写联系人真实的微信号,如不一致,会导致配置不通过。
2、报备通过后,对应生成民生子商户号。
民生子商户号:在民生系统内的子商户标识,用于【统一支付接口】下单的subChnlMerNO。

二、支付宝子商户进件

(一)、商户到支付宝开发平台 https://open.alipay.com/platform/home.htm 以企业主体进行注册,需对公打款进行验证,获取PID。
(二)、验证通过之后,填写进件表格,发至service@zhongmaopay.com ,邮件主题备注与中茂签约主体的公司名称。
(三)、M1-M3级支付宝子商户等级定义:
1、 M1级商户属于可正常交易的子商户,即商户入驻信息为受理商户真实信息;
2、 M2级商户有机会使用花呗支付、商家自运营(支付即会员)等功能。需要在M1级商户基础之上补充商户地址信息;
3、 M3级商户除了可以享受M2级间连商户的权益外,还有机会使用花呗分期、获得支付宝风控黑名单能力、参加支付宝权益日等功能。需在M2级商户基础之上补充营业执照信息和结算卡信息。
(四)、子商户进件说明:
填写步骤如下,请填写完整的M1(必填)标识项目内容;M2和M3级建议填写。
i. 商户名称(M1)(必填)
ii. 商户简称(M1)(必填)
iii.客服电话(M1)(必填)
iv. 经营类目ID(M1)(必填):下拉选,政府/社会组织,专业销售/批发,医疗健康,爱车,教育培训,超市便利店,航旅,生活服务,休闲娱乐,购物,美食
v. 是否使用民生pid:选择否
vi. 受理商户来源机构标识(pid)使用民生pid时候留空,不使用民生pid时必填,请填写:2088XXXXXXXX2932, 208开的16位PID。【不可以使用个人名义的PID进行进件】
vii. 联系人名称(M1)(必填)
viii.联系人电话(M1)(必填)纯数字,不带符号,建议填写服务商自己的员工;支付宝会联系差错交易
ix. 联系人手机(M1)(必填)纯数字,不带符号,建议填写服务商自己的员工,支付宝会联系差错交易
x. 联系人邮箱(M1)(必填)建议填写服务商自己的员工,支付宝会联系差错交易
xi. 联系人类型(M1)下拉选择联系人类型:其他,法人,实际控制人,代理人
xii.身份证号(M1),上述联系人对应的身份证号码
由于后续支付宝所有奖励金、花呗等奖励,均需商户是M2级及以上级别(M3),请商户尽量在填完M1之外,将M2、M3的内容也进行填写。
i. 省份(M2):下拉选择,例如广东省
ii. 城市(M2):下拉选择,例如广州市
iii. 区县(M2):下拉选择,例如天河区
iv. 地址类型(M2): 下拉选择类型:注册地址或经营地址
v. 经营地址(M2):商家详细的经营地址。
vi. 营业执照类型(M3):营业执照(多证合一),营业执照,事业单位法人证书
vii. 营业执照编号(M3):填写对应的营业执照编号
viii. 银行卡持卡人姓名(M3)
ix. 银行卡号(M3)
x. 支付宝帐户和支付二维码信息(可留空)
(五)、支付宝报建数据字典解读:
批量子商户模版中,对应的地区编码,地址类型,营业执照类型,联系人类型,经营类目,对应的数字和字符。

(六)、批量“子商户进件”填写说明(附了两个案例说明),填写步骤如下,请填写完整的M1(必填)标识项目内容;M2建议填写,M3级请选填。 i. 商户名称(M1)(必填)
ii.商户简称(M1)(必填)
iii.客服电话(M1)(必填)
iv.经营类目(M1)(必填):请在报建字典中查询对应的经营类目数值,前缀ID,如美食对应的编码为2015050700000000,则该项填写为ID2015050700000000;
v.是否使用民生pid:选择是或者否,实体商户请选择是
vi.受理商户来源机构标识(pid)(使用民生pid时候留空,不使用民生pid时必填,请填写:2088XXXXXXXX2932, 208开的16位PID。 联系人名称(M1)(必填)
vii.联系人电话(M1)(纯数字,不带符号,必填,建议填写服务商自己的员工;支付宝会联系差错交易)
viii.联系人手机(M1)(必填,纯数字,不带符号,建议填写服务商自己的员工,支付宝会联系差错交易)
ix.联系人邮箱(M1):必填,建议填写服务商自己的员工,支付宝会联系差错交易
x.联系人类型(M1):请在报建字典中联系人类型对应的数值,如联系人为企业法人,则此项填写LEGAL_PERSON;
xi.身份证号(M1):上述联系人对应的身份证号码,前缀ID,如客户身份证号码123456789012345,则此项填写ID123456123456789012345;

由于后续支付宝所有奖励金、花呗等奖励,均需商户是M2级及以上级别(M3),请商户尽量在填完M1之外,将M2、M3级的内容也进行填写。
i.省份(M2):请在报建字典中省份对应的编码
ii.城市(M2):请在报建字典中城市对应的编码
iii.区县(M2):请在报建字典中区县编码,例如石门沟区,区县填写110109(对应字典的地区编码),城市为北京市110100,省份为北京110000;
iv.地址类型(M2): 请在报建字典中地址类型对应的数值,例如,经营地址,填写BUSINESS_ADDRESS
v.经营地址(M2):填写商家详细的经营地址。
vi.营业执照类型(M3):营业执照(多证合一),营业执照,事业单位法人证书
vii.营业执照编号(M3):填写对应的营业执照编号
viii.银行卡持卡人姓名(M3)
ix.银行卡号(M3):请前缀ID

微信扫码支付


场景:用户扫描商家展示的二维码进行支付


步骤一:打开微信,点击扫一扫。图-1
步骤二:商家展示二维码,用户扫描二维码。图-2,图-3


  • 图-1

  • 图-2

  • 图-3



步骤三:用户点击确认支付,前往支付。图-4
步骤四:输入密码,进行支付。图-5
步骤五:完成支付,提示支付成功。图-6


  • 图-4

  • 图-5

  • 图-6




微信刷卡(反扫)


场景:商家扫描用户的二维码进行支付


步骤一:打开微信,点击收付款。图-1
步骤二:向商家展示付款二维码,供商家扫码。图-2
步骤三:商家扫码成功,提示用户支付成功。图-3


  • 图-1

  • 图-2

  • 图-3

支付宝扫码支付


场景:用户扫描商家展示的二维码进行支付


步骤一:打开支付宝,点击扫一扫。图-1
步骤二:商家展示二维码,用户扫描二维码。图-2,图-3


  • 图-1

  • 图-2

  • 图-3



步骤三:用户点击立即支付,进行指纹支付(输入支付密码)。 步骤四:完成支付,提示支付成功。


  • 图-4

  • 图-5




支付宝刷卡支付


场景:商家扫描用户的二维码进行支付


步骤一:打开支付宝,点击付钱。图-1
步骤二:向商家展示付款二维码,供商家扫码。图-2
步骤三:商家扫码成功,提示用户支付成功。图-3


  • 图-1

  • 图-2

  • 图-3

京东扫码支付


场景:用户扫描商家展示的二维码进行支付


步骤一:打开京东金融APP。图-1
步骤二:点击扫一扫,扫描二维码。图-2-1,图-2-2


  • 图-1

  • 图-2-1

  • 图-2-2



步骤三:用户输入密码,进行交易。图-3
支付完成,提示用户支付成功。图-4


  • 图-3

  • 图-4




京东付款码支付


场景:商家扫描用户的二维码进行支付


步骤一:打开京东金融APP。图-1
步骤二:点击付款,向商家展示付款二维码,供商家扫码。图-2
商家扫码成功,提示用户支付成功。图-3


  • 图-1

  • 图-2

  • 图-3

QQ钱包扫码支付


场景:用户扫描商家展示的二维码进行支付


步骤一:打开QQ,点击扫一扫。图-1
步骤二:扫描二维码。图-2
步骤三:用户点击立即支付,前往支付。


  • 图-1

  • 图-2

  • 图-3



步骤四:输入密码,进行支付。
步骤五:完成支付,提示支付成功。


  • 图-4

  • 图-5




QQ钱包付款码支付


场景:商家扫描用户的二维码进行支付


步骤一:打开QQ,点击QQ钱包。图-1
步骤二:点击付款,向商家展示付款二维码,供商家扫码。图-2
步骤三:商家扫码成功,提示用户支付成功。图-3


  • 图-1

  • 图-2

  • 图-3

网银B2


场景:持卡人在商户网站B2C购物支付场景,持卡人通过点击银联在线支付图标,并跳转银联页面完成支付信息录入,最终完成支付。


步骤一:点击银联在线支付图标。图-1
步骤二:跳转银联页面完成支付信息录入。图-2
步骤三:完成支付,提示成功。图-3




图-1





图-2





图-3

代付

代付是指商户从自身单位结算账户向持卡人指定银行卡账户进行款项划付的业务。商户进行代付交易时,必须在系统开设的账户内存在足够的余额。

代扣

基于集团企业客户对于资金单笔代扣、批量代扣的需求设计,代扣交易是指交易请求方(如商户、用户)将交 易信息直接通过请求方服务器发送至服务器的交易方式。代扣交易均为同步短连接方式,不需要持卡人参与完成的交易类型。

版本说明


中茂恒润移动支付平台接口文档



●    2016-08-06

     V1.0 初始版本

●    2017-03-01

     V1.1 统一支付接口新增:银联二维码支付

●    2017-03-08

     V1.2 新增代扣接口新增微信/支付宝报件接口,微信订单关闭接口

●    2017-03-20

     V1.3 新增京东支付/QQ钱包相关消费接口

●    2017-04-18

     V1.4 统一下单支付接口新增京东接口上送参数


中茂恒润支付平台接口文档



●    2016-08-06

     V1.0 初始版本

●    2017-03-14

     V1.1 新增代扣接口

●    2017-07-31

     V1.2 页面通知接口(B2C)

●    2017-09-04

     V1.3 代付接口升级

●    2017-09-20

     V1.4 新增快捷支付产品

名词解释


名词 解释
商户 商户是指在企业或个人在中茂支付平台注册成为商户身份,可能通过中茂进行收款的角色。商户必须是拥有营业执照的企事业单位
商户编号 商户接入后,中茂按照相关标准分配给商户的全局唯一的id
APPID application identification微信公众平台服务号才有的,如果自己家的公众平台不是服务号,需要升级为服务号。就是相当于一个手机应用软件,可以将一个公众号做成快捷方式,放在手机应用里
openid 用户在公众号内的身份标识,不同公众号拥有不同的openid。商户后台系统通过登录授权、支付通知、查询订单等API可获取到用户的openid。主要用途是判断同一个用户,对用户发送客服消息、模版消息等。企业号用户需要使用企业号userid转openid接口将企业成员的userid转换成openidd

通讯方式


所有报文域以key/value的形式,通过HTTPS以POST请求方式发送到中茂支付平台。
接口请求结果实时响应到商户,支付结果通过商户提供的后台通知地址,通知到商户。

通讯地址


环境 地址 备注
测试 https://test.zhongmaopay.com/payment-gate-web/gateway/api/backTransReq
生产 https://www.zhongmaopay.com/payment-gate-web/gateway/api/backTransReq
官网 https://www.zhongmaopay.com/
商户后台 https://www.zhongmaopay.com/merchantWeb/login

签名机制

为保证数据传输过程中的数据真实性,完整性和不可抵赖,我们需要对数据进行数字签名,在接收签名数据之后进行签名校验。 签名算法为RSA。签名是为了防止从商户系统提交的支付请求以及通知数据被非法篡改。

报文签名机制

根据接口报文内容,把除签名字段(signature)以外的所有值为非空的字段按照报文字段的自然顺序升序,依次按照“字段名=字段值”的方式用“&”符号连接符拼接成待签名串。 其次,对待签名串使用SHA-1算法做摘要,再使用中茂颁发给商户的商户RSA私钥证书对摘要做签名操作(签名时算法选择SHA-1)。最后,对签名做Base64编码,将编码后的签名串放在签名(signature),填入待提交的签名字段。
签名字符串样式如下:

报文签名验签机制

根据响应报文内容,把除签名字段(signature)以外的所有值为非空的字段按照报文字段的自然顺序升序,依次按照“字段名=字段值”的方式用“&”符号连接符拼接成待签名串。 其次,对待签名串使用SHA-1算法做摘要,再使用中茂颁发给商户的商户RSA公钥证书对摘要和报文中的签名信息做签名验证操作。注意事项:验签切勿按接口字段获取参数验签, 需获取所有响应字段参与验签,以防因接口新增参数而导致验签失败。

注意事项

1、测试时注意测试环境、生产的地址,见【通讯方式】。
2、签名注意事项:
1)、不能传递空参注意
2)、参数值不能包含空格
3)、参数顺序必须和文档一致
4)、确认证书是否是最新版本
5)、测试时要结合demo和文档一起进行
6)、报文编码只支持UTF-8。编码时只针对待签名字符串,signature不参与编码

符号约定

符号 含义
M 必输入或输出的域
C 可输入或输出的域

数据元类型定义

Ax x字节定长的字母字符
Ax..y 长度为x-y字节的变长字母字符
ANx x字节定长的字母和/或数字字符
ANx..y 长度为x-y字节的变长字母和/或数字字符
ANSx x字节定长的字母、数字和/或特殊符号字符
ANSx..y 长度为x-y字节的变长字母、数字和/或特殊符号字符
ASx x字节定长的字母和/或特殊符号字符
ASx..y 长度为x-y字节的变长字母和/或特殊符号字符
Nx x字节定长的整型数值,若表示金额,则以分为单位
Nx..y 长度为x-y字节的整型数值,若表示金额,则以分为单位
NSx x字节定长的数字符和/或特殊字符
NSx..y 长度为x-y字节的数字字符和/或特殊字符
Sx x字节定长的特殊符号字符
Sx..y 长度为x-y字节的变长特殊符号字符
ss
DD
hh
MM
mm
YY 年(2字节)
YYYY 年(4字节)
VARx 个数为x的复合数据元集,数据元内使用|分割,数据元之间使用逗号,分割
VARx..y 个数为x-y的复合数据元集,数据元内使用|分割,数据元之间使用逗号,分割

统一下单


说明:此接口支持微信支付、支付宝、QQ钱包、京东等产品。请注意文档中的产品类型(productId)、交易类型等参数(transId),参数值请留意注释。

请求字段
字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0
V3.0异步通知返回卡类型
as..4
productId 产品类型 M 0104-微信扫码支付
0105-微信公众号支付
0106-微信刷卡(反扫)
0107-微信H5支付
0108-APP支付
0109-支付宝扫码支付
0110-支付宝刷卡支付
0115-支付宝支付窗支付
0112-QQ扫码支付
0113-QQ公众号支付
0114-QQ付款码支付
0116-网银B2C
0117-京东扫码
0118-京东付款码支付
0119-京东商户二维码支付
0120-京东H5支付
0121-银联二维码刷卡支付(反扫)
0122-银联二维码扫码支付(主扫)
transId 交易类型 M 10-微信/支付宝/QQ/京东消费
19-银联二维码刷卡支付(反扫)消费
20-银联二维码扫码支付(主扫)消费
merNo 商户号 M 商户号 as..30
orderDate 订单日期 M 商品订单支付日期yyyyMMdd N8
orderNo 商户订单号 M 商户订单号 as..32
notifyUrl 异步通知地址 M 异步通知地址 as..256
transAmt 交易金额 M 交易金额,单位为分 N12
commodityName 商品名称 M 商品名称 ans..64
openid 微信openId C 当产品类型为0105时,必填 as..256
authCode 授权码 C 所有反扫产品,必填 as..256
storeId 商户门店编号 C 当产品类型为0109、0110时,必填
格式:字母或数字组合,不能为中文,否则会存在风控限制
例如:s1000017
as..32
terminalId 商户机具终端编号 C 当产品类型为0109时、0110时,必填
格式:字母或数字组合,不能为中文,否则会存在风控限制
例如:t9000026
as..32
subMerNo 商户识别id M 所有微信支付,QQ钱包,京东钱包支付产品必传,格式为商户号+收款商户唯一识别号的数字组合。例如:88844005812100200000001。 as..40
subMerName 收款商户名称 M 为实际店名,不得用个人名称代替,否则会存在风控限制。例如:百果园水果店。[详见] as..40
subChnlMerNo 中茂子商户ID C 子商户ID由商户在中茂报备获得,交易时传送该值 as..20
limitPay 指定支付方式 C 微信产品(不包含刷卡支付)可输入no_credit --指定不能使用信用卡支付 as..10
qrValidTime 二维码有效期 C 仅产品类型为0122时,可选送。上送后,超过二维码有效期时限,将交易失败。 单位:秒 N8
omRt 外部商户注册时间 C 产品类型为0117、0118、0119、0120必须上送时间戳(格式样例:1479802946200,如有不明请自行百度),建议使用商户注册时间时间戳而非当前时间的时间戳,降低京东钱包风控 N13
omType 外部商户行业 C 产品类型为0117、0118、0119、0120必须上送,上送数值参考附录京东行业值
omAdd 外部商户地址 C 产品类型为0117,0118,0119,0120必须上送,填写商户注册地址
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M as..32
version 版本号 M as..4
productId 产品类型 M
transId 交易类型 M
merNo 商户号 M as..30
orderDate 订单日期 M N8
orderNo 商户订单号 M as..32
notifyUrl 异步通知地址 M as..256
transAmt 交易金额 M N12
commodityName 商品名称 M ans..64
openid 微信openId C as..256
authCode 授权码 C as..256
storeId 商户门店编号 C as..32
terminalId 商户机具终端编号 C as..32
subMerNo 商户识别id M as..40
subMerName 收款商户名称 M as..40
respCode 应答码 M N4
respDesc 应答码描述 M ans..128
codeUrl 二维码链接 M ans..64
imgUrl 二维码图片 M ans..128
payInfo 公众号支付信息 M ans..1000
subChnlMerNo 中茂子商户ID C as..20
limitPay 指定支付方式 C as..10
qrValidTime 二维码有效期 C N8
signature 验签字段 M Var
subMerNo(商户识别id)、subMerName(收款商户名称)属于风控字段,需要填写真实收款商户名称。在实际场景当中,加入有20家商家接入了平台,所有商家的交易平台都上送同一个商户识别id、商户名称, 恰好该商家是一家便利店,该便利店一上午(假设为4个小时)的交易金额通常在1万左右,此时所有商家的交易金额均算在这一家商家上,就会出现交易金额高达几十万、几百万, 显然是不符合实际场景的,此时会触发微信风控,导致封停。

支付状态查询接口

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0 as..4
transId 交易类型 M 04
merNo 商户号 M 商户号 as..30
orderDate 订单日期 M 商品订单支付日期yyyyMMdd N8
orderNo 商户订单号 M 商户订单号 as..32
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M as..32
version 版本号 M as..4
transId 交易类型 M
merNo 商户号 M as..30
orderDate 订单日期 M N8
orderNo 商户订单号 M as..32
origRespCode 原交易应答码 M 交易成功:0000 N4
origRespDesc 原交易应答码描述 M ans..128
transAmt 交易金额 M 交易金额,单位为分 N12
refundAmt 已退金额 M 已退金额,单位为分 N12
respCode 应答码 M respCode不等于0000时当未知状态处理,继续调用查询接口;respCode等于0000时以origRespCode返回码为准 N4
respDesc 应答码描述 M ans..128
payId 中茂订单号 C 交易请求版本号上送2.0时返回 as..30
payTime 支付完成时间 C 交易请求版本号上送2.0时返回, yyyyMMddHHmmss as..20
customerName 持卡人姓名 C 当产品类型为0122时,返回姓名 as..30
acctNo 卡号 C 当产品类型为0121/0122时,返回银行卡号 N32
signature 验签字段 M Var

异步通知

请求字段

字段 名称 属性 注释 数据类型
productId 产品类型 M 详见各交易类接口
transId 交易类型 M 详见各交易类接口
merNo 商户号 M 商户号 as..30
origOrderNo 商户订单号 M 原交易商户订单号 as..32
transAmt 交易金额 M 申请退货金额,单位为分 N12
orderDate 订单日期 M 商品订单支付日期yyyyMMdd N8
respCode 应答码 M N4
respDesc 应答码描述 M as..128
payId 中茂订单号 C 交易请求版本号上送2.0时返回 as..30
payTime 支付完成时间 C 交易请求版本号上送2.0时返回, yyyyMMddHHmmss as..20
bankType 卡类型 C 统一下单接口版本号V3.0时通知返回 as..20
customerName 持卡人姓名 C 当产品类型为0122时,返回姓名 as..30
acctNo 卡号 C 当产品类型为0121/0122时,返回银行卡号 N32
signature 验签字段 M 验签字段 Var

响应字段

商户接收通知成功返回“SUCCESS”字符串,不要包含如html等文本语言。

关闭订单号


目前支持微信类产品的关闭订单,支付宝等后续开放。对于原订单结果未知或用户支付超时时,可对原订单发起关闭订单,系统则退出不再受理该订单,避免用户继续支付。

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0 as..4
transId 交易类型 M 21
merNo 商户号 M 商户号 as..30
orderDate 订单日期 M 商品订单支付日期yyyyMMdd N8
orderNo 商户订单号 M 商户订单号 as..32
origOrderNo 原商户订单号 M 填写需关闭的原订单号 as..32
origOrderDate 原订单日期 M 填写需关闭的原订单日期原商品订单yyyyMMdd N8
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M as..32
version 版本号 M V1.0 as..4
transId 交易类型 M 21
merNo 商户号 M as..30
orderDate 订单日期 M N8
orderNo 商户订单号 M as..32
origOrderNo 原商户订单号 M 关闭的原订单号 as..32
origOrderDate 原订单日期 M 关闭的原订单日期原商品订单yyyyMMdd N8
respCode 应答码 M respCode不等于0000时表示关闭订单失败,参考respDesc的错误原因
0075:订单已支付不允许关闭
0076:订单已关闭
9999:系统异常
ans..64
respDesc 应答码描述 M 交易处理中 ans..128
signature 验签字段 M Var

微信/支付宝子商户信息报件


此字段必须保证信息的准确性,联系方式、电话等正确性,会在用户端呈现及调用。

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0 as..4
transId 交易类型 M 23
merNo 商户号 M 商户号 as..30
applyType 报建类型 M BANKSP as..30
applyCont 报建内容 M JSON格式
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M as..32
version 版本号 M as..4
transId 交易类型 M
merNo 商户号 M as..30
applyType 报建类型 M BANKSP as..30
applyCont 报建内容 M JSON格式
applyId 报建ID C 报建信息唯一ID As..12
respCode 应答码 M respCode等于P000表示报建内容已受理,待审核,可以不定时使用报建查询接口查询。 ans..64
respDesc 应答码描述 M
signature 验签字段 M Var

子商户报建applyCont字段内容说明

字段 微信 支付宝
bankSpName 商户名称(必填),注意,商户名称必须是子商户公众号ID对应的主体,微信校验 商户名称(必填)
aliasName 商户简称(必填) 商户简称(必填)
acceptFlag 是否使用民生受理公众号(必填,取值'Y'或'N') 是否使用民生PID(必填,取值'Y'或'N'),服务商模式下,必须使用服务商自己的PID
bankAcceptAppid 受理公众号APPID(使用民生受理公众号时候留空,不使用民生受理公众号时必填。建议使用与民生签约主体的公众号。)(可修改) 受理商户来源机构标识(pid)(使用民生PID时候留空,不使用民生PID时必填,要求服务商必须去注册PID详见,相关流程。)
bankAppId 子商户公众号ID(非必填,但公众号支付、扫码支付交易时,该值必填)(可修改) 无需填写
authPaydir 支付授权目录(非必填,但公众号支付,该值必填)(可修改) 无需填写
categoryId 微信经营目录ID(必填,注意行业费率) 支付宝经营目录ID(必填)
servicePhone 客服电话(必填,电话会在微信APP被持卡人调用) 客服电话(必填,纯数字不带符号)
contactName 联系人(必填,建议填写服务商自己的员工,微信会联系差错交易) 联系人(必填)
contactPhone 联系电话(纯数字,不带符号,必填,建议填写服务商自己的员工,微信会联系差错交易) 联系电话(必填,纯数字不带符号)
contactMobile 联系手机(必填,纯数字,不带符号,建议填写服务商自己的员工,微信会联系差错交易) 联系手机(必填,纯数字不带符号)
contactEmail 联系邮箱(必填,建议填写服务商自己的员工,微信会联系差错交易) 联系邮箱(必填)
chnlType 渠道类型(必填,取值'WEIXIN',’WEIXINAPP’) 渠道类型(必填,取值'ALIPAY')
state 民生状态(信息查询时候返回) 民生状态(信息查询时候返回)
chnlState 民生状态(信息查询时候返回) 民生状态(信息查询时候返回)

仅在民生状态是"VALID",并且渠道状态是"ADD_SUCC"或"MOD_SUCC"的时候,该民生子商户可正常交易。 仅标识了“可修改”的字段,可以通过信息修改接口进行修改。若需要关注公众号,请告知我行运营人员,在微信后台进行配置。

信息查询


注意区分查询交易的状态返回及信息报建状态的区别,查询成功不代表报建成功。

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0 as..4
transId 交易类型 M 18
merNo 商户号 M 商户号 as..30
applyType 报建类型 M BANKSP as..30
applyId 报建ID M BANKSP,同报建接口。 as..30
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M as..32
version 版本号 M as..4
transId 交易类型 M 18
merNo 商户号 M as..30
applyType 报建类型 M BANKSP as..30
applyCont 报建内容 M JSON格式
applyId 报建ID C 报建信息唯一ID As..12
respCode 应答码 M respCode等于0000表示查询成功,否则查询失败。 ans..64
respDesc 应答码描述 M
signature 验签字段 M Var

信息修改


注意区分查询交易的状态返回及信息报建状态的区别,查询成功不代表报建成功。

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0 as..4
transId 交易类型 M 19
merNo 商户号 M 商户号 as..30
applyType 报建类型 M BANKSP as..30
applyId 报建ID M BANKSP,同报建接口。 as..30
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M as..32
version 版本号 M as..4
transId 交易类型 M 19
merNo 商户号 M as..30
applyType 报建类型 M BANKSP as..30
applyCont 报建内容 M JSON格式
applyId 报建ID C 报建信息唯一ID As..12
respCode 应答码 M respCode等于P000表示修改内容已受理,待审核,可不定时使用报建查询接口查询。 ans..64
respDesc 应答码描述 M
signature 验签字段 M Var

余额查询

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0 as..4
transId 交易类型 M 09
merNo 商户号 M 商户号 as..30
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M as..32
version 版本号 M as..4
transId 交易类型 M 09
merNo 商户号 M as..30
origRespCode 原交易应答码 M 交易成功:0000 N4
origRespDesc 原交易应答码描述 M ans..128
avaBal 总余额 M 总余额(已入账金额+未入账金额) N12
avaFreezeBal 总冻结金额 M 总冻结金额(已入账冻结+未入账冻结) N12
cwcBal 已入账金额 M 沉淀资金,由未入账金额在次日清结算后转入到已入账金额中 N12
cwcFreezeBal 已入账冻结金额 M 已入账冻结金额 N12
signature 验签字段 M Var

代扣


代扣交易是指交易请求方(如商户、用户)将交易信息直接通过请求方服务器发送至服务器的交易方式。 代扣交易均为同步短连接方式,不需要持卡人参与完成的交易类型。若通讯超时,则交易请求方必须发起交易状态查询交易。

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0
V3.0(选择V3.0时返回受理成功)
as..4
productId 产品类型 M 0111:广东省内代收
transId 交易类型 M 01
merNo 商户号 M 商户号 as..30
orderDate 订单日期 M 商品订单支付日期yyyyMMdd N8
orderNo 商户订单号 M 商户订单号 as..32
notifyUrl 异步通知地址 M 异步通知地址 as..256
transAmt 交易金额 M 交易金额,单位为分 N12
commodityName 商品名称 M 商品名称 ans..64
customerName 持卡人姓名 M 持卡人姓名 as..30
authCode 授权码 C 所有反扫产品,必填 as..256
isCompay 对公对私标识 C 使用产品0111、0113时填写,对公对私标识0为对私,1为对公 N1
settBankNo 清算行号 C 发卡号清算行号,使用产品0111、0113时填写,商户根据持卡人银行卡情况自行获取,详见列表见附录。 注意:如填写该字段,则accBankName、bankType、addrName字段均不需填写 N12
accBankNo 持卡人开户行号 C 使用产品0113省外代收时填写 N12
accBankName 持卡人开户行名称 C 使用产品0111、0113,如accBankNo、settBankNo无法填写时,则必须填写该字段, 可按照规范填写:例子:佛山市禅城区农村信用合作联社或佛山禅城农商行 ans..128
bankType 银行类别 C 使用产品0111、0113,如accBankNo、settBankNo无法填写时,则必须填写该字段, 标识一个银行身份,如102:工商银行 402:农信社。 N4
addrName 地区名称 C 使用产品0111、0113,如accBankNo、settBankNo无法填写时,则必须填写该字段, 填写银行卡所在城市,如广州。如无法获取城市,则填写省份, ans..20
busiType 业务类型 C 使用产品0111、0113时填写,标识该笔消费用于什么业务,如保险、水电煤等,参考附录列表 N6
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M as..32
version 版本号 M as..4
productId 产品类型 M
transId 交易类型 M
merNo 商户号 M as..30
orderDate 订单日期 M N8
orderNo 商户订单号 M as..32
notifyUrl 异步通知地址 M as..256
transAmt 交易金额 M N12
commodityName 商品名称 M ans..64
customerName 持卡人姓名 C as..256
isCompay 对公对私标识 C as..256
settBankNo 清算行号 C as..32
accBankNo 持卡人开户行号 C as..32
accBankName 持卡人开户行名称 C as..40
bankType 银行类别 C as..40
addrName 地区名称 C N4
busiType 业务类型 C ans..128
respCode 应答码 M ans..64
respDesc 应答码描述 M ans..128
signature 验签字段 M Var

无卡消费


消费是指境内持卡人在境内商户网站进行购物等消费时用银行卡结算的交易,经批准的消费额将即时地反映到该持卡人的账户余额上。此消费交易为由采集银行卡相关信息, 收单行页面无须跳转至银联或发卡行页面完成交易。

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0 as..4
productId 产品类型 M 0103:无卡
0123:小额无卡
0130:快捷支付
0140:小额快捷支付
transId 交易类型 M 01
merNo 商户号 M 商户号 as..30
orderDate 订单日期 M 商品订单支付日期yyyyMMdd N8
orderNo 商户订单号 M 商户订单号 as..32
notifyUrl 异步通知地址 M 异步通知地址 as..256
transAmt 交易金额 M 交易金额,单位为分 N12
commodityName 商品名称 M 商品名称 ans..64
phoneNo 预留手机号 M 银行卡预留手机号 as..30
customerName 持卡人姓名 M 持卡人姓名 as..30
cerdType 证件类型 M 持卡人证件类型
01:身份证
02:军官证
03:护照
04:回乡证
05:台胞证
06:警官证
07:士兵证
99:其它证件
cerdId 证件号 M 证件号 as..32
acctNo 卡号 M 银行卡号 N32
cvn2 CVN2 M 信用卡时必填 N3
expDate 卡有效期 M 信用卡时必填(YYMM) N4
quickToken Token M 虚拟Token,用户信息和token值二选一 N20
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0 as..4
productId 产品类型 M 0103
transId 交易类型 M 01
merNo 商户号 M 商户号 as..30
orderDate 订单日期 M 商品订单支付日期yyyyMMdd N8
orderNo 商户订单号 M 商户订单号 as..32
notifyUrl 异步通知地址 M 异步通知地址 as..256
transAmt 交易金额 M 交易金额,单位为分 N12
commodityName 商品名称 M 商品名称 ans..64
customerName 持卡人姓名 M 持卡人姓名 as..30
cerdType 证件类型 M 持卡人证件类型
01:身份证
02:军官证
03:护照
04:回乡证
05:台胞证
06:警官证
07:士兵证
99:其它证件
cerdId 证件号 M 证件号 as..32
acctNo 卡号 M 银行卡号 N32
cvn2 CVN2 M 信用卡时必填 N3
expDate 卡有效期 M 信用卡时必填(YYMM) N4
quickToken Token M 虚拟Token,用户信息和token值二选一 N20
respCode 应答码 M N4
respDesc 应答码描述 M ans..128
signature 验签字段 M 验签字段 Var
注:
一、关于产品类型
无卡消费目前有4种产品类型,交易时,除产品类型参数的值不同外,其它参数均相同。
二、关于0130快捷支付
1、第一次交易成功后,会返回quickToken,此后的交易只需传送quickToken,6要素等参数不需要传送。
2、当6要素等信息发生变化时,则需从新传送6要素参数,无需传送quickToken。当交易成功后,会返回quickToken,之前的quickToken将作废。
3、交易成功后,已经返回了quickToken,如果不是卡6要素信息发生,需要重新生成quickToken,就不要再传送6要素,否则会生成新的quickToken,之前的quickToken就会作废。

退货


消费交易完成后,可进行退货交易,可退货订单日期根据银行通道一般有3-6个月,具体根据商户协议确定。

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M 新接口V1.0 as..4
transId 交易类型 M 02
merNo 商户号 M 商户号 as..30
orderDate 退货日期 M 退货申请日期yyyyMMdd N8
orderNo 退货订单号 M 退货申请订单号 as..32
origOrderDate 订单日期 M 原交易商户订单号 N8
origOrderNo 商户订单号 M 原交易商户订单号 as..32
notifyUrl 异步通知地址 M 异步通知地址 as..256
transAmt 交易金额 M 申请退货金额,单位为分 N12
refundReson 退货原因 M 退货原因 as..256
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M 新接口:V1.0 as..4
transId 交易类型 M 02
merNo 商户号 M as..30
orderDate 退货日期 M 退货申请日期yyyyMMdd N8
orderNo 退货订单号 M 退货申请订单号 as..32
origOrderDate 订单日期 M 原交易商户订单号 N8
origOrderNo 商户订单号 M 原交易商户订单号 as..32
notifyUrl 异步通知地址 M as..256
transAmt 交易金额 M N12
refundReson 退货原因 M 退货原因 as..256
respCode 应答码 M P000表示下单成功,待用户支付 ans..64
respDesc 应答码描述 M 交易处理中 ans..128
orderTime 订单交易时间 M 支付平台侧订单交易时间YYYYMMDDhhmmss N14
signature 验签字段 M Var

撤销


撤销是指撤销当天的交易,其他时间交易撤销始终报失败。

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M 新接口V1.0 as..4
transId 交易类型 M 03
merNo 商户号 M 商户号 as..30
orderDate 撤销日期 M 撤销申请日期yyyyMMdd N8
orderNo 撤销订单号 M 撤销申请订单号 N8
origOrderNo 商户订单号 M 原交易商户订单号 as..32
notifyUrl 异步通知地址 M 异步通知地址 as..256
transAmt 交易金额 M 申请退货金额,单位为分 N12
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M 新接口:V1.0 as..4
transId 交易类型 M 03
merNo 商户号 M 商户号 as..30
orderDate 撤销日期 M 撤销申请日期yyyyMMdd N8
orderNo 撤销订单号 M 撤销申请订单号 N8
origOrderNo 商户订单号 M 原交易商户订单号 as..32
notifyUrl 异步通知地址 M 异步通知地址 as..256
transAmt 交易金额 M 申请退货金额,单位为分 N12
respCode 应答码 M N4
respDesc 应答码描述 M ans..128
orderTime 订单交易时间 M 支付平台侧订单交易时间YYYYMMDDhhmmss N14
signature 验签字段 M 验签字段 Var

代付


代付业务指商户从自身单位结算账户向持卡人指定银行卡账户进行款项划付的业务。

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0:初始版本
V2.0:异步通知返回merNo信息
V3.0:代付关联消费订单
as..4
productId 产品类型 M 0201-普通代付,0203-额度代付
transId 交易类型 M 07 N2
merNo 商户号 M 商户号 as..30
orderDate 订单日期 M 商品订单支付日期yyyyMMdd N8
orderNo 商户订单号 M 商户订单号 as..32
notifyUrl 异步通知地址 M 异步通知地址 as..256
transAmt 代付金额 M 交易金额,单位为分,V3.0时代付金额必须小于等于原订单金额 N12
isCompay 对公对私标识 C 对公对私标识0为对私,1为对公 N1
phoneNo 代付银行手机号 M 代付银行手机号 as..30
customerName 代付账户名称 M 代付账户名称 as..30
cerdType 代付证件类型 C 代付证件类型
01:身份证
02:军官证
03:护照
04:回乡证
05:台胞证
06:警官证
07:士兵证
99:其它证件
N2
cerdId 代付证件号 C 代付证件号 as..32
accBankNo 代付开户行号 C 收款账户开户行号 as..32
accBankName 代付开户行名称 C 收款账户开户行名称 ans..64
acctNo 代付账号 M 银行卡号 N32
note 代付摘要 C 代付摘要 as..255
origOrderDate 订单日期 M 原商品订单的日期yyyyMMdd,V3.0时必填 N8
origOrderNo 商户订单号 M 原交易商户订单号,V3.0时必填 as..32
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M as..32
version 版本号 M V1.0 as..4
merNo 商户号 M as..30
orderDate 订单日期 M N8
orderNo 商户订单号 M as..32
transAmt 代付金额 M 代付金额,单位为分 N12
respDesc 应答码描述 M N4
respDesc 应答码描述 M ans..128
orderTime 订单交易时间 M 支付平台侧订单交易时间YYYYMMDDhhmmss N14
signature 验签字段 M Var
注:
代付version传V3.0时,即关联消费订单,此时需要传送消费的订单号和订单日期,同时需要注意代付的金额要低于消费时的金额。

短信通知

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0 as..4
productId 产品类型 M 0401
transId 交易类型 M 17
merNo 商户号 M 商户号 as..30
phoneNo 手机号 M N11
memo 短信内容 M ans..120
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
respCode 应答码 M 0000交易成功
0073 短信发送失败
9999 系统异常
ans..64
respDesc 应答码描述 M 0000交易成功
0073 短信发送失败
9999 系统异常
ans..128

网银B2C


消费是指境内持卡人在境内商户网站进行购物等消费时用银行卡结算的交易,经批准的消费额将即时地反映到该持卡人的账户余额上。 此消费交易为由采集银行卡相关信息,收单行页面无须跳转至银联或发卡行页面完成交易。


请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M V1.0(直接跳网银页面)
V2.0(返回网银页面HTML内容)
as..4
productId 产品类型 M 0116
transId 交易类型 M 23
merNo 商户号 M 商户号 as..30
orderDate 订单日期 M 商品订单支付日期yyyyMMdd N8
orderNo 商户订单号 M 商户订单号 as..32
notifyUrl 异步通知地址 M 异步通知地址 as..256
transAmt 交易金额 M 交易金额,单位为分 N12
commodityName 商品名称 M 商品名称 ans..64
commodityDesc 商品描述 M ans..64
bankPayType 网银类型 M 01:B2C网银
02:B2B网银
N2
cardType 银行卡类型 M 01:借记卡
02:贷记卡
N2
bankCode 银行缩写 M 详见附录 as..64
signature 验签字段 M 验签字段 Var

响应字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M as..32
version 版本号 M as..4
productId 产品类型 M
transId 交易类型 M
merNo 商户号 M as..30
orderDate 订单日期 M N8
orderNo 商户订单号 M as..32
notifyUrl 异步通知地址 M as..256
transAmt 交易金额 M N12
commodityName 商品名称 C ans..64
respCode 应答码 M P000表示下单成功,待用户支付 ans..64
respDesc 应答码描述 M 交易处理中 ans..128
commodityDesc 商品描述 M Ans..64
bankPayType 网银类型 M N2
cardType 银行卡类型 M N2
bankCode 银行缩写 M as..64
htmlInfo 页面内容 M 对内容进行Base64解码 Var
signature 验签字段 M Var

对账文件


说明:测试环境没有对账文件,无法进行测试。开发人员请前往下载中心下载对账文件模板,itf文件为响应数据,txt文件为对账文件。

请求字段

字段 名称 属性 注释 数据类型
requestNo 请求流水号 M 交易请求流水号 as..32
version 版本号 M 新接口V1.1 as..4
transId 交易类型 M 14
merNo 商户号 M 商户号 as..30
postingDate 清算日期 M yyyyMMdd T日交易一般去T+1日对账文件 N8
signature 验签字段 M Var

响应字段

字段 名称 属性 注释 数据类型
respCode 应答码 M 0000表示成功 ans..64
respDesc 应答码描述 M ans..128
filecontent 文件流 M 对字段进行Base64解码

对账文件格式说明

1、第一行为合计信息,之后每行记录为一条交易明细。
2、文件内容每行必须符合标准格式,且每行必须以回车换行结束。
3、数据项之间以“|”逗号分隔。
4、如数据项为空时,则相应的数据项不需填任何信息(包括空格)
5、每一行记录标准格式:(首行合计)记账日期,成功总笔数,成功总金额,总手续费,清算金额 (明细)记账日期,父级商户号,商户号,支付产品,交易类型,商品订单号,交易时间,交易金额,交易手续费,清算金额,原商品订单号,原交易时间,备注
6、文件首记录:

序号 长度 类型 描述
1 8 字符型 记账日期yyyyMMdd
2 12 数值型 成功总笔数
3 15 数值型 成功总金额(单位:分)
4 12 数值型 成功总手续费(单位:分)
5 15 数值型 清算金额(单位:分)

对账明细数据域描述:

序号 长度 类型 描述
1 8 字符型 记账日期yyyyMMdd
2 15 字符型 父级商户号
3 15 字符型 商户号
4 4 字符型 支付产品
5 20 字符型 交易类型
6 32 字符型 商品订单号
7 20 字符型 交易时间yyyy-MM-dd hh:mm:ss
8 14 数值型 交易金额(单位分)
9 9 数值型 交易手续费(单位分)
10 14 数值型 清算金额(单位分)
11 20 字符型 原商品订单号(可为空,在退款交易出现)
12 20 字符型 原交易时间(可为空,在退款交易出现)
13 64 字符型 备注(扩展) 附加信息,自定义保留域

交易返回码列表


请仔细阅读返回码列表,进行相应的处理机制。

一、交易接口

1、交易成功:返回0000,表示交易成功
2、中间状态:下列情况为中间状态,即订单状态为支付中,处理方式参考中间状态处理方案。

P000:交易处理中;

9999:系统异常;

9997:交易结果未知;

0028:原交易不存在;

未接收到响应;

http响应码为非200(网络原因、系统不稳定、系统重启等)。

3、交易失败:其它错误码,根据交易返回码进行处理
注:P000表示下单成功,例如微信、支付宝、QQ钱包等,此时等待用户支付。0000表示支付成功。

二、 查询接口

1、成功状态:respCode返回0000,并且origRespCode返回0000
2、中间状态:

a) respCode返回非0000,默认当中间状态处理;

b) respCode 返回0000-查询交易成功的情况;

(1)origRespCode 返回P000(交易处理中)/9999(系统异常)/9997(交易结果未知)
(2)origRespCode返回0028,订单因为参数原因被拒或网络原因没有入库,查询时间和交易间隔时间较短都可能返回该错误码。

c) 未接受到响应

d) http响应码为非200(网络原因、系统不稳定、系统重启等)时;

3、失败状态:respCode返回0000,origRespCode返回非如上错误码,原交易订单为失败
注:respCode返回0000表示查询成功,但是原订单的交易状态结果还需要根据origRespCode来确定处理方式

三.中间状态处理方案

1、中间状态一般需要等待我行的异步通知,建议做好用户提示:
正向交易:包括微信/支付宝/QQ钱包/京东钱包/无卡快捷/代扣等消费支付交易,建议显示支付进度条或者提示支付中,默认先将状态当支付失败状态处理先,等待异步通知或者向我行核实交易状态处理。
负向交易:包括代付/退货/撤销等接口默认将中间状态当成功处理避免款项处理错误,但是在用户端显示:“代付/退款中,请在XXX小时后…..,联系客户xxxxx”避免用户紧张或者投诉。
2、对于实体商户,微信和支付宝的支付交易请求如果为中间状态(尤其出现客户支付成功,系统仍然显示支付中情况下),超过30s-40s仍然为中间状态,可以调用订单关闭接口,关闭订单处理。
3、调用查询接口,需控制查询间隔时间和查询次数,以免对上游系统和自家系统造成系统压力,尤其微信、支付宝类需二次交互的交易需严格控制。建议间隔时间30s /60s/180s/600s的间隔时间查询,如果600s后仍然为中间状态,建议人工核实。


返回码 中文描述 返回码 中文描述
中间状态(需要再发起查询,直至返回明确成功或失败)
P000 交易处理中 9999 系统异常(出现9999错误码时,建议与上游确认再处理)
9997 交易结果未知 0028 原交易不存在(出现0028错误码时,建议与上游确认再处理)
明确成功
0000 交易成功
明确失败
0001 请求参数非法 0002 商户号不能为空
0003 商户订单号不能为空 0004 银行预留手机号不能为空
0005 交易金额不能为空 0006 卡号不能为空
0007 CVN2不能为空 0008 信用卡有效期不能为空
0009 验签字段不能为空 0010 商户信息不存在
0011 商户状态异常 0012 校验签名失败
0013 商户密钥信息不存在 0014 商户密钥已失效
0015 获取商户密钥ID失败 0016 产品信息不存在
0017 产品信息状态异常 0018 未授权的交易
0019 渠道约束信息为空 0020 不支持的卡类型
0021 不支持借记卡交易 0022 不支持贷记卡交易
0023 订单号重复 0024 订单信息保存失败
0025 验证银行结果签名失败 0026 支付信息保存失败
0027 未知交易类型 0028 原交易不存在
0029 原交易状态异常 0030 交易金额超限
0031 路由筛选失败 0032 交易金额非法
0033 银行卡信息保存失败 0034 当天交易不支持退款
0035 原交易已撤销 0036 非当天交易不支持撤销
0037 原交易已发起撤销或退货 0038 不支持的银行卡
0039 原交易不支持撤销 0040 上一笔撤销交易正在处理中
0041 上一笔退货交易正在处理中 0042 余额不足
0043 生成代付单失败 0044 商品订单状态异常
0045 支付订单状态异常 0046 交易限额超限
0047 交易金额与原交易不符 0048 联行号不存在
0049 该时间段不允许交易 0050 订单日期无效
0051 短信验证码请求过于频繁,请稍后再试 0052 手机号非法
0053 短信验证码错误次数过多,请稍候再试 0054 未获取短信验证码或短信验证码为空
0055 短信验证码不能为空 0056 短信验证码错误
0057 文件获取日期格式错误 0058 查询日期范围不能超过31天
0059 获取卡号信息异常 0060 当前交易无需发送短信
0061 交易不支持退款 0062 获取微信授权信息失败
0063 获取微信配置信息失败 0064 对账ftp创建文件失败
0065 对账文件不存在 0066 余额冻结失败
0067 订单冻结失败 0068 更新代付订单失败
0069 更新商品订单失败 0070 更新支付订单失败
0071 获取动态密钥失败 0072 短信发送成功
0073 短信发送失败 0074 短信发送条数超限
0075 手机号码格式不正确 0076 短信模板不存在
0077 短信内容未报备 0078 订单已支付不允许关闭
0079 订单已关闭 0080 无法匹配联行号
9996 交易已退货 9998 交易失败
交易金额或交易次数超限
1000 交易金额或交易次数超限 1001 交易金额超限
1002 交易次数超限

银行编码

简称 名称 简称 名称
ICBC 工商银行 ABC 农业银行
BOC 中国银行 CCB 建设银行
CMB 招商银行 BOCM 交通银行
CMBC 民生银行 CNCB 中信银行
BOB 北京银行 GDB 广发银行
PSBC 邮储银行 SPDB 浦发银行
CEB 中国光大银行 CIB 兴业银行
HXB 华夏银行 PAB 平安银行
BOS 上海银行 BOHC 渤海银行
BOJ 江苏银行 BJRCB 北京农商银行
NJCB 南京银行 NBBANK 宁波银行
HZCB 杭州银行

业务类型

定义范围 类别 名称 序号 编码
0 01 电费 00 00100
家用电费 01 00101
生产用电费 02 00102
…… …… ……
0 02 水暖费 00 00200
用水费 01 00201
排水费 02 00202
直饮水费 03 00203
污水处理费 04 00204
暖气费 05 00205
…… …… ……
0 03 煤气费 00 00300
管道煤气费 01 00301
…… …… ……
0 04 电话费 00 00400
市内电话费 01 00401
长途电话费 02 00402
移动电话费 03 00403
电话初装费 04 00404
IP电话费 05 00405
…… …… ……
0 05 通讯费 01 00500
数据通讯费 02 00501
线路月租费 03 00502
代维费 04 00503
网络使用费 05 00504
信息服务费 06 00505
移动电子商务费 07 00506
网关业务费 08 00507
手机话费 09 00508
…… …… ……
0 06 保险费 00 00600
续期寿险费 01 00601
社会保险费 02 00602
养老保险费 03 00603
医疗保险费 04 00604
车辆保险费 05 00605
…… …… ……
0 07 房屋管理费 00 00700
房屋租赁费 01 00701
租赁服务费 02 00702
物业管理费 03 00703
清洁费 04 00704
保安服务费 05 00705
电梯维护保养费 06 00706
绿化费 07 00707
停车费 08 00708
…… …… ……
0 08 代理服务费 00 00800
押运服务费 01 00801
票据传递费 02 00802
代理记账服务费 03 00803
…… …… ……
0 09 学教费 00 00900
报考费 01 00901
学杂费 02 00902
保教费 03 00903
…… …… ……
0 10 有线电视费 00 01000
有线电视租赁费 01 01001
移动电视费 02 01002
…… …… ……
0 11 机构管理费用 00 01100
工商行政管理费 01 01101
商检费 02 01102
…… …… ……
0 49 其他费用 00 04900
土地使用费 01 04901
加油卡费 02 04902
消费贷款 03 04903
…… …… ……
0 51 薪金报酬 00 05100
工资 01 05101
奖金 02 05102
养老金 03 05103
…… …… ……
0 99 其他代付费用 00 09900
付福利彩票奖金 01 09901
…… …… ……

银行编码


二级/三级商户行业

码值

二级/三级商户行业

码值

本地生活服务 1 教育培训 5
KTV 1001 教育培训 5001
电影/KTV 1002 其他票务 6
结婚婚庆 1003 4D/5D电影 6001
咖啡茶馆 1004 抵用券 6002
丽人 1005 电影 6003
美发洗浴 1006 门票 6004
其他娱乐 1007 演出赛事 6005
摄影 1008 汽车及配件 7
生活服务 1009 汽车服务 7001
休闲娱乐 1010 汽车用品 7002
养生休闲 1011 日用百货 8
运动健身 1012 8001
桌游电玩 1013 彩妆 8002
宠物用品 2 成人用品 8003
宠物护理 2001 服饰内衣 8004
宠物用品 2002 服装 8005
公益 3 服装鞋包 8006
抽奖公益 3001 个护化妆 8007
机票/旅游 4 户外用品 8008
出境游 4001 护肤保养 8009
国内游 4002 化妆工具 8010
豪华型酒店 4003 家纺 8011
经济型酒店 4004 家居家纺 8012
酒店 4005 家居家具 8013
酒店旅游 4006 家清纸品 8014
旅游 4007 健康护理 8015
特色酒店 4008 流行饰品 8016
团房 4009 母婴玩具 8017
小时房 4010 男士用品 8018
周边游 4011 男装 8019
食品 9 女性护理 8020
餐饮美食 9001 女装 8021
冲调 9002 时尚礼品 8022
蛋糕甜品 9003 童装 8023
地方菜 9004 玩具 8024
地方特产 9005 洗涤护理 8025
干货速食 9006 香水 8026
海鲜 9007 8027
火锅 9008 鞋包配饰 8028
进口食品 9009 婴儿服饰 8029
酒饮 9010 婴儿用品 8030
粮油调味 9011 孕妈用品 8031
茗茶 9012 珠宝眼镜 8032
其他美食 9013 收藏品 10
日韩亚料理 9014 配饰、奢侈品 10001
烧烤 9015 奢侈品 10002
食品茶酒 9016 其它
西餐 9017 缴费充值 13
小吃快餐 9018 今日新单 14
休闲零食 9019 母婴亲子 15
婴儿食品 9020 其他生活 16
营养保健 9021 全部商品 17
自助餐 9022 全部生活 18
图书音像 12 运动户外 19
图书文具 12001 运动休闲 20
数码电子 11 展览 21
办公设备 11001
大家电 11002
数码产品 11003
数码家电 11004
小家电 11005