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

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