@delopay/sdk 0.50.0 → 0.52.0

package/dist/index.d.cts

@@ -4663,18 +4663,59 @@ declare class DelopayAuthenticationError extends DelopayError {
     });
 }
 
+/**
+ * The payload of a webhook event, tagged by kind.
+ *
+ * Mirrors the backend's `{ "type": …, "object": … }` envelope: `type` names the
+ * payload shape and `object` carries it. Narrow on `content.type` to get a
+ * fully-typed `object`:
+ *
+ * ```typescript
+ * if (event.content.type === 'payment_details') {
+ *   event.content.object.payment_id; // typed as PaymentResponse
+ * }
+ * ```
+ */
+type WebhookContent = {
+    type: 'payment_details';
+    object: PaymentResponse;
+} | {
+    type: 'refund_details';
+    object: RefundResponse;
+} | {
+    type: 'dispute_details';
+    object: DisputeResponse;
+} | {
+    type: 'mandate_details';
+    object: MandateResponse;
+} | {
+    type: 'payout_details';
+    object: PayoutResponse;
+} | {
+    type: 'subscription_details';
+    object: ConfirmSubscriptionResponse;
+};
 /**
  * A parsed and verified Delopay webhook event.
  *
- * The `type` field identifies the event (e.g. `'payment_succeeded'`).
- * Specific event payload shapes are nested under `data`.
+ * Matches the signed wire body exactly:
+ * `{ merchant_id, event_id, event_type, content: { type, object }, timestamp }`.
+ *
+ * - `event_type` identifies the event, e.g. `'payment_succeeded'`.
+ * - `content.type` tags the payload kind, e.g. `'payment_details'`.
+ * - `content.object` is the payload; narrow on `content.type` to type it.
  */
 interface WebhookEvent {
+    /** ID of the merchant that owns this event. */
+    merchant_id: string;
+    /** Unique ID for this event (stable across delivery retries). */
+    event_id: string;
     /** Event type identifier, e.g. `'payment_succeeded'` or `'refund_succeeded'`. */
-    type: string;
-    /** Event payload. Shape depends on `type`. */
-    data: Record<string, unknown>;
-    [key: string]: unknown;
+    event_type: EventType;
+    /** The event payload, tagged by kind. Narrow on `content.type` to type `object`. */
+    content: WebhookContent;
+    /** ISO 8601 timestamp at which the webhook was sent. */
+    timestamp: string;
 }
 declare const Webhooks: {
     /**
@@ -4709,7 +4750,7 @@ declare const Webhooks: {
      *       req.header('x-webhook-signature-512') ?? '',
      *       process.env.DELOPAY_WEBHOOK_SECRET!,
      *     );
-     *     console.log(event.type, event.data);
+     *     console.log(event.event_type, event.content.object);
      *     res.sendStatus(200);
      *   } catch {
      *     res.status(400).send('Invalid signature');

package/dist/index.d.ts

@@ -4663,18 +4663,59 @@ declare class DelopayAuthenticationError extends DelopayError {
     });
 }
 
+/**
+ * The payload of a webhook event, tagged by kind.
+ *
+ * Mirrors the backend's `{ "type": …, "object": … }` envelope: `type` names the
+ * payload shape and `object` carries it. Narrow on `content.type` to get a
+ * fully-typed `object`:
+ *
+ * ```typescript
+ * if (event.content.type === 'payment_details') {
+ *   event.content.object.payment_id; // typed as PaymentResponse
+ * }
+ * ```
+ */
+type WebhookContent = {
+    type: 'payment_details';
+    object: PaymentResponse;
+} | {
+    type: 'refund_details';
+    object: RefundResponse;
+} | {
+    type: 'dispute_details';
+    object: DisputeResponse;
+} | {
+    type: 'mandate_details';
+    object: MandateResponse;
+} | {
+    type: 'payout_details';
+    object: PayoutResponse;
+} | {
+    type: 'subscription_details';
+    object: ConfirmSubscriptionResponse;
+};
 /**
  * A parsed and verified Delopay webhook event.
  *
- * The `type` field identifies the event (e.g. `'payment_succeeded'`).
- * Specific event payload shapes are nested under `data`.
+ * Matches the signed wire body exactly:
+ * `{ merchant_id, event_id, event_type, content: { type, object }, timestamp }`.
+ *
+ * - `event_type` identifies the event, e.g. `'payment_succeeded'`.
+ * - `content.type` tags the payload kind, e.g. `'payment_details'`.
+ * - `content.object` is the payload; narrow on `content.type` to type it.
  */
 interface WebhookEvent {
+    /** ID of the merchant that owns this event. */
+    merchant_id: string;
+    /** Unique ID for this event (stable across delivery retries). */
+    event_id: string;
     /** Event type identifier, e.g. `'payment_succeeded'` or `'refund_succeeded'`. */
-    type: string;
-    /** Event payload. Shape depends on `type`. */
-    data: Record<string, unknown>;
-    [key: string]: unknown;
+    event_type: EventType;
+    /** The event payload, tagged by kind. Narrow on `content.type` to type `object`. */
+    content: WebhookContent;
+    /** ISO 8601 timestamp at which the webhook was sent. */
+    timestamp: string;
 }
 declare const Webhooks: {
     /**
@@ -4709,7 +4750,7 @@ declare const Webhooks: {
      *       req.header('x-webhook-signature-512') ?? '',
      *       process.env.DELOPAY_WEBHOOK_SECRET!,
      *     );
-     *     console.log(event.type, event.data);
+     *     console.log(event.event_type, event.content.object);
      *     res.sendStatus(200);
      *   } catch {
      *     res.status(400).send('Invalid signature');

package/dist/index.js

@@ -49,7 +49,7 @@ import {
   shadowFor,
   surfacePadValue,
   verticalGapValue
-} from "./chunk-P45MMRTD.js";
+} from "./chunk-7EHSQIPR.js";
 export {
   Analytics,
   AnalyticsDashboard,

package/dist/internal.cjs

@@ -2521,7 +2521,7 @@ var Webhooks = {
    *       req.header('x-webhook-signature-512') ?? '',
    *       process.env.DELOPAY_WEBHOOK_SECRET!,
    *     );
-   *     console.log(event.type, event.data);
+   *     console.log(event.event_type, event.content.object);
    *     res.sendStatus(200);
    *   } catch {
    *     res.status(400).send('Invalid signature');
@@ -4148,6 +4148,35 @@ var AdminPortal = class {
       query: params
     });
   }
+  /**
+   * Full detail for a single transaction of ANY merchant — the same
+   * `PaymentResponse` the merchant `payments.retrieve` returns. Admin-scoped:
+   * the JWT (or admin API key) does not need to belong to the payment's
+   * merchant; the backend resolves the owning merchant and reads it read-only
+   * (no connector sync).
+   */
+  async getTransaction(paymentId) {
+    return this.request("GET", `/admin-portal/transactions/${encodeURIComponent(paymentId)}`);
+  }
+  /**
+   * Per-attempt history (retries across connectors, decline reasons) for a
+   * single transaction of ANY merchant.
+   */
+  async getTransactionAttempts(paymentId) {
+    return this.request(
+      "GET",
+      `/admin-portal/transactions/${encodeURIComponent(paymentId)}/attempts`
+    );
+  }
+  /**
+   * Refunds for a single transaction of ANY merchant.
+   */
+  async getTransactionRefunds(paymentId) {
+    return this.request(
+      "GET",
+      `/admin-portal/transactions/${encodeURIComponent(paymentId)}/refunds`
+    );
+  }
   async analytics(params) {
     return this.request("GET", "/admin-portal/analytics", {
       query: params