# 优惠券

调用此子部分中的API方法，配置和管理优惠券促销活动。
<div class="note">
<p><b>注：</b></p>
<p>关于优惠券的详细信息，请参阅我们的<a href="https://developers.xsolla.com/zh/liveops/promotion-tools/coupons/">文档</a>。</p>
</div>

 - [POST /v2/project/{project_id}/coupon/redeem](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/redeem-coupon.md): 兑换优惠券码。优惠券兑换后，用户将获得赠品。<br> <div class="note"> <strong>注：</strong><br><br> 此API调用使用用户JWT进行授权。<br><br> 请在<code>Authorization</code>请求头中按以下格式传入令牌：<code>Bearer <user_JWT></code>。关于用户JWT的更多信息，请参阅此调用的<stron
 - [GET /v2/project/{project_id}/coupon/code/{coupon_code}/rewards](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/get-coupon-rewards-by-code.md): 通过优惠券码获取优惠券奖励。可用于允许用户从多个商品中选择一个作为赠品。常见场景是：如果优惠券包含游戏作为赠品(`type=unit`)，则选择DRM。<br> <div class="note"> <strong>注：</strong><br><br> 此API调用使用用户JWT进行授权。<br><br> 请在<code>Authorization</code>请求头中按以下格式传入令牌：<co
 - [POST /v3/project/{project_id}/admin/coupon](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/admin-create-coupon.md): 创建优惠券促销活动。
 - [GET /v3/project/{project_id}/admin/coupon](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/get-coupons.md): 获取项目的优惠券促销活动列表。
 - [PUT /v3/project/{project_id}/admin/coupon/{external_id}](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/update-coupon-promotion.md): 更新优惠券促销活动。
 - [GET /v3/project/{project_id}/admin/coupon/{external_id}](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/get-coupon.md): 获取指定的优惠券促销活动。
 - [DELETE /v3/project/{project_id}/admin/coupon/{external_id}](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/delete-coupon-promotion.md): 删除[优惠券促销活动](https://developers.xsolla.com/zh/doc/shop-builder/features/coupons/)。删除的促销活动将： * 从您项目中设置的促销活动列表中消失。 * 不再适用于商品目录。用户无法通过该促销活动获得奖励商品。 删除后，该促销活动无法恢复。 已删除促销活动的优惠券码可以[添加到](https://developers.xs
 - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/activate](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/activate-coupon.md): 激活优惠券促销活动。 默认情况下创建的优惠券促销活动为禁用状态。 激活之前，不能进行兑换。 使用此端点启用和激活优惠券促销活动。
 - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/deactivate](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/deactivate-coupon.md): 停用优惠券促销活动。 默认情况下创建的优惠券促销活动为禁用状态。 激活之前，不能进行兑换。 使用此端点禁用和停用优惠券促销活动。
 - [POST /v2/project/{project_id}/admin/coupon/{external_id}/code](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/create-coupon-code.md): 创建优惠券码。
 - [GET /v2/project/{project_id}/admin/coupon/{external_id}/code](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/get-coupon-codes.md): 获取优惠券码。 响应包含该促销活动中的兑换码总数（`total_count`）以及当前页面的兑换码（`codes`）。如需获取下一页，请按`limit`的值递增`offset`（例如先传`“offset”: 100`，再传`“offset”: 200`），直到获取全部兑换码。 在大多数情况下，`“limit”: 100`或`“limit”: 1000`即可满足需求。较大的值（如`“limit”:
 - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/code/generate](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/generate-coupon-codes.md): 生成优惠券码。 兑换码生成指南： * 每个促销活动的兑换码总数没有上限，但单次请求最多只能生成50,000个兑换码。如果请求的数量超过该限制，将返回`422 Unprocessable Entity`错误。如需生成超过50,000个兑换码，请发送多次请求。 * 为提高可靠性，建议分批生成兑换码，每次请求最多生成10,000个。例如，如需创建100,000个代码，请发送10次`"count": 10
 - [GET /v2/project/{project_id}/admin/user/limit/coupon/external_id/{external_id}](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/get-coupon-user-limit.md): 获取指定用户可以使用优惠券的剩余次数。 用户限制API允许您限制用户可以使用优惠券的次数。要配置用户限制数本身，请前往“管理”部分： * [优惠券](https://developers.xsolla.com/zh/api/shop-builder/tag/promotions-coupons/)
 - [GET /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}](https://xsolla.redocly.app/zh/api/liveops/promotions-coupons/get-coupon-code-limit.md): 获取代码可以使用的剩余次数。要筛选代码，请使用`codes`查询参数。 要配置代码限制本身，请前往“管理”部分： *[优惠券](https://developers.xsolla.com/zh/api/shop-builder/tag/promotions-coupons/)