@cimplify/sdk 0.102.0 → 0.104.0

package/dist/mock/library.js

@@ -2096,10 +2096,14 @@ var ERROR_SUGGESTIONS = {
   PRICE_CHANGED: "Prices changed since the quote was created. Refresh pricing, show the new total to the shopper, and require explicit confirmation before re-submitting.",
   PAYMENT_FAILED: "Payment provider rejected or failed processing. Show retry/change-method options to the shopper.",
   PAYMENT_CANCELLED: "Payment was cancelled by the shopper or provider flow. Allow a safe retry path.",
+  PAYMENT_CAPABILITY_MISMATCH: "Refresh collection capabilities for the exact tenant and presentment currency before retrying.",
+  UNSUPPORTED_CURRENCY: "Choose a supported presentment currency before loading payment methods or submitting checkout.",
   INSUFFICIENT_FUNDS: "Payment method has insufficient funds. Prompt shopper to use another method.",
   CARD_DECLINED: "Card was declined. Ask shopper to retry or switch payment method.",
   INVALID_OTP: "Authorization code is invalid. Let shopper re-enter OTP/PIN and retry.",
   OTP_EXPIRED: "Authorization code expired. Request a new OTP and re-submit authorization.",
+  OTP_CHALLENGE_EXHAUSTED: "This verification challenge has no attempts left. Continue checkout without saved details or request a fresh challenge.",
+  OTP_CHALLENGE_CONSUMED: "This verification challenge has already been used. Continue with the established session or request a fresh challenge.",
   AUTHORIZATION_FAILED: "Additional payment authorization failed. Retry authorization or change payment method.",
   PAYMENT_ACTION_NOT_COMPLETED: "Required payment action was not completed. Resume provider flow and poll for status.",
   SLOT_UNAVAILABLE: "Selected schedule slot is unavailable. Refresh available slots and ask shopper to reselect.",
@@ -2244,6 +2248,12 @@ function getQueryNum(c, key) {
   return Number.isFinite(n) ? n : void 0;
 }
 
+// src/constants.ts
+var PAYMENT_METHOD = {
+  MOBILE_MONEY: "mobile_money",
+  CARD: "card"
+};
+
 // src/mock/routes/v1.ts
 function buildV1(deps) {
   const app = new Hono2();
@@ -2260,10 +2270,22 @@ function buildV1(deps) {
     }));
   });
   app.get("/business", (c) => tryRoute(c, () => deps.business.primary()));
-  app.get("/business/by-handle/:handle", (c) => tryRoute(c, () => deps.business.byHandle(c.req.param("handle"))));
-  app.get("/business/by-domain", (c) => tryRoute(c, () => deps.business.byDomain(c.req.query("domain") ?? "")));
-  app.get("/business/settings", (c) => tryRoute(c, () => deps.business.settings(deps.defaultBusinessId)));
-  app.get("/business/locations", (c) => tryRoute(c, () => deps.business.locations(deps.defaultBusinessId)));
+  app.get(
+    "/business/by-handle/:handle",
+    (c) => tryRoute(c, () => deps.business.byHandle(c.req.param("handle")))
+  );
+  app.get(
+    "/business/by-domain",
+    (c) => tryRoute(c, () => deps.business.byDomain(c.req.query("domain") ?? ""))
+  );
+  app.get(
+    "/business/settings",
+    (c) => tryRoute(c, () => deps.business.settings(deps.defaultBusinessId))
+  );
+  app.get(
+    "/business/locations",
+    (c) => tryRoute(c, () => deps.business.locations(deps.defaultBusinessId))
+  );
   app.get("/business/hours", (c) => tryRoute(c, () => deps.business.hours(deps.defaultBusinessId)));
   app.get("/catalogue", (c) => tryRoute(c, () => deps.catalogue.snapshot(deps.defaultBusinessId)));
   app.get(
@@ -2278,57 +2300,165 @@ function buildV1(deps) {
       })
     )
   );
-  app.get("/catalogue/products/:product_id", (c) => tryRoute(c, () => deps.catalogue.getProduct(c.req.param("product_id"))));
-  app.get("/catalogue/products/:product_id/variants", (c) => tryRoute(c, () => deps.catalogue.getProductVariants(c.req.param("product_id"))));
-  app.get("/catalogue/products/:product_id/variant-axes", (c) => tryRoute(c, () => deps.catalogue.getProductVariantAxes(c.req.param("product_id"))));
+  app.get(
+    "/catalogue/products/:product_id",
+    (c) => tryRoute(c, () => deps.catalogue.getProduct(c.req.param("product_id")))
+  );
+  app.get(
+    "/catalogue/products/:product_id/variants",
+    (c) => tryRoute(c, () => deps.catalogue.getProductVariants(c.req.param("product_id")))
+  );
+  app.get(
+    "/catalogue/products/:product_id/variant-axes",
+    (c) => tryRoute(c, () => deps.catalogue.getProductVariantAxes(c.req.param("product_id")))
+  );
   app.get(
     "/catalogue/products/:product_id/variants/:variant_id",
-    (c) => tryRoute(c, () => deps.catalogue.getProductVariantById(c.req.param("product_id"), c.req.param("variant_id")))
+    (c) => tryRoute(
+      c,
+      () => deps.catalogue.getProductVariantById(c.req.param("product_id"), c.req.param("variant_id"))
+    )
   );
   app.post("/catalogue/products/:product_id/variants/find", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(
       c,
-      () => deps.catalogue.findProductVariant(c.req.param("product_id"), body.axis_selections ?? body.properties ?? {})
+      () => deps.catalogue.findProductVariant(
+        c.req.param("product_id"),
+        body.axis_selections ?? body.properties ?? {}
+      )
     );
   });
