【三方支付】订单发货

正式环境

POST

/karaoke/payment/v2/order_notify

支付类

在业务侧进行支付，支付完成后调K歌发货接口，K歌进行权益发放。
接口请求需要带上三方的订单号，方便后续对账。
该接口需要进行额外配置才能使用。
发货加解密规则参考：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

必需

默认值:

Device-ID

string

可选

设备id，调用KtvSdk.getSdkImei()获取

Body 参数application/json

data

string

可选

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

参数名	必选	类型	说明	备注
appid	是	string	AppID	必须和header中一致
openid	是	string	用户id
pay_type	是	int	支付类型	1-普通包月支付 2-自动续费 3-连包签约 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/order_notify' \
--header 'X-Open-Access-Token;' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID;' \
--header 'Device-ID;' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200OK

application/json

Body

kg_order_id

string

可选

order_id

string

可选

timestamp

integer

可选

示例

{
  "kg_order_id": "string",
  "order_id": "string",
  "timestamp": 0
}

🟢200失败

🟠401没有权限

修改于 2025-03-19 09:16:44

【CDK】CDK状态查询

【三方支付】手机号发货