@delopay/sdk 0.235.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");
@@ -3227,6 +3334,44 @@ var Refunds = class {
     return this.request("POST", "/refunds/list", { body: params });
   }
   // --- OLAP extensions (Task 4.3) ---
+  /**
+   * Refund requests buyers raised from the customer portal, newest first.
+   * Limited to the caller's shop when the caller is scoped to one.
+   * `GET /refund-requests`
+   */
+  async listRequests(params) {
+    return this.request("GET", "/refund-requests", {
+      query: params
+    });
+  }
+  /**
+   * Approve a buyer's refund request with a refund of its payment that has
+   * succeeded, made with `create()` after the buyer asked. Approving records
+   * the decision and moves no money. A refund that is still `pending` or in
+   * `review` is refused: check it again later with `retrieve()` under the same
+   * refund ID and approve once it has succeeded, rather than creating another
+   * refund. `POST /refund-requests/{id}/approve`
+   *
+   * @example
+   * ```typescript
+   * const refund = await delopay.refunds.create({ payment_id: request.payment_id, amount: request.amount });
+   * if (refund.status === 'succeeded') {
+   *   await delopay.refunds.approveRequest(request.id, { refund_id: refund.refund_id });
+   * }
+   * // Otherwise keep refund.refund_id, check it with retrieve() and approve once it has succeeded.
+   * ```
+   */
+  async approveRequest(requestId, params) {
+    return this.request("POST", `/refund-requests/${encodeURIComponent(requestId)}/approve`, {
+      body: params
+    });
+  }
+  /** Decline a buyer's refund request. The buyer sees the reply. `POST /refund-requests/{id}/decline` */
+  async declineRequest(requestId, params) {
+    return this.request("POST", `/refund-requests/${encodeURIComponent(requestId)}/decline`, {
+      body: params
+    });
+  }
   /** List refunds (profile-scoped). `POST /refunds/profile/list` */
   async listByProfile(params) {
     return this.request("POST", "/refunds/profile/list", { body: params });
@@ -6991,6 +7136,29 @@ var BuyerPortal = class {
   async getSession(options) {
     return this.request("GET", "/buyer-portal/session", { ...options });
   }
+  /** The buyer's contact and billing details, and what they may change. */
+  async getProfile(options) {
+    return this.request("GET", "/buyer-portal/profile", { ...options });
+  }
+  /**
+   * Change the buyer's contact and billing details. Fields left out stay as
+   * they are; the merchant decides whether buyers may change them at all.
+   */
+  async updateProfile(params, options) {
+    return this.request("POST", "/buyer-portal/profile", { body: params, ...options });
+  }
+  /**
+   * Ask the shop for a refund of one of the buyer's purchases, named by its
+   * `id` from `listPurchases()`. Nothing is refunded until the shop approves
+   * the request with a refund.
+   */
+  async createRefundRequest(purchaseId, params, options) {
+    return this.request(
+      "POST",
+      `/buyer-portal/purchases/${encodeURIComponent(purchaseId)}/refund-requests`,
+      { body: params, ...options }
+    );
+  }
   async listInvoices(params, options) {
     return this.request("GET", "/buyer-portal/invoices", {
       query: params,