验证优惠券
这是一个用于验证折扣券是否可以使用的API。
Note
请参考这里以获取标识符政策。
请求信息¶
| 项目 | 描述 |
|---|---|
| 生产 URL | https://coupon.withhive.com/tp/coupon/discount_coupon_verify |
| 沙盒 URL | https://sandbox-coupon.withhive.com/tp/coupon/discount_coupon_verify |
| 方法 | POST |
| 响应格式 | JSON |
请求头¶
| 项目 | 描述 | 类型 | 必需 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 字符串 | 是 | |
| Authorization | Bearer | 字符串 | 是 | 如何检查Hive认证密钥：应用中心 > 项目管理 > 游戏详情 > 基本信息 > Hive认证密钥 |
请求参数¶
| 名称 | 类型 | 必需 (必需: M, 可选: O) | 描述 |
|---|---|---|---|
| game_index | 整数 | M | 应用中心游戏索引 |
| coupon | 字符串 | M | 优惠券号码 |
| cs_code | 字符串 | M | 游戏内用户 CS CODE |
| language | 字符串 | O | 响应消息显示 语言代码 (默认是英语) 在屏幕上直接显示消息时使用 |
| discount_type | 字符串 | O | 折扣类型（固定为'percent'） |
响应¶
| 名称 | 类型 | 必需 (必需: M, 可选: O) | 描述 |
|---|---|---|---|
| code | 整数 | M | 响应代码 (103: 可用) |
| message | 字符串 | M | 根据响应代码的结果消息 |
| info | 对象 | O | 如果可用，响应折扣券百分比的子项 |
| info > percent | 整数 | O | 折扣券百分比 |
请求示例¶
curl -L -v
-d '{"game_index": 539,"coupon": "HIVESDKTEST","cs_code": "123456789","language": "ko","discount_type":"percent"}'
-H "Content-Type: text/html"
-H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
https://sandbox-coupon.withhive.com/tp/coupon/api
>> POST /tp/coupon/discount_coupon_verify HTTP/2
> Host: sandbox-coupon.withhive.com
> user-agent: curl/7.68.0
> Content-Type: application/json
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY
> Accept: */*
> Content-Length: 105
响应示例¶
< HTTP/2 200
< server: nginx
< date: Wed, 27 Aug 2025 12:22:34 GMT
< content-type: application/json; charset=utf-8
{"code":103,"message":"The coupon will not be used until payment is completed.","info": {"percent": 30}}
响应代码¶
| 代码 | 描述 | 消息 |
|---|---|---|
| 103 | 可供使用 | 优惠券在付款完成之前不会被使用。 |
| 200 | 请求参数错误 | 一些参数缺失或参数名称不正确。 |
| 202 | 账户使用限制超出 | 您已超过可用的优惠券使用限制。 |
| 203 | 团体优惠券使用限制超出 | 您已超过可用的优惠券使用限制！ |
| 204 | 已发放的优惠券与游戏信息不匹配 | 该优惠券只能在对应游戏的活动优惠券兑换中使用。 |
| 205 | 无法使用的优惠券 | 此优惠券无法使用。 |
| 206 | 优惠券兑换中无法使用折扣券 | 输入的优惠券可以在网上商店使用。 |
| 300 | 优惠券号码长度不正确 | 优惠券号码不正确。请重新输入。 |
| 302 | 不存在的优惠券 | 这是一个不存在的优惠券号码。请再次检查。 |
| 303 | 优惠券当前正在使用 | 此优惠券已被使用。 |
| 304 | 优惠券已使用 | 此优惠券已被使用。 |
| 305 | 优惠券使用限制超出（所有唯一优惠券已使用） | 所有已发放的优惠券均已使用。 |
| 306 | 优惠券已过期 | 此优惠券已过期。 |
| 311 | 停止发放的优惠券 | 此优惠券已停止发放。 |
| 312 | 使用前期优惠券 | 还未到优惠券使用期。（测试优惠券不在验证范围内） |
| 400 | 项目传输错误（完全失败） | 优惠券使用失败。 如果继续失败，请联系客户服务。 |
| 401 | 项目传输错误（部分失败） | 优惠券使用部分失败。 请联系客户服务。 |
| 500 | 数据库通信错误 | 优惠券使用失败。 如果继续失败，请联系客户服务。 |
| 501 | 服务器通信失败 | 优惠券使用失败。 如果继续失败，请联系客户服务。 |