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

发布时间 : 星期日 文章新一代商户接入手册V2.7更新完毕开始阅读

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

3. 第二行开始为明细,字段含义如下表所示: 序号 字段 1 2 3 4 5 6 7 8 TranDate AcqCode MerId TranReserved LiqDate MerOrderNo BankInstNo CurryNo TranType 含义 交易日期 收单机构号 商户号 交易扩展域 清算日期 商户订单号 支付机构号 币种 交易类型 示例 商户提交日期 固定000000000000014 json字符串,包含BusiId、P1-P10 备用,目前为空值 CNY 0001个人网银支付 0002企业网银支付 0003授信交易 0004快捷支付 9 0005账单支付 0006认证支付 0007分期付款 0202预授权完成交易 0401:退款 0402:退款撤销 10 11 12 13 BusiType OrderStatus 业务类型 订单状态 0000:成功 其他:非成功(具体含义参见附录B) ChannelRespCode 渠道应答码 CompleteDate 支付完成日期(年月日) YYYYMMDD -收单收到银行应答的日期 14 15 16 17 18 19 20 CompleteTime 支付完成时间(时分秒) HHSSMM -收单收到银行应答的时间 交易金额 ChinaPay流水号 ChinaPay日期 ChinaPay时间 原始支付商户日期 原始支付交易订单号 借贷标示 单位:分(20位) ChinaPay流水号 ChinaPay流水日期 ChinaPay时间 原商户订单支付日期 原商户订单号 0D:未知 01:借记卡 02:贷记卡 05:预付费 06:存折 OrderAmt AcqSeqId AcqDate AcqTime OriTranDate OriOrderNo DCMark 21 22 MerResv 商户保留域 文件最后一行为整个文件的签名串 文件示例:

第 45 页 共 35 页

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 页

联系合同范文客服:xxxxx#qq.com(#替换为@)