checkout
A customer's checkout.
The checkout object will be deprecated for the Information, Shipping, and Payment pages on August 13, 2024. Merchants who have customized these pages using checkout.liquid need to upgrade to Checkout Extensibility before August 13, 2024.
Learn how to build checkout extensions that extend the functionality of Shopify checkout.
You can access the checkout object on the Order status page.
Shopify Plus merchants can access the checkout object in the checkout.liquid layout.
Properties
- attributes
Additional attributes entered by the customer with the cart.
Shopify Plus merchants that have access to
checkout.liquidcan capture attributes at checkout.Returns
trueif the customer checks the email marketing subscription checkbox. Returnsfalseif not.- cart_
level_ discount_ applications array of discount_application The cart-specific discount applications for the checkout.
The customer associated with the checkout.
NoteThe
customerobject is directly accessible globally when a customer is logged in to their account.- discount_
applications array of discount_application The discount applications for the checkout.
- discounts_
amount array of discount_application The total amount of the discounts applied to the checkout in the currency's subunit.
The value is output in the customer's local (presentment) currency.
For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.
TipUse money filters to output a formatted amount.
- discounts_
savings array of discount_application The total amount of the discounts applied to the checkout in the currency's subunit, as a negative value.
The value is output in the customer's local (presentment) currency.
For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.
TipUse money filters to output a formatted amount.
The amount of the checkout price paid in gift cards.
The value is output in the customer's local (presentment) currency.
TipUse money filters to output a formatted amount.
The sum of the prices of all of the line items of the checkout in the currency's subunit, after any line item discounts. have been applied.
The value is output in the customer's local (presentment) currency.
For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.
TipUse money filters to output a formatted amount.
The name of the checkout.
This value is the same as
checkout.idwith a#prepended to it.The order created by the checkout.
Depending on the payment provider, the order might not have been created when the Thank you page is first viewed. In this case,
nilis returned.NoteThe
orderobject isn't available on the Thank you page.The ID of the order created by the checkout.
The value is the same as
order.id.Depending on the payment provider, the order might not have been created when the Order status page is first viewed. In this case,
nilis returned.The name of the order created by the checkout.
The value is the same as
order.name.Depending on the payment provider, the order might not have been created when the Order status page is first viewed. In this case,
nilis returned.An integer representation of the name of the order created by the checkout.
Depending on the payment provider, the order might not have been created when the Order status page is first viewed. In this case,
nilis returned.Returns
trueif any of the line items of the checkout require shipping. Returnsfalseif not.- shipping_
method The shipping method of the checkout.
The shipping price of the checkout in the currency's subunit.
The value is output in the customer's local (presentment) currency.
For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.
TipUse money filters to output a formatted amount.
The total tax amount of the checkout in the currency's subunit.
The value is output in the customer's local (presentment) currency.
For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.
TipUse money filters to output a formatted amount.
The total price of the checkout in the currency's subunit.
The value is output in the customer's local (presentment) currency.
For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.
TipUse money filters to output a formatted amount.
- transactionsarray of transaction
The transactions of the checkout.
Deprecated Properties
Returns
trueif the checkout has been cancelled. Returnsfalseif not.DeprecatedDeprecated because
falseis always returned.A discount applied to the checkout without being saved.
DeprecatedDeprecated because an unsaved discount doesn't exist on the Order status page.
The discounts applied to the checkout.
The financial status of the checkout.
DeprecatedDeprecated because
nilis always returned.A timestamp for the fulfullment of the checkout.
DeprecatedDeprecated because
nilis always returned.The fulfilled line items from the checkout.
DeprecatedDeprecated because the array is always empty.
The fulfillment status of the checkout.
DeprecatedDeprecated because
unfulfilledis always returned.The unavailable line items of the checkout.
DeprecatedDeprecated because the array is always empty.
Example
{
"applied_gift_cards": [],
"attributes": {},
"billing_address": {},
"buyer_accepts_marketing": false,
"cart_level_discount_applications": [],
"currency": "CAD",
"customer": {},
"discount_applications": [],
"discounts_amount": 4224,
"discounts_savings": -4224,
"email": "cornelius.potionmaker@gmail.com",
"gift_cards_amount": 0,
"id": 29944051400769,
"line_items": [],
"line_items_subtotal_price": 42249,
"name": "#29944051400769",
"note": null,
"order": null,
"order_id": null,
"order_name": "#29944051400769",
"order_number": "#29944051400769",
"requires_shipping": true,
"shipping_address": {},
"shipping_method": {},
"shipping_price": 0,
"tax_lines": [],
"tax_price": 0,
"total_price": 38025,
"transactions": []
}