-  app.get("/catalogue/products/:product_id/add-ons", (c) => tryRoute(c, () => deps.catalogue.getProductAddOns(c.req.param("product_id"))));
-  app.get("/catalogue/categories", (c) => tryRoute(c, () => deps.catalogue.listCategories(deps.defaultBusinessId)));
-  app.get("/catalogue/categories/:category_id", (c) => tryRoute(c, () => deps.catalogue.getCategory(c.req.param("category_id"))));
-  app.get("/catalogue/categories/:category_id/products", (c) => tryRoute(c, () => deps.catalogue.getCategoryProducts(c.req.param("category_id"))));
-  app.get("/catalogue/categories/:category_id/attributes", (c) => tryRoute(c, () => deps.catalogue.getCategoryAttributes(c.req.param("category_id"))));
-  app.get("/catalogue/categories/:category_id/deals", (c) => tryRoute(c, () => deps.catalogue.getCategoryDeals(c.req.param("category_id"))));
-  app.get("/catalogue/collections", (c) => tryRoute(c, () => deps.catalogue.listCollections(deps.defaultBusinessId)));
-  app.get("/catalogue/collections/:collection_id", (c) => tryRoute(c, () => deps.catalogue.getCollection(c.req.param("collection_id"))));
-  app.get("/catalogue/collections/:collection_id/products", (c) => tryRoute(c, () => deps.catalogue.getCollectionProducts(c.req.param("collection_id"))));
-  app.get("/catalogue/collections/:collection_id/attributes", (c) => tryRoute(c, () => deps.catalogue.getCollectionAttributes(c.req.param("collection_id"))));
-  app.get("/catalogue/collections/:collection_id/deals", (c) => tryRoute(c, () => deps.catalogue.getCollectionDeals(c.req.param("collection_id"))));
-  app.get("/catalogue/bundles", (c) => tryRoute(c, () => deps.catalogue.listBundles(deps.defaultBusinessId)));
-  app.get("/catalogue/bundles/:bundle_id", (c) => tryRoute(c, () => deps.catalogue.getBundle(c.req.param("bundle_id"))));
-  app.get("/catalogue/composites", (c) => tryRoute(c, () => deps.catalogue.listComposites(deps.defaultBusinessId)));
-  app.get("/catalogue/composites/by-product/:product_id", (c) => tryRoute(c, () => deps.catalogue.getCompositeByProduct(c.req.param("product_id"))));
-  app.get("/catalogue/composites/:composite_id", (c) => tryRoute(c, () => deps.catalogue.getComposite(c.req.param("composite_id"))));
+  app.get(
+    "/catalogue/products/:product_id/add-ons",
+    (c) => tryRoute(c, () => deps.catalogue.getProductAddOns(c.req.param("product_id")))
+  );
+  app.get(
+    "/catalogue/categories",
+    (c) => tryRoute(c, () => deps.catalogue.listCategories(deps.defaultBusinessId))
+  );
+  app.get(
+    "/catalogue/categories/:category_id",
+    (c) => tryRoute(c, () => deps.catalogue.getCategory(c.req.param("category_id")))
+  );
+  app.get(
+    "/catalogue/categories/:category_id/products",
+    (c) => tryRoute(c, () => deps.catalogue.getCategoryProducts(c.req.param("category_id")))
+  );
+  app.get(
+    "/catalogue/categories/:category_id/attributes",
+    (c) => tryRoute(c, () => deps.catalogue.getCategoryAttributes(c.req.param("category_id")))
+  );
+  app.get(
+    "/catalogue/categories/:category_id/deals",
+    (c) => tryRoute(c, () => deps.catalogue.getCategoryDeals(c.req.param("category_id")))
+  );
+  app.get(
+    "/catalogue/collections",
+    (c) => tryRoute(c, () => deps.catalogue.listCollections(deps.defaultBusinessId))
+  );
+  app.get(
+    "/catalogue/collections/:collection_id",
+    (c) => tryRoute(c, () => deps.catalogue.getCollection(c.req.param("collection_id")))
+  );
+  app.get(
+    "/catalogue/collections/:collection_id/products",
+    (c) => tryRoute(c, () => deps.catalogue.getCollectionProducts(c.req.param("collection_id")))
+  );
+  app.get(
+    "/catalogue/collections/:collection_id/attributes",
+    (c) => tryRoute(c, () => deps.catalogue.getCollectionAttributes(c.req.param("collection_id")))
+  );
+  app.get(
+    "/catalogue/collections/:collection_id/deals",
+    (c) => tryRoute(c, () => deps.catalogue.getCollectionDeals(c.req.param("collection_id")))
+  );
+  app.get(
+    "/catalogue/bundles",
+    (c) => tryRoute(c, () => deps.catalogue.listBundles(deps.defaultBusinessId))
+  );
+  app.get(
+    "/catalogue/bundles/:bundle_id",
+    (c) => tryRoute(c, () => deps.catalogue.getBundle(c.req.param("bundle_id")))
+  );
+  app.get(
+    "/catalogue/composites",
+    (c) => tryRoute(c, () => deps.catalogue.listComposites(deps.defaultBusinessId))
+  );
+  app.get(
+    "/catalogue/composites/by-product/:product_id",
+    (c) => tryRoute(c, () => deps.catalogue.getCompositeByProduct(c.req.param("product_id")))
+  );
+  app.get(
+    "/catalogue/composites/:composite_id",
+    (c) => tryRoute(c, () => deps.catalogue.getComposite(c.req.param("composite_id")))
+  );
   app.post("/catalogue/composites/:composite_id/calculate-price", async (c) => {
     const body = await c.req.json().catch(() => ({}));
-    return tryRoute(c, () => deps.catalogue.calculateCompositePrice(c.req.param("composite_id"), body));
+    return tryRoute(
+      c,
+      () => deps.catalogue.calculateCompositePrice(c.req.param("composite_id"), body)
+    );
   });
