---
title: "customRulesPointGrant"
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/mutations/custom-rules-point-grant'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/mutations/custom-rules-point-grant.md'
---
# customRulesPointGrant

为会员执行自定义积分发放。当商家在会员系统内配置了自定义积分发放规则，并设置该规则必须客户完成行为才发放积分时，调用本接口为完成该行为的客户发放规则内配置的积分。

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

## Arguments

* `customerAccessToken`

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

  客户访问令牌。

* `earnId`

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

  积分获取规则 ID。在会员系统内完成自定义规则配置后，该 ID 展示在规则详情页面中。

## Returns

* `memberUserErrors`

  [MemberUserError!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/member-user-error.md)

  自定义规则积分发放错误信息。

## Examples

### 自定义规则积分发放

当商家在会员系统内配置了自定义积分发放规则，并设置该规则必须客户完成行为才发放积分时，为客户发放规则内配置的积分数。

**Request:**

```json
mutation {
  customRulesPointGrant (
    customerAccessToken: "#A01#SID0000143BNMX5+Ex9bIEkY6dzAwHwTOGkwWRBIF2/7FTbx4GTnvY+f42T7Z5dRvV/y3GSP1IqLe3Q5+gwe76CCmcsJK452Bv1/PuU1tOFvuzMKO6vyXhbhvOBgQI4wLVeC5zpgsOvWKVtp8LPrTzfR+A/4JhVVqH2k14OH5Z23TCvd0YMtCpvqR+zGLJKxtNwKcUEWGCDA",
    earnId: "BAC7308764297261753346"
   ) {
    memberUserErrors {
      code
    }
    
  }
}
```

**Response:**

```json
{
  "data": {
    "data": {
      "customRulesPointGrant": {
        "memberUserErrors": {
          "code": "success"
        }
      }
    }
  }
}
```

## Error Handling

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