@delopay/sdk 0.143.0 → 0.145.0

package/dist/internal.cjs

@@ -87,6 +87,7 @@ __export(internal_exports, {
   PANES_MAX: () => PANES_MAX,
   PANE_CATEGORY_KEYS: () => PANE_CATEGORY_KEYS,
   PANE_ICON_KEYS: () => PANE_ICON_KEYS,
+  PaypalDisputes: () => PaypalDisputes,
   PlatformBilling: () => PlatformBilling,
   PlatformFees: () => PlatformFees,
   RTL_CHECKOUT_LOCALES: () => RTL_CHECKOUT_LOCALES,
@@ -1261,6 +1262,52 @@ var Disputes = class {
   }
 };
 
+// src/resources/paypalDisputes.ts
+var PaypalDisputes = class {
+  constructor(request) {
+    this.request = request;
+  }
+  actions(caseId, offset = 0) {
+    return this.request("GET", `/disputes/paypal/cases/${encodeURIComponent(caseId)}/actions`, {
+      query: { offset }
+    });
+  }
+  download(caseId, documentUrl) {
+    const body = { document_url: documentUrl };
+    return this.request(
+      "POST",
+      `/disputes/paypal/cases/${encodeURIComponent(caseId)}/documents/download`,
+      { body }
+    );
+  }
+  list(params) {
+    return this.request("GET", "/disputes/paypal/cases", {
+      query: params
+    });
+  }
+  retrieve(caseId, forceSync = false) {
+    return this.request("GET", `/disputes/paypal/cases/${encodeURIComponent(caseId)}`, {
+      query: { force_sync: forceSync }
+    });
+  }
+  history(caseId, offset = 0) {
+    return this.request("GET", `/disputes/paypal/cases/${encodeURIComponent(caseId)}/history`, {
+      query: { offset }
+    });
+  }
+  import(params) {
+    return this.request("POST", "/disputes/paypal/import", { body: params });
+  }
+  /** The backend checks current provider permissions and deduplicates request_id.
+   * An unknown result requires reconciliation, not a new request ID.
+   */
+  act(caseId, params) {
+    return this.request("POST", `/disputes/paypal/cases/${encodeURIComponent(caseId)}/actions`, {
+      body: params
+    });
+  }
+};
+
 // src/resources/ephemeralKeys.ts
 var EphemeralKeys = class {
   constructor(request) {
@@ -4590,6 +4637,31 @@ var Settlement = class {
   constructor(request) {
     this.request = request;
   }
+  /**
+   * Read signed refund/dispute processor fees and report availability.
+   * Merchant scope and connector grants apply. Empty movements confirm zero
+   * only when the source is reported and complete.
+   * Supply payment_id without year/month for all history. force_sync reads
+   * provider reports for this page; it requires payment_id and limit <= 20,
+   * and never issues a payment, refund or dispute action.
+   * Omit test_mode for every reporting partition of one payment; period
+   * queries default to live. Each source states its reporting partition.
+   */
+  async listProcessorCostEvents(params, options) {
+    return this.request("GET", "/settlement/processor-cost-events", {
+      query: {
+        profile_id: params.profile_id,
+        payment_id: params.payment_id,
+        year: params.year,
+        month: params.month,
+        test_mode: params.test_mode,
+        limit: params.limit,
+        offset: params.offset,
+        force_sync: params.force_sync
+      },
+      ...options
+    });
+  }
   /**
    * Per-shop settlement rollup for the host merchant: unpaid totals and the
    * running current period, one row per shop.
@@ -4624,7 +4696,9 @@ var Settlement = class {
    * **Host-only.** The response is the host's cost base, which a shop owner
    * must never see, so a profile-scoped caller is refused with a 403 rather
    * than given a redacted shell. Gate the surface on the caller's scope
-   * instead of calling it and handling the failure.
+   * instead of calling it and handling the failure. Connector-restricted
+   * roles cannot read this merchant-wide aggregate; fee-event reads retain
+   * their connector grants.
    *
    * Two things not to flatten when rendering the result:
    * `margin_usd` is absent — not zero — whenever `margin_quality` is
@@ -5066,6 +5140,7 @@ var Delopay = class {
     this.paymentLinks = new PaymentLinks(request);
     this.mandates = new Mandates(request);
     this.disputes = new Disputes(request);
+    this.paypalDisputes = new PaypalDisputes(request);
     this.payouts = new Payouts(request);
     this.ephemeralKeys = new EphemeralKeys(request);
     this.events = new Events(request);
@@ -7700,12 +7775,18 @@ var CheckoutSession = class {
    * order that PayPal's buttons or Card Fields attach the buyer's choice to.
    * The client secret is attached automatically.
    *
-   * For PayPal Card Fields (be#1387) pass `payment_method: 'card'` and the
+   * For PayPal Card Fields pass `payment_method: 'card'` and the
    * `merchant_connector_id` the checkout was rendered with; the order id comes
    * back in `next_action.next_action_data.order_id` and is what the SDK's
    * `createOrder` returns. The confirm that captures it sends the same order
    * and account as `payment_method_data.card_reference`.
    *
+   * Send a distinct `Idempotency-Key` through `options.headers` for each new
+   * card submission; reuse it only to retry that same session request. The
+   * returned order is bound to this attempt and account. Sessions cannot
+   * replace an order while authentication or money processing is unresolved,
+   * or after authorization/capture; stale or foreign references are refused.
+   *
    * `POST /payments/{paymentId}/post-session-tokens` (publishable key)
    */
   async postSessionTokens(params, options) {
@@ -8518,6 +8599,23 @@ var AdminPortal = class {
       `/admin-portal/transactions/${encodeURIComponent(paymentId)}/attempts/${encodeURIComponent(attemptId)}/processor-cost`
     );
   }
+  /** Read or refresh signed processor fees for a payment. Internal admin access required. */
+  async getTransactionProcessorCostEvents(paymentId, params = {}) {
+    return this.request(
+      "GET",
+      `/admin-portal/transactions/${encodeURIComponent(paymentId)}/processor-cost-events`,
+      {
+        query: {
+          test_mode: params.test_mode,
+          year: params.year,
+          month: params.month,
+          limit: params.limit,
+          offset: params.offset,
+          force_sync: params.force_sync
+        }
+      }
+    );
+  }
   /** Get the connector health polling interval. `GET /admin-portal/connector-health-config` */
   async getConnectorHealthConfig() {
     return this.request("GET", "/admin-portal/connector-health-config");
@@ -9428,6 +9526,7 @@ var DelopayInternal = class extends Delopay {
   PANES_MAX,
   PANE_CATEGORY_KEYS,
   PANE_ICON_KEYS,
+  PaypalDisputes,
   PlatformBilling,
   PlatformFees,
   RTL_CHECKOUT_LOCALES,