@01.software/sdk 0.46.0 → 0.48.0

package/dist/{payload-types-CJZuXcgF.d.ts → payload-types-B6AZQcB7.d.ts}

@@ -71,6 +71,8 @@ interface Config {
         'payment-kernel-operations': PaymentKernelOperation;
         'payment-kernel-operation-attempts': PaymentKernelOperationAttempt;
         'payment-kernel-financial-movements': PaymentKernelFinancialMovement;
+        'payment-kernel-provider-receipts': PaymentKernelProviderReceipt;
+        'payment-kernel-reconciliation-cases': PaymentKernelReconciliationCase;
         'order-status-logs': OrderStatusLog;
         'inventory-reservations': InventoryReservation;
         'fulfillment-orders': FulfillmentOrder;
@@ -302,6 +304,8 @@ interface Config {
         'payment-kernel-operations': PaymentKernelOperationsSelect<false> | PaymentKernelOperationsSelect<true>;
         'payment-kernel-operation-attempts': PaymentKernelOperationAttemptsSelect<false> | PaymentKernelOperationAttemptsSelect<true>;
         'payment-kernel-financial-movements': PaymentKernelFinancialMovementsSelect<false> | PaymentKernelFinancialMovementsSelect<true>;
+        'payment-kernel-provider-receipts': PaymentKernelProviderReceiptsSelect<false> | PaymentKernelProviderReceiptsSelect<true>;
+        'payment-kernel-reconciliation-cases': PaymentKernelReconciliationCasesSelect<false> | PaymentKernelReconciliationCasesSelect<true>;
         'order-status-logs': OrderStatusLogsSelect<false> | OrderStatusLogsSelect<true>;
         'inventory-reservations': InventoryReservationsSelect<false> | InventoryReservationsSelect<true>;
         'fulfillment-orders': FulfillmentOrdersSelect<false> | FulfillmentOrdersSelect<true>;
@@ -606,6 +610,14 @@ interface Tenant {
     id: string;
     webhookPurgeFencedAt?: string | null;
     name: string;
+    /**
+     * TEST is a time-limited space with separate data and keys and no external effects.
+     */
+    tenantPurpose?: ('production' | 'test') | null;
+    /**
+     * A TEST tenant can be used for at most 30 days from creation.
+     */
+    testExpiresAt?: string | null;
     /**
      * URL-safe identifier (auto-generated)
      */
@@ -2933,7 +2945,7 @@ interface ShippingPolicy {
      */
     baseAmount?: number | null;
     /**
-     * Read-only rollout field. Edit the shipping rates array instead.
+     * Read-only rollout field. Set up free shipping with an order-amount rate row priced at 0, or with an automatic free_shipping discount that sets a minimum order amount. When you use a rate row, cap the existing paid row with Max Amount so both rows never apply together.
      */
     freeShippingMinAmount?: number | null;
     rates?: {
@@ -2975,7 +2987,13 @@ interface ShippingPolicy {
      * Estimated delivery days
      */
     estimatedDays?: number | null;
+    /**
+     * When off, this policy is skipped and orders price against the default shipping policy.
+     */
     isActive?: boolean | null;
+    /**
+     * Checking this clears the current default policy. Orders without an explicit policy and newly created products follow this one.
+     */
     isDefault?: boolean | null;
     metadata?: {
         [k: string]: unknown;
@@ -3395,14 +3413,26 @@ interface Discount {
      * Amount in KRW (won)
      */
     maxDiscountAmount?: number | null;
+    /**
+     * Start of the validity window (empty = starts immediately)
+     */
     startsAt?: string | null;
+    /**
+     * End of the validity window. Must be after the start; empty = never ends.
+     */
     endsAt?: string | null;
     customerSelection?: {
+        /**
+         * Choosing Included or Excluded requires at least one target below.
+         */
         type?: ('all' | 'included' | 'excluded') | null;
         customers?: (string | Customer)[] | null;
         customerGroups?: (string | CustomerGroup)[] | null;
     };
     productSelection?: {
+        /**
+         * Choosing Included or Excluded requires at least one target below.
+         */
         type?: ('all' | 'included' | 'excluded') | null;
         products?: (string | Product)[] | null;
         collections?: (string | ProductCollection)[] | null;
@@ -3416,7 +3446,7 @@ interface Discount {
      */
     pricingMarket?: (string | null) | Market;
     /**
-     * Total usage limit (empty = unlimited)
+     * Total usage limit (1 or more, empty = unlimited)
      */
     maxUses?: number | null;
     /**
@@ -3424,7 +3454,7 @@ interface Discount {
      */
     usesCount?: number | null;
     /**
-     * Usage limit per customer (empty = unlimited)
+     * Usage limit per customer (1 or more, empty = unlimited)
      */
     maxUsesPerCustomer?: number | null;
     /**
@@ -3435,6 +3465,9 @@ interface Discount {
      * Allow combining with other discounts
      */
     isCombinable?: boolean | null;
+    /**
+     * Only across-order allocation is supported. Each-line-item is always rejected at checkout and cannot be saved.
+     */
     allocationMethod?: ('across' | 'each') | null;
     /**
      * Discount priority (higher = first)
@@ -3505,7 +3538,15 @@ interface PaymentSession {
      */
     slotState: 'held' | 'reconciling' | 'released' | 'spent';
     provider: string;
+    /**
+     * Internal execution provenance for managed adapters and the custom bridge.
+     */
+    sessionOrigin?: ('managed_adapter' | 'custom_bridge') | null;
     providerSessionId: string;
+    /**
+     * Provider Hosted URL exposed only through an ownership-checked PaymentSession response.
+     */
+    providerActionUrl?: string | null;
     providerAccount?: (string | null) | CommercePaymentAccount;
     credentialVersion?: number | null;
     environment?: string | null;
@@ -3561,6 +3602,8 @@ interface PaymentSession {
     deletedAt?: string | null;
 }
 /**
+ * Connect a Toss Payments or PortOne account and register its payment credentials.
+ *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "commerce-payment-accounts".
  */
@@ -3573,26 +3616,51 @@ interface CommercePaymentAccount {
      */
     profileName: string;
     /**
-     * Immutable provider account identity (Toss mId / PortOne storeId).
+     * Provider account identity, immutable after registration (Toss mId / PortOne storeId).
      */
     providerAccountKey: string;
     environment: 'test' | 'live';
     markets: (string | Market)[];
     tossConfiguration?: {
+        /**
+         * Toss client key. Must use the test_ / live_ prefix matching the registered environment.
+         */
         clientKey: string;
         secretKey?: string | null;
+        /**
+         * Encrypted on save and never shown again. Leave blank to keep the registered key.
+         */
+        secretKeyInput?: string | null;
+        /**
+         * Toss payment widget payment-method UI key (e.g. DEFAULT).
+         */
         paymentMethodVariantKey: string;
+        /**
+         * Toss payment widget agreement UI key (e.g. AGREEMENT).
+         */
         agreementVariantKey: string;
         paymentMethodPolicy: 'instant_only';
     };
     portOneConfiguration?: {
         apiSecret?: string | null;
+        /**
+         * Encrypted on save and never shown again. Leave blank to keep the registered secret.
+         */
+        apiSecretInput?: string | null;
+        webhookSecret?: string | null;
+        /**
+         * Encrypted on save and never shown again. Leave blank to keep the registered secret.
+         */
+        webhookSecretInput?: string | null;
+        /**
+         * PortOne channel/store profile key.
+         */
         profileKey: string;
         /**
          * Hosted Payment Session country (ISO 3166-1 alpha-2 uppercase).
          */
         country: string;
-        allowedPaymentMethods: ('CARD_KR' | 'N_PAY' | 'KAKAO_PAY' | 'TOSS_PAY')[];
+        allowedPaymentMethods: ('CARD_KR' | 'N_PAY' | 'KAKAO_PAY' | 'TOSS_PAY' | 'CARD_INTERNATIONAL' | 'PAY_PAL' | 'UNION_PAY' | 'ALIPAY_CN' | 'ALIPAY_HK' | 'TRUE_MONEY' | 'DANA' | 'TOUCH_N_GO' | 'G_CASH' | 'WE_CHAT_PAY' | 'KLARNA' | 'E_CONTEXT' | 'GRAB_PAY_MY' | 'GRAB_PAY_SG' | 'SHOPEE_PAY_TH' | 'PAY_PAY' | 'BPI' | 'RABBIT_LINE_PAY' | 'CONVENIENCE_STORE_JP' | 'AMAZON_PAY' | 'RAKUTEN_PAY' | 'D_BARAI' | 'AU_PAY' | 'MERPAY')[];
     };
     /**
      * When enabled, this connection is eligible for new PaymentSessions.
@@ -5837,17 +5905,68 @@ interface PaymentKernelFinancialMovement {
     tenant?: (string | null) | Tenant;
     operation: string | PaymentKernelOperation;
     providerObjectIdentity: string | PaymentKernelProviderObjectIdentity;
-    movementKind: 'capture_confirmed' | 'refund_reservation' | 'refund_confirmed' | 'refund_reservation_release';
+    movementKind: 'capture_confirmed' | 'refund_reservation' | 'refund_confirmed' | 'refund_reservation_release' | 'dispute_loss' | 'reversal' | 'fee' | 'adjustment' | 'settled';
     movementIdentity: string;
     reservationMovement?: (string | null) | PaymentKernelFinancialMovement;
     terminalAttempt?: (string | null) | PaymentKernelOperationAttempt;
     definitivelyFailedAttempt?: (string | null) | PaymentKernelOperationAttempt;
+    providerReceipt?: (string | null) | PaymentKernelProviderReceipt;
     amount: number;
     currency: string;
     effectiveAt: string;
     updatedAt: string;
     createdAt: string;
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payment-kernel-provider-receipts".
+ */
+interface PaymentKernelProviderReceipt {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    provider: string;
+    providerAccountKey: string;
+    environment: 'test' | 'live';
+    providerConnection: string | PaymentKernelProviderConnection;
+    credentialGeneration: string | PaymentKernelCredentialGeneration;
+    providerObjectIdentity?: (string | null) | PaymentKernelProviderObjectIdentity;
+    eventKind: string;
+    eventId: string;
+    bodyHash: string;
+    rawPayload?: string | null;
+    authenticatedAt: string;
+    rawPayloadRetainedUntil: string;
+    rawPayloadRedactedAt?: string | null;
+    state: 'authenticated' | 'conflicting';
+    updatedAt: string;
+    createdAt: string;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payment-kernel-reconciliation-cases".
+ */
+interface PaymentKernelReconciliationCase {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    provider: string;
+    providerAccountKey: string;
+    environment: 'test' | 'live';
+    providerConnection: string | PaymentKernelProviderConnection;
+    currency: string;
+    periodStart: string;
+    periodEnd: string;
+    exceptionIdentity: string;
+    capturedPrincipal: number;
+    refundedPrincipal: number;
+    disputeLoss: number;
+    adjustments: number;
+    fees: number;
+    expectedSettledNet: number;
+    reportedSettledNet: number;
+    state: 'open' | 'reconciled';
+    updatedAt: string;
+    createdAt: string;
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "order-status-logs".
@@ -8397,9 +8516,6 @@ interface Form {
         blockType: 'textarea';
     })[] | null;
     submitButtonLabel?: string | null;
-    /**
-     * Choose whether to display an on-page message or redirect to a different page after they submit the form.
-     */
     confirmationType?: ('message' | 'redirect') | null;
     confirmationMessage?: {
         root: {
@@ -8419,9 +8535,6 @@ interface Form {
     redirect?: {
         url: string;
     };
-    /**
-     * Send custom emails when the form submits. Use comma separated lists to send the same email to multiple recipients. To reference a value from this form, wrap that field's name with double curly brackets, i.e. {{firstName}}. You can use a wildcard {{*}} to output all data and {{*:table}} to format it as an HTML table in the email.
-     */
     emails?: {
         emailTo?: string | null;
         cc?: string | null;
@@ -8429,9 +8542,6 @@ interface Form {
         replyTo?: string | null;
         emailFrom?: string | null;
         subject: string;
-        /**
-         * Enter the message that should be sent in this email.
-         */
         message?: {
             root: {
                 type: string;
@@ -8897,6 +9007,8 @@ interface WebhookOutboxDeliveriesSelect<T extends boolean = true> {
 interface TenantsSelect<T extends boolean = true> {
     webhookPurgeFencedAt?: T;
     name?: T;
+    tenantPurpose?: T;
+    testExpiresAt?: T;
     slug?: T;
     previewDestinations?: T | {
         origin?: T;
@@ -10223,7 +10335,9 @@ interface PaymentSessionsSelect<T extends boolean = true> {
     finalizationStatus?: T;
     slotState?: T;
     provider?: T;
+    sessionOrigin?: T;
     providerSessionId?: T;
+    providerActionUrl?: T;
     providerAccount?: T;
     credentialVersion?: T;
     environment?: T;
@@ -10519,12 +10633,61 @@ interface PaymentKernelFinancialMovementsSelect<T extends boolean = true> {
     reservationMovement?: T;
     terminalAttempt?: T;
     definitivelyFailedAttempt?: T;
+    providerReceipt?: T;
     amount?: T;
     currency?: T;
     effectiveAt?: T;
     updatedAt?: T;
     createdAt?: T;
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payment-kernel-provider-receipts_select".
+ */
+interface PaymentKernelProviderReceiptsSelect<T extends boolean = true> {
+    tenant?: T;
+    provider?: T;
+    providerAccountKey?: T;
+    environment?: T;
+    providerConnection?: T;
+    credentialGeneration?: T;
+    providerObjectIdentity?: T;
+    eventKind?: T;
+    eventId?: T;
+    bodyHash?: T;
+    rawPayload?: T;
+    authenticatedAt?: T;
+    rawPayloadRetainedUntil?: T;
+    rawPayloadRedactedAt?: T;
+    state?: T;
+    updatedAt?: T;
+    createdAt?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payment-kernel-reconciliation-cases_select".
+ */
+interface PaymentKernelReconciliationCasesSelect<T extends boolean = true> {
+    tenant?: T;
+    provider?: T;
+    providerAccountKey?: T;
+    environment?: T;
+    providerConnection?: T;
+    currency?: T;
+    periodStart?: T;
+    periodEnd?: T;
+    exceptionIdentity?: T;
+    capturedPrincipal?: T;
+    refundedPrincipal?: T;
+    disputeLoss?: T;
+    adjustments?: T;
+    fees?: T;
+    expectedSettledNet?: T;
+    reportedSettledNet?: T;
+    state?: T;
+    updatedAt?: T;
+    createdAt?: T;
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "order-status-logs_select".
@@ -12843,12 +13006,16 @@ interface CommercePaymentAccountsSelect<T extends boolean = true> {
     tossConfiguration?: T | {
         clientKey?: T;
         secretKey?: T;
+        secretKeyInput?: T;
         paymentMethodVariantKey?: T;
         agreementVariantKey?: T;
         paymentMethodPolicy?: T;
     };
     portOneConfiguration?: T | {
         apiSecret?: T;
+        apiSecretInput?: T;
+        webhookSecret?: T;
+        webhookSecretInput?: T;
         profileKey?: T;
         country?: T;
         allowedPaymentMethods?: T;

package/dist/query.cjs

@@ -540,34 +540,78 @@ var SDKError = class extends Error {
 };
 var COMMERCE_ERROR_CODES = [
   "validation_failed",
+  "bad_request",
   "unauthorized",
   "forbidden",
+  "account_suspended",
+  "key_invalid",
+  "pat_tenant_header_forbidden",
+  "tenant_mismatch",
+  "test_tenant_expired",
+  "token_invalid",
   "token_expired",
   "origin_not_allowed",
   "server_credentials_required",
+  "role_denied",
+  "scope_denied",
+  "feature_disabled",
   "not_found",
   "conflict",
+  "locked",
   "cart_revision_conflict",
   "rate_limit_exceeded",
   "usage_limit_exceeded",
   "service_unavailable",
   "idempotency_conflict",
   "idempotency_in_progress",
+  "idempotency_key_required",
+  "invalid_idempotency_key",
   "cart_not_active",
   "cart_locked",
   "cart_empty",
   "cart_market_unavailable",
   "cart_market_mismatch",
   "checkout_not_open",
+  "checkout_already_open",
   "payment_slot_held",
   "reservation_expired",
   "payment_session_not_cancelable",
+  "payment_session_conflict",
   "provider_identity_mismatch",
+  "payment_method_unavailable",
   "provider_unavailable",
   "lock_timeout",
   "price_changed",
   "pricing_fact_in_use",
   "insufficient_stock",
+  "reservation_conflict",
+  "stock_lock_unavailable",
+  "variant_not_found",
+  "variant_stock_write_failed",
+  "stock_invariant_violation",
+  "payment_confirmation_in_flight",
+  "checkout_reservation_release_requires_transaction",
+  "admission_metadata_invalid",
+  "admission_metadata_required",
+  "capacity_exceeded",
+  "occurrence_lock_unavailable",
+  "occurrence_not_open",
+  "admission_type_capacity_exceeded",
+  "admission_type_occurrence_mismatch",
+  "admission_hold_expired",
+  "admission_hold_checkout_item_conflict",
+  "admission_hold_checkout_conflict",
+  "admission_hold_quantity_mismatch",
+  "admission_hold_unbound",
+  "admission_hold_missing",
+  "admission_hold_checkout_item_missing",
+  "admission_hold_expiry_failed",
+  "admission_hold_expiry_requires_transaction",
+  "admission_hold_line_item_mismatch",
+  "admission_materialization_failed",
+  "variant_inactive",
+  "variant_product_mismatch",
+  "product_not_public",
   "market_not_found",
   "market_shipping_currency_unsupported",
   "missing_market_rate",
@@ -592,7 +636,11 @@ var COMMERCE_ERROR_CODES = [
   "discount_min_order_amount",
   "discount_currency_scope_required",
   "discount_allocation_method_unsupported",
-  "currency_mismatch"
+  "currency_mismatch",
+  "customer_token_required",
+  "market_required",
+  "server_derived",
+  "internal_error"
 ];
 var COMMERCE_ERROR_CODE_SET = new Set(
   COMMERCE_ERROR_CODES
@@ -757,12 +805,14 @@ function listingPageSearchParams(options) {
 
 // ../../internal/http-contracts/src/index.ts
 var operationBrand = /* @__PURE__ */ Symbol("sdk-http-operation");
-var operation = (collection, method, path) => Object.freeze({
+var operation = (collection, method, path, errorFamily) => Object.freeze({
   [operationBrand]: true,
   collection,
   method,
-  path
+  path,
+  ...errorFamily && { errorFamily }
 });
+var strictCommerceOperation = (collection, method, path) => operation(collection, method, path, "commerce");
 var COMMERCE_ENDPOINT_OPERATIONS = {
   products: {
     detail: operation("products", "get", "/detail"),
@@ -795,13 +845,13 @@ var COMMERCE_ENDPOINT_OPERATIONS = {
     byPayment: operation("orders", "get", "/by-payment"),
     cancel: operation("orders", "post", "/cancel"),
     resolveCancelRefund: operation("orders", "post", "/resolve-cancel-refund"),
-    checkout: operation("orders", "post", "/checkout"),
+    checkout: strictCommerceOperation("orders", "post", "/checkout"),
     createFulfillment: operation("orders", "post", "/create-fulfillment"),
     updateFulfillment: operation("orders", "post", "/update-fulfillment")
   },
   checkouts: {
-    detail: operation("checkouts", "post", "/detail"),
-    query: operation("checkouts", "post", "/query")
+    detail: strictCommerceOperation("checkouts", "post", "/detail"),
+    query: strictCommerceOperation("checkouts", "post", "/query")
   },
   transactions: {
     update: operation("transactions", "post", "/update")
@@ -822,29 +872,58 @@ var COMMERCE_ENDPOINT_OPERATIONS = {
     bulkImport: operation("fulfillments", "post", "/bulk-import")
   },
   carts: {
-    create: operation("carts", "post", "/create"),
-    retrieve: operation("carts", "post", "/retrieve"),
-    mine: operation("carts", "post", "/mine"),
-    merge: operation("carts", "post", "/merge"),
-    addItem: operation("carts", "post", "/add-item"),
-    updateItem: operation("carts", "post", "/update-item"),
-    removeItem: operation("carts", "post", "/remove-item"),
-    updateDiscountCodes: operation("carts", "post", "/update-discount-codes"),
-    updateAttributes: operation("carts", "post", "/update-attributes"),
-    clear: operation("carts", "post", "/clear")
+    create: strictCommerceOperation("carts", "post", "/create"),
+    retrieve: strictCommerceOperation("carts", "post", "/retrieve"),
+    mine: strictCommerceOperation("carts", "post", "/mine"),
+    merge: strictCommerceOperation("carts", "post", "/merge"),
+    addItem: strictCommerceOperation("carts", "post", "/add-item"),
+    updateItem: strictCommerceOperation("carts", "post", "/update-item"),
+    removeItem: strictCommerceOperation("carts", "post", "/remove-item"),
+    updateDiscountCodes: strictCommerceOperation(
+      "carts",
+      "post",
+      "/update-discount-codes"
+    ),
+    updateAttributes: strictCommerceOperation(
+      "carts",
+      "post",
+      "/update-attributes"
+    ),
+    clear: strictCommerceOperation("carts", "post", "/clear")
   },
   paymentSessions: {
-    create: operation("payment-sessions", "post", "/create"),
-    retrieve: operation("payment-sessions", "post", "/retrieve"),
-    cancel: operation("payment-sessions", "post", "/cancel"),
+    create: strictCommerceOperation("payment-sessions", "post", "/create"),
+    retrieve: strictCommerceOperation("payment-sessions", "post", "/retrieve"),
+    cancel: strictCommerceOperation("payment-sessions", "post", "/cancel"),
     server: {
-      create: operation("payment-sessions", "post", "/server/create"),
-      retrieve: operation("payment-sessions", "post", "/server/retrieve"),
-      cancel: operation("payment-sessions", "post", "/server/cancel"),
-      confirm: operation("payment-sessions", "post", "/server/confirm")
+      create: strictCommerceOperation(
+        "payment-sessions",
+        "post",
+        "/server/create"
+      ),
+      retrieve: strictCommerceOperation(
+        "payment-sessions",
+        "post",
+        "/server/retrieve"
+      ),
+      cancel: strictCommerceOperation(
+        "payment-sessions",
+        "post",
+        "/server/cancel"
+      ),
+      confirm: strictCommerceOperation(
+        "payment-sessions",
+        "post",
+        "/server/confirm"
+      )
     },
     custom: {
       create: operation("orders", "post", "/custom-payment-sessions"),
+      retrieve: operation(
+        "orders",
+        "post",
+        "/custom-payment-sessions/retrieve"
+      ),
       confirm: operation("orders", "post", "/custom-payment-sessions/confirm")
     }
   },
@@ -870,6 +949,11 @@ var EVENTS_ENDPOINT_OPERATIONS = {
     )
   }
 };
+var COMMUNITY_ENDPOINT_OPERATIONS = {
+  posts: {
+    detail: operation("posts", "get", "/detail")
+  }
+};
 function resolveOperationTemplate(descriptor) {
   return descriptor.collection ? `/api/${descriptor.collection}${descriptor.path}` : `/api${descriptor.path}`;
 }
@@ -929,12 +1013,12 @@ var COMMERCE_ENDPOINTS = {
     updateFulfillment: endpoint("POST", "/api/orders/update-fulfillment")
   },
   checkouts: {
-    create: endpoint("POST", "/api/orders/checkout"),
-    retrieve: endpoint("POST", "/api/checkouts/detail"),
+    create: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.orders.checkout),
+    retrieve: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.checkouts.detail),
     server: {
-      create: endpoint("POST", "/api/orders/checkout"),
-      retrieve: endpoint("POST", "/api/checkouts/detail"),
-      query: endpoint("POST", "/api/checkouts/query")
+      create: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.orders.checkout),
+      retrieve: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.checkouts.detail),
+      query: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.checkouts.query)
     }
   },
   returns: {
@@ -952,10 +1036,10 @@ var COMMERCE_ENDPOINTS = {
     bulkImport: endpoint("POST", "/api/fulfillments/bulk-import")
   },
   carts: {
-    create: endpoint("POST", "/api/carts/create"),
+    create: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.carts.create),
     retrieve: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.carts.retrieve),
-    mine: endpoint("POST", "/api/carts/mine"),
-    merge: endpoint("POST", "/api/carts/merge"),
+    mine: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.carts.mine),
+    merge: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.carts.merge),
     server: {
       // Server credentials are an authorization lane, not a second Cart
       // transport. These must stay bound to the registered shared operations.
@@ -975,29 +1059,46 @@ var COMMERCE_ENDPOINTS = {
       clear: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.carts.clear)
     },
     addItem: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.carts.addItem),
-    updateItem: endpoint("POST", "/api/carts/update-item"),
-    removeItem: endpoint("POST", "/api/carts/remove-item"),
-    updateDiscountCodes: endpoint("POST", "/api/carts/update-discount-codes"),
-    updateAttributes: endpoint("POST", "/api/carts/update-attributes"),
-    clear: endpoint("POST", "/api/carts/clear")
+    updateItem: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.carts.updateItem),
+    removeItem: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.carts.removeItem),
+    updateDiscountCodes: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.carts.updateDiscountCodes
+    ),
+    updateAttributes: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.carts.updateAttributes
+    ),
+    clear: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.carts.clear)
   },
   paymentSessions: {
-    create: endpoint("POST", "/api/payment-sessions/create"),
-    retrieve: endpoint("POST", "/api/payment-sessions/retrieve"),
-    cancel: endpoint("POST", "/api/payment-sessions/cancel"),
+    create: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.create),
+    retrieve: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.retrieve
+    ),
+    cancel: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.cancel),
     custom: {
       create: sharedEndpoint(
         COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.custom.create
       ),
+      retrieve: sharedEndpoint(
+        COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.custom.retrieve
+      ),
       confirm: sharedEndpoint(
         COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.custom.confirm
       )
     },
     server: {
-      create: endpoint("POST", "/api/payment-sessions/server/create"),
-      retrieve: endpoint("POST", "/api/payment-sessions/server/retrieve"),
-      cancel: endpoint("POST", "/api/payment-sessions/server/cancel"),
-      confirm: endpoint("POST", "/api/payment-sessions/server/confirm")
+      create: sharedEndpoint(
+        COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.create
+      ),
+      retrieve: sharedEndpoint(
+        COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.retrieve
+      ),
+      cancel: sharedEndpoint(
+        COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.cancel
+      ),
+      confirm: sharedEndpoint(
+        COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.confirm
+      )
     }
   },
   shippingPolicies: {