@delopay/sdk 0.238.0 → 0.240.0

package/dist/index.cjs

@@ -883,6 +883,42 @@ var Connectors = class {
       { body: params }
     );
   }
+  /**
+   * Share a connector with more shops of the same merchant (todos#320).
+   * `POST /account/{accountId}/connectors/{connectorId}/shops`
+   *
+   * Nothing is copied: every shop sends payments to the same account, on the
+   * same credentials and webhook, and the account's limits count them all.
+   */
+  async addShops(accountId, connectorId, params) {
+    return this.request(
+      "POST",
+      `/account/${encodeURIComponent(accountId)}/connectors/${encodeURIComponent(connectorId)}/shops`,
+      { body: params }
+    );
+  }
+  /**
+   * Switch a connector off, or back on, in one shop it serves.
+   * `POST /account/{accountId}/connectors/{connectorId}/shops/{profileId}`
+   */
+  async setShopDisabled(accountId, connectorId, profileId, params) {
+    return this.request(
+      "POST",
+      `/account/${encodeURIComponent(accountId)}/connectors/${encodeURIComponent(connectorId)}/shops/${encodeURIComponent(profileId)}`,
+      { body: params }
+    );
+  }
+  /**
+   * Stop a connector serving one shop it is shared with. The home shop is
+   * refused: it holds the connector's name, limits and webhook.
+   * `DELETE /account/{accountId}/connectors/{connectorId}/shops/{profileId}`
+   */
+  async removeShop(accountId, connectorId, profileId) {
+    return this.request(
+      "DELETE",
+      `/account/${encodeURIComponent(accountId)}/connectors/${encodeURIComponent(connectorId)}/shops/${encodeURIComponent(profileId)}`
+    );
+  }
   // --- Advanced operations (Task 4.8) ---
   /**
    * Run the configuration checks for a vault (VGS) connector account:
@@ -1068,6 +1104,77 @@ var Connectors = class {
       `/account/${encodeURIComponent(merchantId)}/connectors/webhooks/${encodeURIComponent(connectorId)}/sync-events`
     );
   }
+  /**
+   * Read the callback addresses of a connector's payment provider.
+   * `GET /account/{merchantId}/connectors/webhooks/{connectorId}/address`
+   *
+   * One entry per environment: the saved mode and identifier, and for every
+   * credential group the URL the policy asks for (`desired_url`) beside the URL
+   * actually registered at the provider (`registered_url`) with its `status`.
+   * Only `registered` means the provider delivers to the desired URL.
+   *
+   * Available for providers whose webhooks Delopay manages (Stripe, PayPal,
+   * Airwallex, Whop) and for hand-configured ones (Creem, NomuPay,
+   * MicroPayment). Other connectors are refused with a 400.
+   */
+  async getWebhookAddress(merchantId, connectorId) {
+    return this.request(
+      "GET",
+      `/account/${encodeURIComponent(merchantId)}/connectors/webhooks/${encodeURIComponent(connectorId)}/address`
+    );
+  }
+  /**
+   * Validate a proposed callback address without saving it.
+   * `POST /account/{merchantId}/connectors/webhooks/{connectorId}/address/preview`
+   *
+   * Returns the validation errors as `{ field, code }` pairs, the URL every
+   * affected credential group would get, the connector accounts that share it,
+   * and whether saving needs `confirm_shared: true`. Needs the same permission
+   * as saving.
+   *
+   * @example
+   * ```typescript
+   * const preview = await delopay.connectors.previewWebhookAddress('mer_abc', 'mca_xyz', {
+   *   environment: 'live',
+   *   mode: 'anonymous',
+   *   format: { prefix: 'wh-', style: 'alphanumeric', length: 16 },
+   * });
+   * if (!preview.valid) console.warn(preview.errors);
+   * ```
+   */
+  async previewWebhookAddress(merchantId, connectorId, params) {
+    return this.request(
+      "POST",
+      `/account/${encodeURIComponent(merchantId)}/connectors/webhooks/${encodeURIComponent(connectorId)}/address/preview`,
+      { body: params }
+    );
+  }
+  /**
+   * Save the callback address of a connector's payment provider for one
+   * environment.
+   * `PUT /account/{merchantId}/connectors/webhooks/{connectorId}/address`
+   *
+   * The address applies to every connector account of that provider and
+   * environment, so `confirm_shared: true` is required when other accounts are
+   * affected. For a managed provider Delopay then registers the new URL and
+   * keeps the former one accepted; the response reports each credential
+   * group's outcome in `status`. A `pending` or `failed` group keeps receiving
+   * on its previous URL and is retried. For a hand-configured provider the
+   * merchant enters the new `desired_url` at the provider.
+   *
+   * A refused proposal answers 422 with error code `IR_06` and the message
+   * `Webhook address refused: field:code,…`. A save that lost to a concurrent
+   * change of the same address answers 422 with error code `HE_00` and can be
+   * repeated. A caller who may not edit every affected account answers 403.
+   * Address changes are limited per provider and environment (`rate_limit`).
+   */
+  async updateWebhookAddress(merchantId, connectorId, params) {
+    return this.request(
+      "PUT",
+      `/account/${encodeURIComponent(merchantId)}/connectors/webhooks/${encodeURIComponent(connectorId)}/address`,
+      { body: params }
+    );
+  }
   /** List available payment methods. `GET /account/payment-methods` */
   async listPaymentMethods() {
     return this.request("GET", "/account/payment-methods");