当前位置：文档之家 › 威富通统一小额支付接口文档V1.3

威富通统一小额支付接口文档V1.3

  • 格式：pdf
  • 大小：386.18 KB
  • 文档页数：24

威富通统一小额支付接口文档文档版本：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&notify_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运算，形成的摘要字符串即为签名结果。

合集下载

微信支付API文档120(受理)

微信支付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

收银系统开放接口文档(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)

企业付款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 上可以直接双