发布时间 : 星期日 文章新一代商户接入手册V2.7更新完毕开始阅读
http://www.ChinaPay.com Chinapay新一代商户接入手册
有卡交易必填，JSON格式，根据不同交有卡交易信息域 CardTranData N ANS0..1024 易类型填写不同的卡信息;填写后采用RSA加密 单位：分钟，以ChinaPay接收交易的支付超时时间 PayTimeOut N N6 时间为准，超过此时间段后用户支付成功的交易，不通知商户，系统自动退款 商户系统时间毫秒数，如商户开户时开通了时间戳防钓鱼校验，ChinaPay系统防钓鱼时间戳 TimeStamp N ANS0..20 配置商户系统时间和商户系统时间的时间差(以分钟为单位)，如时间超过系统配置的间隔，则会进行防钓鱼提示或拦截交易 客户浏览器端IP，如商户开通校验IP防钓鱼客户浏览器IP 防钓鱼验证，可填写此域做防钓鱼使RemoteAddr N ANS0..128 用。ChinaPay会获取持卡人访问IP和该字段进行比较，如果不一致，则会进行防钓鱼提示或拦截交易 订单完成日期 CompleteDate N N8 N6 YYYYMMDD，支付完成后，ChinaPay返回支付完成日期 hhmmss，支付完成后，ChinaPay返回支付完成时间 商户报文签名信息，报文中的所有字段都参与签名（Signature除外） 订单完成时间 CompleteTime N 签名 说明： ?
Signature Y 应答数据的签名验证
支付交易完成后，支付应答会分前台页面跳转和后台Http通知方式返回给商户，商户需要对ChinaPay
返回报文签名进行验签，以确定此报文是由ChinaPay发出。
注：
后台返回字段需要通过urldecode进行解码后还原原始报文，前台返回报文无需此操作。 JAVA解码方法：URLDecoder.decode(value, \PHP解码方法：urldecode(value)
.NET解码方法：HttpUtility.UrlDecode(value,\
7 后续类交易接口
后续类交易主要是指对已发生的交易，做后续的相关的交易处理；包括：退款、退款撤销、退款重汇、消费撤销、预授权撤销、预授权完成撤销、预授权完成、通知分账。退款的相关操作也可以在企业门户系统中进行操作，但是商户只能选择一种方式进行操作。 7.1 接入地址
ChinaPay的网上支付服务采用WEB服务的方式允许商户接入，其中： ?
0401退款、0402退款撤销、0409退款重汇、9908通知分账的交易接收地址如下：
第 37 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
?
测试环境请求地址：
http://newpayment-test.chinapay.com/CTITS/service/rest/forward/syn/000000000065/0/0/0/0/0 ?
生产环境请求地址：
https://payment.chinapay.com/CTITS/service/rest/forward/syn/000000000065/0/0/0/0/0 ? ?
0403消费撤销、0203预授权撤销、0204预授权完成撤销、0202预授权完成的交易接收地址如下：
测试环境请求地址：
http://newpayment-test.chinapay.com/CTITS/service/rest/page/nref/000000000017/0/0/0/0/0
? 生产环境请求地址：
https://payment.chinapay.com/CTITS/service/rest/page/nref/000000000017/0/0/0/0/0
7.2 请求报文
商户向ChinaPay的交易平台提交订单，表单采用“post”方式提交,提交页面中表单（FORM）的应该包括如下(注意各字段的大小写,编码方式统一用UTF-8)： 字段中文描述 版本号 接入类型 收单机构号 商户号 商户订单号 商户交易日期 字 段 Version AccessType AcqCode MerId MerOrderNo TranDate 是否必填 长度 Y N N Y Y Y AN8 N1 N15 N15 AN1..32 N8 N6 AN1..32 N8 备注 固定值：20140728 0：商户身份接入（默认） 1：机构身份接入 ChinaPay分配 由ChinaPay分配的15位定长数字，用于确认商户身份 退款订单号 商户提交交易的日期，例如交易日期为2015年1月2日，则值为20150102 商户提交交易的时间，例如交易时间10点11分22秒，则值为101122 原始交易订单号 商户原始支付交易日期 单位：分 当TranType=0401退款交易时 退款金额 RefundAmt N N1..20 RefundAmt必填 当TranType为其他值时，交易时不能传RefundAmt 单位：分 当TranType=0202或9908时，OrderAmt订单金额 OrderAmt N N1..20 必填 当TranType为其他值，交易时不能传OrderAmt 交易类型 TranType Y N4 第 38 页 共 35 页
此接口TranType填值范围： 商户交易时间 商户交易订单号 原始商户交易日期 TranTime OriOrderNo OriTranDate Y Y Y
http://www.ChinaPay.com Chinapay新一代商户接入手册
0403消费撤销 0401退款交易 0202预授权完成 0203预授权撤销 0204预授权完成撤销 0402 退款撤销 0409 退款重汇 9908 通知分账 业务类型 BusiType Y N4 固定值：0001 商户后台交易应答接收地址，ChinaPay商户后台通知地址 MerBgUrl N ANS0..256 会根据后台商户响应来判定是否重新发送后台应答流水，以确保后台应答的接收 交易币种 CurryNo N A3 默认为人民币：CNY 不分账不填写此域； 如需要分账，填写格式如下： 分账类型 SplitType N N4 0001：实时分账 0002：延时分账 分账交易退款，此字段传0001 订单分账方式 分账方式 SplitMethod N N1 0：按金额分账 1：按比例分账 商户订单分账信息 商户私有域 分账数据，使用规则： MerSplitMsg N ANS0..512 商户号^金额或比例;商户号^金额或比例 MerResv N ANS0..1024 商户自定义，ChinaPay原样返回 交易扩展域，JSON格式填写,如：{\BusiId \P2\。商户自定义使用，商户可根据商户自定义业务字段BusiId来填写P1到P10参数， 系统会存储P1到P10参数数据，可供商户交易扩展域 TranReserved N ANS0..1024 查询使用。 BusiId业务编号ANS0..8 商户根据自身业务情况，由CP分配业务编号，供商户使用，此域可和P1至P10配合使用，可以使P1至P10代表不同的业务含义 P1-P10业务参数ANS0..512 商户自定义使用 签名 说明：
第 39 页 共 35 页
Signature Y 商户报文签名信息，报文中的所有字段都参与签名（Signature除外）
http://www.ChinaPay.com Chinapay新一代商户接入手册
?
交易数据的数字签名
商户发送给ChinaPay的交易数据均需要进行数字签名。对于版本号为20140728的签名数据使用客户端chinapaysecure或SecssUtil进行签名、验签。 7.3 同步响应
对于0401退款、0402退款撤销、0409退款重汇、9908通知分账的交易，当ChinaPay交易平台接收商户提交的订单后，会返回商户同步处理结果。包括如下(响应数据以key=value形式，用”&”符号分隔)： 字段中文描述 字 段 是否必填 长度 备注 0000：成功 响应码 respCode Y AN4 1003：商户已审核 其他为失败。 响应码描述 签名 说明： ?
交易数据的数字签名
ChinaPay返回给商户同步应答时，会对响应码、响应码描述进行签名，商户需要进行验签。 7.4 应答报文
当ChinaPay交易平台处理完成时，ChinaPay会将订单信息发送给商户，应答的数据域段包括如下内容：(以页面Form数据为例,注意大小写,编码方式统一用UTF-8，后台应答数据的发送的域段名和下面的一致) 字段中文描述 版本号 接入类型 收单机构号 商户号 商户订单号 商户交易日期 商户交易时间 商户交易订单号 原始商户交易日期 退款金额 字 段 Version AccessType AcqCode MerId MerOrderNo TranDate TranTime OriOrderNo OriTranDate 是否必填 长度 Y N N Y N Y Y Y Y AN8 N1 N15 N15 AN1..32 N8 N6 AN1..32 N8 N1..20 N1..20 N4 N4 A3 第 40 页 共 35 页
备注 固定值：20140728 0：商户身份接入（默认） 1：机构身份接入 ChinaPay分配 由ChinaPay分配的15位定长数字，用于确认商户身份 退款订单号 年月日 时分秒 原始交易订单号 商户原始支付交易日期 单位：分 当TranType=0401退款交易时返回 单位：分 当TranType=0202预授权完成时返回 0401 0001 默认为人民币：CNY respMsg Signature Y Y ANS0..128 响应码描述 商户报文签名信息，respCode+respMsg的签名 RefundAmt N 订单金额 交易类型 业务类型 交易币种 OrderAmt TranType BusiType CurryNo N Y Y N