支付平台线上统一对账接口说明V0.2.docx_第1页
支付平台线上统一对账接口说明V0.2.docx_第2页
支付平台线上统一对账接口说明V0.2.docx_第3页
支付平台线上统一对账接口说明V0.2.docx_第4页
支付平台线上统一对账接口说明V0.2.docx_第5页
已阅读5页，还剩9页未读， 继续免费阅读

下载本文档

版权说明：本文档由用户提供并上传，收益归属内容提供方，若内容存在侵权，请进行举报或认领

文档简介

1、创业健保付聚合支付平台线上统一对账接口说明2017年5月健保付技术部本文档中的所有内容为中福支付科技有限公司的机密和专属所有。未经中福支付科技有限公司的明确书面许可，任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。No字段名称Tag类型必输备注<Data>.<Results><Result>1、健康卡卡号HealthCardldC(32)2、姓名NameC(32)3、交易时间CreateTimeC(20)4、交易金额AmtN(22,2)5、交易类型TransTypeN(l)1APP支付（线上）3扫码付（线下）4条码付（线下）6

2、、业务单号OrderNOC(32)7、收款商户代码MerchantNoC(32)8、收款商户名称MerchantNameC(100)9、交易渠道编'VPaychanneln（i）2支付宝3微信4银联10、手机号码MobileC(20)</Result></Results></Data>第4章附录4.1返回码I©(retcode)No参数说明1、0000成功2、9999失败4.2行政区代码国标GB/T226020074.3性别代码代码Va1ue值1男2女4.4职业代码代码Va1ue值0国家机关、党群组织、企业、事业单位负责人1专业技术人员3办

3、事人员和有关人员4商业、服务业人员/5农、林、牧、渔、水利业生产人员6生存、运输设备操作人员及有关人员X军人Y不便分类的其他从业人员4.5文化程度代码Value值10研究生教育11博士研究生毕业12博士研究生结业13博士研究生肄业14硕士研究生毕业15硕士研究生结业16硕士研究生肄业17研究生班毕业18研究生班结业19研究生班肄业20大学本科21大学本科毕业22大学本科结业23大学本科肄业28大学普通班毕业30专科教育31大学专科毕业32大学专科结业33大学专科肄业40中等职业教育41中等专科毕业42中等专科结业43中等专科肄业44职业高中毕业45职业高中结业46职业高中肄业47技工学校毕业4

4、8技工学校结业49技工学校肄业60普通高级中学教育61普通高中毕业62普通高中结业63普通高中肄业70初级中学教育71初中毕业73初中肄业80小学教育81小学毕业83小学肄业90其他国籍/地区代码Va1ue值01中国02中国香港澳门03中国台湾04海外4.6证件类型代码Va1ue值01居民身份证03护照06港澳居民来往大陆通行证07台湾居民来往大陆通行证4.7卡类型代码Va1ue值A5健康虚拟卡A6健康实体卡A2社保卡4.8通道类别代码Va1ue值1健康钱包2支付宝3微信4银联卡修订历史发布日期版本修订人审阅人摘要2017-05-08V0.1gyp文档创建2017-07-14V0.2gyp增加

5、3.4节聚合支付明细查询接口目录修订历史2第1章概述41.1文档说明41.2读者43术语约定4第2章接口规范41网络通信方式42.2语法42.3接口报文约定42.4请求有效性验证算法6第3章支付平台线上统一对账接口定义说明63.1支付订单同步接口63.2退款订单同步73.3商户号校验83.4聚合支付明细查询9第4章附录104.1返回码(retcode)104.2行政区代码104.3性别代码114.4职业代码114.5文化程度114.6国籍/地区134.7证件类型134.8卡类型134.9通道类别13第1章概述1.1文档说明1.2读者本文档的阅读对象为app开发人员1.3术语约定第2章接口规范2

