Checkout Flow

await storefront.cart.update("loc_123", cartId, {
  fulfillmentMethod: "takeout",
});

await storefront.cart.updateOrderTime("loc_123", cartId, {
  pickupType: "ASAP",
});

await storefront.cart.validateAndUpdateCustomer("loc_123", cartId, {
  customerName: "Alex Johnson",
  emailAddress: "alex@example.com",
  phoneNumber: "+1234567890",
});

const choices = await storefront.checkout.getCollectionOptions(
  "loc_123",
  cartId,
  { revision: cart.revision },
);

const outcome = await storefront.checkout.submitOrder(
  "loc_123",
  cartId,
  {
    acceptedCatalogEvidence,
    acceptedDiscountEvidence,
    collectionMode: "ONLINE",
    customerConfirmationRevision,
    quoteFingerprint,
  },
  { idempotencyKey: crypto.randomUUID(), revision: cart.revision },
);

curl -X POST "https://api.craveup.com/api/v1/storefront/locations/loc_123/carts/cart_456/submissions" \
  -H "X-Cart-Token: $CART_ACCESS_TOKEN" \
  -H 'If-Match: "cart-4"' \
  -H "Idempotency-Key: order_01"

const { error, paymentIntent } = await stripe.confirmPayment({
  elements,
  confirmParams: {
    return_url: `${window.location.origin}/checkout/stripe-return`,
  },
  redirect: "if_required",
});

if (error) throw error;
if (
  !paymentIntent ||
  !["requires_capture", "succeeded"].includes(paymentIntent.status)
) {
  throw new Error("Stripe payment is not ready for capture");
}

const result = await storefront.checkout.getOrderSubmissionOutcome(
  "loc_123",
  cartId,
  outcome.attemptId,
);

switch (result.status) {
  case "PROCESSING":
  case "CUSTOMER_ACTION_REQUIRED":
    // Poll again with bounded backoff or complete the requested Stripe action.
    break;
  case "PAID":
    // Online payment and canonical settlement are complete.
    break;
  case "ACCEPTED":
    // PAY_AT_STORE only: the order exists, but native POS payment is still due.
    // Read result.verification?.state for PENDING, WARNING, ACTION_REQUIRED,
    // VERIFIED, CONCLUSIVE_FAILURE, or CANCELED counter-verification state.
    break;
  case "ACTION_REQUIRED":
    // Show the retry-safe operator/customer action without creating another order.
    break;
}