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

发布时间 : 星期一 文章新一代商户接入手册V2.7更新完毕开始阅读

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 页

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 页

联系合同范文客服:xxxxx#qq.com(#替换为@)