-  app.get("/catalogue/taxonomies", (c) => tryRoute(c, () => deps.catalogue.listTaxonomies(deps.defaultBusinessId)));
-  app.get("/catalogue/taxonomies/search", (c) => tryRoute(c, () => deps.catalogue.searchTaxonomies(deps.defaultBusinessId, c.req.query("q") ?? "")));
-  app.get("/catalogue/taxonomies/:taxonomy_id", (c) => tryRoute(c, () => deps.catalogue.getTaxonomy(c.req.param("taxonomy_id"))));
-  app.get("/catalogue/taxonomies/:taxonomy_id/attributes", (c) => tryRoute(c, () => deps.catalogue.getTaxonomyAttributes(c.req.param("taxonomy_id"))));
-  app.get("/catalogue/taxonomies/:taxonomy_id/path", (c) => tryRoute(c, () => deps.catalogue.getTaxonomyPath(c.req.param("taxonomy_id"))));
-  app.get("/catalogue/attributes", (c) => tryRoute(c, () => deps.catalogue.listAttributes(deps.defaultBusinessId)));
-  app.get("/catalogue/properties/facets", (c) => tryRoute(c, () => deps.catalogue.listPropertyFacets(deps.defaultBusinessId)));
-  app.get("/catalogue/tags", (c) => tryRoute(c, () => deps.catalogue.listTags(deps.defaultBusinessId)));
+  app.get(
+    "/catalogue/taxonomies",
+    (c) => tryRoute(c, () => deps.catalogue.listTaxonomies(deps.defaultBusinessId))
+  );
+  app.get(
+    "/catalogue/taxonomies/search",
+    (c) => tryRoute(
+      c,
+      () => deps.catalogue.searchTaxonomies(deps.defaultBusinessId, c.req.query("q") ?? "")
+    )
+  );
+  app.get(
+    "/catalogue/taxonomies/:taxonomy_id",
+    (c) => tryRoute(c, () => deps.catalogue.getTaxonomy(c.req.param("taxonomy_id")))
+  );
+  app.get(
+    "/catalogue/taxonomies/:taxonomy_id/attributes",
+    (c) => tryRoute(c, () => deps.catalogue.getTaxonomyAttributes(c.req.param("taxonomy_id")))
+  );
+  app.get(
+    "/catalogue/taxonomies/:taxonomy_id/path",
+    (c) => tryRoute(c, () => deps.catalogue.getTaxonomyPath(c.req.param("taxonomy_id")))
+  );
+  app.get(
+    "/catalogue/attributes",
+    (c) => tryRoute(c, () => deps.catalogue.listAttributes(deps.defaultBusinessId))
+  );
+  app.get(
+    "/catalogue/properties/facets",
+    (c) => tryRoute(c, () => deps.catalogue.listPropertyFacets(deps.defaultBusinessId))
+  );
+  app.get(
+    "/catalogue/tags",
+    (c) => tryRoute(c, () => deps.catalogue.listTags(deps.defaultBusinessId))
+  );
   app.get("/catalogue/menu", (c) => tryRoute(c, () => deps.lite.getMenu(deps.defaultBusinessId)));
-  app.get("/catalogue/menu/categories/:category_id", (c) => tryRoute(c, () => deps.lite.getMenuCategory(c.req.param("category_id"))));
-  app.get("/catalogue/menu/items/:item_id", (c) => tryRoute(c, () => deps.catalogue.getProduct(c.req.param("item_id"))));
-  app.get("/catalogue/knowledge-base/articles", (c) => tryRoute(c, () => ({ articles: deps.catalogue.listKnowledgeArticles(deps.defaultBusinessId) })));
+  app.get(
+    "/catalogue/menu/categories/:category_id",
+    (c) => tryRoute(c, () => deps.lite.getMenuCategory(c.req.param("category_id")))
+  );
+  app.get(
+    "/catalogue/menu/items/:item_id",
+    (c) => tryRoute(c, () => deps.catalogue.getProduct(c.req.param("item_id")))
+  );
+  app.get(
+    "/catalogue/knowledge-base/articles",
+    (c) => tryRoute(c, () => ({ articles: deps.catalogue.listKnowledgeArticles(deps.defaultBusinessId) }))
+  );
   app.get(
     "/catalogue/knowledge-base/search",
-    (c) => tryRoute(c, () => ({ results: deps.catalogue.searchKnowledgeBase(deps.defaultBusinessId, c.req.query("q") ?? ""), query: c.req.query("q") ?? "" }))
+    (c) => tryRoute(c, () => ({
+      results: deps.catalogue.searchKnowledgeBase(deps.defaultBusinessId, c.req.query("q") ?? ""),
+      query: c.req.query("q") ?? ""
+    }))
+  );
+  app.get(
+    "/catalogue/products/:product_id/attributes",
+    (c) => tryRoute(c, () => deps.catalogue.getProductAttributes(c.req.param("product_id")))
   );
