用户使用说明文档
版本号1.0
上海半丁数码科技有限公司
目录
1. 文档介绍 3
1.1. 读者对象 3
1.2. 基本说明 3
2. 支付流程 4
2.1. 在线支付流程 4
2.2. 手机支付流程 6
3. 支付接口 8
3.1. 在线支付接口 8
3.3. 手机支付接口 8
3.4. 接口参数说明 8
3.5. 签名加密说明 8
3.6. 错误代码说明 8
1. 文档介绍
1.1. 读者对象
系统设计人员、编程人员及测试人员
1.2. 基本说明
使用本平台的终端商户,需要联系半丁获得appid和相应的secretkey
appid是商户在本平台中的唯一标识,需要作为参数传递
secretkey是商户所拥有的私钥,用与生成sign字符串
appid与secretkey请商户自己保存好,因信息泄露所造成的商务纠纷,本公司概不负责
2. 支付流程
2.1. 在线支付流程
流程说明:
1.用户登陆网站
2.选择充值渠道
3.填写需充值的账号和充值金额
4.确认充值信息是否正确
5.产生订单信息
6.用户信息验证,若失败,直接返回失败结果
7.后台对订单信息处理后,转发到支付宝平台进行处理
8.根据支付宝平台返回的成功与否信息,记录充值日志
9.将充值结果显示给用户
2.2. 手机支付流程
流程说明:
1.用户通过手机应用或手机浏览器进入充值中心
2.选择充值渠道
3.填写需充值的账号
4.从下拉列表中选择充值卡面额
5.确认充值信息是否正确
6.产生订单信息
7.用户信息验证,若失败,直接返回失败结果
8.后台对订单信息处理后,转发到支付宝平台进行处理
9.根据支付宝平台返回的成功与否信息,记录充值日志
10.将充值结果返回应用或浏览器
3. 支付接口
3.1. 在线支付接口
http://paycenter.bdo.com/
3.3. 手机支付接口
http://paycenter.bdo.com/gateway/directpay
3.4. 接口参数说明
参数名称 | 参数含义 | 参数说明 | 签名顺序 |
appid | 应用编号 | 需要支付的应用的编号 | 1 |
method | 支付平台类型 | 支付的平台选择,目前固定为1,代表易宝 | 2 |
pid | 用户编号 | 用户的唯一身份标示 | 3 |
ticket | 用户门票 | 带有用户信息的加密字符串 | 4 |
amount | 支付金额 | 单位:元,精确到分。 | 5 |
cardno | 卡号 | 支付用的卡号 | 6 |
cardPwd | 密码 | 支付用的卡密 | 7 |
sign | 签名数据 | 列表中的参数,按签名顺序拼接生成的字符串,采用MD5加密。 |
签名数据按照参数的签名顺序拼接(参数名1=参数值1&参数名2=参数值2),末尾需要添加key值,该字符串为商户的secretkey(参见基本说明)。整个签名数据采用MD5加密处理,以供后台进行验证处理。
3.6. 错误代码说明
错误代码 | 错误说明 |
-1 | appid参数错误 |
-2 | method参数错误 |
-3 | pid参数错误 |
-4 | ticket参数错误 |
-5 | amount参数错误 |
-6 | cardNo参数错误 |
-7 | cardPwd参数错误 |
-8 | sign参数错误 |
-9 | sign验证失败 |
-10 | pid验证失败 |
-11 | method验证失败 |
-12 | 服务器内部错误 |