统一收单系统及商户管理系统.docx
《统一收单系统及商户管理系统.docx》由会员分享,可在线阅读,更多相关《统一收单系统及商户管理系统.docx(86页珍藏版)》请在课桌文档上搜索。
1、统一收单系统及商户管理系统平台接入接口规范V2.3统一收单项目组文档修改记录版本日期说明修订人V0.920201022增加了3.1加签数据域以及说明泰万科V1.020201027修改了退款查询响应报文对应的英文名称域秦万科V1.1.202010291 .公众号!濯序支付,被扫,退款交易中增加了必输字段48域WhetherNotify,取值00时,2域backUr1.必传.2 .消息结果通知和退款入账通知中增加了backr1.秦万科V1.2202011041.秦万科V1.5202101211.报文头增加了Cfca证书序列号,请求方系统代码,是否加验签标志2 .主扫下单接口增加了二维码类型字段3
2、.加签数据组装步骤,去除e步骤4 .报文结构中报文头,VerSion属性不可为空5 .接口访问路径补全秦万科V1.6202104261.收款查询请求参数中增加统一收单订单号OrderN。2.增加杳询方式queryF1.ag字段泰万科V1.7202108251.中邮消金商户查询接口、海牙湾查询实体商户接口添加郑传振V1.8202110186.16支付宝服务窗接口添加6.11兼容唐闸古镇对账单/结算单下载郑传振V1.920211227增加6.2预下单(H5支付);增加终端信息terminfo必输项被扫消费添加单品优惠秦万科V2.020220108增加6.19申请支付二维码郑传振V2.1202201
3、28针对人行259号文,进行主被扫交易,公众号交易的字段新增终端设备信息域,被扫交易中4.5.37终端信息中新增多项必送字段,地区信息必输增加6.17终端报备接口秦万科V2.220220308添加说明:支付类交易需进行终端报备郑传振V2.3202203111) terminfo改为必传字段,涉及接口:1.1 微信公众号/灌序支付1.2 支付宝服务窗接口1.3 被扫二维码消费1.4 申请动态二维码1.10 申请支付二维码2) 6.17终端报备去除部分字段:appid、mch1.dSUbMChId、SubMerchantIdmerchantNamesignsignTypeCert1.d、nonce
4、StrmerchantRemarkexternaIId郑传振3)删除ChannHId、ChanneINamexareainfo属性涉及接口:6.1 微信公众号/小程序支付6.2 支付宝服务窗接口6.3 被扫二维码消费文档目录目录文档修改记录-1-文档目录-3-1 .范国-4-2 .通信方式-4-2.1 证书交换-4-3 .报文结构-5-3.1 加签数据-5-3.2 加验签流程-6-3.3 加验签步骤-7-4 .报文数据元说明-7-4.1 数据元编码编码格式-7-4.2 数据元长度计算-7-4.3 数据元类型定义-7-4.4 数据元出现要求的符号约定-8-4.5 数据元说明-8-5 .交易流程-
5、50-5.1 主扫;薪呈-50-5.2 被扫;薪呈-50-5.3 公众号/小程序Sg-51-6 .交易报文-51-6.1 微信公众号/小程序支付-51-6.2 支付宝服务窗接口-53-6.3 被扫二维码消费-54-6.4 申请动态二维码-56-6.5 消费结果通知-57-6.6 收款查询-58-6.7 退款-60-6.8 退款交易查询-61-6.9 订单关闭-62-6.10 申请支付二维码-63-6.11 对账单下载-64-6.12 对账单文件-65-6.13 商户结算单文件-69-6.14 对账单传输(内部使用)-70-6.15 中邮消金商户查询接口-71-6.16 海牙湾查询实体商户接口-
6、72-6.17 终端报备接口-73-7 .附录-75-7.1 微信支付渠道银行类型码表-75-7.2 支付宝支付渠道取值码表-85-1.范围本规范规定了通过互联网与统一收单系统及商户管理系统交易的平台商户之间进行联机交易时使用的报文接口和文件接口2 .通信方式接口采用HTTPS通讯协议协议,报文采用JSON格式UTF-8编码。2.1 证书交换统一收单系统对接平台商户需要向CFCA申请复合证书,一个用于商户签名,另外一个用于报文加密。平台商户入驻成功后,证书通过商户PC端自助申请和下载。具体流程说明如下:1 .平台商户入驻成功后,商户登录商户服务PC端点击证书申请功能进入证书申请页面;2 .平台
7、商户登录成功后,填写申请两码DN的必要信息并提交,统一收单通过联机交易调用邮储银行RA系统,RA访问CFCA申请两码;3 .两码申请成功后返回给商户PC端显示;4 .生成两码后商户可以点击网页中CFCA连接跳转到CFCA官网下载证书;5 .商户下载签名证书后,将公钥证书上传到统一收单系统,统一收单系统绑定证书和商户的关系,该Cfca证书用于平台商户交易签名6 .商户下载加密证书(该证书用于交易报文加密),将证书上传到统一收单系统,统一收单系统绑定证书和商户的关系。3.报文结构统一收单系统报文分为两部分:通用域和业务参数域(业务参数域详见具体交易),所有的请求和响应报文都必须包含通用域,通用域定
8、义如下:字段名称字段名称version接口版本(必传)txnCode交易码,响应时原样返回ChanneIID渠道ID,标识交易发起渠道,响应时原样返回p1.atformID平台编号,由统一收单系统分配reqTraceID请求方交易流水号或者订单号,交易唯一值,响应时原样返回reqDate请求方交易时间,响应时原样返回,格式:YYYYMMddHHmmSSreqReserved请求方自定义字段,响应时原样返回(可空)certNumCFCA证书序列号reqSysId请求方系统代码(11位),响应时原样返回isSign是否签名,O-免签,I-验签值为0时,signature域可不需要上送signatu
9、re签名域pubSer特殊域,服务开放平台,从服务开发平台进入的交易必输SerOpenPIat3.1 加签数据对于需计算消息鉴别码的报文,以下数据元(见下表)只要出现,就应该包含在MAC计算中。表1MAC应计算的数据字段表序号字段字段名称字段类型1txnCode交易唯一标识04)2p1.atformID平台编号,由统一收单系统分配C(15)3reqTraceID请求方交易流水号C(32)序号字段字段名称字段类型4reqDate请求方交易时间C(14)5txnAMT交易金额M(14)6mchtNo商户号C(15)7respCd响应码C(16)首先,对报文中需要出现在签名域(signature)的
10、数据元(加签数据mac)采用key:va1.ue的形式按照key的序号JI顶序排序,拼接排序时只需要使用va1.ue的值进行JI顶序拼接即可,然后以空格作为连接符拼接成待签名串。然后,对待签名串使用加签处理,最后生成的签名域放入此字段中。MAC块元的构成规则MAc数据元的选取将根据上表中字段是否出现在报文中来确定,上述字段只要出现在报文中,应截下送入MAC计算数据元;数据元数据元之间应插入一个空格。对所选择的MAC报文数据元,应进一步作字符处理。除去一些冗余信息,以提高MAC的质量。处理方法如下:a)在数据元数据元之间插入一个空格;b)除了字母(A-Z,a-z),数字(0-9),空格,逗号(,
11、)和点号(.)以外的字母都删去;c)删去打头空格和结尾空格;d)多于一个的连续空格,由一个空格代替;例如:0001323.2 加验签流程3.3 加验签步骤3.3.1 加签1)组装macbuff签名域(待签名数据);2 )待签名数据进行带证书公钥参与的SM3哈希;3 )对上一结果进行SM2私钥加密;4 )对上一步结果进行Asn1.(der)编码;5 )对上一步结果进行Base64编码;6 )将上一步结果得到的值放入报文头signature(签名域)字段中。3.3.2验签1)根据响应报文(报文头和报文体)得到签名字段的值;2 )对响应报文头中signature值(签名值)编码进行base64解码,
12、得到der编码签名值;3 )对第二步进行der解码得到签名值;4 )使用第一步得到的值根据macbuff组装规则进行加签串组装;5 )对第四步组装好的签名串计算出哈希值;6 )进行公钥,签名值,哈希值,验签。4.报文数据元说明4.1 数据元编码编码格式糠源采用UTF-8格式编码。4.2 数据元长度计算所有数据元的长度均按照字符计算,一个汉字算一个字符。4.3 数据元类型定义符号含义SS秒mm恻DD日符号含义HH小时(24小时制)MM月YY年(2字符)YYYY年(4字符)4.4 数据元出现要求的符号约定标识幡元在交易报文中的出现要求:醋R含义M必须填写的域C某条件成立时必须填写的域C+某条件成立
13、时增加的域C-某条件成立时删除的域M+必须增加的域0自选填写的域4.5 数据元说明幡元标识首字母4泻,如果包含多个单词的,后续单词首字母大写。4.5.1 backUr1.交易遨口地址4.5.1.1 属性string(200)4.5.12描述48域WhetherNotify取值OO时,该域必传;平台或者合作机构在对接统一收单系统时应登记默认接收地址,同时可以在交易请求终端重新指定新的地址,或者的优先级高。如果采用专线通信,则UR1.前需要增加ZX,例如ZX|:5/some,如果通过公网通信接入则直接取值:https/1.2.3.4:5/someo4.5.2 bodyWX微信侧商品描述信息。4.5
14、.2.1 属性string(128)o4.5.2.2 描述商品描述交易字段格式根据不同的应用场景按照以下格式:1. PC网站一传入浏览器打开的网站主页tit1.e名-实际商品名称,例如:腾讯充值中心-QQ会员充值;2. 公众号传入公众号名称-实际商品名称,例如:腾讯形象店-image-QQ公仔;3. H5应用在浏览器网页上的场景,传入浏览器打开的移动网页的主页tit1.e名-实际商品名称,例如:腾讯充值中心-QQ会员充值;4. 线下门店门店品牌名-城市分店名-实际商品名称,例如:image形象店-深圳腾大-QQ公仔);5. APP需传入应用市场上的APP名字-实际商品名称,天天爱消除-游戏充值
15、。4.5.3 ChanneIID交易发起渠道。4.5.3.1 属性string(2)4.53.2描述取值说明如下:取值取值说明备注O1.智能;02扫码盒子;03人脸支付终端;04商户APP;05通用行业APP;06手机银行;07微信银行;08行业接入渠道09平台接入渠道10外部机构接入99其他系统4.5.4 CurrenyCode交易币种4.5.4.1 属性string(3)4.5.4.2 描述当前仅支持人民币支付,取值:156o4.5.5 extPayType订单支付渠道类型。4.5.5.1 属性string(2)4.5.5.2 描述取值说明如下:取值取值说明备注O1.银联02微信03支付宝
16、04银联主扫05银联被扫06微信主扫07微信被扫08支付宝主扫09支付宝被扫4.5.6 identity4.5.6.1 属性本域为JSoN格式,全部内容使用包含,内部可以包含多个对象。4.5.6.2 描述域采用JSON格式,全部内容使用包含,内部可以包含多个对象,具体定义如下:字段名称描述属性出现属性type证件类型string(32)Onumber证件号string(32)Oname姓名string(32)O4.5.7 isCredit信用卡交易标识4.5.7.1 属性int(1.)o4.5.7.2 描述当商户已开通信用卡交易时该字段有意义,该字段可以用做已开通信用卡交易的商户,控制某笔订单
17、是否可用信用卡支付。取值说明如下:取值取值说明备注0支持1不支持4.5.8 mchtNo商户号。4.5.8.1 属性string(15)4.5.8.2 描述由15位定长数字或字母组成.是合作机构或者由合作机构发展的商户在统一收单系统入驻成功后,由统一收单系统生成的机构或者商户在邮储银行统一收单系统内的唯一标识.4.5.9 OrderData订单数据。4.5.9.1 属性本域采用JSc)N格式,全部内容使用包含,内部包含多个子域和字段。4.5.9.2 描述采用JSON格式,全部内容使用包含,当前包含的子域信息如下:子域名称描述属性出现属性OrderFIag订单标志描述订单是单商户订单或者多商户合
18、并支付分账订单。String(I)MOrderTitIe订单标题订单名称string(64)MOrderAMT订单金额订单金额总金额,等于各子订单金额的和。该域取值需要和txnAMT相等。单位为元,精确到小数点后2位,取值范围0.01,.990doub1.eMOrderDctAMT可参与优惠活动的金额当前订单可参数优惠活动的金额。单位为元,精确到小数点后2位,取值范围0.01,.99当该域缺失时,默认全部订单金额都可以参与优惠活动。doub1.e0SubOrderNum子订单数量当为合并支付分账订单时,该域必须出现,且需要和SUbOrderData域出现的次数相等。当该域缺失时,默认全部订单金
19、额都可以参与优惠活动。intCSubOrderData子订单数据域该域采用JSON格式,全部内容用口包含,内部当前包含订单信息。rder1.nf。,门店信息SceneInfow,商品信息goods1.nfo三个子域。JSONC4.5.9.2.1子域:OrderFIag订单标识。描述订单是单商户订单或者多商户合并支付分账订单。取值说明如下:取值取值说明备注0单个商户的交易订单,交易收款、清分结算只涉及一个商户。客户只需要做一次付款操作.1多个商户的交易订单合并成一个交易订单发送给邮储统一收单系统,交易收款、清分结算涉及多个商户。多出现在购物车合并付款场景,客户选择多个商户的多个商品,发起一次支付
20、请求,统一收单系统做一次收款,收款成功后针对不同的商户分别清分结算。暂不支持该场景,计划下个迭代版本支持该功能。4.5.9.2.2子域:SubOrderData该域采用JSON格式,全部内容用口包含,每个元素用于描述单个商户的订单相关信息,内部当前包含订单信息OrderInf0,门店信息SCene1.nfo,商品信息goods1.nfo三个子域。子域名称描述属性出现属性orderinfo订单信息JSON格式,全部内容用包含JSONCsceneinfo门店信息JSON格式,全部内容用包含JSONCgoods1.nfo商品信息JSON格式,全部内容用口包含JSONC1.订单信息OrderInfOO
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 统一 系统 商户 管理

链接地址:https://www.desk33.com/p-126457.html