全民K歌IOT开放平台
  1. 支付类
全民K歌IOT开放平台
  • 厂商合作流程
  • 快速接入
  • SDK bug提单规范
  • 如何在线调试接口
  • 常见问题
  • 业务错误码说明
  • 开放平台接入指南
    • 登录鉴权方式介绍V2(推荐)
    • 如何申请接入
    • CDK权限申请流程
    • 获取应用级token
    • 获取登录二维码
    • 查询二维码的状态
    • 获取用户级token
    • 刷新用户级token
  • 基础类
    • tagId对照表
    • 歌曲详情
    • 查询mv的播放地址
    • 搜索
    • 搜索联想
    • 查询歌手歌曲
    • 获取歌曲歌词文件
    • 搜索某歌手的歌曲
    • Q音歌曲mid映射K歌
    • 短剧播放链接
    • 查询应用限免配置
  • 运营类
    • 排行榜id说明
    • 获取城市id列表
    • 获取专题分类列表
    • 获取云端配置
    • 热门ugc
    • 热搜词
    • 排行榜
    • 获取专题下歌曲信息
    • 获取车联渠道映射
    • 热门推荐
    • (新)排行榜
    • 综合歌单列表查询
    • 设置缓存设备
    • TV版分类歌单列表
    • 获取TV频道页tab配置
    • 获取用户协议
    • 获取广告配置
    • 拉取短剧合集的列表
  • 用户类
    • 用户信息查询
    • 删除用户UGC作品
    • 获取推荐/翻唱作品
    • 获取同城作品
    • 用户作品列表
    • 获取好友作品
    • UGC作品详情
    • 更改作品访问权限
    • 用户个推歌单
  • 支付类
    • 支付接入流程
    • 订单发货使用简述
    • 开通设备会员限免简述
    • 通用sign计算规则
    • 通用返回结构
    • 【CDK】CDK兑换
      POST
    • 【CDK】生成CDK
      POST
    • 【CDK】CDK召回
      POST
    • 【CDK】CDK状态查询
      POST
    • 【三方支付】订单发货
      POST
    • 【三方支付】手机号发货
      POST
    • 【三方支付】订单状态查询
      POST
    • 【米大师支付】获取会员商品列表
      POST
    • 【米大师支付】未登录-查询会员商品列表
      POST
    • 【米大师支付】支付下单
      POST
    • 【米大师支付】支付成功通知
      POST
    • 【米大师支付】查询用户支付成功订单记录
      POST
    • 查询设备以及用户是否有赠送资格
      POST
    • 查询设备限免剩余时长
      POST
    • 退款设备会员
      POST
    • 设备会员迁移
      POST
    • 查询会员赠送时长
      POST
    • 同步支付订单接口
      POST
    • 【三方支付】存量会员迁移领取查询
      POST
    • 【三方支付】存量会员迁移接口
      POST
    • 授权设备体验会员
      POST
    • 查询用户会员信息
      POST
    • 【三方支付】超会发货
      POST
  • 用户作品-文件类
    • callback_url说明
    • 上传音频源文件
    • (服务端)上传音频作品的链接
  • 通用类
    • 【厂商定制】匹配搜索
    • 【腾讯视频专用】获取SDK请求使用的token
    • 获取kg的短链接
  1. 支付类

订单发货使用简述

tips:以下有任何疑问可咨询对应开发人员孙康(kingsun)

1、第三方需提供公钥给K歌#

生成key命令参考
`
openssl genrsa -out rsa_private_key.pem 1024
openssl pkcs8 -topk8 -inform PEM -in rsa_private_key.pem -outform PEM -nocrypt > pkcs8_rsa_private_key.pem
openssl rsa -in pkcs8_rsa_private_key.pem -pubout -out pkcs8_rsa_public_key.pem
`

2、请求参数#

参数名必选类型默认值说明
data是string-消息数据, 内容为json字符串, 经过标准base64编码
sign是string-对上面data数据的签名,签名采用SHA1withRSA,经过标准base64编码,第三方提供public key给K歌,用于验证此消息是否由第三方发出

data参数说明#

参数名必选类型说明备注
appid是stringAppID必须和header中一致
openid是string用户id
pay_type是int支付类型1-普通包月支付 2-自动续费 3-连包签约 11-包月会员补偿 12-连包会员补偿 100-退权益
price是int实际付款金额单位(分)
days是int天数 (31 93 372 其他天数请联系产品)
pay_time是int支付时间秒级时间戳
order_id是string订单id(对账用)对同一个orderid的请求幂等
timestamp是int请求时间戳秒级时间戳,允许误差5分钟内
marketing_id否string营销活动id特殊天数商品需要传,比如1天、3天。活动号请联系产品获取

3、错误码说明#

1.
网关错误
例如 HTTP Header中的X-Open-APP-ID 应用级X-Open-Access-Token验证失败
2.
确认返回HTTP statuscode为200
3.
业务错误码
3.1 错误码范围10001 - 11000 应该在联调阶段处理
返回值错误信息备注
10001参数错误Content-Type错误等
10002解析json失败json字符串 base64解码失败/json解析失败等
10003header不匹配http header中appid与body中appid不一致
10004参数错误2K歌内部server返回,出现概率较小
10005未找到配置k歌内部未进行配置(应在测试阶段发现处理)
10006无发货权限-
10007无自动扣费权限必须使用用户级token验证(对应pay_type=1),不支持应用级token开通
10008重复退款-
10009退款时长或者价格错误-
10010订单超过最晚退款时间-
10016无退款权限-
3.2 错误码范围11001 - 12000 异常错误
返回值错误信息备注
11001签名错误sign校验失败
11002登录态校验失败appid openid 用户access_token校验失败
11003获取账号uid失败例如 自动扣费时,不需要用户在场, 用户已在K歌注销账号, 此时openid无法对应到K歌账号
11004订单已存在极短时间发送同一个订单的请求导致K歌后端异常 (一个请求成功, 其余请求返回该错误)
11005时间戳无效时间戳需要与K歌服务器误差在5分钟内
11006未知错误K歌后台会额外返回未知错误码 补充在msg中
错误说明
http status非200一般是在网关侧失败, 请确认应用级token正确
3.1的错误码在联调阶段后基本上不会出现
3.2的错误码可进行重试, 注意请求时间戳不要过期(5分钟内)

4、RSA加密算法示例#

上一页
支付接入流程
下一页
开通设备会员限免简述
Built with