-  app.get("/catalogue/products/:product_id/attributes", (c) => tryRoute(c, () => deps.catalogue.getProductAttributes(c.req.param("product_id"))));
   app.get(
     "/catalogue/products/:product_id/available-now",
     (c) => tryRoute(c, () => {
@@ -2347,22 +2477,75 @@ function buildV1(deps) {
     "/catalogue/products/:product_id/schedules",
     (c) => tryRoute(c, () => {
       const p = deps.registry.products.get(c.req.param("product_id"));
-      return { schedules: p?.metadata?.["time_profiles"] ?? [] };
+      return {
+        schedules: p?.metadata?.["time_profiles"] ?? []
+      };
     })
   );
-  app.get("/catalogue/deals", (c) => tryRoute(c, () => deps.catalogue.listDeals(deps.defaultBusinessId)));
-  app.get("/catalogue/deals/on-sale", (c) => tryRoute(c, () => deps.catalogue.listOnSale(deps.defaultBusinessId)));
+  app.get(
+    "/catalogue/deals",
+    (c) => tryRoute(c, () => deps.catalogue.listDeals(deps.defaultBusinessId))
+  );
+  app.get(
+    "/catalogue/deals/on-sale",
+    (c) => tryRoute(c, () => deps.catalogue.listOnSale(deps.defaultBusinessId))
+  );
   app.post("/catalogue/deals/validate", async (c) => {
     const body = await c.req.json().catch(() => ({}));
-    return tryRoute(c, () => deps.catalogue.validateDiscount(body.discount_code ?? body.code ?? "", deps.defaultBusinessId));
+    return tryRoute(
+      c,
+      () => deps.catalogue.validateDiscount(
+        body.discount_code ?? body.code ?? "",
+        deps.defaultBusinessId
+      )
+    );
   });
-  app.get("/catalogue/products/:product_id/deals", (c) => tryRoute(c, () => deps.catalogue.getProductDeals(c.req.param("product_id"))));
+  app.get(
+    "/catalogue/products/:product_id/deals",
+    (c) => tryRoute(c, () => deps.catalogue.getProductDeals(c.req.param("product_id")))
+  );
   app.post("/catalogue/quotes", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => deps.catalogue.createQuote(deps.defaultBusinessId, body));
   });
-  app.get("/catalogue/quotes/:quote_id", (c) => tryRoute(c, () => deps.catalogue.getQuote(c.req.param("quote_id"))));
-  app.post("/catalogue/quotes/:quote_id/refresh", (c) => tryRoute(c, () => deps.catalogue.refreshQuote(c.req.param("quote_id"))));
+  app.get(
+    "/catalogue/quotes/:quote_id",
+    (c) => tryRoute(c, () => deps.catalogue.getQuote(c.req.param("quote_id")))
+  );
+  app.post(
+    "/catalogue/quotes/:quote_id/refresh",
+    (c) => tryRoute(c, () => deps.catalogue.refreshQuote(c.req.param("quote_id")))
+  );
+  app.get("/reviews/summary", (c) => {
+    const productId = c.req.query("product_id");
+    if (productId !== void 0 && (productId.length === 0 || productId.trim() !== productId)) {
+      return fail(c, validation("product_id must be a non-empty canonical identifier"));
+    }
+    const response = {
+      data: {
+        ratings: {
+          product_id: productId ?? null,
+          review_count: 0,
+          rating_sum: 0,
+          average_rating: null,
+          distribution: { one: 0, two: 0, three: 0, four: 0, five: 0 }
+        },
+        trust_chips: {
+          on_time_delivery_percent: null,
+          delivery_sample_size: 0,
+          average_first_response_seconds: null,
+          support_sample_size: 0
+        }
+      }
+    };
+    return c.json(response);
+  });
+  app.get("/reviews", (c) => {
+    const response = {
+      data: { items: [], next_cursor: null }
+    };
+    return c.json(response);
+  });
   app.get("/cart", (c) => tryRoute(c, () => deps.cart.toUICart(deps.cart.get(c.var.session))));
   app.delete("/cart", (c) => tryRoute(c, () => deps.cart.clear(c.var.session)));
   app.get("/cart/items", (c) => tryRoute(c, () => deps.cart.getItems(c.var.session)));
@@ -2373,9 +2556,15 @@ function buildV1(deps) {
   app.patch("/cart/items/:cart_item_id", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     if (typeof body.quantity !== "number") return fail(c, validation("quantity required"));
-    return tryRoute(c, () => deps.cart.updateQuantity(c.var.session, c.req.param("cart_item_id"), body.quantity));
+    return tryRoute(
+      c,
+      () => deps.cart.updateQuantity(c.var.session, c.req.param("cart_item_id"), body.quantity)
+    );
   });
-  app.delete("/cart/items/:cart_item_id", (c) => tryRoute(c, () => deps.cart.removeItem(c.var.session, c.req.param("cart_item_id"))));
+  app.delete(
+    "/cart/items/:cart_item_id",
+    (c) => tryRoute(c, () => deps.cart.removeItem(c.var.session, c.req.param("cart_item_id")))
+  );
   app.get("/cart/count", (c) => tryRoute(c, () => deps.cart.getCount(c.var.session)));
   app.get("/cart/total", (c) => tryRoute(c, () => deps.cart.getTotal(c.var.session)));
   app.post("/cart/destination-quote", async (c) => {
@@ -2386,10 +2575,25 @@ function buildV1(deps) {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => deps.cart.applyCoupon(c.var.session, body.coupon_code ?? ""));
   });
-  app.delete("/cart/coupons/current", (c) => tryRoute(c, () => deps.cart.removeCoupon(c.var.session)));
-  app.get("/orders", (c) => tryRoute(c, () => deps.orders.list(c.var.session, { limit: getQueryNum(c, "limit"), status: c.req.query("status") })));
+  app.delete(
+    "/cart/coupons/current",
+    (c) => tryRoute(c, () => deps.cart.removeCoupon(c.var.session))
+  );
+  app.get(
+    "/orders",
+    (c) => tryRoute(
+      c,
+      () => deps.orders.list(c.var.session, {
+        limit: getQueryNum(c, "limit"),
+        status: c.req.query("status")
+      })
+    )
+  );
   app.get("/orders/:order_id", (c) => tryRoute(c, () => deps.orders.get(c.req.param("order_id"))));
-  app.get("/orders/:order_id/payment-status", (c) => tryRoute(c, () => deps.orders.getPaymentStatus(c.req.param("order_id"))));
+  app.get(
+    "/orders/:order_id/payment-status",
+    (c) => tryRoute(c, () => deps.orders.getPaymentStatus(c.req.param("order_id")))
+  );
   app.post("/orders/:order_id/cancel", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => deps.orders.cancel(c.req.param("order_id"), body.reason));
@@ -2398,13 +2602,46 @@ function buildV1(deps) {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => deps.orders.updateCustomer(c.req.param("order_id"), body));
   });
