1. 集成准备

1.1 获得DBKEY和APPKEY

访问地址:https://pay.dangbei.com/open,注册并添加应用后,系统会自动生成DBKEY和APPKEY,也可在配置页面查看

1.2 下载SDK

请联系当贝商务获得SDK或者直接在官网下载https://pay.dangbei.com/index.html

1.3 配置

回调接口:请在后台配置页面填写回调接口;

支付方式:微信支付(必选)、支付宝(必选)、短信支付(非必选,金额只能为:1,2,4,5,6,8,10,12,15,20,25,30中的一个,目前仅支持电信运营商,请根据实际情况勾选)

1.4 导入SDK

#1.4 .1 Eclipse导入SDK

将下载包中的aar文件解压,将解压得到的jar(最好将class.jar重命名,例如:libDangbeiPay**_v1.8.8.jar**)以及googlezxing-3.1.1.jar合并到本地工程libs子目录下;

在Eclipse中右键工程根目录,选择Properties -> Java Build Path -> Libraries,然后点击Add External JARs... 选择指向jar的路径,点击OK,即导入成功。(ADT17及以上不需要手动导入)。

#1.4 .2 Android Studio导入SDK

将下载包中的aar以及googlezxing-3.1.1.jar合并到本地工程libs子目录下,通过如下方式导入:

compile files('libs/googlezxing-3.1.1.jar') compile(name:'edeviceid-1.0.9', ext:'aar') compile(name:'libDangbeiPay', ext:'aar')

2. 基本功能集成

2.1 支付流程图

1553505398003

2.2 配置manifest

2.3 DBKEY&APPKEY填写

中的yourDBKEY替换为您的应用DBKEY,APPKEY同理,标签在application下,其他部分不需改动。配置文件如下所示

2.4 页面的调用

 

注意:渠道号配置可以在调用SDK传参的intent中设置,也可以在清单文件中meta-data节点中配置,必须以DANGBEI_CHANNEL命名,两者当中至少选一项,SDK会优先使用intent中设置的渠道参数,具体配置的渠道,请参照https://pay.dangbei.com/channel.php进行设置.

2.5 获得返回值的方法

 

2.6 回调接口

要求接入方提供回调地址,SDK服务端即时推送支付状态至接入方,接入方根据SDK服务端的支付状态以及SDK客户端的支付状态进行二次确认判断,可在该应用的配置页面填写回调接口。

2.6.1 回调接口返回信息

2.6.2 回调接口参数说明

1. datastr**是支付信息,urldecode解码后信息如下所示**

2. sign 是签名,用来校验信息是否正确

加密算法:md5(Out_trade_no + appkey + openid + sign_85445221145)

以上加密字段不包含特殊符号分别为订单号、应用appkey、支付标识、固定字符串

2.6.3回调接口返回说明

支付成功之后当贝支付服务端会回调接入方的回调地址,将支付信息传给接入方,接入方收到回调信息之后,返回字符串success即可。

特别说明*如果遇到特殊情况,导致接入方的回调接口不可用,第一次回调失败之后,当贝支付会进行三次回调。回调返回信息后台展示

2.6.4支付状态查询接口

为了防止漏单(接入方回调接口调用失败),当贝支付提供支付状态查询接口

接口链接:https://pay.dangbei.com/openapi/getOrderStatus.php

请求方式:POST

请求参数

字段描述示例值
dbkey当贝keydaebb9ee52fba3e75c5e4696c1d2b0de
orderno订单号147831417983235
timestamp时间戳1478782659
salt盐值Paydangbei2016#$%
sign签名0c2d5d61a5801860786a49acd6895218

签名算法示例

sign = md5("dbkey=daebb9ee52fba3e75c5e4696c1d2b0de&orderno=147831417983235

×tamp=1478782659&salt=Paydangbei2016#$%")

返回信息

说明order_no:订单号 result:1 支付成功0不存在或未支付

2.7 特殊情况说明

若以上步骤中,用户将当贝支付SDK关闭后再进行支付,则当贝SDK是无法返回支付结果到接入方的APP,需要接入方自行和APP服务器进行支付确认,否则可能造成无法发放奖品,造成用户投诉。

3. 技术支持

服务端技术QQ:531201650

客户端技术QQ:504345877

商务QQ:2842243477

产品QQ:925503594