发布时间 : 星期一 文章新一代商户接入手册V2.7更新完毕开始阅读
http://www.ChinaPay.com Chinapay新一代商户接入手册
订单状态 分账类型 分账方式 商户订单分账信息 收单流水号 收单日期 商户私有域 交易扩展域 订单完成日期 订单完成时间 签名 说明： ?
应答数据的签名验证
支付交易完成后，支付应答会分前台页面跳转和后台Http通知方式返回给商户，商户需要对ChinaPay返回报文签名进行验签，以确定此报文是由ChinaPay发出。
注：
后台返回字段需要通过urldecode进行解码后还原原始报文，前台返回报文无需此操作。 JAVA解码方法：URLDecoder.decode(value, \PHP解码方法：urldecode(value)
.NET解码方法：HttpUtility.UrlDecode(value,\
OrderStatus SplitType SplitMethod MerSplitMsg AcqSeqId AcqDate MerResv TranReserved CompleteDate CompleteTime Signature Y N N N N N N N N N Y AN4 N4 N1 ANS0..512 AN16 AN8 0000为成功，详见附录B 原样返回交易请求数据 原样返回交易请求数据 原样返回交易请求数据 ChinaPay收单系统交易受理流水号 YYYYMMDD ANS0..1024 商户自定义，ChinaPay原样返回 ANS0..1024 商户交易请求内容原样返回 N8 N6 YYYMMDD hhmmss 商户报文签名信息，报文中的所有字段都参与签名（Signature除外） 8 交易查询接口
8.1 接入地址
ChinaPay的网上支付服务采用WEB服务的方式允许商户接入，接收交易数据的地址为： 测试环境：
http://newpayment-test.chinapay.com/CTITS/service/rest/forward/syn/000000000060/0/0/0/0/0 生产环境：
https://payment.chinapay.com/CTITS/service/rest/forward/syn/000000000060/0/0/0/0/0 8.2 请求报文
商户向ChinaPay的支付接入地址提交订单信息，表单采用“post”方式提交,提交页面中表单（FORM）的应该包括如下(注意各字段的大小写,编码方式统一用UTF-8)： 字段中文描述 版本号 商户号 商户订单号 商户交易日期 字 段 Version MerId MerOrderNo TranDate 是否必填 长度 Y Y Y Y AN8 N15 AN1..32 N8 第 41 页 共 35 页
备注 固定值：20140728 由ChinaPay分配的15位定长数字，用于确认商户身份 商户订单号 格式：yyyyMMdd
http://www.ChinaPay.com Chinapay新一代商户接入手册
商户交易时间 交易类型 业务类型 TranTime TranType BusiType N Y Y N6 N4 N4 格式：HHmmss 0502 固定值：0001 交易扩展域，JSON格式填写,如：{\BusiId \P2\。商户自定义使用，商户可根据商户自定义业务字段BusiId来填写P1到P10参数， 系统会存储P1到P10参数数据，可供商户交易扩展域 TranReserved N ANS0..1024 查询使用。 BusiId业务编号ANS0..8 商户根据自身业务情况，由CP分配业务编号，供商户使用，此域可和P1至P10配合使用，可以使P1至P10代表不同的业务含义 P1-P10业务参数ANS0..512 商户自定义使用 签名 说明： ?
交易数据的数字签名
商户发送给ChinaPay的交易数据均需要进行数字签名。对于版本号为20140728的签名数据使用客户端chinapaysecure或SecssUtil进行签名、验签。 8.3 应答报文
ChinaPay同步返回查询结果应答给商户，以下是否原始报文为“Y”的表示返回的报文数据为商户提交的原始报文数据，应答的数据域段包括如下内容：(应答数据格式为：k1=v1&?&kn=vn,key值注意大小写,编码方式统一用UTF-8),若查询失败，只返回应答码和应答信息。 字段中文描述 响应码 字 段 respCode 是否必填 Y 长度 AN4 ANS0..128 AN8 N1 N15 N15 备注 0000：查询成功 其他：查询失败 响应码描述 固定值：20140728 0：商户身份接入（默认） 1：机构身份接入 ChinaPay分配 由ChinaPay分配的15位定长数字，用于确认商户身份 Signature Y 商户报文签名信息，报文中的所有字段都参与签名（Signature除外） 响应码描述 版本号 接入类型 收单机构号 商户号 商户订单号 商户交易日期 商户私有域信息 respMsg Version AccessType AcqCode MerId MerOrderNo TranDate MerResv Y Y N N Y N Y N AN1..32 商户订单号 N8 ANS0..1YYYYMMDD ChinaPay原样返回 第 42 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
024 订单状态 订单金额 已退款金额 交易币种 分账类型 分账方式 OrderStatus OrderAmt RefundSumAmount CurryNo SplitType SplitMethod Y Y Y N N N N N N N N N Y AN4 N1..20 N1..20 A3 N4 N1 ANS0..512 AN16 AN8 ANS0..1024 N8 N6 0000表示支付成功，详见附录B 单位：分 单位：分 若未退款则为 0 默认为人民币：CNY 原样返回交易请求数据 原样返回交易请求数据 原样返回交易请求数据 ChinaPay收单系统交易受理流水号 YYYYMMDD 交易扩展域，JSON格式，BusiId和P1-P10组成的json字符串 YYYMMDD hhmmss 商户报文签名信息，报文中的所有字段都参与签名（Signature除外） 商户订单分账信息 MerSplitMsg 收单流水号 收单日期 交易扩展域 订单完成日期 订单完成时间 签名 说明：
AcqSeqId AcqDate TranReserved CompleteDate CompleteTime Signature respCode表示同步应答码，只有\才为处理成功，其他均为处理失败。 ?
应答数据的签名验证
支付交易完成后，支付应答会分前台页面跳转和后台Http通知方式返回给商户，商户需要对ChinaPay返回报文签名进行验签，以确定此报文是由ChinaPay发出。
9 交易对账接口
9.1 概述
对于已经提交给ChinaPay平台的交易，ChinaPay会在第二天生成商户对账文件，包括T-1日商户所有的交易（其中退款交易为商户已审核通过的退款明细），以供商户对账使用。对账文件生成后，ChinaPay后台通知商户下载或是通过FTP推送给商户。使用该接口，商户需要事先联系我司运营中心（95534-6；cp_operation@chinapay.com），进行接收地址/FTP地址的配置，配置完成后方可使用。 9.2 通知商户的地址规范
目前商户获取对账文件，有http通知及FTP推送两种方式，具体说明如下： 9.2.1
https方式
1）商户提供https地址（不能包含参数）
2）ChinaPay向商户提供的URL发送请求，请求中包含对账文件下载地址，其中：download为参数名称 序号 1 字段 download 含义 文件下载地示例 https://xxx.xxx.xxx/xxxx/000050000022826_20150627_2015062915500第 43 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
址 0_x_y.txt.zip 3）商户地址收到ChinaPay的通知请求后，需返回包含“ChinapayOK”，表示商户已收到通知。否则ChinaPay会反复通知5次后停止重发；商户如有需要，可联系ChinaPay运营中心，由人工重发通知。
4）ChinaPay保留三周的下载文件 9.2.2
ftp方式
1）商户提供ftp地址，路径、用户名及密码 2）ChinaPay向商户提供的ftp地址推送对账文件
3）ChinaPay向商户ftp推送对账文件失败后，ChinaPay会反复推送5次后停止推送；商户如有需要，可联系ChinaPay运营中心，由人工重新发送。
4）ChinaPay保留三周的下载文件 9.3 对账文件名规则
文件名格式：商户号_支付日期_生成文件时间戳（yyyyMMddHHmmss）_x_y.txt.zip 1. 商户号:长度15位 2. 支付成功日期:8位 3. 时间戳:yyyyMMddHHmmss
4. x是对账文件总个数，y是第几个文件，如果某一天的对账文件太大，ChinaPay会分开发送
例如: 000050000022826_20150627_20150629155000_2_1.txt.zip 9.4 商户对账文件格式（版本号：20150813）
?
商户对账文本提交数据内容
文件样例如下：
1. 每行各字段用竖线分隔 2. 首行为汇总信息，依次为： 字段 Version countPay countPayAmt countPaySuc countPaySucAmt countPayCancel countPayCancelAmt countPayCancelSuc countPayCancelAmtSuc countRefundSuc countRefundAmtSuc countRefundCancel countRefundCancelAmt countRefundCancelSuc 含义 对账文件版本号 支付总笔数 支付总金额 支付成功笔数 支付成功金额 支付撤销总笔数 支付撤销总金额 支付撤销成功笔数 支付撤销成功金额 退款总笔数 退款总金额 退款撤销总笔数 退款撤销总金额 退款撤销成功笔数 格式 8位 整数，如123 小数，如123.45 整数，如123 小数，如123.45 整数，如123 小数，如123.45 整数，如123 小数，如123.45 整数，如123 小数，如123.45 整数，如123 小数，如123.45 整数，如123 小数，如123.45 countRefundCancelAmtSuc 退款撤销成功金额 第 44 页 共 35 页