-  app.post("/orders/:order_id/verify-payment", (c) => tryRoute(c, () => deps.orders.verifyPayment(c.req.param("order_id"))));
+  app.post(
+    "/orders/:order_id/verify-payment",
+    (c) => tryRoute(c, () => deps.orders.verifyPayment(c.req.param("order_id")))
+  );
   app.get("/subscriptions", (c) => tryRoute(c, () => deps.subscriptions.list(c.var.session)));
-  app.get("/subscriptions/:subscription_id", (c) => tryRoute(c, () => deps.subscriptions.get(c.req.param("subscription_id"))));
-  app.post("/subscriptions/:subscription_id/cancel", (c) => tryRoute(c, () => deps.subscriptions.cancel(c.req.param("subscription_id"))));
-  app.post("/subscriptions/:subscription_id/pause", (c) => tryRoute(c, () => deps.subscriptions.pause(c.req.param("subscription_id"))));
-  app.post("/subscriptions/:subscription_id/resume", (c) => tryRoute(c, () => deps.subscriptions.resume(c.req.param("subscription_id"))));
-  app.post("/subscriptions/:subscription_id/skip", (c) => tryRoute(c, () => deps.subscriptions.skipNext(c.req.param("subscription_id"))));
+  app.get(
+    "/subscriptions/:subscription_id",
+    (c) => tryRoute(c, () => deps.subscriptions.get(c.req.param("subscription_id")))
+  );
+  app.post(
+    "/subscriptions/:subscription_id/cancel",
+    (c) => tryRoute(c, () => deps.subscriptions.cancel(c.req.param("subscription_id")))
+  );
+  app.post(
+    "/subscriptions/:subscription_id/pause",
+    (c) => tryRoute(c, () => deps.subscriptions.pause(c.req.param("subscription_id")))
+  );
+  app.post(
+    "/subscriptions/:subscription_id/resume",
+    (c) => tryRoute(c, () => deps.subscriptions.resume(c.req.param("subscription_id")))
+  );
+  app.post(
+    "/subscriptions/:subscription_id/skip",
+    (c) => tryRoute(c, () => deps.subscriptions.skipNext(c.req.param("subscription_id")))
+  );
+  app.get("/payments/collection-options", (c) => {
+    const currency = c.req.query("currency")?.trim().toUpperCase();
+    if (!currency || !/^[A-Z]{3}$/.test(currency)) {
+      return fail(c, validation("currency must be a canonical three-letter code"));
+    }
+    return tryRoute(c, () => ({
+      presentment_currency: currency,
+      options: currency === "GHS" ? [
+        { method: PAYMENT_METHOD.CARD, network: null },
+        { method: PAYMENT_METHOD.MOBILE_MONEY, network: "mtn" },
+        { method: PAYMENT_METHOD.MOBILE_MONEY, network: "telecel" },
+        { method: PAYMENT_METHOD.MOBILE_MONEY, network: "airteltigo" }
+      ] : currency === "USD" ? [{ method: PAYMENT_METHOD.CARD, network: null }] : []
+    }));
+  });
   app.post("/checkout", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => deps.checkout.process(c.var.session, body));
@@ -2458,15 +2695,33 @@ function buildV1(deps) {
       return { success: true, message: "Profile updated successfully" };
     });
   });
