盛付通B2C网关API开发指南20120911剖析.doc

盛付通支付网关开发指南 目录 1 引言 2 1.1 文档概述 2 1.2 阅读对象 2 1.3 业务术语 2 2 方案概述 3 2.1 行业背景 3 2.2 接口介绍 4 2.3 业务实现流程 6 3 交互模式 7 3.1页面跳转交互模式 7 3.2 后台通知交互模式 8 4 数据格式 9 4.1POST 9 4.2字符串格式 9 5 补单机制 10 6接口 11 6.1支付接口 11 6.1.1业务功能 11 6.1.2交互模式 12 6.1.3签名算法 12 6.1.4 MD5签名 12 6.1.5 请求参数列表 13 6.1.6 返回结果和通知参数列表 15 6.1.7后台通知结果反馈 16 6.2退款接口 16 6.2.1业务功能 17 6.2.2交互模式 17 6.2.3签名算法 17 6.2.4 MD5签名 17 6.2.5 请求参数列表 18 6.2.6 返回结果和通知参数列表 19 6.1.7后台通知结果反馈 20 6.3查询接口 20 6.3.1业务功能 20 6.3.2交互模式 20 6.3.3签名算法 21 6.3.4 MD5签名 21 6.3.5 请求参数列表 22 6.3.6 返回结果和通知参数列表 22 7 附录 23 7.1 支付渠道列表 23 7.1.1 支付渠道 23 7.2 银行机构列表 23 7.2.1 综合网银编码列表 24 7.2.2大额B2C银行编码列表 24 7.2.3 B2B银行编码列表 25 7.2.4 借记卡编码列表 25 7.2.5 大额信用卡编码列表 25 7.3 交易状态列表 25 7.3.1 支付状态 26 7.3.2 退款状态 26 引言 文档概述 本文描述了盛付通针对合作商户提供的支付解决方案,帮助商户轻松实现在线收款的功能。文档分别从交互模式、签名、接口、注意事项等方面详细介绍了盛付通的工作方式和开发过程,可以帮助开发人员快速入门并掌握开发技能,同时也可以作为日后接口参数以及参数类型的速查手册。 阅读对象 合作商户系统的技术开发人员,要求具有WEB程序开发背景,了解http和https请求和应答的格式和过程,对XML格式有所掌握。 业务术语 术语 示例 说明 商户号 888888 平台的账号,只用于入账、出帐,由盛付通自动分配的6位数字。 密钥 123456789abcdefg 为保证通讯不被篡改,盛付通与商户之间约定的20位以内的自定义字符串,算签名MAC时使用。 账户 ceshi@ 盛大通行证账户号。 金额 2.00 金额,必须大于0,包含2位小数,默认为RMB 支付渠道 PT001,PT002等 支付渠道,为2位数字,如增加多个渠道请用逗号“,”隔开。如果不传,则显示商户签约的所有支付渠道。 方案概述 行业背景 在电子商务中,商家、买家、中间服务方是交易活动中的三个环节。买家选购商品下发订单,商家确认订单,买家通过中间服务方向商家支付货款,商家发货履行订单。在这个过程中商家的网站需要集成中间服务方的支付功能,让买家完成货款的支付。盛付通作为一家专业的中间服务方除了提供支付接口外,还提供了订单退款、订单结果查询接口等,帮助商家记录货款的往来,让商家能把更多的精力集中到商品服务上。 商户的货款会按照合同约定的频率结算到商户的银行账户,同时收取手续费。这个过程由盛付通自动完成,商户无需做相关开发工作。 接口介绍 接口名 请求URL 功能说明 结果说明 支付接口 /web-acquire-channel/cashier.htm 调用该接口时指定支付参数，完成买家账户向商家账户的支付，采用页面跳转交互模式和后台通知交互模式。 结果分两路返回：一路为前台在PageUrl页面跳转显示支付结果；一路为后台在NotifyUrl收到支付结果通知后进行响应。 退款接口 /api-acquire-channel/services/refundService?wsdl 查询接口 /api-acquire-channel/services/queryOrderService?wsdl 2.3业务实现流程 2.3.1支付流程 2.3.2退款流程 2.3.3查询流程 3 交互模式 3.1 页面跳转交互模式 页面跳转交互模式是指商户系统与盛付通系统的数据交互通过用户浏览器中转进行,是一种非实时的异步交互。 如买家下单买一个商品,商户系统会生成一个支付链接,此链接通过用户的浏览器跳转到盛付通系统,盛付通通过此链接获取支付请求的参数,这个支付请求用的就是页面跳转交易模式。 用户在盛付通页面完成支付后,盛付通通过PageUrl跳转到商户指定页面。 3.2 后台通知交互模式 后台通知交互模式是指盛付通系统主动向