@delopay/sdk 0.144.0 → 0.146.0

package/dist/index.cjs

@@ -4624,6 +4624,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.
@@ -4658,7 +4683,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
@@ -7735,12 +7762,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) {