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.liquid
can capture attributes at checkout.Returns
true
if the customer checks the email marketing subscription checkbox. Returnsfalse
if not.- cart_
level_ discount_ applications array of discount_application The cart-specific discount applications for the checkout.
The customer associated with the checkout.
NoteThe
customer
object 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.id
with 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,
nil
is returned.NoteThe
order
object 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,
nil
is 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,
nil
is 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,
nil
is returned.Returns
true
if any of the line items of the checkout require shipping. Returnsfalse
if 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
true
if the checkout has been cancelled. Returnsfalse
if not.DeprecatedDeprecated because
false
is 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
nil
is always returned.A timestamp for the fulfullment of the checkout.
DeprecatedDeprecated because
nil
is always returned.The fulfilled line items from the checkout.
DeprecatedDeprecated because the array is always empty.
The fulfillment status of the checkout.
DeprecatedDeprecated because
unfulfilled
is always returned.The unavailable line items of the checkout.
DeprecatedDeprecated because the array is always empty.
{
"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": []
}