http://www.ChinaPay.com Chinapay新一代商户接入手册
法性。
4. ChinaPay接受到退款订单后，即时地会返回给商户“退款接收成功”的应答。 【流程三】退款处理
5． ChinaPay与银行之间完成退款操作，其中会有人工干预操作过程，最终会产生退款结果信息。 6． 退款成功/失败应答会在退款处理后通过商户在提交退款信息时所填写的ReturnURL通知给商户。 7． 商户可以在控台上查看退款的进度及退款结果信息。 【流程四】退款完成
8． 退款操作完成。 4.3 查询交易流程
商户根据支付交易明细信息，组合符合ChinaPay规范的查询订单信息，通过ChinaPay系统进行交易明细查询操作，其查询处理流程包括查询确认、查询处理、查询完成三个部分，具体流程说明如下： 【流程一】查询确认
1． 商户形成查询订单信息。
2． 商户确认查询订单信息，该订单信息要符合ChinaPay的规范要求。 【流程二】查询处理
3． 商户确认查询订单后，以ChinaPay规范的数据格式向ChinaPay申请交易明细查询，ChinaPay验证商户合法性。
4． ChinaPay 按照商户信息及提交的查询订单信息进行交易明细查询处理。 【流程三】查询完成
5． ChinaPay服务器端程序在处理完交易明细查询请求之后即时地会返回给商户“查询结果”的应答。
6． 交易明细查询完成 。 4.4 对账处理流程
ChinaPay平台在每日对账完成后，会生成每个商户的对账文件，然后后台通知商户对账文件已经生成，文件的存放地址会在通知的URL地址中传递给商户。商户根据获得的对账文件地址，到该地址上去下载对账文件。
4.5 结算处理流程
ChinaPay平台在每日对账完成后，会生成每个商户的对账文件，然后后台通知商户对账文件已经生成，文件的存放地址会在通知的URL地址中传递给商户。商户根据获得的对账文件地址，到该地址上去下载对账文件。
5 数据类型定义
Ax
x字节定长的字母字符
x字节定长的字母或数字字符
x字节定长的字母、数字或特殊符号字符
第 31 页 共 35 页
Ax..y 长度为x-y字节的变长字母字符 ANx
ANx..y 长度为x-y字节的变长字母或数字字符 ANSx
http://www.ChinaPay.com Chinapay新一代商户接入手册
ANSx..y ASx Nx
长度为x-y字节的变长字母、数字或特殊符号字符 x字节定长的字母或特殊符号字符
x字节定长的整型数值，若表示金额，则以分为单位 x字节定长的数字符或特殊字符 x字节定长的特殊符号字符 秒 日 时 月 分
年（2字节） 年（4字节）
ASx..y 长度为x-y字节的变长字母或特殊符号字符
Nx..y 长度为x-y字节的整型数值，若表示金额，则以分为单位 NSx Sx ss DD hh MM mm YY
特殊符号说明：特殊符号仅限“{”、“}”、“[”、”]”、单引号、双引号、等号、逗号、冒号。
NSx..y 长度为x-y字节的数字字符或特殊字符 Sx..y 长度为x-y字节的变长特殊符号字符
YYYY
6 消费类交易接口
6.1 接入地址
ChinaPay的网上支付服务采用WEB服务的方式允许商户接入，接收交易数据的地址为： ?
测试环境请求地址： 1.
前台交易URL:
http://newpayment-test.chinapay.com/CTITS/service/rest/page/nref/000000000017/0/0/0/0/0 2. /0
说明：测试环境需要配置hosts，见附录A ?
生产环境请求地址： 1.
前台交易URL: 后台交易URL:
http://newpayment-test.chinapay.com/CTITS/service/rest/forward/sta/000000000017/0/0/0/0
https://payment.chinapay.com/CTITS/service/rest/page/nref/000000000017/0/0/0/0/0 2.
后台交易URL:
https://payment.chinapay.com/CTITS/service/rest/forward/sta/000000000017/0/0/0/0/0 说明：
走前台地址的交易：0001个人网银支付、0002企业网银支付、0004快捷支付、0005账单支付、0006认证支付、0007分期付款、0201预授权交易。
走后台地址的交易：0003授信交易。
第 32 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
6.2 请求报文
商户向ChinaPay的支付接入地址提交订单信息，表单采用“post”方式提交,提交页面中表单（FORM）的应该包括如下(注意各字段的大小写,编码方式统一用UTF-8)： 字段中文描述 版本号 接入类型 收单机构号 商户号 字 段 Version AccessType AcqCode MerId 是否必填 Y N N Y 长度 AN8 N1 N15 N15 AN1..32 N8 N6 N1..20 备注 固定值：20140728 0：商户身份接入（默认） 1：机构身份接入 ChinaPay分配 由ChinaPay分配的15位定长数字，用于确认商户身份 必填，变长 32位，同一商户同一交易日期内不可重复 商户提交交易的日期，例如交易日期为2015年1月2日，则值为20150102 商户提交交易的时间，例如交易时间10点11分22秒，则值为101122 单位：分 前台页面方式提交交易：商户可以不填此域，ChinaPay会根据商户交易配置在持卡人页面显示商户开通的交易类型，由持卡人选择商户已开通的交易类型完成支付 后台方式提交交易或支付机构号域有值，此域必填 交易类型 TranType N N4 此接口TranType填值范围： 0001个人网银支付 0002企业网银支付 0003授信交易 0004快捷支付 0005账单支付 0006认证支付 0007分期付款 0201预授权交易 业务类型 交易币种 BusiType CurryNo Y N N4 A3 固定值：0001 默认为人民币：CNY 不分账不填写此域； 分账类型 SplitType N N4 如需要分账，填写格式如下： 0001：实时分账 0002：延时分账 分账方式 SplitMethod N N1 订单分账方式 0：按金额分账 商户订单号 MerOrderNo Y 商户交易日期 TranDate Y 商户交易时间 订单金额 TranTime OrderAmt Y Y 第 33 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
1：按比例分账 商户订单分账信息 支付机构号 商户前台通知地址 分账数据，使用规则： MerSplitMsg N ANS0..512 AN15 ANS0..256 商户号^金额或比例;商户号^金额或比例 BankInstNo MerPageUrl N N 取值参见附录C 页面接受应答地址，用于引导使用者支付后返回商户网站页面 商户后台交易应答接收地址，ChinaPay商户后台通知地址 MerBgUrl Y ANS0..256 会根据后台商户响应来判定是否重新发送后台应答流水，以确保后台应答的接收 商品信息 商户私有域 CommodityMsg MerResv N N ANS0..128 用来描述购买商品的信息，ChinaPay原样返回 ANS0..1024 商户自定义，ChinaPay原样返回 交易扩展域，JSON格式填写,如：{\BusiId \P2\。商户自定义使用，商户可根据商户自定义业务字段BusiId来填写P1到P10参数， 系统会存储P1到P10参数数据，可供商户查询使用。 BusiId业务编号ANS0..8 商户根据自身业务情况，由CP分配业务编号，供商户使用，此域可和P1至P10配合使用，可以使P1至P10代表不同的业务含义 P1-P10业务参数ANS0..512 商户自定义使用 商户页面收集卡号的交易必填（如：0003授信交易、0006认证支付、0007分期付款、0008后台消费、0201预授权交易），JSON格式填写，如：{\CertType \ CertNo \CVV2\CardNo \ ANS0..1024 Password \，根据不同交易类型填写不同的卡信息，填写后进行BASE64编码，编码后采用RSA加密。包含字段：CertType、CertNo、CVV2、CardNo、Password、CardValidityPeriod 单位：分钟，以ChinaPay接收交易的N6 时间为准，超过此时间段后用户支付成功的交易，不通知商户，系统自动退款 交易扩展域 TranReserved N ANS0..1024 有卡交易信息域 CardTranData N 支付超时时间 PayTimeOut N 防钓鱼时间戳 TimeStamp N ANS0..20 商户系统时间毫秒数，如商户开户时开通了时间戳防钓鱼校验，ChinaPay系统第 34 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
配置商户系统时间和商户系统时间的时间差(以分钟为单位)，如时间超过系统配置的间隔，则会进行防钓鱼提示或拦截交易 客户浏览器端IP，如商户开通校验IP防钓鱼客户浏览器IP 防钓鱼验证，可填写此域做防钓鱼使RemoteAddr N ANS0..128 用。ChinaPay会获取持卡人访问IP和该字段进行比较，如果不一致，则会进行防钓鱼提示或拦截交易 Json格式，填写后进行BASE64编码，编码后采用RSA加密，加密后采用BASE64编码进行传输 MerUserId：商户端用户ID MerRegTime：商户端用户注册时间 MerRegEmail：商户端用户注册邮箱 MerRegMobileNo：商户端用户注册手机风控数据 RiskData N ANS0..1024 号 HDSerialNo：支付时使用的PC 硬盘序列号 Mac： 支付时使用的PC mac地址 IMEI： 支付时使用的手机串号IMEI Coordinate：支付时经纬度信息 BSSerialNo：支付时手机所在基站序列号 SmsFeture：短信验证码输入操作特征 签名 说明： ? ?
BankInstNo为可选项，表示 “支付机构号”，如填写BankInstNo（支付机构号），则消费者将直接进入支付页面，否则进入支付机构选择页面。 请求数据的签名验证
商户发送给ChinaPay的交易数据均需要进行数字签名。对于版本号为20140728的签名数据使用客户端chinapaysecure或SecssUtil进行签名、验签。 6.3 应答报文
当消费支付交易完成时，ChinaPay会将交易应答信息发送给商户，应答的数据域段包括如下内容：(以页面Form数据为例,注意大小写,编码方式统一用UTF-8，后台应答数据的发送的域段名和下面的一致) 字段中文描述 版本号 接入类型 收单机构号 字 段 Version AccessType AcqCode 是否必填 长度 Y N N AN8 N1 N15 备注 固定值：20140728 0：商户身份接入（默认） 1：机构身份接入 ChinaPay分配 Signature Y 商户报文签名信息，报文中的所有字段都参与签名（Signature除外） 第 35 页 共 35 页