---
title: "CustomerRewardCreateInput"
description: "用于创建和发放客户奖励的输入字段。"
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/inputs/customer-reward-create-input'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/inputs/customer-reward-create-input.md'
---
# CustomerRewardCreateInput

用于创建和发放客户奖励的输入字段。

- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Input

## Input Fields

* `buyerIds`

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

  奖励适用客户的 ID 列表。<br/>最大个数限制：100

* `businessId`

  [ID!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  本次奖励发放事务的唯一标识符。<br/> 最大长度限制：64

* `rewardType`

  [RewardTypeCreate!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/reward-type-create.md)

  奖励的折扣类型。

* `benefitsDetails`

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

  奖励的折扣数值。<br/>示例：将 `rewardType` 设为 `PERCENTAGE_DISCOUNT` 且 `benefitsDetails` 为 `50`，表示五折优惠。

* `rewardUsageInstructionType`

  [RewardUsageInstructionTypeCreate!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/reward-usage-instruction-type-create.md)

  奖励使用门槛的类型。

* `rewardUsageInstructionValue`

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

  奖励使用门槛的数值。<br/> 示例：将 `rewardType` 设为 `PERCENTAGE_DISCOUNT`、`rewardUsageInstructionType` 为 `MIN_ITEM_QUANTITY` 且 `rewardUsageInstructionValue` 为 `2`，表示客户需购买至少 2 件商品才可以使用该奖励。

* `usageLimits`

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

  奖励使用次数限制。不传或传 `null` 表示无次数限制。

* `autoStackLimit`

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

  是否支持与自动折扣叠加使用。
  - `true`：支持与自动折扣叠加。 
  - `false`：不支持与自动折扣叠加。

* `codeStackLimit`

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

  是否支持与折扣码叠加使用。 
  - `true`：支持与折扣码叠加。
  - `false`：不支持与折扣码叠加。

* `rewardExpiryTime`

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

  奖励失效的日期和时间。格式：<a href="https://www.iso.org/iso-8601-date-and-time-format.html">ISO 8601</a>。不传或传 `null` 表示奖励永久有效。<br/> 示例：`2026-06-10T19:49:00.000Z`

## Argument from

* [Mutation](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/mutations/customer-reward-create.md).customerRewardCreate