Returns the `buyerJourney` details on buyer progression in checkout.
Returns the `buyerJourney` details on buyer progression in checkout.
export function useBuyerJourney< Target extends RenderExtensionTarget = RenderExtensionTarget, >(): BuyerJourney { const api = useApi<Target>(); if ('buyerJourney' in api) { return api.buyerJourney; } throw new ExtensionHasNoMethodError( 'applyAttributeChange', api.extension.target, ); }
Provides details on the buyer's progression through the checkout.
Installs a function for intercepting and preventing progress on checkout. This returns a promise that resolves to a teardown function. Calling the teardown function will remove the interceptor. To block checkout progress, you must set the [block_progress](/docs/api/checkout-ui-extensions/configuration#block-progress) capability in your extension's configuration.
This subscribable value will be true if the buyer completed submitting their order. For example, when viewing the **Order status** page after submitting payment, the buyer will have completed their order.
A function for intercepting and preventing navigation on checkout. You can block navigation by returning an object with `{behavior: 'block', reason: InvalidResultReason.InvalidExtensionState, errors?: ValidationErrors[]}`. If you do, then you're expected to also update some part of your UI to reflect the reason why navigation was blocked, either by targeting checkout UI fields, passing errors to the page level or rendering the errors in your extension.
( interceptorProps: InterceptorProps, ) => InterceptorRequest | Promise<InterceptorRequest>
Whether the interceptor has the capability to block a buyer's progress through checkout. This ability might be granted by a merchant in differing checkout contexts.
InterceptorRequestAllow | InterceptorRequestBlock
Indicates that the interceptor will allow the buyer's journey to continue.
This callback is called when all interceptors finish. We recommend setting errors or reasons for blocking at this stage, so that all the errors in the UI show up at once.
InterceptorResultAllow | InterceptorResultBlock
Indicates that the buyer was allowed to progress through checkout.
Indicates that some part of the checkout UI intercepted and prevented the buyer’s progress. The buyer typically needs to take some action to resolve this issue and to move on to the next step.
Indicates that the interceptor will block the buyer's journey from continuing.
The reason for blocking the interceptor request. This value isn't presented to the buyer, so it doesn't need to be localized. The value is used only for Shopify’s own internal debugging and metrics.
Used to pass errors to the checkout UI, outside your extension's UI boundaries.
This callback is called when all interceptors finish. We recommend setting errors or reasons for blocking at this stage, so that all the errors in the UI show up at once.
Error message to be displayed to the buyer.
The checkout UI field that the error is associated with. Example: `$.cart.deliveryGroups[0].deliveryAddress.countryCode` See the [supported targets](/docs/api/functions/reference/cart-checkout-validation/graphql#supported-targets) for more information.