Ver2.0.105A
快钱
快钱快钱
快钱【
【【
【人民币支付网关
人民币支付网关人民币支付网关
人民币支付网关】
】】
】
商户接口规范
上海快钱信息服务有限公司
目
录
1.
文档说明
文档说明文档说明
文档说明
........................................................................................................................................................... 3
上海快钱信息服务有限公司
版权所有
第
2
页
1.1
文档目标
......................................................................................................................................... 3
1.2
阅读对象
......................................................................................................................................... 3
1.3
相关约定
......................................................................................................................................... 3
1.4
技术支持
......................................................................................................................................... 3
2.
接口
接口接口
接口开发
开发开发
开发
........................................................................................................................................................... 4
2.1
功能说明及流程
............................................................................................................................. 4
2.2
开发准备
......................................................................................................................................... 4
2.3
参数说明
......................................................................................................................................... 4
2.3.1
商户提交到快钱
.................................................................................................................. 4
2.3.2
快钱返回到商户
.................................................................................................................. 6
2.4
开发提示
......................................................................................................................................... 8
2.4.1
签名字符串
.......................................................................................................................... 8
2.4.2
通知支付结果
...................................................................................................................... 8
2.4.3
商户对支付结果的处理
...................................................................................................... 9
2.5
安全要点
......................................................................................................................................... 9
2.5.1
密钥管理
.............................................................................................................................. 9
2.5.2
数据校验
.............................................................................................................................. 9
2.5.3
对账
.................................................................................................................................... 10
2.6
特殊定制
....................................................................................................................................... 10
2.6.1
绑定快钱服务器
IP ............................................................................................................ 10
2.6.2
直连银行
............................................................................................................................ 10
2.6.3
企业网银支付
.................................................................................................................... 10
3.
参考资料
参考资料参考资料
参考资料
......................................................................................................................................................... 11
3.1
常见问题
....................................................................................................................................... 11
3.1.1
如何获取收款账户的账号
................................................................................................ 11
3.1.2
如何获取或修改网关商户密钥
........................................................................................ 11
3.1.3
如何查询网关交易记录
.................................................................................................... 11
3.1.4
如何自助补发支付结果
.................................................................................................... 11
3.2
银行代码表
................................................................................................................................... 12
3.3
错误代码表
................................................................................................................................... 13
4
附录
附录附录
附录
.................................................................................................................................................................. 15
4.1
版权说明
....................................................................................................................................... 15
4.2
快钱资源
....................................................................................................................................... 15
上海快钱信息服务有限公司
版权所有
第
3
页
1. 文档说明
文档说明文档说明
文档说明
1.1 文档目标
文档目标文档目标
文档目标
本文档的目的是为快钱人民币支付网关平台定义一个接口规范，以帮助商户技术人员接入快
钱人民币支付网关，并快速掌握快钱人民币支付网关相关功能，便于尽快投入使用。
1.2 阅读对象
阅读对象阅读对象
阅读对象
快钱人民币支付网关商户的网上应用开发人员、维护人员和管理人员。
他们应具备以下基本知识：
了解 MICROSOFT WINDOWS/NT、WINDOWS9X、WINDOWS 2000、HP-UX、AIX、SUN SOLARIS、
LINUX、BSD 等操作系统的其中一种；
了解上述系统上的网站设置和网页制作方法；
了解 HTML 语言以及 CGI（COMMON GATEWAY INTERFACE）或 ASP（ACTIVE SERVER PAGES）或
PHP 或 JAVA 等开发语言；
了解信息安全的基本概念。
1.3 相关
相关相关
相关约定
约定约定
约定
商户：指已注册成为快钱用户、并使用快钱产品实现其收付费功能需求、为其用户提供各类产
品或者相关服务的企业或个人。
用户：指在商户网站等系统购物的企业或个人。
购物：指用户在商户网站购买相关产品或服务。
{XXX}
：
XXX
前后分别加
{
和
}
，表示名称为
XXX
的变量所对应的值。
1.4 技术支持
技术支持技术支持
技术支持
如果您有任何技术上的疑问，可按如下方式寻求帮助：
技术支持热线：
86 -21 - 58777299 / 58777399 - 8163 / 8161
技术支持邮箱：
support@99bill.com
技术支持时间：周一到周五 9:00-
18
:00
上海快钱信息服务有限公司
版权所有
第
4
页
2. 接口开发
接口开发接口开发
接口开发
2.1 功能说明及流程
功能说明及流程功能说明及流程
功能说明及流程
用户
向
商户购物时，需要通
过
一定方式
向
商户支付相关费用。商户网站系统如果
集
成了快钱人
民币支付网关，可以
让
用户
很
方便
向
商户支付相关款
项
，并
且
商户
也
可以
很容
易了解到款
项
的
到
帐情况
及用户购买的产品或服务。
整体
流程如下：
用户在商户
选择
产品或服务，在下
订单完
成后，商户网站等系统
会将该订单
号及对应
订单金额
以及收款方信息等相关资
料
提交到快钱，
然
后
跳转
到快钱页
面进
行支付。
当
支付
完
成后，快钱
通知商户支付结果，并
且根
据商户指定的
地址跳转
到商户指定页
面
。商户在接收到支付结果
之
后，可以对数据
库进
行相应
更新
，
然
后在
显
示
给
用户的页
面
中作
出
相应提示。
2.2 开发准备
开发准备开发准备
开发准备
商户开发人员应
该仔细
阅读本
协议
以及注
意事项
，并准备
好
如下信息：
商户在快钱的用于收款的人民币账号
商户的人民币网关密钥
2.3 参数说明
参数说明参数说明
参数说明
2.3.1 商户
商户商户
商户提交
提交提交
提交到快钱
到快钱到快钱
到快钱
提交地址
https://www.99bill.com/gateway/recvMerchantInfoAction.htm (推荐！）
或 http://www.99bill.com/gateway/recvMerchantInfoAction.htm
参数名称
参数含义
长度
可否为空
参数说明
协议参数
inputCharset
字符集
2
可为空
固定选择值：
1
、
2
、
3
1
代表
UTF-8; 2
代表
GBK; 3
代表
GB2312
默认值为
1
pageUrl
接 受 支 付 结
果 的 页 面 地
址
256
可为空
需要是绝对地址，与
bgUrl
不能同时为空
当
bgUrl
为空时，快钱直接将支付结果
GET
到
pageUrl
当
bgUrl
不为空时，按照
bgUrl
的方式返回
bgUrl
服 务 器 接 受
支 付 结 果 的
后台地址
256
可为空
需要是绝对地址，与
pageUrl
不能同时为空
快钱将支付结果发送到
bgUrl
对应的地址，并且获取
商户按照约定格式输出的地址，显示页面给用户
version
网关版本
10
不可空
固定值：
v2.0
上海快钱信息服务有限公司
版权所有
第
5
页
注意为小写字母
language 网 关 页 面 显
示语言种类
2
不可空
固定值：
1
1
代表中文显示
signType
签名类型
2
不可空
固定值：
1
1
代表
MD5
加密签名方式
买卖双方信息参数
merchantAcctId
人民币账号
30
不可空
数字串
本参数用来指定接收款项的人民币账号
payerName
支付人姓名
32
可为空
英文或中文字符
payerContactType
支 付 人 联 系
方式类型
2
可为空
固定值：
1
1
代表电子邮件方式
payerContact
支 付 人 联 系
方式
50
可为空
字符串
根据 payerContactType 的方式填写对应字符
业务参数
orderId
商户订单号
50
不可空
字符串
只允许使用字母、数字、
-
、
_,
并以字母或数字开头
每商户提交的订单号，必须在自身账户交易中唯一
orderAmount
商 户 订 单 金
额
10
不可空
整型数字
以分为单位。比方
10
元，提交时金额应为
1000
orderTime
商 户 订 单 提
交时间
14
不可空
数字串，一共
14
位
格式为：年
[4
位
]
月
[2
位
]
日
[2
位
]
时
[2
位
]
分
[2
位
]
秒
[2
位
]
例如：
20071117020101
productName
商品名称
256
可为空
英文或中文字符串
productNum
商品数量
8
可为空
整型数字
productId
商品代码
20
可为空
字母、数字或
-
、
_
的组合
如商户发布了优惠券，并只想对指定的某商品或某类
商品进行优惠时，请将此参数与发布优惠券时设置的
“适用商品”保持一致。只可填写一个代码。
如果不使用优惠券，本参数不用填写
productDesc
商品描述
400
可为空
英文或中文字符串
ext1
扩展字段 1
128
可为空
英文或中文字符串
支付完成后，按照原样返回给商户
ext
2
扩展字段
2
128
可为空
英文或中文字符串
支付完成后，按照原样返回给商户
payType
支付方式
2
不可空
固定选择值：
00
、
10
、
11
、
12
、
13
、
14
、
15
、
17
00
：
其它
支付
10
：
银
行
卡
网
银
支付
11
：电
话
支付
评论0