---
title: "checkoutCustomerAssociate"
description: "关联用户到结账中"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/mutations/checkout-customer-associate'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/mutations/checkout-customer-associate.md'
---
# checkoutCustomerAssociate

关联用户到结账中

- **Required Scopes:** `unauthenticated_write_checkouts_info`
- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Mutation

## Type Signature

`CheckoutCustomerAssociatePayload`

## Required Permissions

* `unauthenticated_write_checkouts_info`

接口访问需要令牌，具体如何获取令牌请参考：[身份认证](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/storefront-api/overview.md)

## Arguments

* `checkoutId`

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

  结账ID

* `customerAccessToken`

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

  要关联的客户访问token

## Returns

* `checkout`

  [Checkout](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/objects/checkout.md)

  更新的结账对象

* `checkoutUserErrors`

  [[CheckoutUserError!]!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/objects/checkout-user-error.md)

  错误信息列表

* `customer`

  [CheckoutCustomer](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/objects/checkout-customer.md)

  客户信息

## Code Example

```graphql
mutation checkoutCustomerAssociate($checkoutId: String! $customerAccessToken: String! ) {
	checkoutCustomerAssociate(checkoutId: $checkoutId, customerAccessToken: $customerAccessToken ) 
		 {
			# CheckoutCustomerAssociatePayload fields
		}
		
	}

```

## Variables

```json
{
  "checkoutId": {},
  "customerAccessToken": {}
}
```

## Error Handling

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