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

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

商户号 MerId Y N15 AN1..32 N8 N6 N1..20 由ChinaPay分配的15位定长数字，用于确认商户身份 必填，变长 32位，同一商户同一交易日期内不可重复 商户提交交易的日期，例如交易日期为2015年1月2日，则值为20150102 商户提交交易的时间，例如交易时间10点11分22秒，则值为101122 单位：分 此接口TranType填值范围： 0001个人网银支付 0002企业网银支付 0003授信交易 交易类型 TranType Y N4 0004快捷支付 0005账单支付 0006认证支付 0007分期付款 0201预授权交易 业务类型 交易币种 BusiType CurryNo Y N N4 A3 AN4 N4 N1 ANS0..512 AN16 AN8 N8 N8 N6 N1..20 AN15 ANS0..128 固定值：0001 默认为人民币：CNY 0000为支付成功状态，0001为未支付，订单支付状态 OrderStatus Y 其它为失败状态，响应码列表参见附录B 分账类型 分账方式 商户订单分账信息 收单流水号 收单日期 渠道流水号 渠道日期 渠道时间 支付账单号 支付机构号 商品信息 商户私有域 交易扩展域 SplitType SplitMethod N N 原样返回交易请求数据 原样返回交易请求数据 分账数据，使用规则： MerSplitMsg N 商户号^金额或比例;商户号^金额或比例 AcqSeqId AcqDate ChannelSeqId ChannelDate ChannelTime PayBillNo BankInstNo CommodityMsg MerResv TranReserved N N N N N N N Y N N ChinaPay收单系统交易受理流水号 ChinaPay系统收单交易受理日期，格式：YYYYMMDD 支付渠道返回给ChinaPay的订单号 支付渠道返回给ChinaPay的交易日期 支付渠道返回给ChinaPay的交易时间 交易类型为账单支付时，下单时返回给商户的账单号 取值参见附录C 用来描述购买商品的信息，ChinaPay原样返回 商户订单号 MerOrderNo Y 商户交易日期 TranDate Y 商户交易时间 订单金额 TranTime OrderAmt Y Y ANS0..1024 商户自定义，ChinaPay原样返回 ANS0..1024 交易扩展域，JSON格式填写，商户交易请求内容原样返回 第 36 页 共 35 页

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 商户自定义 …… 此处隐藏：3717字，全部文档内容请下载后查看。喜欢就下载吧 ……