# Checkout Messages

Checkout sends Messages to provide feedback about events.

To receive Messages from Checkout, pass the `onInfo`, `onWarn`, or `onError` [message handlers](/checkout/browser-sdk.md#oninfo-onwarn-and-onerror) with the `checkoutFlow`, `paymentFlow`, or `expressPayment.init` methods when initializing Checkout.

## Message structure

Checkout Messages are JSON objects with the following common fields. In addition to these common fields, some Messages also contain a `payload` field with data about the event.

[type definition](/search.md?urn=ctp:checkout:type:Message).

```json title="Example Message of severiry level 'error' with payload"
{
  "severity": "error",
  "code": "project_deactivated",
  "message": "Project {projectKey} is deactivated.",
  "payload": {
    "project": {
      "key": "{projectKey}"
    }
  },
  "correlationId": "spa/commercetools-checkout/1729263187262/565301612087128"
}
```

```json title="Example Message of severiry level 'info' with payload"
{
  "severity": "info",
  "code": "order_created",
  "message": "Order {orderId} created.",
  "payload": {
    "order": {
      "id": "{orderId}"
    }
  },
  "correlationId": "spa/commercetools-checkout/1729263187262/565301612087128"
}
```

## Message types

### Application Messages

#### Application Deactivated

[type definition](/search.md?urn=ctp:checkout:type:ApplicationDeactivated).

### Cart Messages

#### Cart Empty

[type definition](/search.md?urn=ctp:checkout:type:CartEmpty).

#### Cart Emptied During Checkout

[type definition](/search.md?urn=ctp:checkout:type:CartEmptiedDuringCheckout).

#### Cart Not Found

[type definition](/search.md?urn=ctp:checkout:type:CartNotFound).

#### Non Orderable Cart Error

[type definition](/search.md?urn=ctp:checkout:type:NonOrderableCartError).

#### Cart With Existing Payment

[type definition](/search.md?urn=ctp:checkout:type:CartWithExistingPayment).

#### Unsupported Country

[type definition](/search.md?urn=ctp:checkout:type:UnsupportedCountry).

#### Shipping Address Missing Error

[type definition](/search.md?urn=ctp:checkout:type:ShippingAddressMissingError).

#### Shipping Address Does Not Match Cart

[type definition](/search.md?urn=ctp:checkout:type:ShippingMethodDoesNotMatchCart).

#### Set Shipping Address Error

[type definition](/search.md?urn=ctp:checkout:type:SetShippingAddressError).

### Checkout Messages

#### Checkout Loaded

[type definition](/search.md?urn=ctp:checkout:type:CheckoutLoaded).

#### Checkout Started

[type definition](/search.md?urn=ctp:checkout:type:CheckoutStarted).

#### Checkout Cancelled

[type definition](/search.md?urn=ctp:checkout:type:CheckoutCancelled).

#### Checkout Completed

[type definition](/search.md?urn=ctp:checkout:type:CheckoutCompleted).

### Express Payments Messages

#### Express Payment Started

[type definition](/search.md?urn=ctp:checkout:type:ExpressPaymentStarted).

#### Express Payment Cancelled

[type definition](/search.md?urn=ctp:checkout:type:ExpressPaymentCancelled).

#### Express Payment Completed

[type definition](/search.md?urn=ctp:checkout:type:ExpressPaymentCompleted).

#### Express Payment Failed

[type definition](/search.md?urn=ctp:checkout:type:ExpressPaymentFailed).

#### Express Container Not Found

[type definition](/search.md?urn=ctp:checkout:type:ExpressContainerNotFound).

#### No Express Payment Integrations

[type definition](/search.md?urn=ctp:checkout:type:NoExpressPaymentIntegrations).

#### Express Multiple Containers Found

[type definition](/search.md?urn=ctp:checkout:type:ExpressMultipleContainersFound).

#### Express Payment Interrupted

[type definition](/search.md?urn=ctp:checkout:type:ExpressPaymentInterrupted).

#### Express Payment Integration Not Available

[type definition](/search.md?urn=ctp:checkout:type:ExpressPaymentIntegrationNotAvailable).

### Configuration Messages

#### Init Error

[type definition](/search.md?urn=ctp:checkout:type:InitError).

#### Init Timeout

[type definition](/search.md?urn=ctp:checkout:type:InitTimeout).

#### Invalid Locale

[type definition](/search.md?urn=ctp:checkout:type:InvalidLocale).

#### Invalid Mode

[type definition](/search.md?urn=ctp:checkout:type:InvalidMode).

#### Expired Session

[type definition](/search.md?urn=ctp:checkout:type:ExpiredSession).

#### Failed To Refresh Session

[type definition](/search.md?urn=ctp:checkout:type:FailedToRefreshSession).

#### Bad Input Data

[type definition](/search.md?urn=ctp:checkout:type:BadInputData).

#### No Shipping Methods

[type definition](/search.md?urn=ctp:checkout:type:NoShippingMethods).

#### Shipping Method Selected

[type definition](/search.md?urn=ctp:checkout:type:ShippingMethodSelected).

#### Shipping Method Selection Confirmation

[type definition](/search.md?urn=ctp:checkout:type:ShippingMethodSelectionConfirmation).

#### Unavailable Locale

[type definition](/search.md?urn=ctp:checkout:type:UnavailableLocale).

#### Deprecated Fields

[type definition](/search.md?urn=ctp:checkout:type:DeprecatedFields).

#### Updated Fields

[type definition](/search.md?urn=ctp:checkout:type:UpdatedFields).

### Discount Code Messages

#### Add Discount Code Error

[type definition](/search.md?urn=ctp:checkout:type:AddDiscountCodeError).

#### Remove Discount Code Error

[type definition](/search.md?urn=ctp:checkout:type:RemoveDiscountCodeError).

#### Discount Not Applicable

[type definition](/search.md?urn=ctp:checkout:type:DiscountCodeNotApplicable).

#### Not Applicable Discount Code Removed

[type definition](/search.md?urn=ctp:checkout:type:NotApplicableDiscountCodeRemoved).

### Gift card Messages

#### Gift Card Balance Started

[type definition](/search.md?urn=ctp:checkout:type:GiftCardBalanceStarted).

#### Gift Card Balance Success

[type definition](/search.md?urn=ctp:checkout:type:GiftCardBalanceSuccess).

#### Gift Card Balance Error

[type definition](/search.md?urn=ctp:checkout:type:GiftCardBalanceError).

#### Gift Card Balance Removed

[type definition](/search.md?urn=ctp:checkout:type:GiftCardBalanceRemoved).

#### Gift Card Redeem Started

[type definition](/search.md?urn=ctp:checkout:type:GiftCardRedeemStarted).

#### Gift Card Redeem Success

[type definition](/search.md?urn=ctp:checkout:type:GiftCardRedeemSuccess).

#### Gift Card Redeem Error

[type definition](/search.md?urn=ctp:checkout:type:GiftCardRedeemError).

### Order Messages

#### Order Created

[type definition](/search.md?urn=ctp:checkout:type:OrderCreated).

#### Order Creation Error

[type definition](/search.md?urn=ctp:checkout:type:OrderCreationError).

#### Order Verification Started

[type definition](/search.md?urn=ctp:checkout:type:OrderVerificationStarted).

#### Order Verification Timeout

[type definition](/search.md?urn=ctp:checkout:type:OrderVerificationTimeout).

#### Order Verification Retry Error

[type definition](/search.md?urn=ctp:checkout:type:OrderVerificationRetryError).

### Payments Messages

#### Connector Error

[type definition](/search.md?urn=ctp:checkout:type:ConnectorError).

#### Payment Integrations Received

[type definition](/search.md?urn=ctp:checkout:type:PaymentIntegrationsReceived).

#### Multiple Payment Integration Containers

[type definition](/search.md?urn=ctp:checkout:type:MultipleVendorButtonContainers).

#### Payment Integration Not Available

[type definition](/search.md?urn=ctp:checkout:type:PaymentIntegrationNotAvailable).

#### No Payment Integrations

[type definition](/search.md?urn=ctp:checkout:type:NoPaymentIntegrations).

#### Payment Integration Loading

[type definition](/search.md?urn=ctp:checkout:type:PaymentIntegrationLoading).

#### Payment Integration Loading Error

[type definition](/search.md?urn=ctp:checkout:type:PaymentIntegrationLoadingError).

#### Payment Integration Loaded

[type definition](/search.md?urn=ctp:checkout:type:PaymentIntegrationLoaded).

#### Payment Integration Selected

[type definition](/search.md?urn=ctp:checkout:type:PaymentIntegrationSelected).

#### Payment Integration Selection Confirmation

[type definition](/search.md?urn=ctp:checkout:type:PaymentIntegrationSelectionConfirmation).

#### Payment Integration Selection Confirmation Failed

[type definition](/search.md?urn=ctp:checkout:type:PaymentIntegrationSelectionConfirmationFailed).

#### Error Loading All Payment Integrations

[type definition](/search.md?urn=ctp:checkout:type:ErrorLoadingAllPaymentIntegrations).

#### Payment Started

[type definition](/search.md?urn=ctp:checkout:type:PaymentStarted).

#### Payment Failed

[type definition](/search.md?urn=ctp:checkout:type:PaymentFailed).

#### Payment Cancelled

[type definition](/search.md?urn=ctp:checkout:type:PaymentCancelled).

#### Payment Validation Failed

[type definition](/search.md?urn=ctp:checkout:type:PaymentValidationFailed).

#### Payment Validation Passed

[type definition](/search.md?urn=ctp:checkout:type:PaymentValidationPassed).

#### Payment Validation Started

[type definition](/search.md?urn=ctp:checkout:type:PaymentValidationStarted).

#### External Terms And Conditions Pending

[type definition](/search.md?urn=ctp:checkout:type:ExternalTermsAndConditionsPending).

### Project Messages

#### Project Is Deactivated

[type definition](/search.md?urn=ctp:checkout:type:ProjectIsDeactivated).

## Related pages

- [Area overview page with navigation](/checkout.md)
- [Previous page: Events](/checkout/checkout-events.md)
- [Search documentation and API specs](/search.md)