@delopay/sdk 0.49.0 → 0.50.0

package/README.md

@@ -146,6 +146,23 @@ for (const dispute of payment.disputes ?? []) {
 const open = await delopay.disputes.list({ dispute_status: 'dispute_opened' });
 ```
 
+### Inspect why a payment failed
+
+```typescript
+// Every attempt on a payment — including retries across connectors — with its
+// full failure detail (raw code + Delopay-unified, human-readable reason).
+const { size, data } = await delopay.payments.listAttempts('pay_abc123');
+
+for (const attempt of data) {
+  // e.g. "stripe failure — Insufficient funds (51)"
+  console.log(
+    `${attempt.connector ?? 'unknown'} ${attempt.status} — ` +
+      `${attempt.unified_message ?? attempt.error_message ?? 'no error'}` +
+      `${attempt.error_code ? ` (${attempt.error_code})` : ''}`,
+  );
+}
+```
+
 ### Manage shops and gateways
 
 ```typescript

package/dist/{chunk-ABYAZHZC.js → chunk-P45MMRTD.js}

@@ -1060,6 +1060,37 @@ var Payments = class {
     if (Object.keys(query).length === 0) return this.request("GET", path);
     return this.request("GET", path, { query });
   }
+  /**
+   * List every attempt made on a payment, each with its full failure detail
+   * (`error_code` / `error_message`, the Delopay-unified `unified_code` and
+   * `unified_message`, and structured `error_details`).
+   *
+   * Useful for surfacing retries across connectors — e.g. "attempt 1 stripe →
+   * insufficient_funds, attempt 2 adyen → success".
+   *
+   * `GET /payments/{paymentId}/attempts`
+   *
+   * @param paymentId - The payment intent ID whose attempts to list.
+   * @param options - Optional per-call extras: extra `headers`, a `timeout`
+   *   override, and an `AbortSignal`.
+   * @returns The attempt list — `size` plus a `data` array of attempts.
+   * @throws If the payment does not exist or belongs to another merchant (404).
+   *
+   * @example
+   * ```typescript
+   * const { size, data } = await delopay.payments.listAttempts('pay_abc123');
+   * for (const attempt of data) {
+   *   console.log(attempt.status, attempt.unified_message ?? attempt.error_message);
+   * }
+   * ```
+   */
+  async listAttempts(paymentId, options) {
+    return this.request(
+      "GET",
+      `/payments/${encodeURIComponent(paymentId)}/attempts`,
+      options
+    );
+  }
   /**
    * Update an existing payment intent before it is confirmed.
    *
@@ -4024,4 +4055,4 @@ export {
   applyBrandingVariables,
   shadowFor
 };
-//# sourceMappingURL=chunk-ABYAZHZC.js.map
+//# sourceMappingURL=chunk-P45MMRTD.js.map