-  app.get("/inventory/products/:product_id/stock", (c) => tryRoute(c, () => deps.inventory.productStock(c.req.param("product_id"))));
-  app.get("/inventory/variants/:variant_id/stock", (c) => tryRoute(c, () => deps.inventory.variantStock(c.req.param("variant_id"))));
+  app.get(
+    "/inventory/products/:product_id/stock",
+    (c) => tryRoute(c, () => deps.inventory.productStock(c.req.param("product_id")))
+  );
+  app.get(
+    "/inventory/variants/:variant_id/stock",
+    (c) => tryRoute(c, () => deps.inventory.variantStock(c.req.param("variant_id")))
+  );
   app.get(
     "/inventory/products/:product_id/availability",
-    (c) => tryRoute(c, () => deps.inventory.productAvailability(c.req.param("product_id"), getQueryNum(c, "quantity") ?? 1))
+    (c) => tryRoute(
+      c,
+      () => deps.inventory.productAvailability(
+        c.req.param("product_id"),
+        getQueryNum(c, "quantity") ?? 1
+      )
+    )
   );
   app.get(
     "/inventory/variants/:variant_id/availability",
-    (c) => tryRoute(c, () => deps.inventory.variantAvailability(c.req.param("variant_id"), getQueryNum(c, "quantity") ?? 1))
+    (c) => tryRoute(
+      c,
+      () => deps.inventory.variantAvailability(
+        c.req.param("variant_id"),
+        getQueryNum(c, "quantity") ?? 1
+      )
+    )
   );
   app.get(
     "/delivery/fee",
@@ -2493,35 +2748,75 @@ function buildV1(deps) {
   );
   app.post("/places/autocomplete", async (c) => {
     const body = await c.req.json().catch(() => ({}));
-    return tryRoute(c, () => deps.places.autocomplete({ query: body.input ?? body.query ?? "", country: body.country }));
+    return tryRoute(
+      c,
+      () => deps.places.autocomplete({ query: body.input ?? body.query ?? "", country: body.country })
+    );
   });
   app.post("/places/details", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => deps.places.details({ place_id: body.place_id ?? "" }));
   });
-  app.get("/scheduling/services", (c) => tryRoute(c, () => deps.scheduling.listServices(deps.defaultBusinessId)));
-  app.get("/scheduling/services/:service_id", (c) => tryRoute(c, () => deps.scheduling.getService(c.req.param("service_id"))));
-  app.get("/scheduling/slots", (c) => tryRoute(c, () => deps.scheduling.getSlots(c.req.query("service_id") ?? "", { date: c.req.query("date") })));
+  app.get(
+    "/scheduling/services",
+    (c) => tryRoute(c, () => deps.scheduling.listServices(deps.defaultBusinessId))
+  );
+  app.get(
+    "/scheduling/services/:service_id",
+    (c) => tryRoute(c, () => deps.scheduling.getService(c.req.param("service_id")))
+  );
+  app.get(
+    "/scheduling/slots",
+    (c) => tryRoute(
+      c,
+      () => deps.scheduling.getSlots(c.req.query("service_id") ?? "", { date: c.req.query("date") })
+    )
+  );
   app.get(
     "/scheduling/slots/check",
-    (c) => tryRoute(c, () => deps.scheduling.checkSlot(c.req.query("service_id") ?? "", c.req.query("start") ?? "", c.req.query("end") ?? ""))
+    (c) => tryRoute(
+      c,
+      () => deps.scheduling.checkSlot(
+        c.req.query("service_id") ?? "",
+        c.req.query("start") ?? "",
+        c.req.query("end") ?? ""
+      )
+    )
+  );
+  app.get(
+    "/scheduling/availability",
+    (c) => tryRoute(c, () => deps.scheduling.getServiceAvailability(c.req.query("service_id") ?? ""))
+  );
+  app.get(
+    "/scheduling/bookings",
+    (c) => tryRoute(c, () => deps.scheduling.getCustomerBookings(c.var.session))
   );
-  app.get("/scheduling/availability", (c) => tryRoute(c, () => deps.scheduling.getServiceAvailability(c.req.query("service_id") ?? "")));
-  app.get("/scheduling/bookings", (c) => tryRoute(c, () => deps.scheduling.getCustomerBookings(c.var.session)));
   app.post("/scheduling/bookings/reschedule", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => deps.scheduling.rescheduleBooking(body));
   });
-  app.get("/scheduling/bookings/:booking_id", (c) => tryRoute(c, () => deps.scheduling.getBooking(c.req.param("booking_id"))));
+  app.get(
+    "/scheduling/bookings/:booking_id",
+    (c) => tryRoute(c, () => deps.scheduling.getBooking(c.req.param("booking_id")))
+  );
   app.post("/scheduling/bookings/:booking_id/cancel", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => deps.scheduling.cancelBooking(c.req.param("booking_id"), body.reason));
   });
   app.get("/lite/bootstrap", (c) => tryRoute(c, () => deps.lite.bootstrap(deps.defaultBusinessId)));
-  app.get("/lite/resources/:resource_id", (c) => tryRoute(c, () => deps.lite.getResource(c.req.param("resource_id"))));
+  app.get(
+    "/lite/resources/:resource_id",
+    (c) => tryRoute(c, () => deps.lite.getResource(c.req.param("resource_id")))
+  );
   app.get("/lite/menu", (c) => tryRoute(c, () => deps.lite.getMenu(deps.defaultBusinessId)));
-  app.get("/lite/menu/categories/:category_id", (c) => tryRoute(c, () => deps.lite.getMenuCategory(c.req.param("category_id"))));
-  app.get("/fx/rate", (c) => tryRoute(c, () => deps.fx.getRate(c.req.query("from") ?? "USD", c.req.query("to") ?? "GHS")));
+  app.get(
+    "/lite/menu/categories/:category_id",
+    (c) => tryRoute(c, () => deps.lite.getMenuCategory(c.req.param("category_id")))
+  );
+  app.get(
+    "/fx/rate",
+    (c) => tryRoute(c, () => deps.fx.getRate(c.req.query("from") ?? "USD", c.req.query("to") ?? "GHS"))
+  );
   app.post("/fx/quotes", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => deps.fx.lockQuote(body));
@@ -2534,31 +2829,47 @@ function buildV1(deps) {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => deps.uploads.confirm(body));
   });
