新一代商户接入手册V2.7(10)

http://www.ChinaPay.com Chinapay新一代商户接入手册

20140701|120|20000|1|50|1|10|1|10 20140630|88020000|000050000022826|?? 20140630|88020000|000050000022826|?? Signature签名信息

如上，Signature为对整个文档签名得到的签名数据信息，换行符没有参与签名。 备注：

因为每行数据字段是用“|”隔开的。如果商户私有域数据里面含有“|”符号，这里将使用空格代替商户私有域中的“|”符号。假设商户私有域为”123|6666”替换为”123 6666” 其中签名验证是按照修改后的商户私有域数据来进行验签的。即”123 6666” 每个对账文件中交易笔数上限200万条，超过200万条的交易会另出一个对账文件。

?

交易数据的数字签名

商户接收到的ChinaPay对账文件，需要对其验证签名以确定是由ChinaPay发出的对账文件的合法性。

10 结算对账接口

10.1 概述

对于已经提交给ChinaPay平台的交易，ChinaPay会在到达商户结算周期时，产生商户的结算明细文件，供商户做资金核对、交易对账使用。结算文件生成后，ChinaPay后台通知商户下载或是通过FTP推送给商户。使用该接口，商户需要事先联系我司运营中心（95534-6；cp_operation@chinapay.com），进行接收地址/FTP地址的配置，配置完成后方可使用。 10.2 通知商户的地址规范

目前商户获取结算文件，有https通知及FTP推送两种方式，具体说明如下： 10.2.1 https方式

1）商户提供https地址（不能包含参数）

2）ChinaPay向商户提供的URL发送请求，请求中包含结算文件下载地址，其中：download为参数名称 序号 1 字段 download 含义 文件下载地址 示例 https://xxx.xxx.xxx/xxxx/000050000022826_20150627_20150629155000.txt.zip 3）商户地址收到ChinaPay的通知请求后，需返回包含“ChinapayOK”，表示商户已收到通知。否则ChinaPay会反复通知5次后停止重发；商户如有需要，可联系ChinaPay运营中心，由人工重发通知。

4）ChinaPay保留一周的下载文件 10.2.2

ftp方式

1）商户提供ftp地址，路径、用户名及密码 2）ChinaPay向商户提供的ftp地址推送结算文件

3）ChinaPay向商户ftp推送结算文件失败后，ChinaPay会反复推送5次后停止推送；商户如有需要，可联系ChinaPay运营中心，由人工重新发送。

第 46 页 共 35 页

http://www.ChinaPay.com Chinapay新一代商户接入手册

4）ChinaPay保留一周的下载文件 10.3 结算文件名规则

结算文件名规则文件名格式：商户号_结算日期_生成文件时间戳（yyyyMMddHHmmss）.txt.zip 1. 商户号:长度15位 2. 支付成功日期:8位 3. 时间戳:yyyyMMddHHmmss

例如: 000050000022826_20150627_20150629155000.txt.zip 10.4 商户结算文件格式（版本号：20150813）

?

文件样例如下：

1. 每行各字段用竖线分隔 2. 首行为汇总信息，依次为： 字段 Version liqDate PurCnt PurAmt FeeAmt RefCnt RefAmt RefCancelCnt RefCancelAmt ReverseCnt ReverseAmt LiqAmt 含义 结算文件版本号 结算日期 支付笔数 支付金额 手续费金额 退款笔数 退款金额 退款撤销笔数 退款撤销金额 冲正笔数 冲正金额 结算金额 格式 8位 YYYYMMDD 整数，如123 小数，如123.45 小数，如123.45 整数，如123 小数，如123.45 整数，如123 小数，如123.45 整数，如123 小数，如123.45 小数，如123.45 3. 第二行开始为明细，字段含义如下表所示： 序号 字段 1 2 3 4 5 6 7 8 9 10 11 TranDate AcqCode MerId 含义 交易日期 收单机构号 商户号 示例 固定000000000000014 json字符串，包含BusiId、P1-P10 YYYYMMDD CNY 0001：个人网银支付 0401：退款 OrderStatus 订单状态 0000：成功 TranReserved 交易扩展域 LiqDate MerOrderNo BankInstNo CurryNo TranType 清算日期 商户订单号 支付机构号 币种 交易类型 CompleteDate 支付成功日期（时分秒） YYYYMMDD 收到银行应答的日期 第 47 页 共 35 页

http://www.ChinaPay.com Chinapay新一代商户接入手册

12 13 14 15 16 CompleteTime 支付完成时间（时分秒） HHSSMM 收到银行应答的时间 OrderAmt 订单金额 0D:未知 01:借记卡 17 02:贷记卡 05:预付费 06:存折 18 19 20 21 22 23 MerResv AcqDate AcqTime AcqSeqId OriTranDate OriOrderNo 商户私有域 ChinaPay日期 ChinaPay时间 ChinaPay流水号 原始支付商户日期 原始支付交易订单号 ChinaPay日期 ChinaPay时间 ChinaPay流水号 原商户订单支付日期 原商户订单号 RefundAmount 退款金额 FeeAmt LiqAmt DCMark 手续费 结算金额 借贷标示 最后一行为整个文件的签名信息 文件示例：

20140701|120|20000|20|1|50|1|10|1|10|19950 20140630|88020000|000050000022826|?? 20140630|88020000|000050000022826|?? ??

Signature签名信息

如上，Signature为对整个文档签名得到的签名数据信息，换行符没有参与签名。 备注：

因为每行数据字段是用“|”隔开的。如果商户私有域数据里面含有“|”符号，这里将使用空格代替商户私有域中的“|”符号。假设商户私有域为”123|6666”替换为”123 6666” 其中签名验证是按照修改后的商户私有域数据来进行验签的。即”123 6666”

?

交易数据的数字签名

商户接收到的ChinaPay对账文件，需要对其验证签名以确定是由ChinaPay发出的对账文件的合法性。

11 附录A 常见接入问题及解答

1、 开发过程中，商户签名报SecurityException异常

检查交易证书密码是否配置正确，并检查配置文件security.properties是否配置正确。 需要将security.properties放在类路径下，并配置如下： #交易证书路径

sign.file=D:/cert_cp/000000000000001.pfx

第 48 页 共 35 页

http://www.ChinaPay.com Chinapay新一代商户接入手册

#交易证书密码

sign.file.password=123456 #交易证书的密钥容器格式 sign.cert.type=PKCS12

#报文中不参与签名的字段名称，多个字段用逗号进行分隔 sign.invalid.fields=Signature,CertId #验签证书路径

verify.file=D:/cert_cp/cp_test.cer #签名值字段名称

signature.field=Signature

2、 开发过程中，商户签名报“未初始化配置”异常

检查签名或验签之前是否调用SecssUtil.init();方法，如果未调用，则调用SecssUtil.init()方法初始化安全签名配置

3、 签名过程出现 Illegal key size错误

请检查下载的pfx证书是否正确，或者重新申请CFCA交易证书 4、 交易失败！错误信息：证书未配置

这个报错通常有两个原因，一是没有申请交易证书，二是交易地址提交错误，测试地址和正式地址搞错了。

5、 交易失败！错误信息：验签失败。

需要确认交易证书在Internet选项---内容---证书---颁发给的名字和在商户服务管理系统里面查到的交易证书的证书名称是一样的。证书确认没有问题，需要确认参加签名的字段和传过来的字段是一样的。

12 附录B 应答码说明

状态码 状态描述 0000 0001 0002 0003 0004 0005 0006 0007 000 …… 此处隐藏：2856字，全部文档内容请下载后查看。喜欢就下载吧 ……