checkout_write
Boolean
True when landed costs (duties and import fees) are added to this method’s price, overriding the experience-level setting. Omitted when the method does not override it.
Dynamic methods only. The carrier services this method quotes live rates from. This is the answer to ‘which carrier do my checkout rates come from’ — the rates are fetched by Redo from these carriers. Empty means no carrier service has been pinned, so the method draws on whatever the account has available.
Redo coverage bundled into this shipping method. Omitted when no coverage is bundled.
String!
required
Shopper-facing description shown next to the method at checkout. Like
name, it may contain customer-name template variables; see fallbackDescription.Dynamic methods only. Carriers never considered for this method. Omitted when no carrier is excluded.
String
Shopper-facing description used in place of
description under the same condition as fallbackName: description contains customer-name template variables and the shopper’s name is not available. Omitted when the merchant has not set one.String
Shopper-facing name used in place of
name when name contains customer-name template variables and the shopper’s name is not available at quote time. Ignored when name has no variables. Omitted when the merchant has not set one, in which case an unpersonalized name renders with the variables emptied out.Int
Dynamic methods only. Days Redo assumes an order takes to ship when it estimates delivery dates for this method, overriding the experience’s
fulfillmentDelayDaysOverride. Omitted when the method uses the experience’s value, or the store-level value if the experience sets none. A whole number of days, zero or more.ID!
required
Shipping method ID.
Dynamic methods only. Markup applied to every live carrier rate on this method, on top of which per-carrier-service markups still apply. Omitted when no method-level markup is set.
String!
required
Shopper-facing name of the shipping method as it appears at checkout. May contain customer-name template variables — ‘{customer_name}’, ‘{customer_name:first}’, ‘{customer_name:last}’ — which are substituted per shopper. Preserve them when rewriting this field, or personalization is silently dropped; see
fallbackName for what is shown when the shopper’s name is unknown.[String!]
Tags applied to the order when this method is bought. Omitted when the merchant has configured no tags.
Dynamic methods only. Hard clamp applied after markup and rounding. Omitted when the price is not clamped.
Bounds the method’s sold price must stay within. Omitted when the merchant has set no price or margin constraints.
String!
required
Human-readable price: ‘FREE’, a formatted amount like ‘$5.99’, ‘DYNAMIC’ for carrier-calculated rates, ‘CUSTOM’ for merchant-scripted rates, or ’-’ when no price is configured. Reflects only the first entry in
rates, so on a method with several it can read ‘FREE’ or show the cheapest tier while most carts are charged something else — read rates for the full picture.Dynamic methods only. Which of the eligible live carrier rates is shown to the shopper. Omitted when the merchant has not chosen a preset.
Fixed methods only. Every configured price, in order. More than one entry means the price varies by cart weight or cart value; a single entry with empty
conditions is a flat price.Dynamic methods only. How the marked-up price is rounded before it is shown. Omitted when prices are shown unrounded.
String
Identifier the storefront platform uses for this shipping option at checkout. Omitted when the merchant has not set one.
Dynamic methods only. When set, the cheapest carrier service delivering within this service level’s window is used. Omitted when the method is not bucketed by service level.
Shipping discounts applied to this method, in order. READ ONLY: these are configured by Redo, not by the merchant, and they sync to a live storefront-platform function, so writing them here would put the stored rules and the deployed function out of step. Creating or updating a shipping method carries them over untouched. Omitted when the method has no discount rules.
required
How the price is produced: FIXED is a merchant-set price served by Redo with no carrier involved, DYNAMIC is quoted live from the carriers listed in
carrierServices, CUSTOM is produced by a merchant-authored script.