【三方支付】手机号发货

正式环境

https://api.kg.qq.com

POST

/karaoke/payment/v2/phone_notify

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

请求参数

Header 参数

Body 参数application/json

示例

{
    "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 '{
    "data": "string",
    "sign": "string"
}'

返回响应

🟢200OK

application/json

Body

示例

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

🟢200手机号未绑定

修改于 2025-12-05 03:32:58

【三方支付】订单发货

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