威富通统一小额支付接口文档V1.3
微信支付API文档120(受理)
1. 阅读对象本文阅读对象：商户系统（在线购物平台、人工收银系统、自动化智能收银系统或其他）集成微信支付涉及的技术架构师，研发工程师，测试工程师，系统运维工程师。
2. 术语1. 支付模式1) 被扫支付被扫支付是用户展示微信上“我的刷卡条码/二维码”给商户系统扫描后直接完成支付的模式。
主要应用线下面对面收银的场景。
2) 扫码支付扫码支付是商户系统按微信支付协议生成支付二维码，用户再用微信“扫一扫”完成支付的模式。
该模式适用于P C 网站支付、实体店单品或订单支付、媒体广告支付等场景。
3) 微信内网页支付微信内网页支付是用户在微信中打开商户的H5 页面，商户在H5 页面通过调用微信支付提供的JSAPI 接口调起微信支付模块完成支付。
应用场景有：•用户在微信公众账号内进入商家公众号，打开某个主页面，完成支付；•用户的好友在朋友圈、聊天窗口等分享商家页面连接，用户点击链接打开商家页面，完成支付•将商户页面转换成二维码，用户扫描二维码后在微信浏览器中打开页面后完成支付4) APP 支付APP 支付又称移动端支付，是商户通过在移动端应用APP 中集成开放SDK 调起微信支付模块完成支付的模式。
5) 普通浏览器网页支付模式正在建设中，敬请期待。
2. 名词解释1) 微信公众平台微信公众平台是微信公众账号申请入口和管理后台。
商户可以在公众平台提交基本资料、业务资料、财务资料申请开通微信支付功能。
平台入口：。
2) 微信开放平台微信开放平台是商户APP 接入微信支付开放接口的申请入口，通过此平台可申请微信APP 支付。
平台入口：。
3) 微信商户平台微信商户平台是微信支付相关的商户功能集合，包括参数配置、支付数据查询与统计、在线退款、代金券或立减优惠运营等功能。
平台入口：。
4) 微信支付系统微信支付系统是指完成微信支付流程中涉及的API 接口、后台业务处理系统、账务系统、回调通知等系统的总称。
5) 商户收银系统商户收银系统即商户的POS 收银系统，是录入商品信息、生成订单、客户支付、打印小票等功能的系统。
微信支付接口说明书
微信支付说明书V1.0 2016年04月修订页1.1.接口说明通过http post方式交互，请求报文为json格式，请求报文由商户号、交易命令、交易信息、signature(签名)组成，交易信息的内容需加签，整个交易信息需要进行加密，返回格式为json。
1.2.数据流程客户端处理流程1.拼装报文，对msg字段加签放入signature字段中2.对拼装后报文加密并发送3.接收服务器响应，解密4.对于接收的报文验证签名。
1.3.安全说明报文会对敏感字段（msg）进行MD5WITHRSA签名，并对整个报文RSA加密，加密说明见相关demo。
1.4.数据类型规则1.4.1.出现次数1)0..1——数据元值域可填，且出现一次，节点中必须出现，可空；2)0..n——数据元值域可填，且可出现多次；3) 1..1——数据元值域必填，且出现一次；4) 1..n——数据元值域必填，且可出现多次1.4.2.节点数据类型1)s=字符类型，例：s..60 字符串60个长度2)n=数值类型，例：n..18,4 数值包含小数点共18位，其中包含4位小数3)date=日期类型，全文要求日期格式为 yyyyMMddHHmmss1.4.3.相关数据详解1)时间字段：时间字段如无特殊说明，则格式为yyyyMMddHHmmss1.5.交易码列表1.5.1.基础功能注意：2.3.4.5 接口全部按照加密传输;加密格式为：{"data":"加密信息","signature":"签名"}加密信息：{"msg":"{"参数":"",......}"}1.6.接口信息说明1.6.1.注册商户接口请求报文：备注：普通HTTP POST交互,详见demo;推广码和下放商户标识必须填写下放资料里面对应的信息;响应报文1.6.2.下载密钥接口(tb_DownLoadKey) 请求报文响应报文1.6.3.验卡接口(tb_verifyInfo)请求报文响应报文1.6.4.二维码支付接口(tb_WeixinPay) 请求报文响应报文1.6.5.订单状态查询接口(tb_OrderConfirm) 请求报文响应报文1.6.6.交易回调通知返回信息注意：发送方式普通POST表单，request 接收;1.6.7.同步商户签约费率(xy_ChangeRate)请求报文响应报文1.7.返回码及描述1.8.对账文件1.8.1.对账文件说明服务器每日9：00—10：00生成前一日的对账文件，对账文件采用txt 的格式记录。
收银系统开放接口文档v1.2.1
收银系统开放接口文档(V1.2.1)目录收银系统开放接口文档 (1)目录 (2)文档版本更新说明 (4)账号说明 (5)1.下单接口 (5)1.1.接口说明： (5)1.2.参数： (6)1.3.返回字段说明： (8)1.4.返回实例结果： (8)2.APP同步返回接口 (9)2.1.接口说明： (9)2.2.参数： (9)2.3.返回字段说明： (10)2.4.返回实例结果： (10)3.异步通知接口 (11)3.1.接口说明： (11)3.2.参数： (11)3.3.返回字段说明： (12)3.4.返回实例结果： (13)4.订单查询接口 (13)4.1.接口说明： (13)4.2.参数： (13)4.3.返回字段说明： (14)4.4.返回实例结果： (17)5.签名机制 (18)5.1.生成签名字符串sign (18)5.2.签名注意事项 (20)6.附录 (20)6.1.交易状态： (20)6.2.请求错误码 (21)文档版本更新说明账号说明账号作用1.下单接口1.1.接口说明：通过WEB、USB、蓝牙、APP等通讯，调起旺POS收银app，并创建订单，收银app将显示支付页面，等待用户支付使用WEB、USB、蓝牙、APP进行下单时，下单接口本身不提供接口访问地址，只提供接口访问参数，调用者在需要使用下单接口时，需使用平台相关api（详见BP服务端开发文档）及近场通讯协议（USB、蓝牙、APP）并传递此接口的所定义的参数（1.2参数），即可调起旺POS收银app支付页面值得注意的是，当使用APP间调用收银下单接口进行下单时，需要APP将1.2参数进行组装成JSON字符串，并以UTF-8编码成byte[]格式，将此byte[]作为参数项传递给sdk的params参数（详见微POS SDK文档），同时，收银app在支付完成后，也会将相应返回字段组装成JSON字符串，并以UTF-8编码成byte[]格式，返回给调用方。
企业付款API接口说明文档_V2 (1)(1)
内部文档，请勿外传
3.2.2 生成随机数算法 微信支付 API 接口协议中包含固定 nonce_str，主要保证签名不可预测。我们推荐生成 随机数算法如下：调用随机数生成函数，将得到的值转换为字符串。
3.2.3 商户证书 1) 获取商户证书
微信支付接口中，涉及资金回滚的接口会使用到商户证书，包括退款、撤销接口。商家 在申请微信支付成功后，收到的相应邮件通知中，附件会包含接口需要用到的证书文件，有 四个证书文件，分别说明如下。
文件，为 pem 格 pem，为了方便 -clcerts -nokeys -in
式，请妥善保管不 您使用，已为您 apiclient_cert.p12
要泄漏和被他人复 直接提供
-out
制
apiclient_cert.pem
证书密钥 pem 格式
从
PHP 等不能直 您也可以使用 openssl
（apiclient_key.pem） apiclient_cert.p12 接使用 p12 文 命令来自己导出：
中导出密钥部分的 件，而需要使用 openssl pkcs12
文件，为 pem 格式 pem，为了方便 -nocerts -in
您使用，已为您 apiclient_cert.p12
直接提供
-out
内部文档，请勿外传
apiclient_key.pem CA 证书（rootca.pem） 微信支付 api 服务 该文件为签署 部分工具已经内置了若
表 4.2：证书文件说明
内部文档，请勿外传
证书附件
描述
使用场景
备注
pkcs12 格式 (apiclient_cert.p12)
包含了私钥信息的 撤销、退款申请 windows 上可以直接双
网银在线支付商户接口文档(B2C系统)
网银在线支付接口规范B2C系统商户接口平台版本号4.0网银在线（北京）科技有限公司目录1.文档介绍 (1)1.1. 读者对象 (1)1.2. 版权声明 (1)2.支付接口 (2)2.1. 商户>>> 网银在线支付 (2)2.2. 网银在线支付>>> 商户（页面返回） (5)2.3. 网银在线支付>>> 商户（服务器返回） (6)2.4. 网关错误编码表 (6)1.文档介绍1.1.读者对象商户系统设计人员、编程人员及测试人员1.2.版权声明此文档版权归网银在线（北京）科技有限公司所有。
作为本系统的最终用户，可以拥有该份文档的使用权，但未征得网银在线（北京）科技有限公司的书面批准，不得向第三方借阅、出让、出版该文档。
2.支付接口2.1.商户 >>> 网银在线支付示例程序：ChinaBank.html用途：收集信息并发送到数据发送页即Send页订单号：//选填项，订单号收货人姓名：//选填项，总长不超过80字符收货人地址：//选填项，总长不超过200个字符收货人电话：//选填项，总长不超过50个字符收货人邮编：//选填项，总长不超过10个字符收货人邮件：//选填项，总长不超过100个字符收货人手机号：//选填项，总长不超过13个字符备注1：//选填项，总长不超过150个字符订货人姓名：//选填项，总长不超过80字符订货人地址：//选填项，总长不超过200个字符订货人电话：//选填项，总长不超过50个字符订货人邮编：//选填项，总长不超过10个字符订货人邮件：//选填项，总长不超过100个字符订货人手机号：//选填项，总长不超过13个字符备注2：//选填项，总长不超过150个字符订单总金额（元）：*必填项，譬如：0.01示例程序：Send.asp、Send.aspx、Send.php、Send.jsp用途：接收ChinaBank.html发送过来的数据加密后发往网银在线电子支付平台的接口网关1、支付平台网关接口地址<form method=post action="https:///PayGate">2、FORM表单参数关，建议不用表1支付表单中的变量定义：—必填项—与网上支付货款无关项，建议不用表2MD5校验串生成方法：当消费者在商户端生成最终订单的时候，将订单中的v_amount v_moneytype v_oid v_mid v_url key六个参数的value值拼成一个无间隔的字符串(顺序不要改变)。
通联互联网支付网关商户接口技术规范模板
文件修改记录目录1. 目的.................................................................................. 错误!未定义书签。
2. 通联互联网支付网关业务简介 ..................................... 错误!未定义书签。
2.1 名词解释............................................................. 错误!未定义书签。
2.2 商户与通联合作程序......................................... 错误!未定义书签。
2.3 支付业务流程..................................................... 错误!未定义书签。
2.3.1通联互联网支付网关的网银支付流程 ....... 错误!未定义书签。
2.3.2通知支付结果处理流程................................ 错误!未定义书签。
2.3.3清算结算流程................................................ 错误!未定义书签。
2.3.4退货流程........................................................ 错误!未定义书签。
3. 商户系统接入接口定义 ................................................. 错误!未定义书签。
3.1 页面订单提交接口............................................. 错误!未定义书签。
3.2 支付结果返回接口............................................. 错误!未定义书签。
通联支付接口文档
账户支付系统接口文档属性文档名称：账户支付系统接口当前版本号： 1.37创建者：创建日期：复核者：复核日期：审批者：审批日期：版本修改内容修改人日期1.00 创建王作林1.10 规范XML的节点王作林2009-10-12 1.15 完善签约的协议王作林2010-6-11 1.36 增加有磁有密签到王作林2010-8-10 1.37 签约查询响应及签约通知增加户名王作林2010-11-12目录1.接口通讯 (3)1.1通讯方式 (3)1.1.1方式1 (3)1.2信息体说明 (3)1.2.1编码要求 (3)1.3安全 (3)2.交易报文 (3)2.1批量代收请求 (3)2.1.1请求报文说明 (3)2.1.2响应报文说明 (4)2.1.3例子 (5)2.2批量代付请求 (9)2.2.1请求报文说明 (9)2.2.2响应报文说明 (10)2.2.3例子 (10)2.3交易结果查询请求 (14)2.3.1请求报文说明 (15)2.3.2返回报文说明 (15)2.4交易结果通知 (16)2.4.1请求报文说明 (16)2.4.2返回报文说明 (16)2.5成功交易结果通知 (16)2.5.1请求报文说明 (16)2.5.2响应报文说明 (17)2.6退票通知 (17)2.6.1请求报文说明 (17)2.6.2响应报文说明 (17)2.7对账文件下载 (17)2.7.1请求报文说明 (17)2.7.2响应报文说明 (18)2.8简单对账文件下载 (18)2.8.1请求报文说明 (18)2.8.2响应报文说明 (18)2.9对账文件格式 (18)3.附录 (19)3.1代付业务代码 (19)3.2代收业务代码 (20)3.3银行代码 (21)3.4反馈代码表 (23)3.5中国邮政区号表 (26)3.6测试资料 (26)1.接口通讯1.1 通讯方式1.1.1方式1使用HTTPS作为通讯方式，报文格式为XML。
口袋支付API接口文档
口袋支付平台商户支付功能接口规范版本号修订日期2.0 2013年4月17日3.0 2015年6月15日3.2 2015年10月27日功能说明：本接口主要目的是为了让商户自有系统自由接入口袋支付平台，完成网站支付接入，用户支付后，平台会即时返回结果给商户。
接口商户是根据口袋支付提供的接口文档传递相关的请求参数到平台里，口袋支付平台验证参数后，会引导用户到相应的页面进行支付操作，用户成功填入支付信息后，口袋支付平台将用户的支付成功与失败状态通知商户。
接口商户可以在自己的页面带入一些附加信息，口袋支付平台在回调时将该信息原样返回。
本接口支持那些语言？本平台接口支持大部分web语言，比如ASP，PHP，ASPX，JSP。
接口支持的协议方式？本平台使用http+GET/POST方式，如需https协议，请与平台客服联系。
- 1 –口袋支付接口应用类型？接口是面向所有需要支付购买的行业，软件、商城、游戏等均可以进行集成接入。
接口提交编码？口袋支付接口统一编码为：GB2312，编码错误可能导致乱码订单错误或者不能正确返回结果。
支付流程图- 2 –口袋支付网关接口规范（1）网关接口提交参数：商户向平台网关提交的参数卡类网关地址：/pay/Card.aspx网银网关地址：/pay/Bank.aspx兼容易宝卡类网关地址：/gateway/yeepay/Card.aspx兼容易宝网银网关地址：/gateway/yeepay/Bank.aspx网银网关包括支付宝、微信、财付通等非卡类支付方式具体通道编码详见具体参数详见附录参数参数说明参与签名类型备注P_UserId商户ID 是整型数字必须（商户管理中心查看）P_OrderId 商户订单号是字符串，最长32位必须，在商户系统中保持唯一P_CardId 卡类交易时的卡号是字符串，最长20位卡类交易时必须，网银支付为空P_CardPass 卡类交易时的卡密是字符串，最长20位卡类交易时必须，否则可为空P_FaceValue 面值是float，保留2位小数必须P_ChannelId 充值类型是整型数字必须(具体参数详见附录)P_Subject 产品名称否字符串，最长20位可为空P_Price 产品价格否float，保留2位小数必须，可传0- 3 –口袋支付P_Quantity 产品数量否整型数字必须P_Description 银行ID 否字符串，最长20位充值类型为在线银行时必填P_Notic 用户附加信息否字符串，最长50位可为空P_Result_URL 充值状态通知地址否字符串，最长100位必须P_Notify_URL 充值后网页跳转地址否字符串，最长100位可为空P_PostKey 签名认证串－字符串必须说明：1.签名认证P_PostKey的生成：必须按照“参与签名”状态为“是”的参数按其顺序用“|”组合，最后加上用户密钥，然后进行32位的md5编码，比如：P_PostKey=md5_32(P_UserId| P_OrderId| P_CardId| P_CardPass |P_FaceValue| P_ChannelId|SalfStr)，SalfStr是您的安全码，如安全码被泄漏可通过平台重置。
【微信支付】APP支付(Android)接口文档V3
（Android ） APP 支付接口文档 支付接口文档（ Android） V3
信支付简介................................................................................................................................4 1.1 功能简介............................................................................................................................. 4 1.2 平台帐号注册..................................................................................................................... 4 1.2.1 申请流程指引图...................................................................................................... 4 1.2.2 申请接入步骤详细说明......................................................................................... 4 1.3 支付账户............................................................................................................................. 5 2.微信 APP 支付接入.......................................................................................................................6 2.1 系统架构............................................................................................................................. 6 2.2 基本交互............................................................................................................................. 7 2.3 支付功能开发介绍............................................................................................................. 7 3.接口介绍........................................................................................................................................8 3.1.接口调用规则..................................................................................................................... 8 3.2.Sign 签名生成方法.............................................................................................................8 3.3.代码实例............................................................................................................................. 9 4.API 说明...................................................................................................................................... 11 4.1.统一支付接口................................................................................................................... 11 4.2.通用通知接口................................................................................................................... 12 4.3.订单查询接口................................................................................................................... 14 4.4. APP 端开发说明.............................................................................................................. 16 4.4.1 初始化设置............................................................................................................ 16 4.4.2 注册您的 APPID................................................................................................... 17 4.4.3 用服务器返回的参数调起支付............................................................................ 17
在线支付接口文档
在线支付接口文档I. 概述本文档提供了有关在线支付接口的详细说明。
在线支付接口可供开发人员使用，以便在他们的应用程序中实现支付功能。
本文档将介绍接口的功能、参数、请求和响应的格式以及示例代码。
II. 接口功能在线支付接口提供了以下主要功能：1. 发起支付请求：应用程序可以通过接口向支付平台发起支付请求，包括订单金额、支付方式等参数。
2. 处理支付回调：支付平台会在支付完成后通过接口向应用程序发送支付回调通知，以便应用程序更新支付状态等信息。
3. 查询订单状态：应用程序可以通过接口查询订单的支付状态、金额等详细信息。
III. 接口参数1. 商户参数：- 商户ID：用于标识商户的唯一身份。
- 商户密钥：用于对接口参数进行签名验证，确保请求的安全性和完整性。
2. 支付参数：- 订单号：用于唯一标识一笔订单。
- 订单金额：支付的金额，以货币单位表示。
- 支付方式：指定支付使用的方式，如支付宝、微信支付等。
3. 回调参数：- 状态码：支付平台发送的回调通知的状态码，用于验证通知的有效性。
- 支付状态：订单的支付状态，如支付成功、支付失败等。
- 其他支付相关信息：例如支付完成时间、支付流水号等。
IV. 请求和响应格式1. 请求格式：请求参数使用POST方法通过HTTPS协议发送，格式为JSON。
请求示例如下：```json{"merchant_id": "商户ID","timestamp": "请求时间戳","sign": "参数签名","data": {"order_no": "订单号","amount": "订单金额","payment_method": "支付方式"}}```其中，商户ID、请求时间戳以及参数签名需按接口规定进行生成和验证。
连连支付银行卡代付API商户接口说明书
String
RSA
String
RSA 加密签名，见安全签名机制
String(32) String(14)
Number(8, 2)
String String String
商户系统唯一标识该代付的流水号 格式：YYYYMMDDH24MISS 14 位数字， 精确到秒 代付金额，单位为 RMB-元。 大于 0 的数字，精确到小数点后两位。 如：49.65 0-对私 1 –对公 对私必须是借记卡 必须
bank_code
否
开户行所在省 province_code 否
编码
开户行所在市 city_code
否
编码
开户支行名称 brabank_name 否
订单描述
info_order
是
代付结果服务 notify_url
是
器异步通知地
址
版本号
api_version
是
大额行号
prcptcd
否
连连支付 – 银行卡代付 API 商户接口说明书
文档编号 文档版本 保密级别
1.4 保密
连连银通电子支付有限公司
连连支付
银行卡代付 API 商户接口说明书
2014/5/12
连连支付 – 银行卡代付 API 商户接口说明书
目录
目 录 ..............................................................................................................................................1 使用授权声明...................................................................................................................................2 文档修订记录...................................................................................................................................2 1. 文档说明...................................................................................................................................3
小额支付系统(MBFE)安装与维护手册
中国现代化支付系统小额支付系统(MBFE)安装与维护手册版本号：2.00中国人民银行二○○五年九月目录1.概述 (1)2.BEPSMBFE系统初装 (2)2.1.BEPSMBFE服务器端安装与配置 (2)2.1.1.安装前须知 (2)2.1.2.安装步骤 (2)2.1.3.配置文件说明 (8)2.1.4.环境变量说明 (12)2.1.5.其他注意事项 (12)2.1.6.BEPSMBFE安装程序包含的文件列表 (14)2.2.BEPSMBFE客户端安装与配置 (15)2.2.1.安装运行环境 (15)2.2.2.运行环境 (15)2.2.3.安装步骤 (15)2.2.4.环境配置说明 (21)2.3.BEPSMBFE数据库的创建与设置 (23)2.3.1.SYBASE客户端的登录 (23)2.3.2.BEPSMBFE数据库的创建过程 (23)2.4.BEPSMBFE数据初始化 (25)2.4.1.客户端登录 (27)2.4.2.新建用户............................................................................. 错误！未定义书签。
2.4.3.导入基础数据 (27)2.4.4.设置连接模式..................................................................... 错误！未定义书签。
3.系统启动 (29)4.系统关闭 (31)5.系统校时 (32)6.日常维护 (33)6.1.备份与恢复 (33)6.1.1.数据库备份 (33)6.1.2.恢复数据库 (34)6.1.3.业务数据备份 (35)6.2.双机热备的切换 (35)6.3.数据清理 (36)6.3.1.数据库日志定期清理 (36)6.3.2.临时数据清理 (37)MBFE安装维护手册1. 概述本系统维护手册是中国现代化支付系统商业银行前台（BEPSMBFE）系统管理员的维护手册。
支付对接API文档
系统接口文档提交请求：提交地址: http://你的网关地址/Pay_Index.html 提交的参数MD5签名字段格式：将上表中红色的字段，按表中所列的顺序将请求字段组合成为待验证的一个无间隔字符串，然后将组合成的字符串加上你在支付系统上的密钥(key)后，通过MD5加密，就是待验证字符串hmacstr="pay_amount="+pay_amount+"&pay_applydate="+pay_applydate+"&pay_ bankcode="+pay_bankcode+"&pay_callbackurl="+pay_callbackurl+"&pay_memberi d=>"+pay_memberid+"&pay_notifyurl="+pay_notifyurl+"&pay_orderid="+pay_ord erid+"&key="+keyhmac= md5(hmacstr)然后将hmac 转换为大写订单通知：如果接收到服务器点对点通讯时，在页面输出“OK”（没有双引号，OK两个字母大写）,否则会重复5次发送点对点通知验证签名字段格式：将上面的字段，按表中所列的顺序将请求字段组合成为待验证的一个无间隔字符串，然后将组合成的字符串加上你在平台的密钥(key)后，通过MD5加密，就是待验证字符串hmacstr=”amount=>”+amount+”&datetime=>”+datetime+”&memberid=>”+memberid+”&orderid=>”+orderid+”&returncode=>”+returncode+”&key=”+key Sign= md5(hmacstr)然后将Sign转换为大写支付渠道列表你的程序生成的订单号放在扩展字段里，传过来的订单号为空，让支付系统自动生成订单号，然后你那边要你生成的订单号，直接在返回的扩展字段里去获取你的程序的订单号就是他提交过来的数据里，订单号为空，就可以了，他生成的订单号放在扩展字段里，到时会原样返回给你/*修订时间2017 - 03 -21 */。
《一卡通电子支付平台统一第三方接入》使用说明书
3.2.1. 资源....................................................................................... 6 3.3. 安装及运行环境......................................................................... 6
2.3. 金额............................................................................................. 2 2.3.1. 库余额................................................................................... 2 2.3.2. 卡余额................................................................................... 2 2.3.3. 商户手续费 ........................................................................... 2 2.3.4. 启用消费密码限额 ............................................................... 2 2.3.5. 补助....................................................................................... 3 2.3.6. 扣款....................................................................................... 3
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
威富通统一小额支付接口文档文档版本：1.3接口版本：2.0目录1引言 (3)1.1文档概述 (3)1.2阅读对象 (3)1.3业务术语 (3)2方案概述 (4)2.1行业背景 (4)2.2业务实现流程 (4)2.2.1小额支付业务 (4)3数据格式 (5)3.1提交数据 (5)3.2XML数据格式 (6)4数字签名 (7)4.1签名原始串 (7)4.2签名算法 (8)5小额支付接口 (9)5.1小额支付接口 (9)5.1.1业务功能 (9)5.1.2交互模式 (9)5.1.3请求参数列表 (9)5.1.4返回结果 (10)5.2冲正接口 (12)5.2.1业务功能 (12)5.2.2交互模式 (12)5.2.3请求参数列表 (13)5.2.4返回结果................................................................................................................错误！未定义书签。
6查询退款接口 (14)6.1订单查询接口 (14)6.1.1业务功能 (14)6.1.2交互模式 (14)6.1.3请求参数列表 (14)6.1.4返回结果 (15)6.2退款接口 (17)6.2.1业务功能 (17)6.2.2交互模式 (17)6.2.3请求参数列表 (18)6.2.4返回结果 (18)6.3退款查询接口 (19)6.3.1请求参数列表 (19)6.3.2返回结果 (20)7注意事项 (21)1引言1.1文档概述本文件描述威富通针对线下O2O手机支付行业提供的支付解决方案。
供内部相关开发和技术支持人员与商户平台服务方技术人员使用。
文档分别从交互模式、签名、接口、注意事项等方面详细介绍了威富通的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。
1.2阅读对象供威富通开发人员与商户平台服务方技术或业务人员参考和查询。
1.3业务术语术语示例说明商户号7551000001商户平台的账号，只用于记账密钥9d101c97133837e13dde2d32a5054abb为保证通讯不被篡改，威富通与商户之间约定的32位字符串，算签名sign时使用金额1000金额，默认为RMB，以分为单位。
1000表示RMB10.002方案概述2.1行业背景扫码支付，是基于微信，手机qq，支付宝钱包客户端提供的支付服务功能。
同时向商户提供销售经营分析、账户和资金管理的功能支持。
用户通过扫描二维码、反扫二维码等多种方式调起支付模块完成支付。
2.2业务实现流程2.2.1小额支付业务使用场景：(1)用户打开小额刷卡界面，商家扫描到用户二维码或条码后发起支付，通过Post生成订单的必要信息调用威富通API。
API返回XML格式的数据，返回调用结果。
支付成功后微信|手机qq|支付宝钱包会提示用户交易结果，如下图：(2)在步骤1中，如果用户使用小额已支付金额超过日限额(详细说明见下文)，会提示用户输入密码。
(3)当步骤1未返回未成功或支付中状态，可以主动调用查单接口查询支付状态。
(4)在交易状况不明晰的情况下调用冲正接口，如果交易成功，取消扣款，如果交易失败则关闭订单。
接口调用时序图：用户使用小额支付的免密额度以微信，手机qq，支付宝钱包实时的额度限制为准3数据格式3.1提交数据采用HTTPS标准的POST协议，为了保证接收方接收数据正确,传输数据必须签名。
<xml><service>unified.trade.micropay</service><attach><![CDATA[att]]></attach><body><![CDATA[支付测试]]></body><device_info>1000</device_info><mch_id>10000100</mch_id><nonce_str>adf880d5c8986bd0deb6423c92c9d948</nonce_str><out_trade_no>1406046836</out_trade_no><spbill_create_ip>127.0.0.1</spbill_create_ip><total_fee>1</total_fee><sign><![CDATA[F53145E553092CE52E4CAA4D2B49A91C]]></sign></xml3.2XML数据格式采用标准XML协议，所有参数只存在一级节点中，不采用多级节点嵌套。
协议级错误返回：<xml><status>500</status><message><![CDATA[SYSERR]]></message></xml>正确返回数据：<xml><status>0</status><message><![CDATA[OK]]></message><appid><![CDATA[wx2421b1c4370ec43b]]></appid><mch_id><![CDATA[10000100]]></mch_id><device_info><![CDATA[1000]]></device_info><nonce_str><![CDATA[FvYSnPuFFPkAr77M]]></nonce_str><sign><![CDATA[63238039D6E43634297CF2A6EB5F3B72]]></sign><result_code>0</result_code><openid><![CDATA[oUpF8uN95-Ptaags6E_roPHg7AG0]]></openid><is_subscribe><![CDATA[Y]]></is_subscribe><trade_type><![CDATA[MICROPAY]]></trade_type><bank_type><![CDATA[CCB_CREDIT]]></bank_type><total_fee>1</total_fee><coupon_fee>0</coupon_fee><fee_type><![CDATA[CNY]]></fee_type><transaction_id><![CDATA[1008450740201407220000058756]]></transaction_id> <out_trade_no><![CDATA[1406033828]]></out_trade_no><attach><![CDATA[att]]></attach><time_end><![CDATA[20140722160655]]></time_end></xml>业务级错误返回：<xml><status>0</status><message><![CDATA[OK]]></message><appid><![CDATA[wx2421b1c4370ec43b]]></appid><mch_id><![CDATA[10000100]]></mch_id><device_info><![CDATA[1000]]></device_info><nonce_str><![CDATA[sthBJ9QyUG6vkrjJ]]></nonce_str><sign><![CDATA[6277A96D7875D4FF23AA7B6A4C3046AB]]></sign><result_code>1</result_code><err_code><![CDATA[AUTHCODE_EXPIRE]]></err_code><err_code_des><![CDATA[二维码已过期，请刷新再试]]></err_code_des></xml一般有返回有status参数，0表示调用成功；非0表示调用失败。
4数字签名为了保证数据传输过程中的数据真实性和完整性，我们需要对数据进行数字签名，在接收签名数据之后进行签名校验。
数字签名有两个步骤，先按一定规则拼接要签名的原始串，再选择具体的算法和密钥计算出签名结果。
一般失败的结果不签名。
4.1签名原始串无论是请求还是应答，签名原始串按以下方式组装成字符串：1、除sign字段外，所有参数按照字段名的ascii码从小到大排序后使用QueryString的格式（即key1=value1&key2=value2…）拼接而成，空值不传递，不参与签名组串。
2、签名原始串中，字段名和字段值都采用原始值，不进行URL Encode。
3、威富通返回的应答或通知消息可能会由于升级增加参数，请验证应答签名时注意允许这种情况。
举例：调用某个接口，接口有如下字段：<xml><body><![CDATA[测试支付]]></body><mch_create_ip><![CDATA[127.0.0.1]]></mch_create_ip><mch_id><![CDATA[001075552110006]]></mch_id><nonce_str><![CDATA[1409196838]]></nonce_str><notify_url><![CDATA[http://227.0.0.1:9001/javak/sds?123&23=3]]></notify_url> <out_trade_no><![CDATA[141903606228]]></out_trade_no><service><![CDATA[unified.trade.micropay]]></service><sign><![CDATA[83684D9546F261997EFF2ECFAC372583]]></sign><total_fee><![CDATA[1]]></total_fee></xml>正确的签名字段排序为：body=测试支付&mch_create_ip=127.0.0.1&mch_id=001075552110006&nonce_str=1409196838¬ify_url=http://227.0.0.1:9001/javak/sds?123&23=3&out_trade_no=141903606228&service=pay. weixin.scancode&total_fee=14.2签名算法目前暂只支持MD5签名MD5签名MD5是一种摘要生成算法，通过在签名原始串后加上商户通信密钥的内容，进行MD5运算，形成的摘要字符串即为签名结果。