比例折扣券验证

这是一个用于验证百分比折扣券是否可以使用的API。

Note

请参考这里以获取标识符政策。

请求信息¶

项目	描述
生产 URL	https://coupon.withhive.com/v2/tp/coupon/discount_coupon_verify
沙盒 URL	https://sandbox-coupon.withhive.com/v2/tp/coupon/discount_coupon_verify
方法	POST
响应格式	JSON

请求头¶

项目	描述	类型	必需	备注
Content-Type	application/json	字符串	是
X-Access-Token	用于应用服务器认证的 OAuth 2.0 Access Token （请参阅发行 OAuth Token）	字符串	是	如何检查Hive认证密钥：应用中心 > 项目管理 > 游戏详情 > 基本信息 > Hive认证密钥

请求参数¶

名称	类型	必需 (必需: M, 可选: O)	描述
game_index	Integer	M	应用中心游戏索引
coupon	String	M	优惠券号码
cs_code	String	M	游戏内用户 CS CODE
server_id	String	O	服务器 ID 针对全部服务器发放的优惠券为必填针对特定服务器发放的优惠券非必填
language	String	O	响应消息显示语言代码 (默认是英语) 在屏幕上直接显示消息时使用
discount_type	String	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","server_id":"kr","language": "ko","discount_type":"percent"}'
 -H "Content-Type: application/json"
 -H "X-Access-Token: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6ImEwYWZlYjZlLTllYWItY2ZiMC03ZTMxLTNhNzMyZTQ5In0.eyJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5oaXZlc2RrIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImdyYW50X3R5cGUiOiJ1c2VyIiwiaWF0IjoxNzg5NDA2NzI5LCJleHAiOjE3ODk0MTAzMjksImF1dGhfdmVyIjoidjQiLCJ1c2VyX2lkIjoyMDAwMDAzMTM0MSwiaXNfd2hpdGVsaXN0IjpmYWxzZX0.MgPO-e-Gm_dErRcfjVPKFdrh9M1ywqpU5aBmrFDZihzA5kKCw_QjPZv-Sb94LmbrzIqYuGQu29tIbX9DhJg_SpschZ4dihLx75pt5fSqYkzXMNHsbDjP-A7Yn0yjqP8f9w0DD0B_20Vbw6WfUUImNLQK0UpKu9Pd6cOILImDOn9YSkc1ozuzGQ04jgihwSxtP8cRTNGn53aB89CbSzYZbUqdUtyCOY9q1BXeIlrq_4zd_YWoPPQjPd3uD3wt3cVNg4nfNfQ55PDXPTn-QCm_HsfnL12wrNFnD-UW9SlCvM6TouoErNFrLaQ3sYvgsek-n47-bylvzTGa7GAvakwuog"
 https://sandbox-coupon.withhive.com/v2/tp/coupon/discount_coupon_verify

>> POST /tp/coupon/discount_coupon_verify HTTP/2
> Host: sandbox-coupon.withhive.com 
> user-agent: curl/7.68.0 
> Content-Type: application/json
> X-Access-Token: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6ImEwYWZlYjZlLTllYWItY2ZiMC03ZTMxLTNhNzMyZTQ5In0.eyJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5oaXZlc2RrIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImdyYW50X3R5cGUiOiJ1c2VyIiwiaWF0IjoxNzg5NDA2NzI5LCJleHAiOjE3ODk0MTAzMjksImF1dGhfdmVyIjoidjQiLCJ1c2VyX2lkIjoyMDAwMDAzMTM0MSwiaXNfd2hpdGVsaXN0IjpmYWxzZX0.MgPO-e-Gm_dErRcfjVPKFdrh9M1ywqpU5aBmrFDZihzA5kKCw_QjPZv-Sb94LmbrzIqYuGQu29tIbX9DhJg_SpschZ4dihLx75pt5fSqYkzXMNHsbDjP-A7Yn0yjqP8f9w0DD0B_20Vbw6WfUUImNLQK0UpKu9Pd6cOILImDOn9YSkc1ozuzGQ04jgihwSxtP8cRTNGn53aB89CbSzYZbUqdUtyCOY9q1BXeIlrq_4zd_YWoPPQjPd3uD3wt3cVNg4nfNfQ55PDXPTn-QCm_HsfnL12wrNFnD-UW9SlCvM6TouoErNFrLaQ3sYvgsek-n47-bylvzTGa7GAvakwuog
> 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	服务器通信失败	优惠券使用失败。如果继续失败，请联系客户服务。