6、.1网络通信方式以http/https协议，服务器点对点post方式进行数据通信2.2语法消息体采用XML格式描述，消息体的语法规则完全遵循XML语法规则，并严格区分大小写。2.3接口报文约定2.3.1接口通信地址接口地址:https:/*/gatewayOnline/gateway/portal/execute语法消息体采用XML格式描述，消息体的语法规则完全遵循XML语法规则，并严格区分大小写。每一个消息由一个消息头和消息体构成。其中消息是由一个完整的XML加密而来。一个完整的消息如下图所示：消消息头消息头内容息消息体业务要素1内容体整个XML格式的消息体以Data为根节点，即完整的消息报

7、文例子如下:v?xmlversion='l.0encoding="UTF-8"?<Root><Head><MerchantNo>00001</MerchantNo><Funcid>函数名v/Funcid>vRetCode>0000</RetCode><RetMsg>success</RetMsg><Timestamp>234423234</Timestamp><Signature>ADSSSSSSSDWW</Signa

8、ture>将原文用私钥签名以后的内容</Head><Body>AAAAAAAAAAAAAAAAAAAAAAAAAAAA将BODY原文经过DES加密后的字符串</Body></Data></Root>BODY原文如下<Data><HealthCardId>HealthCardId</HealthCardId><Signature>2113333334440</Signature><Data>2.3.2消息头每一个会话或应用消息有一个消息头，该消息头指明消息类型

9、、发送起始点、发送目的地、发送时间、消息标识号以及其他一些通用信息。消息头格式如下：No字段名称字段类型必输备注1、商户号MerchantNoC(20)平台为开发者提供的商户号2、返回码RetCodeC(4)0000成功9999失败3、错误描述RetMsgC(100)4、功能码FuncidC(6)V5、时间戳TimestampC(100)V自1970-1-0100:00:00.000到当前时刻的时间距离（精确到毫秒）6、签名码SignatureC(500)签名以后的字符串2.4请求有效性验证算法支付系统接口服务和商户系统约定统一的请求指令验证算法。> 算法原理：将数据域通过Des加密后放

10、入Body中，并将原文通过RSA私钥签名得到结果放入消息头Signature中> 算法规则：先用密钥将数据解密得到原文，再用RSA公钥匙对原文进行验签。第3章支付平台线上统一对账接口定义说明3.1支付订单同步接口发起方：商户后台功能码：P9001场景描述：接口设计：将线上支付的订单同步到统一支付平台发送sdata报文：消息头：见2.3.3消息体：No字段名称Tag类型必填备注<Data><0rders><0rder>（此节点可以有多个）1.健康卡号HealthCardldC(30)2.手机号码MobileC(20)J支付人手机号码3.外部订单号orde

11、r_noC(30)V发送到支付宝微信的订单号码4.支付渠道编号paytypen（i）J2支付宝3微信5.支付金额AmtN(22,2)V应答报文:6.姓名NameC(30)V7.收款商户号MerchantNoC(30)V支付宝微信的商户号8.交易时间TransdateTimeC(2)V日期格式：yyyyMMdd，例如：20160802、201212129.订单超时时间PayTimeOutN(10)以分钟为单位10.商品标题OrderSubjectC(250)J11.订单描述OrderDetailC(250)V12.操作员OptC(20)13.备注RemarkC(10)</0rder>

12、</Orders></Data>No字段名称Tag类型必输备注<Data><Results><Result>1、外部订单号OrderNo2、结果代码CodeSUCCESS成功FAIL失败3、错误描述Msg错误描述</Result></Results></Data>3.2退款订单同步发起方：商户app功能码：P9002场景描述：接口设计：退款的订单同步到支付平台发送sdata报文：消息头：见2.3.3消息体：No字段名称Tag类型必填备注<Data><0rders><0r

13、der>（此节点可以有多个）1.退款订单号RequestNoC(30)V2.健康卡卡c-HealthCardldC(32)3.支付渠道编号PayTypen（i）J4.退款金额AmtN(22,2)V5.支付原订单号TradeNoC(30)J6.收款商户号MerchantNoC(2)V支付宝微信为医院分配的商户号</0rder></0rders></Data>应答报文:No字段名称Tag类型必输备注<Data>.<Results><Result>1、外部订单号OrderNo2、结果代码CodeSUCCESS成功FAIL失

14、败3、错误描述Msg错误描述</Result></Results></Data>3.3商户号校验发起方：APP后台功能码：P9003场景描述：接口设计：校验支付宝/微信分配的商户号在支付平台后台有没有维护发送sdata报文：消息头：见2.3.3消息体:No字段名称Tag类型必填备注<Data>1.支付渠道编号PayTypen（i）J2.收款商户号MerchantNoC(2)V支付宝微信为医院分配的商户号</Data>应答报文:No字段名称Tag类型必输备注<Data>1、结果代码CodeSUCCESS成功FAIL失败2、错误描述Msg错误描述</Data>3.4聚合支付明细查询发起方：APP后台功能码：P9004场景描述：接口设计：通过健康卡卡号查询该健康卡下的交易明细数据发送sdata报文：消息头：见2.3.3消息体:No字段名称Tag类型必填备注<Data&g

人人文库> 全部分类> 应用文书 > 规章制度

温馨提示

  • 1. 本站所有资源如无特殊说明，都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等，如果需要附件，请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸，网页内容里面会有图纸预览，若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间，仅对用户上传内容的表现方式做保护处理，对用户上传分享的文档内容本身不做任何修改或编辑，并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容，请与我们联系，我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

最新文档

评论

0/150

提交评论