@cimplify/sdk 0.101.1 → 0.103.0

package/dist/{product-DwKdC_to.d.mts → payment-H5LoIvXU.d.mts}

@@ -27,6 +27,7 @@ declare const ErrorCode: {
     readonly TIMEOUT: "TIMEOUT";
     readonly UNAUTHORIZED: "UNAUTHORIZED";
     readonly FORBIDDEN: "FORBIDDEN";
+    readonly TENANT_CONTEXT_CHANGED: "TENANT_CONTEXT_CHANGED";
     readonly NOT_FOUND: "NOT_FOUND";
     readonly VALIDATION_ERROR: "VALIDATION_ERROR";
     readonly CART_EMPTY: "CART_EMPTY";
@@ -48,6 +49,8 @@ declare const ErrorCode: {
     readonly PRICE_CHANGED: "PRICE_CHANGED";
     readonly PAYMENT_FAILED: "PAYMENT_FAILED";
     readonly PAYMENT_CANCELLED: "PAYMENT_CANCELLED";
+    readonly PAYMENT_CAPABILITY_MISMATCH: "PAYMENT_CAPABILITY_MISMATCH";
+    readonly UNSUPPORTED_CURRENCY: "UNSUPPORTED_CURRENCY";
     readonly INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS";
     readonly CARD_DECLINED: "CARD_DECLINED";
     readonly INVALID_OTP: "INVALID_OTP";
@@ -955,6 +958,11 @@ interface components {
              *     labels it "included" rather than summing it onto the total.
              */
             tax_inclusive: boolean;
+            /**
+             * @description Reviewed policy for presenting tax in customer-facing prices. This is
+             *     independent from whether the pricing arithmetic is tax-inclusive.
+             */
+            price_display_mode?: components["schemas"]["TaxPriceDisplayMode"];
             /**
              * @description Deposit due now when the cart has deposit-eligible service items, letting
              *     checkout offer "pay deposit now, balance later". `0` when none applies.
@@ -1092,13 +1100,14 @@ interface components {
             order_id: string;
             order_number: string;
             bill_token?: string | null;
+            payment_id?: string | null;
             payment_reference?: string | null;
             payment_status: string;
             requires_authorization: boolean;
             authorization_type?: null | components["schemas"]["AuthorizationType"];
             authorization_url?: string | null;
             display_text?: string | null;
-            provider?: string | null;
+            provider?: null | components["schemas"]["ProviderType"];
             client_secret?: string | null;
             public_key?: string | null;
             next_action: components["schemas"]["NextAction"];
@@ -1122,6 +1131,8 @@ interface components {
             tax_inclusive: boolean;
             /** @description Effective tax rate in percentage points (for example, `8.25`). */
             tax_rate?: string | null;
+            /** @description Reviewed consumer-facing price presentation policy for this quote. */
+            price_display_mode: components["schemas"]["TaxPriceDisplayMode"];
             delivery_fee_details?: null | components["schemas"]["DeliveryFeeDetails"];
             address_info: components["schemas"]["AddressInfo"];
         };
@@ -1159,8 +1170,8 @@ interface components {
             fx_quote_id?: string | null;
             /**
              * @description Pay only the required deposit now (balance collected later) instead of the
-             *     full total. Only honored when the order is deposit-eligible and paying in
-             *     the order's native currency.
+             *     full total. Honored only for the first collection on a deposit-eligible
+             *     order; later attempts collect the authoritative remaining balance.
              */
             pay_deposit?: boolean;
             /**
@@ -1191,6 +1202,8 @@ interface components {
             tax_inclusive: boolean;
             /** @description Effective tax rate in percentage points (for example, `8.25`). */
             tax_rate?: string | null;
+            /** @description Reviewed consumer-facing price presentation policy for these totals. */
+            price_display_mode: components["schemas"]["TaxPriceDisplayMode"];
         };
         CheckoutSessionCartItem: {
             product_id: string;
@@ -2740,6 +2753,37 @@ interface components {
             has_more: boolean;
             next_cursor?: string | null;
         };
+        /**
+         * @description Typed customer input for one provider-requested authorization step.
+         *
+         *     Provider references are deliberately absent. The payment service resolves
+         *     the authoritative reference and provider from the tenant-scoped payment
+         *     row before making provider I/O.
+         */
+        PaymentAuthorizationSubmission: {
+            value: string;
+            /** @enum {string} */
+            type: "pin";
+        } | {
+            value: string;
+            /** @enum {string} */
+            type: "otp";
+        } | {
+            value: string;
+            /** @enum {string} */
+            type: "phone";
+        } | {
+            value: string;
+            /** @enum {string} */
+            type: "birthday";
+        } | {
+            address: string;
+            city: string;
+            state: string;
+            zip_code: string;
+            /** @enum {string} */
+            type: "address";
+        };
         PaymentInfoDTO: {
             state: components["schemas"]["PaymentState"];
             computed_status?: string | null;
@@ -3266,6 +3310,8 @@ interface components {
          * @enum {string}
          */
         ProviderResolutionSource: "zone" | "hint" | "fallback" | "rate" | "best_price";
+        /** @enum {string} */
+        ProviderType: "stripe" | "paystack" | "cellulant" | "mtn_momo" | "offline";
         PublicCheckoutSessionResponse: {
             id: string;
             status: string;
@@ -3799,10 +3845,37 @@ interface components {
             balance: string;
             currency: string;
         };
+        /**
+         * @description One method/network combination accepted by the storefront checkout input.
+         * @enum {string}
+         */
+        StorefrontCollectionMethod: "card" | "mobile_money";
+        StorefrontCollectionMethodOption: {
+            method: components["schemas"]["StorefrontCollectionMethod"];
+            /** @description Optional network selector required by network-specific methods. */
+            network?: string | null;
+        };
+        /**
+         * @description Storefront-safe projection of active merchant collection routes.
+         *
+         *     Internal providers, route cells, proceeds, operation scopes, activations,
+         *     bindings, readiness, provider accounts, and payout identifiers deliberately
+         *     remain behind the payment service boundary.
+         */
+        StorefrontCollectionOptions: {
+            /** @description Exact ISO 4217 currency charged to the customer. */
+            presentment_currency: string;
+            options: components["schemas"]["StorefrontCollectionMethodOption"][];
+        };
+        StorefrontCollectionOptionsResponse: {
+            data: components["schemas"]["StorefrontCollectionOptions"];
+        };
+        StorefrontPaymentAuthorizationResponse: {
+            data: components["schemas"]["CheckoutApiResponse"];
+        };
         SubmitAuthorizationArgs: {
-            reference: string;
-            auth_type: string;
-            value: string;
+            payment_id: string;
+            authorization: components["schemas"]["PaymentAuthorizationSubmission"];
         };
         SubscriptionItem: {
             id: string;
@@ -3886,6 +3959,11 @@ interface components {
             name: string;
             rate: string;
         };
+        /**
+         * @description Reviewed ways a price may be presented to the selected audience.
+         * @enum {string}
+         */
+        TaxPriceDisplayMode: "unspecified" | "gross_required" | "gross_and_net" | "net_allowed";
         TaxonomyWithChildren: components["schemas"]["ProductTaxonomy"] & {
             children: components["schemas"]["ProductTaxonomy"][];
         };
@@ -4525,6 +4603,7 @@ interface UICartCustomer {
     phone?: string;
     address?: string;
 }
+type TaxPriceDisplayMode = "unspecified" | "gross_required" | "gross_and_net" | "net_allowed";
 interface UICartPricing {
     subtotal: Money;
     tax_amount: Money;
@@ -4537,6 +4616,9 @@ interface UICartPricing {
     /** Tax is baked into the prices (e.g. Ghana VAT), so `tax_amount` is the
      *  portion already inside `subtotal`/`total_price`, not an addition. */
     tax_inclusive: boolean;
+    /** Reviewed presentation policy, independent from whether tax arithmetic is
+     *  inclusive. Older backend responses may omit it. */
+    price_display_mode?: TaxPriceDisplayMode;
     /** Jurisdiction resolved by the checkout tax decision (for example,
      *  `Austin, TX`). Absent until the cart has a destination decision;
      *  clients must not infer it from the preview rate. */
@@ -5663,4 +5745,122 @@ interface TagsResponse {
     offset: number;
 }
 
-export { type ComponentPriceBreakdown as $, type AddOn as A, BOUNDARY_KIND as B, type BundleProduct as C, type BundleSelectionData as D, type BundleSelectionInput as E, type BundleStoredSelection as F, type BundleSummary as G, type BundleWithDetails as H, type Cart as I, type CartAddOn as J, type CartChannel as K, type CartItem as L, type CartItemDetails as M, type CartMutationResult as N, type CartNotice as O, type CartStatus as P, type CartSummary as Q, type CartTotals as R, type Category as S, type CategorySummary as T, type ChosenPrice as U, CimplifyError as V, type Collection as W, type CollectionProduct as X, type CollectionSummary as Y, type ComponentGroup as Z, type ComponentGroupWithComponents as _, type AddOnDetails as a, type PriceSource as a$, type ComponentSchedulingData as a0, type ComponentSelectionInput as a1, type ComponentSourceType as a2, type Composite as a3, type CompositeComponent as a4, type CompositeComponentView as a5, type CompositeGroupView as a6, type CompositePriceBreakdown as a7, type CompositePriceResult as a8, type CompositePricingMode as a9, type EligiblePlansQuery as aA, ErrorCode as aB, type ErrorCodeType as aC, type ErrorHint as aD, type FacetValue as aE, type FormattedPlanOption as aF, type GroupPricingBehavior as aG, INPUT_FIELD_TYPE as aH, IdempotencyMismatchError as aI, type InputFieldType as aJ, type InputFieldValidation as aK, type InventoryType as aL, type KnowledgeArticle as aM, type LineConfiguration as aN, type LocationProductPrice as aO, type LocationValue as aP, type MeasurementValue as aQ, type Money as aR, PRODUCT_TYPE as aS, type Pagination as aT, type PaginationParams as aU, type PhoneValue as aV, type Price as aW, type PriceAdjustment as aX, type PriceDecisionPath as aY, type PriceEntryType as aZ, type PricePathTaxInfo as a_, type CompositeSelectionData as aa, type CompositeStoredSelection as ab, type CompositeWithDetails as ac, type CurrencyCode as ad, type CustomAttributeDefinition as ae, type CustomAttributeValue as af, type CustomerInputValue as ag, DURATION_UNIT as ah, type DateRangeValue as ai, type Deal as aj, type DealBenefitType as ak, type DepositType as al, type DestinationQuote as am, type DestinationQuoteAddress as an, type DestinationQuoteInput as ao, type DigitalProductType as ap, type DiscountBreakdown as aq, type DiscountDetails as ar, type DiscountValidation as as, type DisplayAddOn as at, type DisplayAddOnOption as au, type DisplayCart as av, type DisplayCartItem as aw, type DisplayMode as ax, type DurationUnit as ay, ERROR_HINTS as az, type AddOnGroupDetails as b, isQuoteConflictRequiringConsent as b$, type Product as b0, type ProductAddOn as b1, type ProductAvailability as b2, type ProductAvailabilityNow as b3, type ProductBillingPlan as b4, type ProductDealInfo as b5, type ProductInputField as b6, type ProductProperty as b7, type ProductRenderHint as b8, type ProductTaxonomy as b9, type TaxonomyWithChildren as bA, type UICart as bB, type UICartBusiness as bC, type UICartCustomer as bD, type UICartLocation as bE, type UICartPricing as bF, type UpcomingSale as bG, type UpdateCartItemInput as bH, type VariantAxis as bI, type VariantAxisSelection as bJ, type VariantAxisValue as bK, type VariantAxisValueView as bL, type VariantAxisView as bM, type VariantAxisWithValues as bN, type VariantDetails as bO, type VariantDetailsDTO as bP, type VariantDisplayAttribute as bQ, type VariantLocationAvailability as bR, type VariantStrategy as bS, type VariantView as bT, ZERO as bU, type components as bV, currencyCode as bW, enrichError as bX, getErrorHint as bY, isCimplifyError as bZ, isIdempotencyMismatchError as b_, type ProductTimeProfile as ba, type ProductType as bb, type ProductVariant as bc, type ProductVariantValue as bd, type ProductWithDetails as be, type PropertyFacet as bf, type PropertySource as bg, type QuantityPricingTier as bh, RENDER_HINT as bi, type RelatedProductView as bj, type SaleCapInfo as bk, type SaleInfo as bl, type SalesChannel as bm, type SchedulingMode as bn, type SelectedAddOnOption as bo, type SemanticKind as bp, type SignatureValue as bq, type Subscription as br, type SubscriptionInvoice as bs, type SubscriptionItem as bt, type SubscriptionStatus as bu, type SubscriptionWithDetails as bv, type Tag as bw, type TagsResponse as bx, type TaxPathComponent as by, type TaxonomyAttributeTemplate as bz, type AddOnOption as c, isQuoteError as c0, isRetryableError as c1, isSupportedCurrency as c2, money as c3, moneyFromNumber as c4, type AddOnOptionDetails as d, type AddOnOptionPrice as e, type AddOnWithOptions as f, type AddToCartInput as g, type AddressValue as h, type AdjustmentType as i, type ApiError as j, type AppliedDiscount as k, type AttributeAppliesTo as l, type AttributeType as m, type AttributeValidationRules as n, type AttributeVisibility as o, type BenefitType as p, type BillingFrequency as q, type BillingMarkupType as r, type BillingPlanType as s, type BoundaryKind as t, type Bundle as u, type BundleComponentData as v, type BundleComponentInfo as w, type BundleComponentVariantView as x, type BundleComponentView as y, type BundlePriceType as z };
+type PaymentStatus = "initialized" | "pending" | "processing" | "authorized" | "captured" | "not_required" | "failed" | "cancelled" | "refunded" | "unknown" | "voided" | "requires_action" | "abandoned" | "reversed" | "disputed" | "refund_pending";
+type PaymentProvider = "stripe" | "paystack" | "cellulant" | "mtn_momo" | "offline" | "mtn" | "vodafone" | "airtel" | "cash" | "manual";
+type PaymentMethodType = "card" | "bank_transfer" | "cash" | {
+    mobile_money: {
+        provider: string;
+        phone_number: string;
+    };
+} | {
+    ussd: {
+        provider: string;
+    };
+} | {
+    bank: {
+        bank_code: string;
+        account_number: string;
+        account_name?: string;
+        bank_name?: string;
+    };
+} | {
+    qr: {
+        provider: string;
+    };
+} | {
+    wallet: {
+        provider: string;
+    };
+} | {
+    crypto: {
+        currency: string;
+    };
+} | {
+    custom: string;
+};
+interface AddressAuthorizationData {
+    address: string;
+    city: string;
+    state: string;
+    zip_code: string;
+}
+type PaymentAuthorizationKind = "otp" | "pin" | "phone" | "birthday" | "address";
+type AuthorizationType = Exclude<PaymentAuthorizationKind, "address"> | {
+    address: AddressAuthorizationData;
+};
+/** Customer input for one provider-requested authorization challenge. */
+type PaymentAuthorizationSubmission = {
+    type: Exclude<PaymentAuthorizationKind, "address">;
+    value: string;
+} | ({
+    type: "address";
+} & AddressAuthorizationData);
+type PaymentProcessingState = "initial" | "preparing" | "processing" | "verifying" | "awaiting_authorization" | "success" | "error" | "timeout";
+interface PaymentMethod {
+    type: PaymentMethodType;
+    provider?: string;
+    phone_number?: string;
+    card_last_four?: string;
+    custom_value?: string;
+}
+interface Payment {
+    id: string;
+    order_id: string;
+    business_id: string;
+    amount: Money;
+    currency: CurrencyCode;
+    payment_method: PaymentMethod;
+    status: PaymentStatus;
+    provider: PaymentProvider;
+    provider_reference?: string;
+    failure_reason?: string;
+    created_at: string;
+    updated_at: string;
+}
+interface InitializePaymentResult {
+    payment_id: string;
+    status: PaymentStatus;
+    redirect_url?: string;
+    authorization_url?: string;
+    reference: string;
+    provider: PaymentProvider;
+}
+interface PaymentResponse {
+    method: string;
+    provider: string;
+    requires_action: boolean;
+    public_key?: string;
+    client_secret?: string;
+    access_code?: string;
+    redirect_url?: string;
+    transaction_id?: string;
+    order_id?: string;
+    reference?: string;
+    metadata?: Record<string, unknown>;
+    instructions?: string;
+    display_text?: string;
+    requires_authorization?: boolean;
+    authorization_type?: AuthorizationType;
+    provider_payment_id?: string;
+}
+interface PaymentStatusResponse {
+    status: PaymentStatus;
+    paid: boolean;
+    amount: Money;
+    currency: string;
+    reference?: string;
+    message: string;
+}
+interface PaymentErrorDetails {
+    code: string;
+    message: string;
+    recoverable: boolean;
+    technical?: string;
+}
+interface SubmitAuthorizationInput {
+    /** Tenant-scoped Cimplify payment id returned by checkout. */
+    payment_id: string;
+    authorization: PaymentAuthorizationSubmission;
+}
+
+export { type ComponentGroup as $, type AddOn as A, BOUNDARY_KIND as B, type BundleComponentView as C, type BundlePriceType as D, type BundleProduct as E, type BundleSelectionData as F, type BundleSelectionInput as G, type BundleStoredSelection as H, type BundleSummary as I, type BundleWithDetails as J, type Cart as K, type CartAddOn as L, type CartChannel as M, type CartItem as N, type CartItemDetails as O, type CartMutationResult as P, type CartNotice as Q, type CartStatus as R, type CartSummary as S, type CartTotals as T, type Category as U, type CategorySummary as V, type ChosenPrice as W, CimplifyError as X, type Collection as Y, type CollectionProduct as Z, type CollectionSummary as _, type AddOnDetails as a, type PaymentErrorDetails as a$, type ComponentGroupWithComponents as a0, type ComponentPriceBreakdown as a1, type ComponentSchedulingData as a2, type ComponentSelectionInput as a3, type ComponentSourceType as a4, type Composite as a5, type CompositeComponent as a6, type CompositeComponentView as a7, type CompositeGroupView as a8, type CompositePriceBreakdown as a9, type DurationUnit as aA, ERROR_HINTS as aB, type EligiblePlansQuery as aC, ErrorCode as aD, type ErrorCodeType as aE, type ErrorHint as aF, type FacetValue as aG, type FormattedPlanOption as aH, type GroupPricingBehavior as aI, INPUT_FIELD_TYPE as aJ, IdempotencyMismatchError as aK, type InitializePaymentResult as aL, type InputFieldType as aM, type InputFieldValidation as aN, type InventoryType as aO, type KnowledgeArticle as aP, type LineConfiguration as aQ, type LocationProductPrice as aR, type LocationValue as aS, type MeasurementValue as aT, type Money as aU, PRODUCT_TYPE as aV, type Pagination as aW, type PaginationParams as aX, type Payment as aY, type PaymentAuthorizationKind as aZ, type PaymentAuthorizationSubmission as a_, type CompositePriceResult as aa, type CompositePricingMode as ab, type CompositeSelectionData as ac, type CompositeStoredSelection as ad, type CompositeWithDetails as ae, type CurrencyCode as af, type CustomAttributeDefinition as ag, type CustomAttributeValue as ah, type CustomerInputValue as ai, DURATION_UNIT as aj, type DateRangeValue as ak, type Deal as al, type DealBenefitType as am, type DepositType as an, type DestinationQuote as ao, type DestinationQuoteAddress as ap, type DestinationQuoteInput as aq, type DigitalProductType as ar, type DiscountBreakdown as as, type DiscountDetails as at, type DiscountValidation as au, type DisplayAddOn as av, type DisplayAddOnOption as aw, type DisplayCart as ax, type DisplayCartItem as ay, type DisplayMode as az, type AddOnGroupDetails as b, type VariantAxisValueView as b$, type PaymentMethod as b0, type PaymentMethodType as b1, type PaymentProcessingState as b2, type PaymentProvider as b3, type PaymentResponse as b4, type PaymentStatus as b5, type PaymentStatusResponse as b6, type PhoneValue as b7, type Price as b8, type PriceAdjustment as b9, type SalesChannel as bA, type SchedulingMode as bB, type SelectedAddOnOption as bC, type SemanticKind as bD, type SignatureValue as bE, type SubmitAuthorizationInput as bF, type Subscription as bG, type SubscriptionInvoice as bH, type SubscriptionItem as bI, type SubscriptionStatus as bJ, type SubscriptionWithDetails as bK, type Tag as bL, type TagsResponse as bM, type TaxPathComponent as bN, type TaxPriceDisplayMode as bO, type TaxonomyAttributeTemplate as bP, type TaxonomyWithChildren as bQ, type UICart as bR, type UICartBusiness as bS, type UICartCustomer as bT, type UICartLocation as bU, type UICartPricing as bV, type UpcomingSale as bW, type UpdateCartItemInput as bX, type VariantAxis as bY, type VariantAxisSelection as bZ, type VariantAxisValue as b_, type PriceDecisionPath as ba, type PriceEntryType as bb, type PricePathTaxInfo as bc, type PriceSource as bd, type Product as be, type ProductAddOn as bf, type ProductAvailability as bg, type ProductAvailabilityNow as bh, type ProductBillingPlan as bi, type ProductDealInfo as bj, type ProductInputField as bk, type ProductProperty as bl, type ProductRenderHint as bm, type ProductTaxonomy as bn, type ProductTimeProfile as bo, type ProductType as bp, type ProductVariant as bq, type ProductVariantValue as br, type ProductWithDetails as bs, type PropertyFacet as bt, type PropertySource as bu, type QuantityPricingTier as bv, RENDER_HINT as bw, type RelatedProductView as bx, type SaleCapInfo as by, type SaleInfo as bz, type AddOnOption as c, type VariantAxisView as c0, type VariantAxisWithValues as c1, type VariantDetails as c2, type VariantDetailsDTO as c3, type VariantDisplayAttribute as c4, type VariantLocationAvailability as c5, type VariantStrategy as c6, type VariantView as c7, ZERO as c8, type components as c9, currencyCode as ca, enrichError as cb, getErrorHint as cc, isCimplifyError as cd, isIdempotencyMismatchError as ce, isQuoteConflictRequiringConsent as cf, isQuoteError as cg, isRetryableError as ch, isSupportedCurrency as ci, money as cj, moneyFromNumber as ck, type AddOnOptionDetails as d, type AddOnOptionPrice as e, type AddOnWithOptions as f, type AddToCartInput as g, type AddressAuthorizationData as h, type AddressValue as i, type AdjustmentType as j, type ApiError as k, type AppliedDiscount as l, type AttributeAppliesTo as m, type AttributeType as n, type AttributeValidationRules as o, type AttributeVisibility as p, type AuthorizationType as q, type BenefitType as r, type BillingFrequency as s, type BillingMarkupType as t, type BillingPlanType as u, type BoundaryKind as v, type Bundle as w, type BundleComponentData as x, type BundleComponentInfo as y, type BundleComponentVariantView as z };

package/dist/{product-DwKdC_to.d.ts → payment-H5LoIvXU.d.ts}

@@ -27,6 +27,7 @@ declare const ErrorCode: {
     readonly TIMEOUT: "TIMEOUT";
     readonly UNAUTHORIZED: "UNAUTHORIZED";
     readonly FORBIDDEN: "FORBIDDEN";
+    readonly TENANT_CONTEXT_CHANGED: "TENANT_CONTEXT_CHANGED";
     readonly NOT_FOUND: "NOT_FOUND";
     readonly VALIDATION_ERROR: "VALIDATION_ERROR";
     readonly CART_EMPTY: "CART_EMPTY";
@@ -48,6 +49,8 @@ declare const ErrorCode: {
     readonly PRICE_CHANGED: "PRICE_CHANGED";
     readonly PAYMENT_FAILED: "PAYMENT_FAILED";
     readonly PAYMENT_CANCELLED: "PAYMENT_CANCELLED";
+    readonly PAYMENT_CAPABILITY_MISMATCH: "PAYMENT_CAPABILITY_MISMATCH";
+    readonly UNSUPPORTED_CURRENCY: "UNSUPPORTED_CURRENCY";
     readonly INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS";
     readonly CARD_DECLINED: "CARD_DECLINED";
     readonly INVALID_OTP: "INVALID_OTP";
@@ -955,6 +958,11 @@ interface components {
              *     labels it "included" rather than summing it onto the total.
              */
             tax_inclusive: boolean;
+            /**
+             * @description Reviewed policy for presenting tax in customer-facing prices. This is
+             *     independent from whether the pricing arithmetic is tax-inclusive.
+             */
+            price_display_mode?: components["schemas"]["TaxPriceDisplayMode"];
             /**
              * @description Deposit due now when the cart has deposit-eligible service items, letting
              *     checkout offer "pay deposit now, balance later". `0` when none applies.
@@ -1092,13 +1100,14 @@ interface components {
             order_id: string;
             order_number: string;
             bill_token?: string | null;
+            payment_id?: string | null;
             payment_reference?: string | null;
             payment_status: string;
             requires_authorization: boolean;
             authorization_type?: null | components["schemas"]["AuthorizationType"];
             authorization_url?: string | null;
             display_text?: string | null;
-            provider?: string | null;
+            provider?: null | components["schemas"]["ProviderType"];
             client_secret?: string | null;
             public_key?: string | null;
             next_action: components["schemas"]["NextAction"];
@@ -1122,6 +1131,8 @@ interface components {
             tax_inclusive: boolean;
             /** @description Effective tax rate in percentage points (for example, `8.25`). */
             tax_rate?: string | null;
+            /** @description Reviewed consumer-facing price presentation policy for this quote. */
+            price_display_mode: components["schemas"]["TaxPriceDisplayMode"];
             delivery_fee_details?: null | components["schemas"]["DeliveryFeeDetails"];
             address_info: components["schemas"]["AddressInfo"];
         };
@@ -1159,8 +1170,8 @@ interface components {
             fx_quote_id?: string | null;
             /**
              * @description Pay only the required deposit now (balance collected later) instead of the
-             *     full total. Only honored when the order is deposit-eligible and paying in
-             *     the order's native currency.
+             *     full total. Honored only for the first collection on a deposit-eligible
+             *     order; later attempts collect the authoritative remaining balance.
              */
             pay_deposit?: boolean;
             /**
@@ -1191,6 +1202,8 @@ interface components {
             tax_inclusive: boolean;
             /** @description Effective tax rate in percentage points (for example, `8.25`). */
             tax_rate?: string | null;
+            /** @description Reviewed consumer-facing price presentation policy for these totals. */
+            price_display_mode: components["schemas"]["TaxPriceDisplayMode"];
         };
         CheckoutSessionCartItem: {
             product_id: string;
@@ -2740,6 +2753,37 @@ interface components {
             has_more: boolean;
             next_cursor?: string | null;
         };
+        /**
+         * @description Typed customer input for one provider-requested authorization step.
+         *
+         *     Provider references are deliberately absent. The payment service resolves
+         *     the authoritative reference and provider from the tenant-scoped payment
+         *     row before making provider I/O.
+         */
+        PaymentAuthorizationSubmission: {
+            value: string;
+            /** @enum {string} */
+            type: "pin";
+        } | {
+            value: string;
+            /** @enum {string} */
+            type: "otp";
+        } | {
+            value: string;
+            /** @enum {string} */
+            type: "phone";
+        } | {
+            value: string;
+            /** @enum {string} */
+            type: "birthday";
+        } | {
+            address: string;
+            city: string;
+            state: string;
+            zip_code: string;
+            /** @enum {string} */
+            type: "address";
+        };
         PaymentInfoDTO: {
             state: components["schemas"]["PaymentState"];
             computed_status?: string | null;
@@ -3266,6 +3310,8 @@ interface components {
          * @enum {string}
          */
         ProviderResolutionSource: "zone" | "hint" | "fallback" | "rate" | "best_price";
+        /** @enum {string} */
+        ProviderType: "stripe" | "paystack" | "cellulant" | "mtn_momo" | "offline";
         PublicCheckoutSessionResponse: {
             id: string;
             status: string;
@@ -3799,10 +3845,37 @@ interface components {
             balance: string;
             currency: string;
         };
+        /**
+         * @description One method/network combination accepted by the storefront checkout input.
+         * @enum {string}
+         */
+        StorefrontCollectionMethod: "card" | "mobile_money";
+        StorefrontCollectionMethodOption: {
+            method: components["schemas"]["StorefrontCollectionMethod"];
+            /** @description Optional network selector required by network-specific methods. */
+            network?: string | null;
+        };
+        /**
+         * @description Storefront-safe projection of active merchant collection routes.
+         *
+         *     Internal providers, route cells, proceeds, operation scopes, activations,
+         *     bindings, readiness, provider accounts, and payout identifiers deliberately
+         *     remain behind the payment service boundary.
+         */
+        StorefrontCollectionOptions: {
+            /** @description Exact ISO 4217 currency charged to the customer. */
+            presentment_currency: string;
+            options: components["schemas"]["StorefrontCollectionMethodOption"][];
+        };
+        StorefrontCollectionOptionsResponse: {
+            data: components["schemas"]["StorefrontCollectionOptions"];
+        };
+        StorefrontPaymentAuthorizationResponse: {
+            data: components["schemas"]["CheckoutApiResponse"];
+        };
         SubmitAuthorizationArgs: {
-            reference: string;
-            auth_type: string;
-            value: string;
+            payment_id: string;
+            authorization: components["schemas"]["PaymentAuthorizationSubmission"];
         };
         SubscriptionItem: {
             id: string;
@@ -3886,6 +3959,11 @@ interface components {
             name: string;
             rate: string;
         };
+        /**
+         * @description Reviewed ways a price may be presented to the selected audience.
+         * @enum {string}
+         */
+        TaxPriceDisplayMode: "unspecified" | "gross_required" | "gross_and_net" | "net_allowed";
         TaxonomyWithChildren: components["schemas"]["ProductTaxonomy"] & {
             children: components["schemas"]["ProductTaxonomy"][];
         };
@@ -4525,6 +4603,7 @@ interface UICartCustomer {
     phone?: string;
     address?: string;
 }
+type TaxPriceDisplayMode = "unspecified" | "gross_required" | "gross_and_net" | "net_allowed";
 interface UICartPricing {
     subtotal: Money;
     tax_amount: Money;
@@ -4537,6 +4616,9 @@ interface UICartPricing {
     /** Tax is baked into the prices (e.g. Ghana VAT), so `tax_amount` is the
      *  portion already inside `subtotal`/`total_price`, not an addition. */
     tax_inclusive: boolean;
+    /** Reviewed presentation policy, independent from whether tax arithmetic is
+     *  inclusive. Older backend responses may omit it. */
+    price_display_mode?: TaxPriceDisplayMode;
     /** Jurisdiction resolved by the checkout tax decision (for example,
      *  `Austin, TX`). Absent until the cart has a destination decision;
      *  clients must not infer it from the preview rate. */
@@ -5663,4 +5745,122 @@ interface TagsResponse {
     offset: number;
 }
 
-export { type ComponentPriceBreakdown as $, type AddOn as A, BOUNDARY_KIND as B, type BundleProduct as C, type BundleSelectionData as D, type BundleSelectionInput as E, type BundleStoredSelection as F, type BundleSummary as G, type BundleWithDetails as H, type Cart as I, type CartAddOn as J, type CartChannel as K, type CartItem as L, type CartItemDetails as M, type CartMutationResult as N, type CartNotice as O, type CartStatus as P, type CartSummary as Q, type CartTotals as R, type Category as S, type CategorySummary as T, type ChosenPrice as U, CimplifyError as V, type Collection as W, type CollectionProduct as X, type CollectionSummary as Y, type ComponentGroup as Z, type ComponentGroupWithComponents as _, type AddOnDetails as a, type PriceSource as a$, type ComponentSchedulingData as a0, type ComponentSelectionInput as a1, type ComponentSourceType as a2, type Composite as a3, type CompositeComponent as a4, type CompositeComponentView as a5, type CompositeGroupView as a6, type CompositePriceBreakdown as a7, type CompositePriceResult as a8, type CompositePricingMode as a9, type EligiblePlansQuery as aA, ErrorCode as aB, type ErrorCodeType as aC, type ErrorHint as aD, type FacetValue as aE, type FormattedPlanOption as aF, type GroupPricingBehavior as aG, INPUT_FIELD_TYPE as aH, IdempotencyMismatchError as aI, type InputFieldType as aJ, type InputFieldValidation as aK, type InventoryType as aL, type KnowledgeArticle as aM, type LineConfiguration as aN, type LocationProductPrice as aO, type LocationValue as aP, type MeasurementValue as aQ, type Money as aR, PRODUCT_TYPE as aS, type Pagination as aT, type PaginationParams as aU, type PhoneValue as aV, type Price as aW, type PriceAdjustment as aX, type PriceDecisionPath as aY, type PriceEntryType as aZ, type PricePathTaxInfo as a_, type CompositeSelectionData as aa, type CompositeStoredSelection as ab, type CompositeWithDetails as ac, type CurrencyCode as ad, type CustomAttributeDefinition as ae, type CustomAttributeValue as af, type CustomerInputValue as ag, DURATION_UNIT as ah, type DateRangeValue as ai, type Deal as aj, type DealBenefitType as ak, type DepositType as al, type DestinationQuote as am, type DestinationQuoteAddress as an, type DestinationQuoteInput as ao, type DigitalProductType as ap, type DiscountBreakdown as aq, type DiscountDetails as ar, type DiscountValidation as as, type DisplayAddOn as at, type DisplayAddOnOption as au, type DisplayCart as av, type DisplayCartItem as aw, type DisplayMode as ax, type DurationUnit as ay, ERROR_HINTS as az, type AddOnGroupDetails as b, isQuoteConflictRequiringConsent as b$, type Product as b0, type ProductAddOn as b1, type ProductAvailability as b2, type ProductAvailabilityNow as b3, type ProductBillingPlan as b4, type ProductDealInfo as b5, type ProductInputField as b6, type ProductProperty as b7, type ProductRenderHint as b8, type ProductTaxonomy as b9, type TaxonomyWithChildren as bA, type UICart as bB, type UICartBusiness as bC, type UICartCustomer as bD, type UICartLocation as bE, type UICartPricing as bF, type UpcomingSale as bG, type UpdateCartItemInput as bH, type VariantAxis as bI, type VariantAxisSelection as bJ, type VariantAxisValue as bK, type VariantAxisValueView as bL, type VariantAxisView as bM, type VariantAxisWithValues as bN, type VariantDetails as bO, type VariantDetailsDTO as bP, type VariantDisplayAttribute as bQ, type VariantLocationAvailability as bR, type VariantStrategy as bS, type VariantView as bT, ZERO as bU, type components as bV, currencyCode as bW, enrichError as bX, getErrorHint as bY, isCimplifyError as bZ, isIdempotencyMismatchError as b_, type ProductTimeProfile as ba, type ProductType as bb, type ProductVariant as bc, type ProductVariantValue as bd, type ProductWithDetails as be, type PropertyFacet as bf, type PropertySource as bg, type QuantityPricingTier as bh, RENDER_HINT as bi, type RelatedProductView as bj, type SaleCapInfo as bk, type SaleInfo as bl, type SalesChannel as bm, type SchedulingMode as bn, type SelectedAddOnOption as bo, type SemanticKind as bp, type SignatureValue as bq, type Subscription as br, type SubscriptionInvoice as bs, type SubscriptionItem as bt, type SubscriptionStatus as bu, type SubscriptionWithDetails as bv, type Tag as bw, type TagsResponse as bx, type TaxPathComponent as by, type TaxonomyAttributeTemplate as bz, type AddOnOption as c, isQuoteError as c0, isRetryableError as c1, isSupportedCurrency as c2, money as c3, moneyFromNumber as c4, type AddOnOptionDetails as d, type AddOnOptionPrice as e, type AddOnWithOptions as f, type AddToCartInput as g, type AddressValue as h, type AdjustmentType as i, type ApiError as j, type AppliedDiscount as k, type AttributeAppliesTo as l, type AttributeType as m, type AttributeValidationRules as n, type AttributeVisibility as o, type BenefitType as p, type BillingFrequency as q, type BillingMarkupType as r, type BillingPlanType as s, type BoundaryKind as t, type Bundle as u, type BundleComponentData as v, type BundleComponentInfo as w, type BundleComponentVariantView as x, type BundleComponentView as y, type BundlePriceType as z };
+type PaymentStatus = "initialized" | "pending" | "processing" | "authorized" | "captured" | "not_required" | "failed" | "cancelled" | "refunded" | "unknown" | "voided" | "requires_action" | "abandoned" | "reversed" | "disputed" | "refund_pending";
+type PaymentProvider = "stripe" | "paystack" | "cellulant" | "mtn_momo" | "offline" | "mtn" | "vodafone" | "airtel" | "cash" | "manual";
+type PaymentMethodType = "card" | "bank_transfer" | "cash" | {
+    mobile_money: {
+        provider: string;
+        phone_number: string;
+    };
+} | {
+    ussd: {
+        provider: string;
+    };
+} | {
+    bank: {
+        bank_code: string;
+        account_number: string;
+        account_name?: string;
+        bank_name?: string;
+    };
+} | {
+    qr: {
+        provider: string;
+    };
+} | {
+    wallet: {
+        provider: string;
+    };
+} | {
+    crypto: {
+        currency: string;
+    };
+} | {
+    custom: string;
+};
+interface AddressAuthorizationData {
+    address: string;
+    city: string;
+    state: string;
+    zip_code: string;
+}
+type PaymentAuthorizationKind = "otp" | "pin" | "phone" | "birthday" | "address";
+type AuthorizationType = Exclude<PaymentAuthorizationKind, "address"> | {
+    address: AddressAuthorizationData;
+};
+/** Customer input for one provider-requested authorization challenge. */
+type PaymentAuthorizationSubmission = {
+    type: Exclude<PaymentAuthorizationKind, "address">;
+    value: string;
+} | ({
+    type: "address";
+} & AddressAuthorizationData);
+type PaymentProcessingState = "initial" | "preparing" | "processing" | "verifying" | "awaiting_authorization" | "success" | "error" | "timeout";
+interface PaymentMethod {
+    type: PaymentMethodType;
+    provider?: string;
+    phone_number?: string;
+    card_last_four?: string;
+    custom_value?: string;
+}
+interface Payment {
+    id: string;
+    order_id: string;
+    business_id: string;
+    amount: Money;
+    currency: CurrencyCode;
+    payment_method: PaymentMethod;
+    status: PaymentStatus;
+    provider: PaymentProvider;
+    provider_reference?: string;
+    failure_reason?: string;
+    created_at: string;
+    updated_at: string;
+}
+interface InitializePaymentResult {
+    payment_id: string;
+    status: PaymentStatus;
+    redirect_url?: string;
+    authorization_url?: string;
+    reference: string;
+    provider: PaymentProvider;
+}
+interface PaymentResponse {
+    method: string;
+    provider: string;
+    requires_action: boolean;
+    public_key?: string;
+    client_secret?: string;
+    access_code?: string;
+    redirect_url?: string;
+    transaction_id?: string;
+    order_id?: string;
+    reference?: string;
+    metadata?: Record<string, unknown>;
+    instructions?: string;
+    display_text?: string;
+    requires_authorization?: boolean;
+    authorization_type?: AuthorizationType;
+    provider_payment_id?: string;
+}
+interface PaymentStatusResponse {
+    status: PaymentStatus;
+    paid: boolean;
+    amount: Money;
+    currency: string;
+    reference?: string;
+    message: string;
+}
+interface PaymentErrorDetails {
+    code: string;
+    message: string;
+    recoverable: boolean;
+    technical?: string;
+}
+interface SubmitAuthorizationInput {
+    /** Tenant-scoped Cimplify payment id returned by checkout. */
+    payment_id: string;
+    authorization: PaymentAuthorizationSubmission;
+}
+
+export { type ComponentGroup as $, type AddOn as A, BOUNDARY_KIND as B, type BundleComponentView as C, type BundlePriceType as D, type BundleProduct as E, type BundleSelectionData as F, type BundleSelectionInput as G, type BundleStoredSelection as H, type BundleSummary as I, type BundleWithDetails as J, type Cart as K, type CartAddOn as L, type CartChannel as M, type CartItem as N, type CartItemDetails as O, type CartMutationResult as P, type CartNotice as Q, type CartStatus as R, type CartSummary as S, type CartTotals as T, type Category as U, type CategorySummary as V, type ChosenPrice as W, CimplifyError as X, type Collection as Y, type CollectionProduct as Z, type CollectionSummary as _, type AddOnDetails as a, type PaymentErrorDetails as a$, type ComponentGroupWithComponents as a0, type ComponentPriceBreakdown as a1, type ComponentSchedulingData as a2, type ComponentSelectionInput as a3, type ComponentSourceType as a4, type Composite as a5, type CompositeComponent as a6, type CompositeComponentView as a7, type CompositeGroupView as a8, type CompositePriceBreakdown as a9, type DurationUnit as aA, ERROR_HINTS as aB, type EligiblePlansQuery as aC, ErrorCode as aD, type ErrorCodeType as aE, type ErrorHint as aF, type FacetValue as aG, type FormattedPlanOption as aH, type GroupPricingBehavior as aI, INPUT_FIELD_TYPE as aJ, IdempotencyMismatchError as aK, type InitializePaymentResult as aL, type InputFieldType as aM, type InputFieldValidation as aN, type InventoryType as aO, type KnowledgeArticle as aP, type LineConfiguration as aQ, type LocationProductPrice as aR, type LocationValue as aS, type MeasurementValue as aT, type Money as aU, PRODUCT_TYPE as aV, type Pagination as aW, type PaginationParams as aX, type Payment as aY, type PaymentAuthorizationKind as aZ, type PaymentAuthorizationSubmission as a_, type CompositePriceResult as aa, type CompositePricingMode as ab, type CompositeSelectionData as ac, type CompositeStoredSelection as ad, type CompositeWithDetails as ae, type CurrencyCode as af, type CustomAttributeDefinition as ag, type CustomAttributeValue as ah, type CustomerInputValue as ai, DURATION_UNIT as aj, type DateRangeValue as ak, type Deal as al, type DealBenefitType as am, type DepositType as an, type DestinationQuote as ao, type DestinationQuoteAddress as ap, type DestinationQuoteInput as aq, type DigitalProductType as ar, type DiscountBreakdown as as, type DiscountDetails as at, type DiscountValidation as au, type DisplayAddOn as av, type DisplayAddOnOption as aw, type DisplayCart as ax, type DisplayCartItem as ay, type DisplayMode as az, type AddOnGroupDetails as b, type VariantAxisValueView as b$, type PaymentMethod as b0, type PaymentMethodType as b1, type PaymentProcessingState as b2, type PaymentProvider as b3, type PaymentResponse as b4, type PaymentStatus as b5, type PaymentStatusResponse as b6, type PhoneValue as b7, type Price as b8, type PriceAdjustment as b9, type SalesChannel as bA, type SchedulingMode as bB, type SelectedAddOnOption as bC, type SemanticKind as bD, type SignatureValue as bE, type SubmitAuthorizationInput as bF, type Subscription as bG, type SubscriptionInvoice as bH, type SubscriptionItem as bI, type SubscriptionStatus as bJ, type SubscriptionWithDetails as bK, type Tag as bL, type TagsResponse as bM, type TaxPathComponent as bN, type TaxPriceDisplayMode as bO, type TaxonomyAttributeTemplate as bP, type TaxonomyWithChildren as bQ, type UICart as bR, type UICartBusiness as bS, type UICartCustomer as bT, type UICartLocation as bU, type UICartPricing as bV, type UpcomingSale as bW, type UpdateCartItemInput as bX, type VariantAxis as bY, type VariantAxisSelection as bZ, type VariantAxisValue as b_, type PriceDecisionPath as ba, type PriceEntryType as bb, type PricePathTaxInfo as bc, type PriceSource as bd, type Product as be, type ProductAddOn as bf, type ProductAvailability as bg, type ProductAvailabilityNow as bh, type ProductBillingPlan as bi, type ProductDealInfo as bj, type ProductInputField as bk, type ProductProperty as bl, type ProductRenderHint as bm, type ProductTaxonomy as bn, type ProductTimeProfile as bo, type ProductType as bp, type ProductVariant as bq, type ProductVariantValue as br, type ProductWithDetails as bs, type PropertyFacet as bt, type PropertySource as bu, type QuantityPricingTier as bv, RENDER_HINT as bw, type RelatedProductView as bx, type SaleCapInfo as by, type SaleInfo as bz, type AddOnOption as c, type VariantAxisView as c0, type VariantAxisWithValues as c1, type VariantDetails as c2, type VariantDetailsDTO as c3, type VariantDisplayAttribute as c4, type VariantLocationAvailability as c5, type VariantStrategy as c6, type VariantView as c7, ZERO as c8, type components as c9, currencyCode as ca, enrichError as cb, getErrorHint as cc, isCimplifyError as cd, isIdempotencyMismatchError as ce, isQuoteConflictRequiringConsent as cf, isQuoteError as cg, isRetryableError as ch, isSupportedCurrency as ci, money as cj, moneyFromNumber as ck, type AddOnOptionDetails as d, type AddOnOptionPrice as e, type AddOnWithOptions as f, type AddToCartInput as g, type AddressAuthorizationData as h, type AddressValue as i, type AdjustmentType as j, type ApiError as k, type AppliedDiscount as l, type AttributeAppliesTo as m, type AttributeType as n, type AttributeValidationRules as o, type AttributeVisibility as p, type AuthorizationType as q, type BenefitType as r, type BillingFrequency as s, type BillingMarkupType as t, type BillingPlanType as u, type BoundaryKind as v, type Bundle as w, type BundleComponentData as x, type BundleComponentInfo as y, type BundleComponentVariantView as z };

package/dist/{price-CiQUd_XX.d.mts → price-BvePgDXe.d.mts}

@@ -1,4 +1,4 @@
-import { ad as CurrencyCode, U as ChosenPrice, bl as SaleInfo, bG as UpcomingSale } from './product-DwKdC_to.mjs';
+import { af as CurrencyCode, W as ChosenPrice, bz as SaleInfo, bW as UpcomingSale } from './payment-H5LoIvXU.mjs';
 
 interface ProductWithPrice {
     price_info?: ChosenPrice;