---
title: "RewardInfo"
description: "客户可用的奖励，包含了奖励的基本信息。"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/reward-info'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/reward-info.md'
---
# RewardInfo

客户可用的奖励，包含了奖励的基本信息。

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Type Signature

`RewardInfo`

## Fields

* `autoStackLimit`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/boolean.md)

  是否允许与自动折扣叠加使用。
  

* `benefitsCode`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  权益折扣码

* `benefitsDetails`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  当 rewardType 为 CASHBACK，PERCENTAGE_DISCOUNT， CASH_VOUCHER，FREE_SHIPPING 时，表示这些优惠对应的折扣值，比如优惠x%

* `benefitsUsageInstructionType`

  [BenefitsUsageInstructionType](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/benefits-usage-instruction-type.md)

  权益使用条件类型 

* `benefitsUsageInstructionValue`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  	当rewardScene = BIRTH_BENEFITS,或 rewardType = PERCENTAGE_DISCOUNT 或 CASH_VOUCHER 时有效。表示 benefitsUsageInstructionType 对应的数值。

* `codeStackLimit`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/boolean.md)

  是否允许与折扣码叠加使用。
  

* `couponStatus`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/boolean.md)

  是否可用。
  

* `couponStatusDetail`

  [couponStatusDetail](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/coupon-status-detail.md)

  仅 couponStatus= false时有意义。 used: 已使用 expired: 已过期

* `couponUsageScope`

  [CouponUsageScope](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/coupon-usage-scope.md)

  折扣码使用范围。

* `createdAt`

  [Date](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/date.md)

  奖励被创建的时间

* `redeemPointsValue`

  [Int](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/int.md)

  积分兑换奖励时，使用的积分数。仅当 rewardSource = POINTS_REDEMPTION 时有意义。

* `rewardAcquireTime`

  [Date](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/date.md)

  奖励获取时间

* `rewardExpiryTime`

  [Date](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/date.md)

  奖励失效时间。当字段为空时，表示永久有效

* `rewardScene`

  [RewardScene](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/reward-scene.md)

  奖励场景。

* `rewardSource`

  [RewardSource](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/reward-source.md)

  奖励来源。

* `rewardType`

  [RewardType](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/reward-type.md)

  奖励类型。

* `usageLimits`

  [Int](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/int.md)

  
  
  中文
  当 rewardType 为 CASHBACK，PERCENTAGE_DISCOUNT， CASH_VOUCHER，FREE_SHIPPING 和 FREE_PRODUCT 时，表示这些优惠的使用次数限制，null代表无限使用

## Schema Definition

```graphql
type RewardInfo { 
	autoStackLimit: Boolean
	benefitsCode: String
	benefitsDetails: String
	benefitsUsageInstructionType: BenefitsUsageInstructionType
	benefitsUsageInstructionValue: String
	codeStackLimit: Boolean
	couponStatus: Boolean
	couponStatusDetail: couponStatusDetail
	couponUsageScope: CouponUsageScope
	createdAt: Date
	redeemPointsValue: Int
	rewardAcquireTime: Date
	rewardExpiryTime: Date
	rewardScene: RewardScene
	rewardSource: RewardSource
	rewardType: RewardType
	usageLimits: Int 
}
```

## Field from

* [CustomerRewardsInfoConnection](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/customer-rewards-info-connection.md).nodes

  节点列表

* [CustomerRewardsInfoEdge](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/customers/objects/customer-rewards-info-edge.md).node

  节点信息

## Error Handling

关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/storefront-api/overview.md#status-and-error-codes)。