教程分类
快手话费直充联调指南
一、商家入驻阶段
商家自行联系快手平台开通娱乐会员或者话费充值等业务，目前话费和会员业务，均由「吕守鑫」老师负责
二、创建开发者应用
1、开放平台入驻
快手开放平台地址：https://open.kwaixiaodian.com/
注册账号时，话费，娱乐会员，油卡，电子凭证等业务，必须选择【商家开发者】模式
2、创建应用
①回调地址填写：http://aldskwai.agiso.com/kwai/CustomLogin
特别注意：按如下图应选择http://
②官网地址填写: https://www.agiso.com
特别注意：应该选择https://
3、确认应用上线
添加完成之后，可以在下面这个地址里面看到应用，状态是"上线运行中"
https://open.kwaixiaodian.com/console/zone/new/home/application/appList
三、测试流程
1、添加集成中心
a）找快手邀请【集成中心】
跟快手说明准备联调了，需要添加【集成中心】，将”邀请所需数据“整理一下发给群里的快手技术
邀请所需数据：企业主体全称+邮箱账号+appkey+对接业务（话费业务、会员业务或者电子凭证业务）
示例：杭州快手科技有限公司（行业测试专用）+zhangsan@kuaishou.com+ks690458119367888888+话费充值业务
查看企业主体信息：
查看邮箱账号：
b）邀请成功后，商家需要【添加集成】接口实现
c）关联应用
“娱乐会员充值”里点击"关联应用"--选择申请的自研应用--关联
d）参数设置
AppKey、 AppSecret、SignSecret 这三个值从商家自研后台--应用详情--证书信息里复制出来并填入：
阿奇索自动发货后台--定制开发--娱乐会员--参数配置，填入对应证书信息。
填完之后需再点击“获取当前账号授权Token”
温馨提醒：可能出现的2种错误提示
提示1: 如果会出现如下图提示，则说明【回调地址】填写错误。正确的回调地址为http://aldskwai.agiso.com/kwai/CustomLogin
提示2：如果会出现如下图错误提示，则说明【没有添加测试用户】。需前往添加测试用户
2、商家自助调试准备
前往【开发】-【集成中心】-【官方集成】
a）配置地址
关联后该页面即可看到应用"娱乐会员充值”，出现2个【配置】两个按钮。需要将自动发货后台的信息填到“SPI”配置里面，要分别填入提单的地址和查询的地址，两个地址是不一样的，别填错了。
①快手通知商家会员充值：
*点击【配置】
*参考下图，将自动发货后台的数据填到“SPI”配置里面
②快手查询会员充值结果
*点击【配置】
*参考下图，将自动发货后台的数据填到“SPI”配置里面
b）准备测试截图word文档
*先建好“商家联调结果”word文档，待会测试时将测试结果截图放到word文档里面
*根据你要对接的业务准备word文档
例如娱乐会员：
商家联调结果示例：
其他业务：
3、开始测试
前往【开发】-【集成中心】-【官方集成】
a）请点击【快手通知商家会员充值】的测试按钮进入测试页面
*收单成功
-这里要填一下正确信息，把订单号记录好来，因为后面可能会要用到。
-测试结果中的【responseBody】要显示成“status”:ACCEPTED"，则说明测试成功，把结果截图下来放到word文档
将店铺信息和测试结果截图一起截图
*拒单场景：商品价格错误（话费和电子凭证业务需要测试此项）
-其它参数（APPKEY、签名、店铺ID、订单编号等）要正确，价格填成负数。
-测试结果中的【responseBody】要显示成“error_msg”:商品价格错误"，则说明测试成功，把结果截图下来放到word文档
将店铺信息和测试结果截图一起截图
*拒单场景：appkey未传入
无法修改appkey，无法调试。不需要截图
*拒单场景：签名错误
-只要将签名全部清空，点“发起测试”。
-测试结果中的【responseBody】要显示成“error_msg”:"验签失败"，则说明测试成功，把结果截图下来放到word文档
将店铺信息和测试结果截图一起截图
其他场景：比如超时
word文档里写【无此场景】就行
b）请点击【快手查询会员充值结果】的测试按钮进入测试页面
由于我们在“步骤a）”测试了一些订单所以在自动发货后台订单列表可以看到一些订单，接下来的测试如果订单不够用，可以参考“步骤a）-收单成功”生产一些订单出来测试
*查询成功：返回状态充值中（ACCEPED）
-自动发货后台找一笔订单“订单状态”为“已收单”
-在测试页面，其它参数（appkey、签名、店铺id等）都要填写正确
-测试结果中的【responseBody】要显示成"status"："ACCEPTED"，则说明测试成功，把结果截图下来放到word文档
将店铺信息和测试结果截图一起截图
*查询成功：返回状态充值成功（SUCCESS）
-前往自动发货后台，找到一笔订单，利用“自助联调”功能将“订单状态”改为“充值成功”
-测试结果中的【responseBody】要显示成"status"："SUCCESS"，则说明测试成功，把结果截图下来放到word文档
将店铺信息和测试结果截图一起截图
*查询成功：返回状态充值失败（FAILED）
-前往自动发货后台，找到一笔订单，利用“自助联调”功能将“订单状态”改为“充值失败”
-测试结果中的【responseBody】要显示成"status"："FAILED"，则说明测试成功，把结果截图下来放到word文档
将店铺信息和测试结果截图一起截图
*查询失败：订单不存在（必须返回错误码「4012002」)
-在测试页面，填一个没用过的订单号
-测试结果中的【responseBody】要显示成"error_msg"："查询不到指定订单，请检查订单号"，则说明测试成功，把结果截图下来放到word文档
将店铺信息和测试结果截图一起截图
c）会员充值结果回调结果
*回调充值成功
-前往自动发货后台，找一笔订单，点击“通知平台成功”按钮
-有红色的报错提示（如下图）则说明测试成功，将错误信息复制起来
-将错误信息粘贴到这里https://www.json.cn/
*回调充值失败
-前往自动发货后台，找一笔订单，点击“退款”按钮
-有红色的报错提示（如下图）则说明测试成功，将错误信息复制起来
-将错误信息粘贴到这里https://www.json.cn/
将”商家联调结果”word文档整理好后，发给快手，他们看完会表示是否有问题
没问题我们就将点击“提交实现”
三、准备发布
*建一个“发布前准备数据”word文档。将下面15点内容复制到文档里
1、本次业务对接的快手运营小二是谁。
菠萝老师
2、话费或娱乐会员收单接口，线下环境是否自测通过。自测通过，详见联调文档
3、话费或娱乐会员查询接口，线下环境是否自测通过。自测通过，详见联调文档
4、话费或娱乐会员收单接口，线上环境是否自测通过。自测通过，详见联调文档
5、话费或娱乐会员查询接口，线上环境是否自测通过。自测通过，详见联调文档
6、话费或娱乐会员收单接口（请求方式：P0ST),生产环境地址（必须使用域名形式，不支持IP+端口形式。注意不支持1024以内端口，快手侧会强制审核），最大能支撑的P$和平均耗时。
通商家收单接口：http3:/xxx.xxx.com/xxx/xxx,最大能支撑200TPS,平均耗时500ms
7、话费或娱乐会员查询接口（请求方式：P0ST),生产环境地址（同上），最大能支撑的QP$和平均耗时。
查询商家充值结果接口：http3:/xxx.xxx.con/xxx/xxx,最大能支撑500QPS,平均耗时50ms
8、服务商的生产环境appkey和signScret,是否已上线。（已上线）
appkey:ksxxx
signSecret:xxx
9、服务商生产环境商家的用户id(即快手号id)和商家名称。商家id(又名快手号id)：123456,商家名称：xxx旗舰店
10、本次技术对接，发布商品的末级类目。中国移动话费快充类目、中国联通话费快充类目、娱乐会员类目.…
11、是否晓：不及时回调导致超时关单资损，由商家承担。
已知晓
12、是否晓：配置完成后，商家必须在生产环境下每个类目测试验证一笔订单，并把订单号发给快手人员确认。
已知晓
13、是否有监控，可以主动发现异常场景。比如：拒单场景（商品未绑定、携号转网、库存不足、系统异常等）、查询失败场景（订单不存在、系统异常等）。
已监控
14、是否晓：商家在大主播带货前必须要压测，压测通过后方可带货。详细见压测s0P:商家压测s0P。
已知晓
15、是否知晓：在快手大促期间(618、818、双11、双12、年货节)或者周五（快手禁止变更），尽量不要做系统变更。
已晓，fo11ow快手策略
*修改文档的信息，按照下图修改，修改完就发送给快手
*如果有【电子卡券】的，就用下面这份模板修改
【电子凭证发布前准备数据】
1、本次业务对接的快手运营小二是谁。
菠萝老师
2、通知商家发码接口，线下环境是否自测通过。快手发码快手核销，无需实现
3、查询商家卡券接口，线下环境是否自测通过。快手发码快手核销，无需实现
4、通知商家销毁接口，线下环境是否自测通过。快手发码快手核销，无需实现
5、通知商家发码接口，线上环境是否自测通过。快手发码快手核销，无需实现
6、查询商家卡券接口，线上环境是否白测通过。快手发码快手核销，无需实现
7、通知商家销毁接口，线上环境是否自测通过。快手发码快手核销，无需实现
8、服务商的生产环境appkey和signScret。(已上线)
appKey:xx
signSecret:xx
9、服务商生产环境商家的用户id和商家名称。商家ID:xx,商家名称：聚琳琅xx
10、本次技术对接，要上架商品的未级类目。游戏充值类目（电子凭证发货方式）
11、电子凭证对接方案：方案D(快手发码快手核销)
12、发码方式：快手发码
13、核销方式：快手核销
14、服务商需要提供的接口地址
方案D无需提供接口实现
15、是否晓：不及时回调发码导致超时关单资损，由商家承担。
已知晓
16、是否晓：配置完成后，商家必须在生产环境下每个类目测试验证一笔订单，并把订单号发给快手人员确认。
已知晓
17、是否有监控，可以主动发现异常场景。比如：拒单场景（商品不存在、库存不足、限购1单等）、查询失败场景订单不存在、卡券不存在等)。
已知晓
18、是否晓：商家在大主播带货前必须要压测，压测通过后方可带货。
已知晓
19、是否晓：在快手大促期间(618、818、双11、双12、年货节)或者周五（快手禁止变更），尽量不要做系统变更。
已知晓，fo11ow快手策略
四、发布成功，自行测试一笔订单
等待快手发布完应用，商家自行去快手后台创建商品，再前往自动发货后台设置发货内容