---
title: "Checkout"
description: "结账单相关信息。"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/objects/checkout'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/objects/checkout.md'
---
# Checkout

结账单相关信息。

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

## Fields

* `webUrl`

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

  结账页面的 URL。
  :::danger{title="废弃"}
  该字段自 `v20251201` 起已废弃，使用 `checkoutUrl` 作为替代。
  :::
  

* `email`

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

  关联的邮箱地址。

* `id`

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

  结账单的全局唯一标识符 ID。

* `appliedGiftCards`

  [[AppliedGiftCard]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/applied-gift-card.md)

  应用于结账单的礼品卡列表。

* `buyerIdentity`

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

  关联的客户身份信息。

* `completedAt`

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

  结账单完结的日期和时间。格式：[ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。  
  例子：`2024-08-31T02:20:26+08:00`

* `createdAt`

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

  结账单创建的日期和时间。格式：[ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。  
  例子：`2024-08-31T02:20:26+08:00`

* `currencyCode`

  [CurrencyCode](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/enums/currency-code.md)

  结账单结算使用的货币代码。

* `lineItemsSubtotalPrice`

  [Money](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/money.md)

  所有商品行价格总和小计（未扣除折扣且不包含运费、关税和税费）。

* `note`

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

  结账单备注。

* `paymentDue`

  [Money](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/money.md)

  剩余需支付的金额（包含运费、关税和税费，并扣除折扣与礼品卡抵扣金额）。

* `customAttributes`

  [[Attribute]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/attribute.md)

  添加到结账单的自定义属性列表，包含额外业务信息。

* `requiresShipping`

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

  结账单是否包含需要运输的商品。
    - `true`：包含
    - `false`：不包含

* `shippingAddress`

  [ShippingAddress](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/shipping-address.md)

  结账单的商品收货地址。

* `shippingDiscountAllocations`

  [[DiscountAllocation]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/discount-allocation.md)

  分摊至运费的折扣明细列表。

* `shippingLine`

  [ShippingRate](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/shipping-rate.md)

  运费行信息，包含客户选择的运送方案和运费明细。

* `subtotalPrice`

  [Money](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/money.md)

  结账单中所有商品价格小计（未包含运费、关税和税费但已扣减折扣）。

* `taxesIncluded`

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

  商品行价格和运费行价格是否含税。
    - `true`：含税
    - `false`：不含税

* `totalPrice`

  [Money](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/money.md)

  结账单所有商品价格合计（包含运费、关税和税费且已扣减折扣）。

* `totalTax`

  [Money](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/money.md)

  商品行及运费行产生的税费总额。

* `updatedAt`

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

  结账单最近一次更新的日期和时间。格式：[ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。  
  例子：`2024-08-31T02:20:26+08:00`

* `discountApplications`

  [[DiscountApplication]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/discount-application.md)

  已应用于结账单的折扣列表。

* `lineItems`

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

  商品行列表。

* `availableShippingRates`

  [AvailableShippingRates](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/available-shipping-rates.md)

  可选的运费方案集。

* `checkoutUrl`

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

  结账页 URL。

## Field from

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

* [CheckoutLineItemsUpdatePayload](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/objects/checkout-line-items-update-payload.md).checkout

* [CheckoutLineItemsReplacePayload](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/objects/checkout-line-items-replace-payload.md).checkout

* [CheckoutLineItemsAddPayload](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/objects/checkout-line-items-add-payload.md).checkout

* [CheckoutDiscountCodeRemovePayload](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/checkouts/objects/checkout-discount-code-remove-payload.md).checkout