@delopay/sdk 0.309.0 → 0.318.0

package/dist/internal.cjs

@@ -825,9 +825,10 @@ var Billing = class {
    * @param params - Auto-recharge settings to update.
    * @returns The updated billing profile.
    */
-  async updateAutoRecharge(merchantId, params) {
+  async updateAutoRecharge(merchantId, params, options) {
     return this.request("PATCH", `/billing/${encodeURIComponent(merchantId)}/auto-recharge`, {
-      body: params
+      body: params,
+      ...options
     });
   }
 };
@@ -1011,12 +1012,13 @@ var Connectors = class {
    *
    * `POST /account/{accountId}/connectors/{connectorId}`
    */
-  async update(accountId, connectorId, params) {
+  async update(accountId, connectorId, params, options) {
     return this.request(
       "POST",
       `/account/${encodeURIComponent(accountId)}/connectors/${encodeURIComponent(connectorId)}`,
       {
-        body: params
+        body: params,
+        ...options
       }
     );
   }
@@ -1580,8 +1582,11 @@ var Customers = class {
    * @param params - Fields to update (name, email, address, metadata, etc.).
    * @returns The updated customer.
    */
-  async update(customerId, params) {
-    return this.request("POST", `/customers/${encodeURIComponent(customerId)}`, { body: params });
+  async update(customerId, params, options) {
+    return this.request("POST", `/customers/${encodeURIComponent(customerId)}`, {
+      body: params,
+      ...options
+    });
   }
   /**
    * Delete a customer and all their saved payment methods.
@@ -2437,8 +2442,11 @@ var Fees = class {
    * @param feeId - The fee schedule ID.
    * @param params - Fields to update.
    */
-  async update(feeId, params) {
-    return this.request("PUT", `/merchant-fees/${encodeURIComponent(feeId)}`, { body: params });
+  async update(feeId, params, options) {
+    return this.request("PUT", `/merchant-fees/${encodeURIComponent(feeId)}`, {
+      body: params,
+      ...options
+    });
   }
   /**
    * Delete a merchant-scoped fee schedule.
@@ -2556,8 +2564,11 @@ var MerchantAccounts = class {
   async retrieve(accountId) {
     return this.request("GET", `/accounts/${encodeURIComponent(accountId)}`);
   }
-  async update(accountId, params) {
-    return this.request("POST", `/accounts/${encodeURIComponent(accountId)}`, { body: params });
+  async update(accountId, params, options) {
+    return this.request("POST", `/accounts/${encodeURIComponent(accountId)}`, {
+      body: params,
+      ...options
+    });
   }
   async delete(accountId) {
     return this.request("DELETE", `/accounts/${encodeURIComponent(accountId)}`);
@@ -3667,12 +3678,13 @@ var Profiles = class {
   async listByProfile(accountId) {
     return this.request("GET", `/account/${encodeURIComponent(accountId)}/profile`);
   }
-  async update(accountId, profileId, params) {
+  async update(accountId, profileId, params, options) {
     return this.request(
       "POST",
       `/account/${encodeURIComponent(accountId)}/business-profile/${encodeURIComponent(profileId)}`,
       {
-        body: params
+        body: params,
+        ...options
       }
     );
   }
@@ -3777,10 +3789,14 @@ var Projects = class {
    * @param merchantId - Optional merchant scope. See {@link Projects.retrieve}.
    * @returns The updated project.
    */
-  async update(projectId, params, merchantId) {
+  async update(projectId, params, merchantId, options) {
     const path = `/projects/${encodeURIComponent(projectId)}`;
-    if (merchantId === void 0) return this.request("PUT", path, { body: params });
-    return this.request("PUT", path, { body: params, query: { merchant_id: merchantId } });
+    if (merchantId === void 0) return this.request("PUT", path, { body: params, ...options });
+    return this.request("PUT", path, {
+      body: params,
+      query: { merchant_id: merchantId },
+      ...options
+    });
   }
   /**
    * Delete a project.
@@ -3923,8 +3939,11 @@ var Refunds = class {
    * @param params - Fields to update (reason, metadata).
    * @returns The updated refund.
    */
-  async update(refundId, params) {
-    return this.request("POST", `/refunds/${encodeURIComponent(refundId)}`, { body: params });
+  async update(refundId, params, options) {
+    return this.request("POST", `/refunds/${encodeURIComponent(refundId)}`, {
+      body: params,
+      ...options
+    });
   }
   /**
    * List refunds, optionally filtered by payment, status, or date range.
@@ -4127,8 +4146,11 @@ var Routing = class {
    * @param params - The fields to change (at least one required).
    * @returns The updated routing configuration including the algorithm body.
    */
-  async update(algorithmId, params) {
-    return this.request("PUT", `/routing/${encodeURIComponent(algorithmId)}`, { body: params });
+  async update(algorithmId, params, options) {
+    return this.request("PUT", `/routing/${encodeURIComponent(algorithmId)}`, {
+      body: params,
+      ...options
+    });
   }
   /**
    * Delete a static routing configuration.
@@ -4305,9 +4327,10 @@ var Routing = class {
     return this.request("GET", `/routing/default/profile/${encodeURIComponent(profileId)}`);
   }
   /** Update default config for a profile. `POST /routing/default/profile/{profileId}` */
-  async updateDefaultProfile(profileId, params) {
+  async updateDefaultProfile(profileId, params, options) {
     return this.request("POST", `/routing/default/profile/${encodeURIComponent(profileId)}`, {
-      body: params
+      body: params,
+      ...options
     });
   }
   /** List routing configs for profile. `GET /routing/list/profile` */
@@ -4336,28 +4359,28 @@ var RoutingDecisionManager = class {
     this.request = request;
   }
   /** Upsert decision manager config. `PUT /routing/decision` */
-  async upsert(params) {
-    return this.request("PUT", "/routing/decision", { body: params });
+  async upsert(params, options) {
+    return this.request("PUT", "/routing/decision", { body: params, ...options });
   }
   /** Retrieve decision manager config. `GET /routing/decision` */
   async retrieve() {
     return this.request("GET", "/routing/decision");
   }
   /** Delete decision manager config. `DELETE /routing/decision` */
-  async delete() {
-    return this.request("DELETE", "/routing/decision");
+  async delete(options) {
+    return this.request("DELETE", "/routing/decision", options);
   }
   /** Upsert surcharge decision config. `PUT /routing/decision/surcharge` */
-  async upsertSurcharge(params) {
-    return this.request("PUT", "/routing/decision/surcharge", { body: params });
+  async upsertSurcharge(params, options) {
+    return this.request("PUT", "/routing/decision/surcharge", { body: params, ...options });
   }
   /** Retrieve surcharge decision config. `GET /routing/decision/surcharge` */
   async retrieveSurcharge() {
     return this.request("GET", "/routing/decision/surcharge");
   }
   /** Delete surcharge decision config. `DELETE /routing/decision/surcharge` */
-  async deleteSurcharge() {
-    return this.request("DELETE", "/routing/decision/surcharge");
+  async deleteSurcharge(options) {
+    return this.request("DELETE", "/routing/decision/surcharge", options);
   }
 };
 var SurchargeRules = class {
@@ -4379,8 +4402,8 @@ var SurchargeRules = class {
    * });
    * ```
    */
-  async upsert(params) {
-    return this.request("PUT", "/routing/surcharge/rules", { body: params });
+  async upsert(params, options) {
+    return this.request("PUT", "/routing/surcharge/rules", { body: params, ...options });
   }
   /**
    * Retrieve the active surcharge program for a scope, or `null` when none is set.
@@ -4401,9 +4424,10 @@ var SurchargeRules = class {
    *
    * @param profileId - Shop scope. Omit for the merchant-wide rule.
    */
-  async delete(profileId) {
+  async delete(profileId, options) {
     return this.request("DELETE", "/routing/surcharge/rules", {
-      query: { profile_id: profileId }
+      query: { profile_id: profileId },
+      ...options
     });
   }
 };
@@ -4784,6 +4808,34 @@ var Shops = class {
       options
     );
   }
+  /**
+   * Read the Test checkout's appearance, used by payments created with
+   * `test_mode: true`. Until its first save, Test follows Live:
+   * `follows_live` is `true` and `payment_link_config` is Live's.
+   *
+   * `GET /shops/{merchantId}/{shopId}/checkout-branding/test`
+   */
+  async retrieveTestCheckoutBranding(merchantId, shopId, options) {
+    return this.request(
+      "GET",
+      `/shops/${encodeURIComponent(merchantId)}/${encodeURIComponent(shopId)}/checkout-branding/test`,
+      options
+    );
+  }
+  /**
+   * Replace the Test checkout's appearance, exactly as
+   * {@link updateCheckoutBranding} replaces Live's. Live is not touched; a
+   * shop whose Test followed Live has its own Test settings from this save on.
+   *
+   * `POST /shops/{merchantId}/{shopId}/checkout-branding/test`
+   */
+  async updateTestCheckoutBranding(merchantId, shopId, params, options) {
+    return this.request(
+      "POST",
+      `/shops/${encodeURIComponent(merchantId)}/${encodeURIComponent(shopId)}/checkout-branding/test`,
+      { body: params, ...options }
+    );
+  }
 };
 
 // src/resources/stripeConnect.ts
@@ -4939,8 +4991,8 @@ var Users = class {
   async getDetails() {
     return this.request("GET", "/user");
   }
-  async update(params) {
-    return this.request("POST", "/user/update", { body: params });
+  async update(params, options) {
+    return this.request("POST", "/user/update", { body: params, ...options });
   }
   /**
    * Read a preference owned by the logged-in user. Missing keys return value null.
@@ -5658,8 +5710,11 @@ var Users = class {
     return this.request("GET", `/user/role/${encodeURIComponent(roleId)}`);
   }
   /** Update role by ID. `PUT /user/role/{roleId}` */
-  async updateRole(roleId, params) {
-    return this.request("PUT", `/user/role/${encodeURIComponent(roleId)}`, { body: params });
+  async updateRole(roleId, params, options) {
+    return this.request("PUT", `/user/role/${encodeURIComponent(roleId)}`, {
+      body: params,
+      ...options
+    });
   }
   /**
    * Delete a custom role. Predefined roles and roles still assigned to
@@ -6236,8 +6291,11 @@ var Analytics = class {
    * clear, and the full `surfaces` list you mean to keep.
    * `PUT /analytics/exclusions/{id}`
    */
-  async updateExclusion(id, rule) {
-    return this.request("PUT", `/analytics/exclusions/${encodeURIComponent(id)}`, { body: rule });
+  async updateExclusion(id, rule, options) {
+    return this.request("PUT", `/analytics/exclusions/${encodeURIComponent(id)}`, {
+      body: rule,
+      ...options
+    });
   }
   /**
    * Delete a stored exclusion. Returns the rule as it was, so a caller can
@@ -6272,7 +6330,16 @@ var Analytics = class {
   async connectorEventLogs(params) {
     return this.request("GET", "/analytics/connector-event-logs", { query: params });
   }
-  /** Get routing event logs. `GET /analytics/routing-event-logs` */
+  /**
+   * Get routing event logs. `GET /analytics/routing-event-logs`
+   *
+   * @deprecated The service answers this only from a ClickHouse analytics
+   * store; with SQL analytics, the default configuration, it answers an
+   * error. To learn why a payment used a connector, read
+   * `payments.routingDecisions(paymentId)`,
+   * the routing decision recorded behind each attempt. This method stays for
+   * compatibility and still sends the same request.
+   */
   async routingEventLogs(params) {
     return this.request("GET", "/analytics/routing-event-logs", { query: params });
   }
@@ -6570,17 +6637,18 @@ var SellToRestrictions = class {
    * The change is recorded in the audit log before it is made.
    * `PUT /sell-to-restrictions/merchant`
    */
-  async updateMerchantPolicy(params) {
-    return this.request("PUT", "/sell-to-restrictions/merchant", { body: params });
+  async updateMerchantPolicy(params, options) {
+    return this.request("PUT", "/sell-to-restrictions/merchant", { body: params, ...options });
   }
   /**
    * Give one shop its own policy, replacing the merchant-wide policy for that
    * shop. An empty `blocked_countries` lifts every restriction for it.
    * `PUT /sell-to-restrictions/shops/{profile_id}`
    */
-  async updateShopOverride(profileId, params) {
+  async updateShopOverride(profileId, params, options) {
     return this.request("PUT", `/sell-to-restrictions/shops/${encodeURIComponent(profileId)}`, {
-      body: params
+      body: params,
+      ...options
     });
   }
   /**
@@ -6588,8 +6656,12 @@ var SellToRestrictions = class {
    * Removing an override the shop does not have changes nothing.
    * `DELETE /sell-to-restrictions/shops/{profile_id}`
    */
-  async deleteShopOverride(profileId) {
-    return this.request("DELETE", `/sell-to-restrictions/shops/${encodeURIComponent(profileId)}`);
+  async deleteShopOverride(profileId, options) {
+    return this.request(
+      "DELETE",
+      `/sell-to-restrictions/shops/${encodeURIComponent(profileId)}`,
+      options
+    );
   }
   /**
    * Which checks each payment path performs, and how this deployment resolves
@@ -8155,10 +8227,11 @@ var ProcessorCosts = class {
    * @param params - The new rate.
    * @param merchantId - The merchant account ID.
    */
-  async replace(scheduleId, params, merchantId) {
+  async replace(scheduleId, params, merchantId, options) {
     return this.request("POST", `/processor-costs/${encodeURIComponent(scheduleId)}/replace`, {
       body: params,
-      query: { merchant_id: merchantId }
+      query: { merchant_id: merchantId },
+      ...options
     });
   }
   /**
@@ -8183,33 +8256,42 @@ var CheckoutMethods = class {
   }
   /**
    * The shop's layout (stored, or derived from its accounts) and every item
-   * it may place. `GET /checkout-methods/{profile_id}`
+   * it may place. Live's by default; `environment: 'test'` reads the Test
+   * checkout's, used by payments with `test_mode: true`, which follows Live's
+   * (`follows_live`) until its first save.
+   * `GET /checkout-methods/{profile_id}` (`/test`)
    */
-  async retrieve(merchantId, profileId) {
-    return this.request("GET", `/checkout-methods/${encodeURIComponent(profileId)}`, {
-      query: { merchant_id: merchantId }
+  async retrieve(merchantId, profileId, params = {}, options) {
+    return this.request("GET", methodsPath(profileId, params.environment), {
+      query: { merchant_id: merchantId },
+      ...options
     });
   }
   /**
    * The same document as {@link retrieve}, on the route that stays open to a
    * reader of the checkout's appearance while the role's payment-data
-   * visibility is restricted. `GET /checkout-methods/{profile_id}/preview`
+   * visibility is restricted.
+   * `GET /checkout-methods/{profile_id}/preview` (`/test/preview`)
    */
-  async preview(merchantId, profileId) {
-    return this.request("GET", `/checkout-methods/${encodeURIComponent(profileId)}/preview`, {
-      query: { merchant_id: merchantId }
+  async preview(merchantId, profileId, params = {}, options) {
+    return this.request("GET", `${methodsPath(profileId, params.environment)}/preview`, {
+      query: { merchant_id: merchantId },
+      ...options
     });
   }
   /**
-   * Replace the shop's layout. The router refuses an express item that does
-   * not draw its own button, more than two rows of two in the express strip,
-   * a title without text, or an item no account of the shop offers.
-   * `PUT /checkout-methods/{profile_id}`
+   * Replace the layout of one environment. The router refuses an express
+   * item that does not draw its own button, more than two rows of two in the
+   * express strip, a title without text, or an item no account of the shop
+   * offers. Pass `options.headers` with the `If-Match` of the version read to
+   * have a save over a newer change refused.
+   * `PUT /checkout-methods/{profile_id}` (`/test`)
    */
-  async update(merchantId, profileId, body) {
-    return this.request("PUT", `/checkout-methods/${encodeURIComponent(profileId)}`, {
+  async update(merchantId, profileId, body, params = {}, options) {
+    return this.request("PUT", methodsPath(profileId, params.environment), {
       query: { merchant_id: merchantId },
-      body
+      body,
+      ...options
     });
   }
   /**
@@ -8259,14 +8341,59 @@ var CheckoutMethods = class {
     });
   }
   /**
-   * Delete the stored layout; the shop is back on the derived one.
-   * `DELETE /checkout-methods/{profile_id}`
+   * Delete the stored layout of one environment; Live is back on the derived
+   * layout, Test follows Live again.
+   * `DELETE /checkout-methods/{profile_id}` (`/test`)
    */
-  async reset(merchantId, profileId) {
-    return this.request("DELETE", `/checkout-methods/${encodeURIComponent(profileId)}`, {
-      query: { merchant_id: merchantId }
+  async reset(merchantId, profileId, params = {}, options) {
+    return this.request("DELETE", methodsPath(profileId, params.environment), {
+      query: { merchant_id: merchantId },
+      ...options
     });
   }
+  /**
+   * The methods a payment of the shop can be limited to through
+   * `allowed_payment_method_types`, in the order its checkout places them, for
+   * one environment. Names methods only, never a processor or account.
+   * `GET /checkout-methods/{profile_id}/payment-method-options` (`/test/…`)
+   */
+  async paymentMethodOptions(merchantId, profileId, params = {}, options) {
+    return this.request(
+      "GET",
+      `${methodsPath(profileId, params.environment)}/payment-method-options`,
+      { query: { merchant_id: merchantId }, ...options }
+    );
+  }
+  /**
+   * What the given redirect rules, saved or not, decide for the buyer the
+   * body describes, and how each rule fared. The buyer's options are the
+   * shop's layout after its availability rules and the cap states; nothing is
+   * stored. Live's checkout by default, `environment: 'test'` for the Test
+   * checkout's. Refused with 422 when the rules are malformed or name an
+   * account that is not the shop's, and with 403 when they name one the
+   * caller may not read.
+   * `POST /checkout-methods/{profile_id}/redirect-rules/test` (`/test/…`)
+   */
+  async testRedirectRules(merchantId, profileId, body, params = {}, options) {
+    return this.request(
+      "POST",
+      `${methodsPath(profileId, params.environment)}/redirect-rules/test`,
+      { query: { merchant_id: merchantId }, body, ...options }
+    );
+  }
+  /**
+   * Hide a connector account from the checkout of the named environments, or
+   * show it again. Its items stay in the layout, listed with
+   * `account_enabled: false`; routing and credentials are not changed.
+   * `PUT /checkout-methods/{profile_id}/accounts/{merchant_connector_id}/visibility`
+   */
+  async setAccountVisibility(merchantId, profileId, merchantConnectorId, body, options) {
+    return this.request(
+      "PUT",
+      `/checkout-methods/${encodeURIComponent(profileId)}/accounts/${encodeURIComponent(merchantConnectorId)}/visibility`,
+      { query: { merchant_id: merchantId }, body, ...options }
+    );
+  }
   /**
    * The shop's checkout entries: separate ways into the hosted checkout of
    * one payment (`?entry=<key>`), such as a card form embedded in the shop's
@@ -8305,6 +8432,10 @@ var CheckoutMethods = class {
     });
   }
 };
+function methodsPath(profileId, environment) {
+  const shop = `/checkout-methods/${encodeURIComponent(profileId)}`;
+  return environment === "test" ? `${shop}/test` : shop;
+}
 function entriesPath(profileId, environment) {
   const shop = `/checkout-methods/${encodeURIComponent(profileId)}`;
   return environment === "test" ? `${shop}/test/entries` : `${shop}/entries`;
@@ -16307,12 +16438,13 @@ var AdminPortal = class {
     return this.request("POST", "/admin-portal/analytics/exclusions/copy", { body });
   }
   /**
-   * Shop comparison for one merchant: one series per shop over one window,
-   * with whole-window and previous-window totals. `merchant_id` is required
-   * (400 without it). Same contract as the merchant surface's
-   * `analytics.shops`. `GET /admin-portal/analytics/shops`
+   * Shop comparison: one series per shop over one window, with whole-window
+   * and previous-window totals. With `merchant_id`, that merchant's shops;
+   * without it, the top `limit` (default 50) shops of every merchant by
+   * successful volume, the rest summed into `others`. Same contract as the
+   * merchant surface's `analytics.shops`. `GET /admin-portal/analytics/shops`
    */
-  async analyticsShops(params) {
+  async analyticsShops(params = {}) {
     const query = params;
     return this.request("GET", "/admin-portal/analytics/shops", {
       query
@@ -16558,11 +16690,13 @@ var AdminPortal = class {
    *
    * Server validates each origin: full origin (scheme + host[:port]),
    * no path/query/fragment, no wildcards.
+   *
+   * `POST /admin-portal/accounts/{merchantId}/business-profile/{profileId}/iframe-origins`
    */
   async updateShopIframeOrigins(merchantId, profileId, origins) {
     return this.request(
       "POST",
-      `/admin-portal/accounts/${encodeURIComponent(merchantId)}/business_profile/${encodeURIComponent(profileId)}/iframe-origins`,
+      `/admin-portal/accounts/${encodeURIComponent(merchantId)}/business-profile/${encodeURIComponent(profileId)}/iframe-origins`,
       { body: { iframe_allowed_origins: origins } }
     );
   }
@@ -16959,6 +17093,74 @@ var AdminPortal = class {
   async getRiskBackfill(jobId) {
     return this.request("GET", `/admin-portal/risk-engine/backfill/${encodeURIComponent(jobId)}`);
   }
+  /**
+   * Where a merchant stands in the risk policy (`merchant_risk.policy`): the
+   * policy in force, the stage, the conditions of the last evaluation with
+   * their evidence, pending and past actions, exemptions and stage changes.
+   *
+   * `GET /admin-portal/accounts/{merchant_id}/risk/stage`
+   */
+  async getMerchantRiskStage(merchantId) {
+    return this.request("GET", `${adminAccount(merchantId)}/risk/stage`);
+  }
+  /**
+   * Evaluate a merchant against its risk policy now, as the scoring pass
+   * does, and answer where it stands afterwards. Needs `AccountManage`.
+   *
+   * `POST /admin-portal/accounts/{merchant_id}/risk/stage/evaluate`
+   */
+  async evaluateMerchantRiskStage(merchantId) {
+    return this.request("POST", `${adminAccount(merchantId)}/risk/stage/evaluate`, { body: {} });
+  }
+  /**
+   * Apply a pending action that waits for an operator. An action already
+   * decided, suppressed or expired is refused with `DE_19` (HTTP 409).
+   *
+   * `POST /admin-portal/accounts/{merchant_id}/risk/actions/{action_id}/confirm`
+   */
+  async confirmMerchantRiskAction(merchantId, actionId, params = {}) {
+    return this.request(
+      "POST",
+      `${adminAccount(merchantId)}/risk/actions/${encodeURIComponent(actionId)}/confirm`,
+      { body: params }
+    );
+  }
+  /**
+   * Dismiss a pending action with a reason; it never applies. An action
+   * already decided is refused with `DE_19` (HTTP 409).
+   *
+   * `POST /admin-portal/accounts/{merchant_id}/risk/actions/{action_id}/dismiss`
+   */
+  async dismissMerchantRiskAction(merchantId, actionId, params) {
+    return this.request(
+      "POST",
+      `${adminAccount(merchantId)}/risk/actions/${encodeURIComponent(actionId)}/dismiss`,
+      { body: params }
+    );
+  }
+  /**
+   * Exempt a merchant from one action for one risk dimension, until
+   * `expires_at` or for good. An exempted action is recorded as `suppressed`
+   * with the exemption's id; the stage itself is still entered.
+   *
+   * `POST /admin-portal/accounts/{merchant_id}/risk/exemptions`
+   */
+  async createMerchantRiskExemption(merchantId, params) {
+    return this.request("POST", `${adminAccount(merchantId)}/risk/exemptions`, { body: params });
+  }
+  /**
+   * End an exemption now, with a reason. It no longer suppresses anything
+   * from the next evaluation on.
+   *
+   * `POST /admin-portal/accounts/{merchant_id}/risk/exemptions/{exemption_id}/revoke`
+   */
+  async revokeMerchantRiskExemption(merchantId, exemptionId, params) {
+    return this.request(
+      "POST",
+      `${adminAccount(merchantId)}/risk/exemptions/${encodeURIComponent(exemptionId)}/revoke`,
+      { body: params }
+    );
+  }
 };
 function transactionListQuery(params) {
   if (!params) return void 0;