---
title: "checkoutDiscountCodeApply"
description: "Applies a discount to an existing checkout using a discount code."
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/storefront-api/checkouts/mutations/checkout-discount-code-apply'
  md: 'https://developer.shopline.com/docs/storefront-api/checkouts/mutations/checkout-discount-code-apply.md'
---
# checkoutDiscountCodeApply

Applies a discount to an existing checkout using a discount code.

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

## Type Signature

`CheckoutDiscountCodeApplyPayload`

## Required Permissions

* `unauthenticated_write_checkouts_info`

An access token is required to call this API. Refer to [Authorization](https://developer.shopline.com/docs/apps/api-instructions-for-use/storefront-api/overview.md) for more information about how to obtain the token.

## Arguments

* `checkoutId`

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

  The ID of the checkout.

* `discountCode`

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

  Discount code to apply to checkout

## Returns

* `checkout`

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

  The updated checkout object.

* `checkoutUserErrors`

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

  error message

## Code Example

```graphql
mutation checkoutDiscountCodeApply($checkoutId: String! $discountCode: String! ) {
	checkoutDiscountCodeApply(checkoutId: $checkoutId, discountCode: $discountCode ) 
		 {
			# CheckoutDiscountCodeApplyPayload fields
		}
		
	}

```

## Variables

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

## Error Handling

For detailed information about common codes, see [Status and error codes](https://developer.shopline.com/docs/apps/api-instructions-for-use/storefront-api/overview.md#status-and-error-codes).