-  app.get(
-    "/store-credit/balance",
-    (c) => c.json({ data: { balance: "0.00", currency: "USD" } })
-  );
+  app.get("/store-credit/balance", (c) => c.json({ data: { balance: "0.00", currency: "USD" } }));
   app.post("/activity/session", async (c) => {
     await c.req.json().catch(() => ({}));
     return c.json({ data: { recorded: true } });
   });
   app.post("/activity/events", async (c) => {
     const body = await c.req.json().catch(() => ({}));
-    return tryRoute(c, () => deps.activity.recordEvents(deps.defaultBusinessId, body.analytics_session_id ?? c.var.session.id, body.events ?? []));
+    return tryRoute(
+      c,
+      () => deps.activity.recordEvents(
+        deps.defaultBusinessId,
+        body.analytics_session_id ?? c.var.session.id,
+        body.events ?? []
+      )
+    );
   });
-  app.get("/activity/state", (c) => tryRoute(c, () => deps.activity.getState(deps.defaultBusinessId, c.var.session.id)));
-  app.get("/activity/recommendations", (c) => tryRoute(c, () => deps.activity.getRecommendations(deps.defaultBusinessId)));
+  app.get(
+    "/activity/state",
+    (c) => tryRoute(c, () => deps.activity.getState(deps.defaultBusinessId, c.var.session.id))
+  );
+  app.get(
+    "/activity/recommendations",
+    (c) => tryRoute(c, () => deps.activity.getRecommendations(deps.defaultBusinessId))
+  );
   app.post("/activity/messages/dismiss", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => deps.activity.dismissMessage(body.code ?? body.message_id ?? ""));
   });
   app.post(
     "/support/conversation",
-    (c) => tryRoute(c, () => deps.support.openConversation(deps.defaultBusinessId, c.var.session.customer_id))
+    (c) => tryRoute(
+      c,
+      () => deps.support.openConversation(deps.defaultBusinessId, c.var.session.customer_id)
+    )
   );
   app.get(
     "/support/conversation",
-    (c) => tryRoute(c, () => deps.support.peekConversation(deps.defaultBusinessId, c.var.session.customer_id))
+    (c) => tryRoute(
+      c,
+      () => deps.support.peekConversation(deps.defaultBusinessId, c.var.session.customer_id)
+    )
   );
   app.post("/support/conversation/messages", async (c) => {
     const body = await c.req.json().catch(() => ({}));
@@ -2574,7 +2885,12 @@ function buildV1(deps) {
   });
   app.get(
     "/support/conversation/messages",
-    (c) => tryRoute(c, () => deps.support.listMessages(c.req.query("conversation_id") ?? "", { limit: getQueryNum(c, "limit") }))
+    (c) => tryRoute(
+      c,
+      () => deps.support.listMessages(c.req.query("conversation_id") ?? "", {
+        limit: getQueryNum(c, "limit")
+      })
+    )
   );
   app.post("/support/conversation/messages/:messageId/reactions", async (c) => {
     const body = await c.req.json().catch(() => ({}));
@@ -2595,7 +2911,10 @@ function buildV1(deps) {
   });
   app.get(
     "/support/conversation/ws",
-    (c) => c.json({ note: "WebSocket connection \u2014 connect via ws:// at the same path", supported: false }, 426)
+    (c) => c.json(
+      { note: "WebSocket connection \u2014 connect via ws:// at the same path", supported: false },
+      426
+    )
   );
   return app;
 }
@@ -3122,9 +3441,10 @@ function buildLink(deps) {
   app.post("/auth/request-otp", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => {
-      deps.auth.requestOtp(body.contact ?? "");
+      const challenge = deps.auth.requestOtp(body.contact ?? "");
       return {
         success: true,
+        challenge_id: challenge.otp_id,
         message: `OTP sent to ${body.contact ?? "contact"}`,
         expires_in: 300,
         is_new_account: false
@@ -3134,7 +3454,11 @@ function buildLink(deps) {
   app.post("/auth/verify-otp", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => {
-      const session = deps.auth.verifyOtp(body.contact ?? "", body.otp_code ?? "");
+      const session = deps.auth.verifyOtp(
+        body.contact ?? "",
+        body.otp_code ?? "",
+        body.challenge_id
+      );
       c.header("x-session-token", session.token);
       const customer = deps.link.ensureCustomer(session.customer_id ?? session.id, {
         email: body.contact?.includes("@") ? body.contact : void 0,
@@ -3228,10 +3552,7 @@ function buildLink(deps) {
       };
     });
   });
-  app.get(
-    "/preferences",
-    (c) => tryRoute(c, () => deps.link.getPreferences(customerId(c)))
-  );
+  app.get("/preferences", (c) => tryRoute(c, () => deps.link.getPreferences(customerId(c))));
   app.post("/preferences", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     return tryRoute(c, () => {
@@ -3708,9 +4029,16 @@ function createAuthService(opts) {
         code_hint: options.mode === "permissive" ? code : void 0
       };
     },
-    verifyOtp(contact, code) {
-      const matching = registry.otps.list((o) => o.contact === contact);
-      const otp = matching[matching.length - 1];
+    verifyOtp(contact, code, challengeId) {
+      let otp = challengeId ? registry.otps.get(challengeId) : void 0;
+      if (!challengeId) {
+        const matching = registry.otps.list((o) => o.contact === contact);
+        otp = matching[matching.length - 1];
+      }
+      if (challengeId) {
+        if (!otp) throw new Error("No OTP challenge found");
+        if (otp.contact !== contact) throw new Error("OTP challenge does not match contact");
+      }
       if (options.mode === "strict") {
         if (!otp) throw new Error("No OTP requested");
         if (otp.code !== code && code !== options.defaultOtp) throw new Error("Invalid OTP");
@@ -5038,7 +5366,7 @@ function createCartService(opts) {
 
 // src/mock/domain/checkout.ts
 function createCheckoutService(opts) {
-  const { registry, clock, ids, bus} = opts;
+  const { registry, clock, ids, bus } = opts;
   return {
     process(session, body) {
       if (!body.cart_id) throw validation("cart_id required");
@@ -5047,9 +5375,11 @@ function createCheckoutService(opts) {
       if (c.items.length === 0) throw validation("Cart is empty", { code: "CART_EMPTY" });
       const orderId = ids.order();
       const orderNumber = ids.orderNumber();
+      const paymentId = ids.payment();
       const reference = ids.payment();
       const requiresAuth = body.payment_method === "mobile_money";
       const isCard = body.payment_method === "card" || body.payment_method === "stripe";
+      const cardProvider = body.payment_method === "stripe" || body.pay_currency?.toUpperCase() === "USD" ? "stripe" : "paystack";
       const order = {
         id: orderId,
         business_id: c.business_id,
@@ -5073,6 +5403,7 @@ function createCheckoutService(opts) {
         items: c.items,
         applied_discount_ids: c.applied_discount_ids,
         applied_discount_codes: c.applied_discount_codes,
+        payment_id: paymentId,
         payment_reference: reference,
         metadata: body.metadata,
         created_at: clock.iso(),
@@ -5089,31 +5420,57 @@ function createCheckoutService(opts) {
       const result = {
         order_id: orderId,
         order_number: orderNumber,
-        payment_status: requiresAuth ? "pending" : "succeeded",
+        payment_id: paymentId,
+        payment_status: requiresAuth || isCard ? "pending" : "succeeded",
         payment_reference: reference,
         requires_authorization: requiresAuth,
         authorization_type: requiresAuth ? "otp" : void 0,
-        next_action: requiresAuth ? { type: "authorization", authorization_type: "otp", display_text: "Approve on your mobile money app" } : { type: "none" },
-        provider: body.payment_method,
+        next_action: requiresAuth ? {
+          type: "authorization",
+          authorization_type: "otp",
+          display_text: "Approve on your mobile money app"
+        } : { type: "none" },
+        provider: isCard ? cardProvider : body.payment_method,
         bill_token: billToken
       };
       if (isCard) {
-        result.next_action = { type: "redirect", authorization_url: `https://mock.cimplify.io/pay/${reference}` };
-        result.authorization_url = `https://mock.cimplify.io/pay/${reference}`;
-        result.client_secret = `pi_${orderId.slice(-12)}_secret_${Math.random().toString(36).slice(2, 18)}`;
         const proc = globalThis.process;
-        result.public_key = proc?.env?.NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY ?? "pk_test_mock_publishable_key";
+        result.client_secret = cardProvider === "stripe" ? `pi_${orderId.slice(-12)}_secret_${Math.random().toString(36).slice(2, 18)}` : `access_${reference}`;
+        result.public_key = cardProvider === "stripe" ? proc?.env?.NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY ?? "pk_test_mock_stripe" : proc?.env?.NEXT_PUBLIC_PAYSTACK_PUBLIC_KEY ?? "pk_test_mock_paystack";
+        result.next_action = {
+          type: "card_popup",
+          provider: cardProvider,
+          client_secret: result.client_secret,
+          public_key: result.public_key
+        };
       }
       return result;
     },
     authorize(body) {
-      const order = registry.orders.get(body.order_id);
-      if (!order) throw notFound(`Order ${body.order_id} not found`);
-      const updated = { ...order, payment_state: "paid", status: "confirmed", updated_at: clock.iso() };
+      if (!body.payment_id?.trim()) throw validation("payment_id required");
+      if (!body.authorization) throw validation("authorization required");
+      const order = registry.orders.list(
+        (candidate) => candidate.payment_id === body.payment_id
+      )[0];
+      if (!order) throw notFound(`Payment ${body.payment_id} not found`);
+      const updated = {
+        ...order,
+        payment_state: "paid",
+        status: "confirmed",
+        updated_at: clock.iso()
+      };
       registry.orders.put(order.id, updated);
       bus.emit("order.payment.captured", { order_id: order.id }, order.business_id);
       bus.emit("order.confirmed", { order_id: order.id }, order.business_id);
-      return { status: "succeeded", order_id: order.id };
+      return {
+        order_id: order.id,
+        order_number: order.user_friendly_id,
+        payment_id: body.payment_id,
+        payment_reference: order.payment_reference,
+        payment_status: "succeeded",
+        requires_authorization: false,
+        next_action: { type: "none" }
+      };
     }
   };
 }
@@ -5496,6 +5853,7 @@ function createDeliveryService() {
             rate_id: "dlvrt_mock_standard",
             name: "Standard",
             fee: standardFree ? money(0) : money(15),
+            fee_status: "priced",
             currency: "GHS",
             free_delivery_applied: standardFree,
             free_over_amount: money(200),
@@ -5509,6 +5867,7 @@ function createDeliveryService() {
             name: "Express",
             description: "Delivered within the hour",
             fee: money(25),
+            fee_status: "priced",
             currency: "GHS",
             free_delivery_applied: false,
             eta_min_minutes: 30,