【三方支付】手机号发货

正式环境

POST

/karaoke/payment/v2/phone_notify

支付类

在业务侧进行支付，支付完成后调K歌发货接口，K歌进行权益发放。
接口请求需要带上三方的订单号，方便后续对账。
【三方支付】手机号发货接口可以认为是【三方支付】订单发货的前置接口，在没有用户账号只有手机号的情况下，前置查询手机号绑定的用户账号，然后再走订单发货接口正常发货。在用户手机号没有绑定K歌账号的情况下，会缓存订单&轮询，直至用户绑定手机号或者最终超时终止重试。
该接口需要进行额外配置才能使用。
如果手机号暂未绑定全民K歌帐号，请点击 https://c.y.qq.com/r/9Hin?_isForbidBigFont=1 进行绑定。
退权益失败请重试。
发货加解密规则参考：https://apifox.com/apidoc/project-951819/doc-771666

请求参数

Header 参数

X-Open-Access-Token

string

必需

access token

默认值:

X-Open-ID

string

openid

可选

默认值:

X-Open-App-ID

string

业务appid

必需

默认值:

Body 参数application/json

data

string

可选

OpenapiOrderInfo json字符串, 经base64编码。
OpenapiOrderInfo的结构为：

参数名	必选	类型	说明	备注
appid	是	string	AppID	必须和header中一致
phone	是	int	手机号
pay_type	是	int	支付类型	1-普通包月支付 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天。活动号请联系产品获取

sign

string

可选

示例

{
  "data": "string",
  "sign": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.kg.qq.com/karaoke/payment/v2/phone_notify' \
--header 'X-Open-Access-Token;' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID;' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200OK

application/json

Body

openid

string

可选

如果手机号已经绑定全民K歌帐号，则返回该用户openid；如果为空，则未绑定，请提醒用户点击 https://c.y.qq.com/r/9Hin?_isForbidBigFont=1 进行绑定。

kg_order_id

string

可选

如果手机号已经绑定全民K歌帐号，则返回该笔发货订单号；如果为空，则未绑定，请提醒用户点击 https://c.y.qq.com/r/9Hin?_isForbidBigFont=1 进行绑定。

order_id

string

可选

status

integer

可选

1-新订单，发货中 2-发货成功 3-已退权益 4-发货失败，终止重试；其中 234 为最终状态

timestamp

integer

服务端时间戳

可选

示例

{
  "code": 0,
  "sub_code": 0,
  "msg": "请求成功",
  "data": {
    "openid": "",
    "kg_order_id": "",
    "order_id": "kingsuntest111222224341",
    "status": 1,
    "timestamp": 1743162916
  }
}

🟢200手机号未绑定

修改于 2025-04-10 06:27:44

【三方支付】订单发货

【三方支付】订单状态查询