Skip to main content
Billing

Use and manage coupons

View, use, and manage your coupons

Coupons are promotional benefits provided by QwenCloud during marketing campaigns. They fall into three types: Cash Coupon, Spend and Save Coupon, and Discount Coupon.

Coupon types

By issuance type, coupons fall into three categories:
TypeDescription
Cash CouponA coupon with a fixed face value that can be used multiple times to deduct from bills or orders until the balance is used up
Spend and Save CouponA coupon with a spending threshold (for example, "get 10 USD off for orders over 100 USD"). The discount is applied once to a qualifying order
Discount CouponA coupon with no minimum spending requirement that provides a one-time discount on an order amount, up to the maximum discount value
By scope, coupons are categorized as general-purpose coupons or product-specific coupons. Each account can hold a maximum of 50 valid coupons at one time, including coupons frozen by unpaid orders.

View coupons

Log in to QwenCloud, go to Special Offer > My free tier to enter the Benefits page, then select the Coupon tab to view your coupons. You can also access the Coupons page directly. You can filter coupons by:
  • Coupon Type: Cash Coupon, Spend and Save Coupon, or Discount Coupon
  • Status: Active, Exhausted, Expired, or Void
In the coupon list, you can view the following details for each coupon:
FieldDescription
Coupon IDThe unique identifier of the coupon
Coupon TypeCash Coupon, Spend and Save Coupon, or Discount Coupon
Face ValueThe face value of the coupon
BalanceThe remaining deductible amount
Order Amount LimitThe minimum order amount required to use the coupon
Applicable Order TypesThe transaction scenarios where the coupon applies, such as New Purchase, Renewal, Trial, Conversion, Scale-out, Upgrade, or Pay-as-you-go Bill
Effective TimeThe start date of the coupon
Expiry TimeThe end date of the coupon
StatusActive, Exhausted, Expired, or Void
The QwenCloud coupons page only displays coupons applicable to QwenCloud. If you also use Alibaba Cloud, your coupons may be consumed by Alibaba Cloud usage.

How to use coupons

Each coupon has specific applicable products, billing methods (subscription or pay-as-you-go), and usage conditions. Some coupons cannot be combined with other promotions. Check the coupon details before use.

Automatic deduction for pay-as-you-go bills

QwenCloud model API calls are billed on a pay-as-you-go (post-paid) basis. The system automatically applies eligible coupons when bills are generated. No manual action is required.
  • Automatic matching: The system prioritizes coupons closest to their expiration date. If multiple coupons have the same expiration date, the one with the highest remaining balance is applied first.
  • Multi-coupon deduction: If a single coupon's balance is insufficient to cover an entire bill, the system automatically applies the next available Cash Coupon until the bill is fully covered or all available coupons are exhausted.
  • Remaining balance: If a balance remains on the bill after all eligible coupons are applied, you must pay the remaining amount separately.
Pay-as-you-go bills are generated in hourly intervals and may have a delay. If you do not see a deduction record immediately after API calls or token consumption, wait and check again later.
The deduction order cannot be adjusted: the system automatically prioritizes coupons expiring soonest. You cannot manually configure the deduction priority or set account balance to be deducted first. There is no fixed billing date for pay-as-you-go resources. As long as the coupon is within its validity period and applicable to the product, the system deducts in real time as usage is incurred.
Coupons cannot be used to cover overdue payments. You must top up your account to clear any overdue balance. After you clear the overdue balance, subsequent pay-as-you-go charges can be offset using coupons.

Apply a coupon during order payment

When you purchase a subscription resource, the system automatically matches available coupons to your order based on the product, payment type, and order amount. On the payment page, you can manually select an eligible coupon.
  • Spend and Save Coupons and Discount Coupons are only applicable to subscription (prepaid) orders.
  • You can use only one coupon per order. A single coupon can be applied to multiple orders within its validity period until its balance is used up.
  • A coupon applied to an unpaid order is frozen. To use the coupon again, you must first cancel the unpaid order.

View deduction details

On the Coupons page, click View Details in the Actions column to view the deduction history of a specific coupon, including: Transaction time, billing period, and deduction amount.

Coupon refund rules

When an order is canceled, you unsubscribe from a resource, or provisioning fails, a used coupon may be refunded depending on the situation:
  • If you cancel an order before payment, the coupon is refunded.
  • If resource provisioning fails after ordering or a bill is rolled back, Cash Coupons and Spend and Save Coupons are refunded. Discount Coupons are not refunded.
  • If you unsubscribe from a resource or a bill is adjusted, the system evaluates whether to refund the used coupon based on its rules.

FAQ

Why can't I use my coupon?

Coupons have specific usage rules and restrictions. Check the Coupons management page for details. Common reasons include:
  • Product restrictions: The coupon is not applicable to the product you are purchasing or using.
  • Expiration: The coupon has expired.
  • Transaction type: The order type is not within the coupon's applicable scope.
  • Order amount: The order amount does not meet the minimum spending requirement for a Spend and Save Coupon.
  • Promotional exclusivity: Another discount or promotional offer is already applied.
  • Frozen coupon: The coupon is allocated to an unpaid order. Cancel the associated order first.

Can coupons be used for account top-up?

Coupons cannot be used to top up your account balance. They can only be deducted from order payments or automatically applied to pay-as-you-go bills.

Can coupons be cashed out, converted to balance, extended, or reissued?

  • Cannot be converted to balance or cashed out: Coupons cannot be converted to cash or deposited into your account balance. They can only be used for order payment deductions or automatic pay-as-you-go bill offsets.
  • Cannot be extended or reissued: Once a coupon expires, it cannot be recovered, reissued, or extended. Use coupons before they expire.
  • No charge for unused coupons: Claiming a coupon does not incur any charges. Deductions are only triggered when you purchase products or consume resources.