@open-mercato/gateway-stripe 0.6.7-develop.6572.1.3d8e83062f → 0.6.7-develop.6574.1.05dcf72ba8

package/dist/modules/gateway_stripe/lib/adapters/v2023-10-16.js

@@ -5,7 +5,9 @@ import {
   fromCents,
   buildStripeMetadata,
   normalizeStripePaymentElementSettings,
-  resolveStripeRendererKey
+  resolveStripeRendererKey,
+  resolveStripeRefundStatus,
+  stripeIdempotencyOptions
 } from "../shared.js";
 import { verifyStripeWebhook } from "../webhook-handler.js";
 const stripeAdapterV20231016 = {
@@ -49,9 +51,13 @@ const stripeAdapterV20231016 = {
   async capture(input) {
     const stripe = resolveStripeClient(input.credentials, "2023-10-16");
     const paymentIntent = input.amount ? await stripe.paymentIntents.retrieve(input.sessionId) : null;
-    const captured = await stripe.paymentIntents.capture(input.sessionId, {
-      amount_to_capture: input.amount && paymentIntent ? toCents(input.amount, paymentIntent.currency) : void 0
-    });
+    const captured = await stripe.paymentIntents.capture(
+      input.sessionId,
+      {
+        amount_to_capture: input.amount && paymentIntent ? toCents(input.amount, paymentIntent.currency) : void 0
+      },
+      stripeIdempotencyOptions(input.idempotencyKey)
+    );
     return {
       status: mapStripeStatus(captured.status),
       capturedAmount: fromCents(captured.amount_received, captured.currency),
@@ -61,20 +67,27 @@ const stripeAdapterV20231016 = {
   async refund(input) {
     const stripe = resolveStripeClient(input.credentials, "2023-10-16");
     const paymentIntent = input.amount ? await stripe.paymentIntents.retrieve(input.sessionId) : null;
-    const refund = await stripe.refunds.create({
-      payment_intent: input.sessionId,
-      amount: input.amount && paymentIntent ? toCents(input.amount, paymentIntent.currency) : void 0,
-      reason: mapRefundReason(input.reason)
-    });
+    const refund = await stripe.refunds.create(
+      {
+        payment_intent: input.sessionId,
+        amount: input.amount && paymentIntent ? toCents(input.amount, paymentIntent.currency) : void 0,
+        reason: mapRefundReason(input.reason)
+      },
+      stripeIdempotencyOptions(input.idempotencyKey)
+    );
     return {
       refundId: refund.id,
-      status: refund.status === "succeeded" ? "refunded" : "pending",
+      status: await resolveStripeRefundStatus(stripe, refund, paymentIntent?.amount_received),
       refundedAmount: fromCents(refund.amount, refund.currency)
     };
   },
   async cancel(input) {
     const stripe = resolveStripeClient(input.credentials, "2023-10-16");
-    const cancelled = await stripe.paymentIntents.cancel(input.sessionId);
+    const cancelled = await stripe.paymentIntents.cancel(
+      input.sessionId,
+      {},
+      stripeIdempotencyOptions(input.idempotencyKey)
+    );
     return { status: mapStripeStatus(cancelled.status) };
   },
   async getStatus(input) {

package/dist/modules/gateway_stripe/lib/adapters/v2023-10-16.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/modules/gateway_stripe/lib/adapters/v2023-10-16.ts"],
-  "sourcesContent": ["import type {\n  GatewayAdapter,\n  CreateSessionInput,\n  CreateSessionResult,\n  CaptureInput,\n  CaptureResult,\n  RefundInput,\n  RefundResult,\n  CancelInput,\n  CancelResult,\n  GetStatusInput,\n  GatewayPaymentStatus,\n  VerifyWebhookInput,\n  WebhookEvent,\n  UnifiedPaymentStatus,\n} from '@open-mercato/shared/modules/payment_gateways/types'\nimport { resolveStripeClient } from '../client'\nimport { mapRefundReason, mapStripeStatus, mapWebhookEventToStatus } from '../status-map'\nimport {\n  toCents,\n  fromCents,\n  buildStripeMetadata,\n  normalizeStripePaymentElementSettings,\n  resolveStripeRendererKey,\n} from '../shared'\nimport { verifyStripeWebhook } from '../webhook-handler'\n\nexport const stripeAdapterV20231016: GatewayAdapter = {\n  providerKey: 'stripe',\n\n  async createSession(input: CreateSessionInput): Promise<CreateSessionResult> {\n    const stripe = resolveStripeClient(input.credentials, '2023-10-16')\n    const rendererKey = resolveStripeRendererKey(input.presentation)\n    const rendererSettings = normalizeStripePaymentElementSettings(input.presentation?.rendererSettings)\n\n    const paymentIntent = await stripe.paymentIntents.create({\n      amount: toCents(input.amount, input.currencyCode),\n      currency: input.currencyCode.toLowerCase(),\n      capture_method: input.captureMethod ?? 'automatic',\n      metadata: buildStripeMetadata({\n        paymentId: input.paymentId,\n        tenantId: input.tenantId,\n        organizationId: input.organizationId,\n        orderId: input.orderId,\n      }),\n      payment_method_types: input.paymentTypes ?? ['card'],\n      description: input.description,\n    }, input.idempotencyKey ? { idempotencyKey: input.idempotencyKey } : undefined)\n\n    return {\n      sessionId: paymentIntent.id,\n      clientSecret: paymentIntent.client_secret ?? undefined,\n      status: mapStripeStatus(paymentIntent.status),\n      providerData: {\n        paymentIntentId: paymentIntent.id,\n        publishableKey: typeof input.credentials.publishableKey === 'string'\n          ? input.credentials.publishableKey\n          : undefined,\n      },\n      clientSession: paymentIntent.client_secret && typeof input.credentials.publishableKey === 'string'\n        ? {\n            type: 'embedded',\n            rendererKey,\n            payload: {\n              clientSecret: paymentIntent.client_secret,\n              publishableKey: input.credentials.publishableKey,\n            },\n            settings: rendererSettings,\n          }\n        : undefined,\n    }\n  },\n\n  async capture(input: CaptureInput): Promise<CaptureResult> {\n    const stripe = resolveStripeClient(input.credentials, '2023-10-16')\n    const paymentIntent = input.amount\n      ? await stripe.paymentIntents.retrieve(input.sessionId)\n      : null\n    const captured = await stripe.paymentIntents.capture(input.sessionId, {\n      amount_to_capture: input.amount && paymentIntent\n        ? toCents(input.amount, paymentIntent.currency)\n        : undefined,\n    })\n    return {\n      status: mapStripeStatus(captured.status),\n      capturedAmount: fromCents(captured.amount_received, captured.currency),\n      providerData: { chargeId: captured.latest_charge },\n    }\n  },\n\n  async refund(input: RefundInput): Promise<RefundResult> {\n    const stripe = resolveStripeClient(input.credentials, '2023-10-16')\n    const paymentIntent = input.amount\n      ? await stripe.paymentIntents.retrieve(input.sessionId)\n      : null\n    const refund = await stripe.refunds.create({\n      payment_intent: input.sessionId,\n      amount: input.amount && paymentIntent\n        ? toCents(input.amount, paymentIntent.currency)\n        : undefined,\n      reason: mapRefundReason(input.reason),\n    })\n    return {\n      refundId: refund.id,\n      status: refund.status === 'succeeded' ? 'refunded' : 'pending',\n      refundedAmount: fromCents(refund.amount, refund.currency),\n    }\n  },\n\n  async cancel(input: CancelInput): Promise<CancelResult> {\n    const stripe = resolveStripeClient(input.credentials, '2023-10-16')\n    const cancelled = await stripe.paymentIntents.cancel(input.sessionId)\n    return { status: mapStripeStatus(cancelled.status) }\n  },\n\n  async getStatus(input: GetStatusInput): Promise<GatewayPaymentStatus> {\n    const stripe = resolveStripeClient(input.credentials, '2023-10-16')\n    const pi = await stripe.paymentIntents.retrieve(input.sessionId)\n    return {\n      status: mapStripeStatus(pi.status),\n      amount: fromCents(pi.amount, pi.currency),\n      amountReceived: fromCents(pi.amount_received, pi.currency),\n      currencyCode: pi.currency.toUpperCase(),\n    }\n  },\n\n  async verifyWebhook(input: VerifyWebhookInput): Promise<WebhookEvent> {\n    return verifyStripeWebhook(input)\n  },\n\n  mapStatus(providerStatus: string, eventType?: string): UnifiedPaymentStatus {\n    if (eventType) {\n      const mappedEvent = mapWebhookEventToStatus(eventType)\n      if (mappedEvent) return mappedEvent\n    }\n    return mapStripeStatus(providerStatus)\n  },\n}\n"],
-  "mappings": "AAgBA,SAAS,2BAA2B;AACpC,SAAS,iBAAiB,iBAAiB,+BAA+B;AAC1E;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,2BAA2B;AAE7B,MAAM,yBAAyC;AAAA,EACpD,aAAa;AAAA,EAEb,MAAM,cAAc,OAAyD;AAC3E,UAAM,SAAS,oBAAoB,MAAM,aAAa,YAAY;AAClE,UAAM,cAAc,yBAAyB,MAAM,YAAY;AAC/D,UAAM,mBAAmB,sCAAsC,MAAM,cAAc,gBAAgB;AAEnG,UAAM,gBAAgB,MAAM,OAAO,eAAe,OAAO;AAAA,MACvD,QAAQ,QAAQ,MAAM,QAAQ,MAAM,YAAY;AAAA,MAChD,UAAU,MAAM,aAAa,YAAY;AAAA,MACzC,gBAAgB,MAAM,iBAAiB;AAAA,MACvC,UAAU,oBAAoB;AAAA,QAC5B,WAAW,MAAM;AAAA,QACjB,UAAU,MAAM;AAAA,QAChB,gBAAgB,MAAM;AAAA,QACtB,SAAS,MAAM;AAAA,MACjB,CAAC;AAAA,MACD,sBAAsB,MAAM,gBAAgB,CAAC,MAAM;AAAA,MACnD,aAAa,MAAM;AAAA,IACrB,GAAG,MAAM,iBAAiB,EAAE,gBAAgB,MAAM,eAAe,IAAI,MAAS;AAE9E,WAAO;AAAA,MACL,WAAW,cAAc;AAAA,MACzB,cAAc,cAAc,iBAAiB;AAAA,MAC7C,QAAQ,gBAAgB,cAAc,MAAM;AAAA,MAC5C,cAAc;AAAA,QACZ,iBAAiB,cAAc;AAAA,QAC/B,gBAAgB,OAAO,MAAM,YAAY,mBAAmB,WACxD,MAAM,YAAY,iBAClB;AAAA,MACN;AAAA,MACA,eAAe,cAAc,iBAAiB,OAAO,MAAM,YAAY,mBAAmB,WACtF;AAAA,QACE,MAAM;AAAA,QACN;AAAA,QACA,SAAS;AAAA,UACP,cAAc,cAAc;AAAA,UAC5B,gBAAgB,MAAM,YAAY;AAAA,QACpC;AAAA,QACA,UAAU;AAAA,MACZ,IACA;AAAA,IACN;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,OAA6C;AACzD,UAAM,SAAS,oBAAoB,MAAM,aAAa,YAAY;AAClE,UAAM,gBAAgB,MAAM,SACxB,MAAM,OAAO,eAAe,SAAS,MAAM,SAAS,IACpD;AACJ,UAAM,WAAW,MAAM,OAAO,eAAe,QAAQ,MAAM,WAAW;AAAA,MACpE,mBAAmB,MAAM,UAAU,gBAC/B,QAAQ,MAAM,QAAQ,cAAc,QAAQ,IAC5C;AAAA,IACN,CAAC;AACD,WAAO;AAAA,MACL,QAAQ,gBAAgB,SAAS,MAAM;AAAA,MACvC,gBAAgB,UAAU,SAAS,iBAAiB,SAAS,QAAQ;AAAA,MACrE,cAAc,EAAE,UAAU,SAAS,cAAc;AAAA,IACnD;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,OAA2C;AACtD,UAAM,SAAS,oBAAoB,MAAM,aAAa,YAAY;AAClE,UAAM,gBAAgB,MAAM,SACxB,MAAM,OAAO,eAAe,SAAS,MAAM,SAAS,IACpD;AACJ,UAAM,SAAS,MAAM,OAAO,QAAQ,OAAO;AAAA,MACzC,gBAAgB,MAAM;AAAA,MACtB,QAAQ,MAAM,UAAU,gBACpB,QAAQ,MAAM,QAAQ,cAAc,QAAQ,IAC5C;AAAA,MACJ,QAAQ,gBAAgB,MAAM,MAAM;AAAA,IACtC,CAAC;AACD,WAAO;AAAA,MACL,UAAU,OAAO;AAAA,MACjB,QAAQ,OAAO,WAAW,cAAc,aAAa;AAAA,MACrD,gBAAgB,UAAU,OAAO,QAAQ,OAAO,QAAQ;AAAA,IAC1D;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,OAA2C;AACtD,UAAM,SAAS,oBAAoB,MAAM,aAAa,YAAY;AAClE,UAAM,YAAY,MAAM,OAAO,eAAe,OAAO,MAAM,SAAS;AACpE,WAAO,EAAE,QAAQ,gBAAgB,UAAU,MAAM,EAAE;AAAA,EACrD;AAAA,EAEA,MAAM,UAAU,OAAsD;AACpE,UAAM,SAAS,oBAAoB,MAAM,aAAa,YAAY;AAClE,UAAM,KAAK,MAAM,OAAO,eAAe,SAAS,MAAM,SAAS;AAC/D,WAAO;AAAA,MACL,QAAQ,gBAAgB,GAAG,MAAM;AAAA,MACjC,QAAQ,UAAU,GAAG,QAAQ,GAAG,QAAQ;AAAA,MACxC,gBAAgB,UAAU,GAAG,iBAAiB,GAAG,QAAQ;AAAA,MACzD,cAAc,GAAG,SAAS,YAAY;AAAA,IACxC;AAAA,EACF;AAAA,EAEA,MAAM,cAAc,OAAkD;AACpE,WAAO,oBAAoB,KAAK;AAAA,EAClC;AAAA,EAEA,UAAU,gBAAwB,WAA0C;AAC1E,QAAI,WAAW;AACb,YAAM,cAAc,wBAAwB,SAAS;AACrD,UAAI,YAAa,QAAO;AAAA,IAC1B;AACA,WAAO,gBAAgB,cAAc;AAAA,EACvC;AACF;",
+  "sourcesContent": ["import type {\n  GatewayAdapter,\n  CreateSessionInput,\n  CreateSessionResult,\n  CaptureInput,\n  CaptureResult,\n  RefundInput,\n  RefundResult,\n  CancelInput,\n  CancelResult,\n  GetStatusInput,\n  GatewayPaymentStatus,\n  VerifyWebhookInput,\n  WebhookEvent,\n  UnifiedPaymentStatus,\n} from '@open-mercato/shared/modules/payment_gateways/types'\nimport { resolveStripeClient } from '../client'\nimport { mapRefundReason, mapStripeStatus, mapWebhookEventToStatus } from '../status-map'\nimport {\n  toCents,\n  fromCents,\n  buildStripeMetadata,\n  normalizeStripePaymentElementSettings,\n  resolveStripeRendererKey,\n  resolveStripeRefundStatus,\n  stripeIdempotencyOptions,\n} from '../shared'\nimport { verifyStripeWebhook } from '../webhook-handler'\n\nexport const stripeAdapterV20231016: GatewayAdapter = {\n  providerKey: 'stripe',\n\n  async createSession(input: CreateSessionInput): Promise<CreateSessionResult> {\n    const stripe = resolveStripeClient(input.credentials, '2023-10-16')\n    const rendererKey = resolveStripeRendererKey(input.presentation)\n    const rendererSettings = normalizeStripePaymentElementSettings(input.presentation?.rendererSettings)\n\n    const paymentIntent = await stripe.paymentIntents.create({\n      amount: toCents(input.amount, input.currencyCode),\n      currency: input.currencyCode.toLowerCase(),\n      capture_method: input.captureMethod ?? 'automatic',\n      metadata: buildStripeMetadata({\n        paymentId: input.paymentId,\n        tenantId: input.tenantId,\n        organizationId: input.organizationId,\n        orderId: input.orderId,\n      }),\n      payment_method_types: input.paymentTypes ?? ['card'],\n      description: input.description,\n    }, input.idempotencyKey ? { idempotencyKey: input.idempotencyKey } : undefined)\n\n    return {\n      sessionId: paymentIntent.id,\n      clientSecret: paymentIntent.client_secret ?? undefined,\n      status: mapStripeStatus(paymentIntent.status),\n      providerData: {\n        paymentIntentId: paymentIntent.id,\n        publishableKey: typeof input.credentials.publishableKey === 'string'\n          ? input.credentials.publishableKey\n          : undefined,\n      },\n      clientSession: paymentIntent.client_secret && typeof input.credentials.publishableKey === 'string'\n        ? {\n            type: 'embedded',\n            rendererKey,\n            payload: {\n              clientSecret: paymentIntent.client_secret,\n              publishableKey: input.credentials.publishableKey,\n            },\n            settings: rendererSettings,\n          }\n        : undefined,\n    }\n  },\n\n  async capture(input: CaptureInput): Promise<CaptureResult> {\n    const stripe = resolveStripeClient(input.credentials, '2023-10-16')\n    const paymentIntent = input.amount\n      ? await stripe.paymentIntents.retrieve(input.sessionId)\n      : null\n    const captured = await stripe.paymentIntents.capture(\n      input.sessionId,\n      {\n        amount_to_capture: input.amount && paymentIntent\n          ? toCents(input.amount, paymentIntent.currency)\n          : undefined,\n      },\n      stripeIdempotencyOptions(input.idempotencyKey),\n    )\n    return {\n      status: mapStripeStatus(captured.status),\n      capturedAmount: fromCents(captured.amount_received, captured.currency),\n      providerData: { chargeId: captured.latest_charge },\n    }\n  },\n\n  async refund(input: RefundInput): Promise<RefundResult> {\n    const stripe = resolveStripeClient(input.credentials, '2023-10-16')\n    const paymentIntent = input.amount\n      ? await stripe.paymentIntents.retrieve(input.sessionId)\n      : null\n    const refund = await stripe.refunds.create(\n      {\n        payment_intent: input.sessionId,\n        amount: input.amount && paymentIntent\n          ? toCents(input.amount, paymentIntent.currency)\n          : undefined,\n        reason: mapRefundReason(input.reason),\n      },\n      stripeIdempotencyOptions(input.idempotencyKey),\n    )\n    return {\n      refundId: refund.id,\n      status: await resolveStripeRefundStatus(stripe, refund, paymentIntent?.amount_received),\n      refundedAmount: fromCents(refund.amount, refund.currency),\n    }\n  },\n\n  async cancel(input: CancelInput): Promise<CancelResult> {\n    const stripe = resolveStripeClient(input.credentials, '2023-10-16')\n    const cancelled = await stripe.paymentIntents.cancel(\n      input.sessionId,\n      {},\n      stripeIdempotencyOptions(input.idempotencyKey),\n    )\n    return { status: mapStripeStatus(cancelled.status) }\n  },\n\n  async getStatus(input: GetStatusInput): Promise<GatewayPaymentStatus> {\n    const stripe = resolveStripeClient(input.credentials, '2023-10-16')\n    const pi = await stripe.paymentIntents.retrieve(input.sessionId)\n    return {\n      status: mapStripeStatus(pi.status),\n      amount: fromCents(pi.amount, pi.currency),\n      amountReceived: fromCents(pi.amount_received, pi.currency),\n      currencyCode: pi.currency.toUpperCase(),\n    }\n  },\n\n  async verifyWebhook(input: VerifyWebhookInput): Promise<WebhookEvent> {\n    return verifyStripeWebhook(input)\n  },\n\n  mapStatus(providerStatus: string, eventType?: string): UnifiedPaymentStatus {\n    if (eventType) {\n      const mappedEvent = mapWebhookEventToStatus(eventType)\n      if (mappedEvent) return mappedEvent\n    }\n    return mapStripeStatus(providerStatus)\n  },\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/gateway_stripe/lib/adapters/v2024-12-18.js

@@ -5,7 +5,9 @@ import {
   fromCents,
   buildStripeMetadata,
   normalizeStripePaymentElementSettings,
-  resolveStripeRendererKey
+  resolveStripeRendererKey,
+  resolveStripeRefundStatus,
+  stripeIdempotencyOptions
 } from "../shared.js";
 import { verifyStripeWebhook } from "../webhook-handler.js";
 const STRIPE_API_VERSION = "2024-12-18";
@@ -50,9 +52,13 @@ const stripeAdapterV20241218 = {
   async capture(input) {
     const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION);
     const paymentIntent = input.amount ? await stripe.paymentIntents.retrieve(input.sessionId) : null;
-    const captured = await stripe.paymentIntents.capture(input.sessionId, {
-      amount_to_capture: input.amount && paymentIntent ? toCents(input.amount, paymentIntent.currency) : void 0
-    });
+    const captured = await stripe.paymentIntents.capture(
+      input.sessionId,
+      {
+        amount_to_capture: input.amount && paymentIntent ? toCents(input.amount, paymentIntent.currency) : void 0
+      },
+      stripeIdempotencyOptions(input.idempotencyKey)
+    );
     const capturedCurrencyCode = captured.currency.toUpperCase();
     return {
       status: mapStripeStatus(captured.status),
@@ -63,24 +69,29 @@ const stripeAdapterV20241218 = {
   async refund(input) {
     const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION);
     const paymentIntent = input.amount ? await stripe.paymentIntents.retrieve(input.sessionId) : null;
-    const refund = await stripe.refunds.create({
-      payment_intent: input.sessionId,
-      amount: input.amount && paymentIntent ? toCents(input.amount, paymentIntent.currency) : void 0,
-      reason: mapRefundReason(input.reason),
-      metadata: input.metadata
-    });
+    const refund = await stripe.refunds.create(
+      {
+        payment_intent: input.sessionId,
+        amount: input.amount && paymentIntent ? toCents(input.amount, paymentIntent.currency) : void 0,
+        reason: mapRefundReason(input.reason),
+        metadata: input.metadata
+      },
+      stripeIdempotencyOptions(input.idempotencyKey)
+    );
     const refundCurrencyCode = refund.currency.toUpperCase();
     return {
       refundId: refund.id,
-      status: refund.status === "succeeded" ? "refunded" : "pending",
+      status: await resolveStripeRefundStatus(stripe, refund, paymentIntent?.amount_received),
       refundedAmount: fromCents(refund.amount, refundCurrencyCode)
     };
   },
   async cancel(input) {
     const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION);
-    const cancelled = await stripe.paymentIntents.cancel(input.sessionId, {
-      cancellation_reason: "requested_by_customer"
-    });
+    const cancelled = await stripe.paymentIntents.cancel(
+      input.sessionId,
+      { cancellation_reason: "requested_by_customer" },
+      stripeIdempotencyOptions(input.idempotencyKey)
+    );
     return {
       status: mapStripeStatus(cancelled.status)
     };

package/dist/modules/gateway_stripe/lib/adapters/v2024-12-18.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/modules/gateway_stripe/lib/adapters/v2024-12-18.ts"],
-  "sourcesContent": ["import type {\n  GatewayAdapter,\n  CreateSessionInput,\n  CreateSessionResult,\n  CaptureInput,\n  CaptureResult,\n  RefundInput,\n  RefundResult,\n  CancelInput,\n  CancelResult,\n  GetStatusInput,\n  GatewayPaymentStatus,\n  VerifyWebhookInput,\n  WebhookEvent,\n  UnifiedPaymentStatus,\n} from '@open-mercato/shared/modules/payment_gateways/types'\nimport { resolveStripeClient } from '../client'\nimport { mapRefundReason, mapStripeStatus, mapWebhookEventToStatus } from '../status-map'\nimport {\n  toCents,\n  fromCents,\n  buildStripeMetadata,\n  normalizeStripePaymentElementSettings,\n  resolveStripeRendererKey,\n} from '../shared'\nimport { verifyStripeWebhook } from '../webhook-handler'\n\nconst STRIPE_API_VERSION = '2024-12-18'\n\nexport const stripeAdapterV20241218: GatewayAdapter = {\n  providerKey: 'stripe',\n\n  async createSession(input: CreateSessionInput): Promise<CreateSessionResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n    const rendererKey = resolveStripeRendererKey(input.presentation)\n    const rendererSettings = normalizeStripePaymentElementSettings(input.presentation?.rendererSettings)\n\n    const paymentIntent = await stripe.paymentIntents.create({\n      amount: toCents(input.amount, input.currencyCode),\n      currency: input.currencyCode.toLowerCase(),\n      capture_method: input.captureMethod ?? 'automatic',\n      metadata: buildStripeMetadata({\n        paymentId: input.paymentId,\n        tenantId: input.tenantId,\n        organizationId: input.organizationId,\n        orderId: input.orderId,\n      }),\n      payment_method_types: input.paymentTypes ?? ['card'],\n      description: input.description,\n    }, input.idempotencyKey ? { idempotencyKey: input.idempotencyKey } : undefined)\n\n    return {\n      sessionId: paymentIntent.id,\n      clientSecret: paymentIntent.client_secret ?? undefined,\n      status: mapStripeStatus(paymentIntent.status),\n      providerData: {\n        paymentIntentId: paymentIntent.id,\n        publishableKey: typeof input.credentials.publishableKey === 'string'\n          ? input.credentials.publishableKey\n          : undefined,\n      },\n      clientSession: paymentIntent.client_secret && typeof input.credentials.publishableKey === 'string'\n        ? {\n            type: 'embedded',\n            rendererKey,\n            payload: {\n              clientSecret: paymentIntent.client_secret,\n              publishableKey: input.credentials.publishableKey,\n            },\n            settings: rendererSettings,\n          }\n        : undefined,\n    }\n  },\n\n  async capture(input: CaptureInput): Promise<CaptureResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n    const paymentIntent = input.amount\n      ? await stripe.paymentIntents.retrieve(input.sessionId)\n      : null\n\n    const captured = await stripe.paymentIntents.capture(input.sessionId, {\n      amount_to_capture: input.amount && paymentIntent\n        ? toCents(input.amount, paymentIntent.currency)\n        : undefined,\n    })\n\n    const capturedCurrencyCode = captured.currency.toUpperCase()\n\n    return {\n      status: mapStripeStatus(captured.status),\n      capturedAmount: fromCents(captured.amount_received, capturedCurrencyCode),\n      providerData: { chargeId: captured.latest_charge },\n    }\n  },\n\n  async refund(input: RefundInput): Promise<RefundResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n    const paymentIntent = input.amount\n      ? await stripe.paymentIntents.retrieve(input.sessionId)\n      : null\n\n    const refund = await stripe.refunds.create({\n      payment_intent: input.sessionId,\n      amount: input.amount && paymentIntent\n        ? toCents(input.amount, paymentIntent.currency)\n        : undefined,\n      reason: mapRefundReason(input.reason),\n      metadata: input.metadata as Record<string, string> | undefined,\n    })\n\n    const refundCurrencyCode = refund.currency.toUpperCase()\n\n    return {\n      refundId: refund.id,\n      status: refund.status === 'succeeded' ? 'refunded' : 'pending',\n      refundedAmount: fromCents(refund.amount, refundCurrencyCode),\n    }\n  },\n\n  async cancel(input: CancelInput): Promise<CancelResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n\n    const cancelled = await stripe.paymentIntents.cancel(input.sessionId, {\n      cancellation_reason: 'requested_by_customer',\n    })\n\n    return {\n      status: mapStripeStatus(cancelled.status),\n    }\n  },\n\n  async getStatus(input: GetStatusInput): Promise<GatewayPaymentStatus> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n\n    const pi = await stripe.paymentIntents.retrieve(input.sessionId)\n    return {\n      status: mapStripeStatus(pi.status),\n      amount: fromCents(pi.amount, pi.currency),\n      amountReceived: fromCents(pi.amount_received, pi.currency),\n      currencyCode: pi.currency.toUpperCase(),\n    }\n  },\n\n  async verifyWebhook(input: VerifyWebhookInput): Promise<WebhookEvent> {\n    return verifyStripeWebhook(input)\n  },\n\n  mapStatus(providerStatus: string, eventType?: string): UnifiedPaymentStatus {\n    if (eventType) {\n      const mappedEvent = mapWebhookEventToStatus(eventType)\n      if (mappedEvent) return mappedEvent\n    }\n    return mapStripeStatus(providerStatus)\n  },\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type {\n  GatewayAdapter,\n  CreateSessionInput,\n  CreateSessionResult,\n  CaptureInput,\n  CaptureResult,\n  RefundInput,\n  RefundResult,\n  CancelInput,\n  CancelResult,\n  GetStatusInput,\n  GatewayPaymentStatus,\n  VerifyWebhookInput,\n  WebhookEvent,\n  UnifiedPaymentStatus,\n} from '@open-mercato/shared/modules/payment_gateways/types'\nimport { resolveStripeClient } from '../client'\nimport { mapRefundReason, mapStripeStatus, mapWebhookEventToStatus } from '../status-map'\nimport {\n  toCents,\n  fromCents,\n  buildStripeMetadata,\n  normalizeStripePaymentElementSettings,\n  resolveStripeRendererKey,\n  resolveStripeRefundStatus,\n  stripeIdempotencyOptions,\n} from '../shared'\nimport { verifyStripeWebhook } from '../webhook-handler'\n\nconst STRIPE_API_VERSION = '2024-12-18'\n\nexport const stripeAdapterV20241218: GatewayAdapter = {\n  providerKey: 'stripe',\n\n  async createSession(input: CreateSessionInput): Promise<CreateSessionResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n    const rendererKey = resolveStripeRendererKey(input.presentation)\n    const rendererSettings = normalizeStripePaymentElementSettings(input.presentation?.rendererSettings)\n\n    const paymentIntent = await stripe.paymentIntents.create({\n      amount: toCents(input.amount, input.currencyCode),\n      currency: input.currencyCode.toLowerCase(),\n      capture_method: input.captureMethod ?? 'automatic',\n      metadata: buildStripeMetadata({\n        paymentId: input.paymentId,\n        tenantId: input.tenantId,\n        organizationId: input.organizationId,\n        orderId: input.orderId,\n      }),\n      payment_method_types: input.paymentTypes ?? ['card'],\n      description: input.description,\n    }, input.idempotencyKey ? { idempotencyKey: input.idempotencyKey } : undefined)\n\n    return {\n      sessionId: paymentIntent.id,\n      clientSecret: paymentIntent.client_secret ?? undefined,\n      status: mapStripeStatus(paymentIntent.status),\n      providerData: {\n        paymentIntentId: paymentIntent.id,\n        publishableKey: typeof input.credentials.publishableKey === 'string'\n          ? input.credentials.publishableKey\n          : undefined,\n      },\n      clientSession: paymentIntent.client_secret && typeof input.credentials.publishableKey === 'string'\n        ? {\n            type: 'embedded',\n            rendererKey,\n            payload: {\n              clientSecret: paymentIntent.client_secret,\n              publishableKey: input.credentials.publishableKey,\n            },\n            settings: rendererSettings,\n          }\n        : undefined,\n    }\n  },\n\n  async capture(input: CaptureInput): Promise<CaptureResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n    const paymentIntent = input.amount\n      ? await stripe.paymentIntents.retrieve(input.sessionId)\n      : null\n\n    const captured = await stripe.paymentIntents.capture(\n      input.sessionId,\n      {\n        amount_to_capture: input.amount && paymentIntent\n          ? toCents(input.amount, paymentIntent.currency)\n          : undefined,\n      },\n      stripeIdempotencyOptions(input.idempotencyKey),\n    )\n\n    const capturedCurrencyCode = captured.currency.toUpperCase()\n\n    return {\n      status: mapStripeStatus(captured.status),\n      capturedAmount: fromCents(captured.amount_received, capturedCurrencyCode),\n      providerData: { chargeId: captured.latest_charge },\n    }\n  },\n\n  async refund(input: RefundInput): Promise<RefundResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n    const paymentIntent = input.amount\n      ? await stripe.paymentIntents.retrieve(input.sessionId)\n      : null\n\n    const refund = await stripe.refunds.create(\n      {\n        payment_intent: input.sessionId,\n        amount: input.amount && paymentIntent\n          ? toCents(input.amount, paymentIntent.currency)\n          : undefined,\n        reason: mapRefundReason(input.reason),\n        metadata: input.metadata as Record<string, string> | undefined,\n      },\n      stripeIdempotencyOptions(input.idempotencyKey),\n    )\n\n    const refundCurrencyCode = refund.currency.toUpperCase()\n\n    return {\n      refundId: refund.id,\n      status: await resolveStripeRefundStatus(stripe, refund, paymentIntent?.amount_received),\n      refundedAmount: fromCents(refund.amount, refundCurrencyCode),\n    }\n  },\n\n  async cancel(input: CancelInput): Promise<CancelResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n\n    const cancelled = await stripe.paymentIntents.cancel(\n      input.sessionId,\n      { cancellation_reason: 'requested_by_customer' },\n      stripeIdempotencyOptions(input.idempotencyKey),\n    )\n\n    return {\n      status: mapStripeStatus(cancelled.status),\n    }\n  },\n\n  async getStatus(input: GetStatusInput): Promise<GatewayPaymentStatus> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n\n    const pi = await stripe.paymentIntents.retrieve(input.sessionId)\n    return {\n      status: mapStripeStatus(pi.status),\n      amount: fromCents(pi.amount, pi.currency),\n      amountReceived: fromCents(pi.amount_received, pi.currency),\n      currencyCode: pi.currency.toUpperCase(),\n    }\n  },\n\n  async verifyWebhook(input: VerifyWebhookInput): Promise<WebhookEvent> {\n    return verifyStripeWebhook(input)\n  },\n\n  mapStatus(providerStatus: string, eventType?: string): UnifiedPaymentStatus {\n    if (eventType) {\n      const mappedEvent = mapWebhookEventToStatus(eventType)\n      if (mappedEvent) return mappedEvent\n    }\n    return mapStripeStatus(providerStatus)\n  },\n}\n"],
+  "mappings": "AAgBA,SAAS,2BAA2B;AACpC,SAAS,iBAAiB,iBAAiB,+BAA+B;AAC1E;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,2BAA2B;AAEpC,MAAM,qBAAqB;AAEpB,MAAM,yBAAyC;AAAA,EACpD,aAAa;AAAA,EAEb,MAAM,cAAc,OAAyD;AAC3E,UAAM,SAAS,oBAAoB,MAAM,aAAa,kBAAkB;AACxE,UAAM,cAAc,yBAAyB,MAAM,YAAY;AAC/D,UAAM,mBAAmB,sCAAsC,MAAM,cAAc,gBAAgB;AAEnG,UAAM,gBAAgB,MAAM,OAAO,eAAe,OAAO;AAAA,MACvD,QAAQ,QAAQ,MAAM,QAAQ,MAAM,YAAY;AAAA,MAChD,UAAU,MAAM,aAAa,YAAY;AAAA,MACzC,gBAAgB,MAAM,iBAAiB;AAAA,MACvC,UAAU,oBAAoB;AAAA,QAC5B,WAAW,MAAM;AAAA,QACjB,UAAU,MAAM;AAAA,QAChB,gBAAgB,MAAM;AAAA,QACtB,SAAS,MAAM;AAAA,MACjB,CAAC;AAAA,MACD,sBAAsB,MAAM,gBAAgB,CAAC,MAAM;AAAA,MACnD,aAAa,MAAM;AAAA,IACrB,GAAG,MAAM,iBAAiB,EAAE,gBAAgB,MAAM,eAAe,IAAI,MAAS;AAE9E,WAAO;AAAA,MACL,WAAW,cAAc;AAAA,MACzB,cAAc,cAAc,iBAAiB;AAAA,MAC7C,QAAQ,gBAAgB,cAAc,MAAM;AAAA,MAC5C,cAAc;AAAA,QACZ,iBAAiB,cAAc;AAAA,QAC/B,gBAAgB,OAAO,MAAM,YAAY,mBAAmB,WACxD,MAAM,YAAY,iBAClB;AAAA,MACN;AAAA,MACA,eAAe,cAAc,iBAAiB,OAAO,MAAM,YAAY,mBAAmB,WACtF;AAAA,QACE,MAAM;AAAA,QACN;AAAA,QACA,SAAS;AAAA,UACP,cAAc,cAAc;AAAA,UAC5B,gBAAgB,MAAM,YAAY;AAAA,QACpC;AAAA,QACA,UAAU;AAAA,MACZ,IACA;AAAA,IACN;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,OAA6C;AACzD,UAAM,SAAS,oBAAoB,MAAM,aAAa,kBAAkB;AACxE,UAAM,gBAAgB,MAAM,SACxB,MAAM,OAAO,eAAe,SAAS,MAAM,SAAS,IACpD;AAEJ,UAAM,WAAW,MAAM,OAAO,eAAe;AAAA,MAC3C,MAAM;AAAA,MACN;AAAA,QACE,mBAAmB,MAAM,UAAU,gBAC/B,QAAQ,MAAM,QAAQ,cAAc,QAAQ,IAC5C;AAAA,MACN;AAAA,MACA,yBAAyB,MAAM,cAAc;AAAA,IAC/C;AAEA,UAAM,uBAAuB,SAAS,SAAS,YAAY;AAE3D,WAAO;AAAA,MACL,QAAQ,gBAAgB,SAAS,MAAM;AAAA,MACvC,gBAAgB,UAAU,SAAS,iBAAiB,oBAAoB;AAAA,MACxE,cAAc,EAAE,UAAU,SAAS,cAAc;AAAA,IACnD;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,OAA2C;AACtD,UAAM,SAAS,oBAAoB,MAAM,aAAa,kBAAkB;AACxE,UAAM,gBAAgB,MAAM,SACxB,MAAM,OAAO,eAAe,SAAS,MAAM,SAAS,IACpD;AAEJ,UAAM,SAAS,MAAM,OAAO,QAAQ;AAAA,MAClC;AAAA,QACE,gBAAgB,MAAM;AAAA,QACtB,QAAQ,MAAM,UAAU,gBACpB,QAAQ,MAAM,QAAQ,cAAc,QAAQ,IAC5C;AAAA,QACJ,QAAQ,gBAAgB,MAAM,MAAM;AAAA,QACpC,UAAU,MAAM;AAAA,MAClB;AAAA,MACA,yBAAyB,MAAM,cAAc;AAAA,IAC/C;AAEA,UAAM,qBAAqB,OAAO,SAAS,YAAY;AAEvD,WAAO;AAAA,MACL,UAAU,OAAO;AAAA,MACjB,QAAQ,MAAM,0BAA0B,QAAQ,QAAQ,eAAe,eAAe;AAAA,MACtF,gBAAgB,UAAU,OAAO,QAAQ,kBAAkB;AAAA,IAC7D;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,OAA2C;AACtD,UAAM,SAAS,oBAAoB,MAAM,aAAa,kBAAkB;AAExE,UAAM,YAAY,MAAM,OAAO,eAAe;AAAA,MAC5C,MAAM;AAAA,MACN,EAAE,qBAAqB,wBAAwB;AAAA,MAC/C,yBAAyB,MAAM,cAAc;AAAA,IAC/C;AAEA,WAAO;AAAA,MACL,QAAQ,gBAAgB,UAAU,MAAM;AAAA,IAC1C;AAAA,EACF;AAAA,EAEA,MAAM,UAAU,OAAsD;AACpE,UAAM,SAAS,oBAAoB,MAAM,aAAa,kBAAkB;AAExE,UAAM,KAAK,MAAM,OAAO,eAAe,SAAS,MAAM,SAAS;AAC/D,WAAO;AAAA,MACL,QAAQ,gBAAgB,GAAG,MAAM;AAAA,MACjC,QAAQ,UAAU,GAAG,QAAQ,GAAG,QAAQ;AAAA,MACxC,gBAAgB,UAAU,GAAG,iBAAiB,GAAG,QAAQ;AAAA,MACzD,cAAc,GAAG,SAAS,YAAY;AAAA,IACxC;AAAA,EACF;AAAA,EAEA,MAAM,cAAc,OAAkD;AACpE,WAAO,oBAAoB,KAAK;AAAA,EAClC;AAAA,EAEA,UAAU,gBAAwB,WAA0C;AAC1E,QAAI,WAAW;AACb,YAAM,cAAc,wBAAwB,SAAS;AACrD,UAAI,YAAa,QAAO;AAAA,IAC1B;AACA,WAAO,gBAAgB,cAAc;AAAA,EACvC;AACF;",
   "names": []
 }

package/dist/modules/gateway_stripe/lib/adapters/v2025-02-24.acacia.js

@@ -5,7 +5,9 @@ import {
   fromCents,
   buildStripeMetadata,
   normalizeStripePaymentElementSettings,
-  resolveStripeRendererKey
+  resolveStripeRendererKey,
+  resolveStripeRefundStatus,
+  stripeIdempotencyOptions
 } from "../shared.js";
 import { verifyStripeWebhook } from "../webhook-handler.js";
 const STRIPE_API_VERSION = "2025-02-24.acacia";
@@ -50,9 +52,13 @@ const stripeAdapterV20250224Acacia = {
   async capture(input) {
     const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION);
     const paymentIntent = input.amount ? await stripe.paymentIntents.retrieve(input.sessionId) : null;
-    const captured = await stripe.paymentIntents.capture(input.sessionId, {
-      amount_to_capture: input.amount && paymentIntent ? toCents(input.amount, paymentIntent.currency) : void 0
-    });
+    const captured = await stripe.paymentIntents.capture(
+      input.sessionId,
+      {
+        amount_to_capture: input.amount && paymentIntent ? toCents(input.amount, paymentIntent.currency) : void 0
+      },
+      stripeIdempotencyOptions(input.idempotencyKey)
+    );
     return {
       status: mapStripeStatus(captured.status),
       capturedAmount: fromCents(captured.amount_received, captured.currency),
@@ -62,23 +68,28 @@ const stripeAdapterV20250224Acacia = {
   async refund(input) {
     const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION);
     const paymentIntent = input.amount ? await stripe.paymentIntents.retrieve(input.sessionId) : null;
-    const refund = await stripe.refunds.create({
-      payment_intent: input.sessionId,
-      amount: input.amount && paymentIntent ? toCents(input.amount, paymentIntent.currency) : void 0,
-      reason: mapRefundReason(input.reason),
-      metadata: input.metadata
-    });
+    const refund = await stripe.refunds.create(
+      {
+        payment_intent: input.sessionId,
+        amount: input.amount && paymentIntent ? toCents(input.amount, paymentIntent.currency) : void 0,
+        reason: mapRefundReason(input.reason),
+        metadata: input.metadata
+      },
+      stripeIdempotencyOptions(input.idempotencyKey)
+    );
     return {
       refundId: refund.id,
-      status: refund.status === "succeeded" ? "refunded" : "pending",
+      status: await resolveStripeRefundStatus(stripe, refund, paymentIntent?.amount_received),
       refundedAmount: fromCents(refund.amount, refund.currency)
     };
   },
   async cancel(input) {
     const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION);
-    const cancelled = await stripe.paymentIntents.cancel(input.sessionId, {
-      cancellation_reason: "requested_by_customer"
-    });
+    const cancelled = await stripe.paymentIntents.cancel(
+      input.sessionId,
+      { cancellation_reason: "requested_by_customer" },
+      stripeIdempotencyOptions(input.idempotencyKey)
+    );
     return {
       status: mapStripeStatus(cancelled.status)
     };

package/dist/modules/gateway_stripe/lib/adapters/v2025-02-24.acacia.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/modules/gateway_stripe/lib/adapters/v2025-02-24.acacia.ts"],
-  "sourcesContent": ["import type {\n  GatewayAdapter,\n  CreateSessionInput,\n  CreateSessionResult,\n  CaptureInput,\n  CaptureResult,\n  RefundInput,\n  RefundResult,\n  CancelInput,\n  CancelResult,\n  GetStatusInput,\n  GatewayPaymentStatus,\n  VerifyWebhookInput,\n  WebhookEvent,\n  UnifiedPaymentStatus,\n} from '@open-mercato/shared/modules/payment_gateways/types'\nimport { resolveStripeClient } from '../client'\nimport { mapRefundReason, mapStripeStatus, mapWebhookEventToStatus } from '../status-map'\nimport {\n  toCents,\n  fromCents,\n  buildStripeMetadata,\n  normalizeStripePaymentElementSettings,\n  resolveStripeRendererKey,\n} from '../shared'\nimport { verifyStripeWebhook } from '../webhook-handler'\n\nconst STRIPE_API_VERSION = '2025-02-24.acacia'\n\nexport const stripeAdapterV20250224Acacia: GatewayAdapter = {\n  providerKey: 'stripe',\n\n  async createSession(input: CreateSessionInput): Promise<CreateSessionResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n    const rendererKey = resolveStripeRendererKey(input.presentation)\n    const rendererSettings = normalizeStripePaymentElementSettings(input.presentation?.rendererSettings)\n\n    const paymentIntent = await stripe.paymentIntents.create({\n      amount: toCents(input.amount, input.currencyCode),\n      currency: input.currencyCode.toLowerCase(),\n      capture_method: input.captureMethod ?? 'automatic',\n      metadata: buildStripeMetadata({\n        paymentId: input.paymentId,\n        tenantId: input.tenantId,\n        organizationId: input.organizationId,\n        orderId: input.orderId,\n      }),\n      payment_method_types: input.paymentTypes ?? ['card'],\n      description: input.description,\n    }, input.idempotencyKey ? { idempotencyKey: input.idempotencyKey } : undefined)\n\n    return {\n      sessionId: paymentIntent.id,\n      clientSecret: paymentIntent.client_secret ?? undefined,\n      status: mapStripeStatus(paymentIntent.status),\n      providerData: {\n        paymentIntentId: paymentIntent.id,\n        publishableKey: typeof input.credentials.publishableKey === 'string'\n          ? input.credentials.publishableKey\n          : undefined,\n      },\n      clientSession: paymentIntent.client_secret && typeof input.credentials.publishableKey === 'string'\n        ? {\n            type: 'embedded',\n            rendererKey,\n            payload: {\n              clientSecret: paymentIntent.client_secret,\n              publishableKey: input.credentials.publishableKey,\n            },\n            settings: rendererSettings,\n          }\n        : undefined,\n    }\n  },\n\n  async capture(input: CaptureInput): Promise<CaptureResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n    const paymentIntent = input.amount\n      ? await stripe.paymentIntents.retrieve(input.sessionId)\n      : null\n\n    const captured = await stripe.paymentIntents.capture(input.sessionId, {\n      amount_to_capture: input.amount && paymentIntent\n        ? toCents(input.amount, paymentIntent.currency)\n        : undefined,\n    })\n\n    return {\n      status: mapStripeStatus(captured.status),\n      capturedAmount: fromCents(captured.amount_received, captured.currency),\n      providerData: { chargeId: captured.latest_charge },\n    }\n  },\n\n  async refund(input: RefundInput): Promise<RefundResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n    const paymentIntent = input.amount\n      ? await stripe.paymentIntents.retrieve(input.sessionId)\n      : null\n\n    const refund = await stripe.refunds.create({\n      payment_intent: input.sessionId,\n      amount: input.amount && paymentIntent\n        ? toCents(input.amount, paymentIntent.currency)\n        : undefined,\n      reason: mapRefundReason(input.reason),\n      metadata: input.metadata as Record<string, string> | undefined,\n    })\n\n    return {\n      refundId: refund.id,\n      status: refund.status === 'succeeded' ? 'refunded' : 'pending',\n      refundedAmount: fromCents(refund.amount, refund.currency),\n    }\n  },\n\n  async cancel(input: CancelInput): Promise<CancelResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n\n    const cancelled = await stripe.paymentIntents.cancel(input.sessionId, {\n      cancellation_reason: 'requested_by_customer',\n    })\n\n    return {\n      status: mapStripeStatus(cancelled.status),\n    }\n  },\n\n  async getStatus(input: GetStatusInput): Promise<GatewayPaymentStatus> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n\n    const pi = await stripe.paymentIntents.retrieve(input.sessionId)\n    return {\n      status: mapStripeStatus(pi.status),\n      amount: fromCents(pi.amount, pi.currency),\n      amountReceived: fromCents(pi.amount_received, pi.currency),\n      currencyCode: pi.currency.toUpperCase(),\n    }\n  },\n\n  async verifyWebhook(input: VerifyWebhookInput): Promise<WebhookEvent> {\n    return verifyStripeWebhook(input)\n  },\n\n  mapStatus(providerStatus: string, eventType?: string): UnifiedPaymentStatus {\n    if (eventType) {\n      const mappedEvent = mapWebhookEventToStatus(eventType)\n      if (mappedEvent) return mappedEvent\n    }\n    return mapStripeStatus(providerStatus)\n  },\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type {\n  GatewayAdapter,\n  CreateSessionInput,\n  CreateSessionResult,\n  CaptureInput,\n  CaptureResult,\n  RefundInput,\n  RefundResult,\n  CancelInput,\n  CancelResult,\n  GetStatusInput,\n  GatewayPaymentStatus,\n  VerifyWebhookInput,\n  WebhookEvent,\n  UnifiedPaymentStatus,\n} from '@open-mercato/shared/modules/payment_gateways/types'\nimport { resolveStripeClient } from '../client'\nimport { mapRefundReason, mapStripeStatus, mapWebhookEventToStatus } from '../status-map'\nimport {\n  toCents,\n  fromCents,\n  buildStripeMetadata,\n  normalizeStripePaymentElementSettings,\n  resolveStripeRendererKey,\n  resolveStripeRefundStatus,\n  stripeIdempotencyOptions,\n} from '../shared'\nimport { verifyStripeWebhook } from '../webhook-handler'\n\nconst STRIPE_API_VERSION = '2025-02-24.acacia'\n\nexport const stripeAdapterV20250224Acacia: GatewayAdapter = {\n  providerKey: 'stripe',\n\n  async createSession(input: CreateSessionInput): Promise<CreateSessionResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n    const rendererKey = resolveStripeRendererKey(input.presentation)\n    const rendererSettings = normalizeStripePaymentElementSettings(input.presentation?.rendererSettings)\n\n    const paymentIntent = await stripe.paymentIntents.create({\n      amount: toCents(input.amount, input.currencyCode),\n      currency: input.currencyCode.toLowerCase(),\n      capture_method: input.captureMethod ?? 'automatic',\n      metadata: buildStripeMetadata({\n        paymentId: input.paymentId,\n        tenantId: input.tenantId,\n        organizationId: input.organizationId,\n        orderId: input.orderId,\n      }),\n      payment_method_types: input.paymentTypes ?? ['card'],\n      description: input.description,\n    }, input.idempotencyKey ? { idempotencyKey: input.idempotencyKey } : undefined)\n\n    return {\n      sessionId: paymentIntent.id,\n      clientSecret: paymentIntent.client_secret ?? undefined,\n      status: mapStripeStatus(paymentIntent.status),\n      providerData: {\n        paymentIntentId: paymentIntent.id,\n        publishableKey: typeof input.credentials.publishableKey === 'string'\n          ? input.credentials.publishableKey\n          : undefined,\n      },\n      clientSession: paymentIntent.client_secret && typeof input.credentials.publishableKey === 'string'\n        ? {\n            type: 'embedded',\n            rendererKey,\n            payload: {\n              clientSecret: paymentIntent.client_secret,\n              publishableKey: input.credentials.publishableKey,\n            },\n            settings: rendererSettings,\n          }\n        : undefined,\n    }\n  },\n\n  async capture(input: CaptureInput): Promise<CaptureResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n    const paymentIntent = input.amount\n      ? await stripe.paymentIntents.retrieve(input.sessionId)\n      : null\n\n    const captured = await stripe.paymentIntents.capture(\n      input.sessionId,\n      {\n        amount_to_capture: input.amount && paymentIntent\n          ? toCents(input.amount, paymentIntent.currency)\n          : undefined,\n      },\n      stripeIdempotencyOptions(input.idempotencyKey),\n    )\n\n    return {\n      status: mapStripeStatus(captured.status),\n      capturedAmount: fromCents(captured.amount_received, captured.currency),\n      providerData: { chargeId: captured.latest_charge },\n    }\n  },\n\n  async refund(input: RefundInput): Promise<RefundResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n    const paymentIntent = input.amount\n      ? await stripe.paymentIntents.retrieve(input.sessionId)\n      : null\n\n    const refund = await stripe.refunds.create(\n      {\n        payment_intent: input.sessionId,\n        amount: input.amount && paymentIntent\n          ? toCents(input.amount, paymentIntent.currency)\n          : undefined,\n        reason: mapRefundReason(input.reason),\n        metadata: input.metadata as Record<string, string> | undefined,\n      },\n      stripeIdempotencyOptions(input.idempotencyKey),\n    )\n\n    return {\n      refundId: refund.id,\n      status: await resolveStripeRefundStatus(stripe, refund, paymentIntent?.amount_received),\n      refundedAmount: fromCents(refund.amount, refund.currency),\n    }\n  },\n\n  async cancel(input: CancelInput): Promise<CancelResult> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n\n    const cancelled = await stripe.paymentIntents.cancel(\n      input.sessionId,\n      { cancellation_reason: 'requested_by_customer' },\n      stripeIdempotencyOptions(input.idempotencyKey),\n    )\n\n    return {\n      status: mapStripeStatus(cancelled.status),\n    }\n  },\n\n  async getStatus(input: GetStatusInput): Promise<GatewayPaymentStatus> {\n    const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)\n\n    const pi = await stripe.paymentIntents.retrieve(input.sessionId)\n    return {\n      status: mapStripeStatus(pi.status),\n      amount: fromCents(pi.amount, pi.currency),\n      amountReceived: fromCents(pi.amount_received, pi.currency),\n      currencyCode: pi.currency.toUpperCase(),\n    }\n  },\n\n  async verifyWebhook(input: VerifyWebhookInput): Promise<WebhookEvent> {\n    return verifyStripeWebhook(input)\n  },\n\n  mapStatus(providerStatus: string, eventType?: string): UnifiedPaymentStatus {\n    if (eventType) {\n      const mappedEvent = mapWebhookEventToStatus(eventType)\n      if (mappedEvent) return mappedEvent\n    }\n    return mapStripeStatus(providerStatus)\n  },\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/gateway_stripe/lib/shared.js

@@ -25,6 +25,18 @@ function toCents(amount, currencyCode) {
 function fromCents(amount, currencyCode) {
   return isZeroDecimalCurrency(currencyCode) ? amount : amount / 100;
 }
+function stripeIdempotencyOptions(idempotencyKey) {
+  return idempotencyKey ? { idempotencyKey } : void 0;
+}
+async function resolveStripeRefundStatus(stripe, refund, capturedAmount) {
+  if (refund.status !== "succeeded") return "pending";
+  const chargeId = typeof refund.charge === "string" ? refund.charge : refund.charge?.id;
+  if (chargeId) {
+    const charge = await stripe.charges.retrieve(chargeId);
+    return charge.amount_refunded < charge.amount ? "partially_refunded" : "refunded";
+  }
+  return capturedAmount !== void 0 && refund.amount < capturedAmount ? "partially_refunded" : "refunded";
+}
 function buildStripeMetadata(input) {
   const meta = {
     paymentId: input.paymentId,
@@ -65,7 +77,9 @@ export {
   buildStripeMetadata,
   fromCents,
   normalizeStripePaymentElementSettings,
+  resolveStripeRefundStatus,
   resolveStripeRendererKey,
+  stripeIdempotencyOptions,
   toCents
 };
 //# sourceMappingURL=shared.js.map

package/dist/modules/gateway_stripe/lib/shared.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/gateway_stripe/lib/shared.ts"],
-  "sourcesContent": ["import type { PaymentGatewayPresentationRequest } from '@open-mercato/shared/modules/payment_gateways/types'\n\nconst ZERO_DECIMAL_CURRENCIES = new Set([\n  'BIF',\n  'CLP',\n  'DJF',\n  'GNF',\n  'JPY',\n  'KMF',\n  'KRW',\n  'MGA',\n  'PYG',\n  'RWF',\n  'UGX',\n  'VND',\n  'VUV',\n  'XAF',\n  'XOF',\n  'XPF',\n])\n\nfunction isZeroDecimalCurrency(currencyCode: string): boolean {\n  return ZERO_DECIMAL_CURRENCIES.has(currencyCode.toUpperCase())\n}\n\nexport function toCents(amount: number, currencyCode: string): number {\n  return isZeroDecimalCurrency(currencyCode)\n    ? Math.round(amount)\n    : Math.round(amount * 100)\n}\n\nexport function fromCents(amount: number, currencyCode: string): number {\n  return isZeroDecimalCurrency(currencyCode)\n    ? amount\n    : amount / 100\n}\n\nexport function buildStripeMetadata(input: {\n  paymentId: string\n  tenantId: string\n  organizationId: string\n  orderId?: string\n}): Record<string, string> {\n  const meta: Record<string, string> = {\n    paymentId: input.paymentId,\n    tenantId: input.tenantId,\n    organizationId: input.organizationId,\n  }\n  if (input.orderId) {\n    meta.orderId = input.orderId\n  }\n  return meta\n}\n\nconst STRIPE_PAYMENT_METHOD_ORDER = new Set([\n  'card',\n  'apple_pay',\n  'google_pay',\n  'link',\n])\n\nexport type StripePaymentElementSettings = {\n  layout?: 'tabs' | 'accordion'\n  paymentMethodOrder?: string[]\n  billingDetails?: 'auto' | 'never' | 'if_required'\n}\n\nexport function resolveStripeRendererKey(request?: PaymentGatewayPresentationRequest): string {\n  return request?.rendererKey === 'stripe.payment_element'\n    ? request.rendererKey\n    : 'stripe.payment_element'\n}\n\nexport function normalizeStripePaymentElementSettings(\n  settings: Record<string, unknown> | null | undefined,\n): StripePaymentElementSettings | undefined {\n  if (!settings) return undefined\n\n  const layout = settings.layout === 'tabs' || settings.layout === 'accordion'\n    ? settings.layout\n    : undefined\n  const billingDetails = settings.billingDetails === 'auto'\n    || settings.billingDetails === 'never'\n    || settings.billingDetails === 'if_required'\n    ? settings.billingDetails\n    : undefined\n  const paymentMethodOrder = Array.isArray(settings.paymentMethodOrder)\n    ? settings.paymentMethodOrder.filter(\n        (value): value is string => typeof value === 'string' && STRIPE_PAYMENT_METHOD_ORDER.has(value),\n      )\n    : []\n\n  if (!layout && !billingDetails && paymentMethodOrder.length === 0) {\n    return undefined\n  }\n\n  return {\n    ...(layout ? { layout } : {}),\n    ...(billingDetails ? { billingDetails } : {}),\n    ...(paymentMethodOrder.length > 0 ? { paymentMethodOrder } : {}),\n  }\n}\n"],
-  "mappings": "AAEA,MAAM,0BAA0B,oBAAI,IAAI;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,SAAS,sBAAsB,cAA+B;AAC5D,SAAO,wBAAwB,IAAI,aAAa,YAAY,CAAC;AAC/D;AAEO,SAAS,QAAQ,QAAgB,cAA8B;AACpE,SAAO,sBAAsB,YAAY,IACrC,KAAK,MAAM,MAAM,IACjB,KAAK,MAAM,SAAS,GAAG;AAC7B;AAEO,SAAS,UAAU,QAAgB,cAA8B;AACtE,SAAO,sBAAsB,YAAY,IACrC,SACA,SAAS;AACf;AAEO,SAAS,oBAAoB,OAKT;AACzB,QAAM,OAA+B;AAAA,IACnC,WAAW,MAAM;AAAA,IACjB,UAAU,MAAM;AAAA,IAChB,gBAAgB,MAAM;AAAA,EACxB;AACA,MAAI,MAAM,SAAS;AACjB,SAAK,UAAU,MAAM;AAAA,EACvB;AACA,SAAO;AACT;AAEA,MAAM,8BAA8B,oBAAI,IAAI;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAQM,SAAS,yBAAyB,SAAqD;AAC5F,SAAO,SAAS,gBAAgB,2BAC5B,QAAQ,cACR;AACN;AAEO,SAAS,sCACd,UAC0C;AAC1C,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,SAAS,WAAW,UAAU,SAAS,WAAW,cAC7D,SAAS,SACT;AACJ,QAAM,iBAAiB,SAAS,mBAAmB,UAC9C,SAAS,mBAAmB,WAC5B,SAAS,mBAAmB,gBAC7B,SAAS,iBACT;AACJ,QAAM,qBAAqB,MAAM,QAAQ,SAAS,kBAAkB,IAChE,SAAS,mBAAmB;AAAA,IAC1B,CAAC,UAA2B,OAAO,UAAU,YAAY,4BAA4B,IAAI,KAAK;AAAA,EAChG,IACA,CAAC;AAEL,MAAI,CAAC,UAAU,CAAC,kBAAkB,mBAAmB,WAAW,GAAG;AACjE,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,IAC3B,GAAI,iBAAiB,EAAE,eAAe,IAAI,CAAC;AAAA,IAC3C,GAAI,mBAAmB,SAAS,IAAI,EAAE,mBAAmB,IAAI,CAAC;AAAA,EAChE;AACF;",
+  "sourcesContent": ["import type { PaymentGatewayPresentationRequest } from '@open-mercato/shared/modules/payment_gateways/types'\nimport type Stripe from 'stripe'\n\nconst ZERO_DECIMAL_CURRENCIES = new Set([\n  'BIF',\n  'CLP',\n  'DJF',\n  'GNF',\n  'JPY',\n  'KMF',\n  'KRW',\n  'MGA',\n  'PYG',\n  'RWF',\n  'UGX',\n  'VND',\n  'VUV',\n  'XAF',\n  'XOF',\n  'XPF',\n])\n\nfunction isZeroDecimalCurrency(currencyCode: string): boolean {\n  return ZERO_DECIMAL_CURRENCIES.has(currencyCode.toUpperCase())\n}\n\nexport function toCents(amount: number, currencyCode: string): number {\n  return isZeroDecimalCurrency(currencyCode)\n    ? Math.round(amount)\n    : Math.round(amount * 100)\n}\n\nexport function fromCents(amount: number, currencyCode: string): number {\n  return isZeroDecimalCurrency(currencyCode)\n    ? amount\n    : amount / 100\n}\n\nexport function stripeIdempotencyOptions(idempotencyKey?: string): { idempotencyKey: string } | undefined {\n  return idempotencyKey ? { idempotencyKey } : undefined\n}\n\nexport async function resolveStripeRefundStatus(\n  stripe: Pick<Stripe, 'charges'>,\n  refund: Stripe.Refund,\n  capturedAmount?: number,\n): Promise<'pending' | 'partially_refunded' | 'refunded'> {\n  if (refund.status !== 'succeeded') return 'pending'\n  const chargeId = typeof refund.charge === 'string' ? refund.charge : refund.charge?.id\n  if (chargeId) {\n    const charge = await stripe.charges.retrieve(chargeId)\n    return charge.amount_refunded < charge.amount ? 'partially_refunded' : 'refunded'\n  }\n  return capturedAmount !== undefined && refund.amount < capturedAmount\n    ? 'partially_refunded'\n    : 'refunded'\n}\n\nexport function buildStripeMetadata(input: {\n  paymentId: string\n  tenantId: string\n  organizationId: string\n  orderId?: string\n}): Record<string, string> {\n  const meta: Record<string, string> = {\n    paymentId: input.paymentId,\n    tenantId: input.tenantId,\n    organizationId: input.organizationId,\n  }\n  if (input.orderId) {\n    meta.orderId = input.orderId\n  }\n  return meta\n}\n\nconst STRIPE_PAYMENT_METHOD_ORDER = new Set([\n  'card',\n  'apple_pay',\n  'google_pay',\n  'link',\n])\n\nexport type StripePaymentElementSettings = {\n  layout?: 'tabs' | 'accordion'\n  paymentMethodOrder?: string[]\n  billingDetails?: 'auto' | 'never' | 'if_required'\n}\n\nexport function resolveStripeRendererKey(request?: PaymentGatewayPresentationRequest): string {\n  return request?.rendererKey === 'stripe.payment_element'\n    ? request.rendererKey\n    : 'stripe.payment_element'\n}\n\nexport function normalizeStripePaymentElementSettings(\n  settings: Record<string, unknown> | null | undefined,\n): StripePaymentElementSettings | undefined {\n  if (!settings) return undefined\n\n  const layout = settings.layout === 'tabs' || settings.layout === 'accordion'\n    ? settings.layout\n    : undefined\n  const billingDetails = settings.billingDetails === 'auto'\n    || settings.billingDetails === 'never'\n    || settings.billingDetails === 'if_required'\n    ? settings.billingDetails\n    : undefined\n  const paymentMethodOrder = Array.isArray(settings.paymentMethodOrder)\n    ? settings.paymentMethodOrder.filter(\n        (value): value is string => typeof value === 'string' && STRIPE_PAYMENT_METHOD_ORDER.has(value),\n      )\n    : []\n\n  if (!layout && !billingDetails && paymentMethodOrder.length === 0) {\n    return undefined\n  }\n\n  return {\n    ...(layout ? { layout } : {}),\n    ...(billingDetails ? { billingDetails } : {}),\n    ...(paymentMethodOrder.length > 0 ? { paymentMethodOrder } : {}),\n  }\n}\n"],
+  "mappings": "AAGA,MAAM,0BAA0B,oBAAI,IAAI;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,SAAS,sBAAsB,cAA+B;AAC5D,SAAO,wBAAwB,IAAI,aAAa,YAAY,CAAC;AAC/D;AAEO,SAAS,QAAQ,QAAgB,cAA8B;AACpE,SAAO,sBAAsB,YAAY,IACrC,KAAK,MAAM,MAAM,IACjB,KAAK,MAAM,SAAS,GAAG;AAC7B;AAEO,SAAS,UAAU,QAAgB,cAA8B;AACtE,SAAO,sBAAsB,YAAY,IACrC,SACA,SAAS;AACf;AAEO,SAAS,yBAAyB,gBAAiE;AACxG,SAAO,iBAAiB,EAAE,eAAe,IAAI;AAC/C;AAEA,eAAsB,0BACpB,QACA,QACA,gBACwD;AACxD,MAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,QAAM,WAAW,OAAO,OAAO,WAAW,WAAW,OAAO,SAAS,OAAO,QAAQ;AACpF,MAAI,UAAU;AACZ,UAAM,SAAS,MAAM,OAAO,QAAQ,SAAS,QAAQ;AACrD,WAAO,OAAO,kBAAkB,OAAO,SAAS,uBAAuB;AAAA,EACzE;AACA,SAAO,mBAAmB,UAAa,OAAO,SAAS,iBACnD,uBACA;AACN;AAEO,SAAS,oBAAoB,OAKT;AACzB,QAAM,OAA+B;AAAA,IACnC,WAAW,MAAM;AAAA,IACjB,UAAU,MAAM;AAAA,IAChB,gBAAgB,MAAM;AAAA,EACxB;AACA,MAAI,MAAM,SAAS;AACjB,SAAK,UAAU,MAAM;AAAA,EACvB;AACA,SAAO;AACT;AAEA,MAAM,8BAA8B,oBAAI,IAAI;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAQM,SAAS,yBAAyB,SAAqD;AAC5F,SAAO,SAAS,gBAAgB,2BAC5B,QAAQ,cACR;AACN;AAEO,SAAS,sCACd,UAC0C;AAC1C,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,SAAS,WAAW,UAAU,SAAS,WAAW,cAC7D,SAAS,SACT;AACJ,QAAM,iBAAiB,SAAS,mBAAmB,UAC9C,SAAS,mBAAmB,WAC5B,SAAS,mBAAmB,gBAC7B,SAAS,iBACT;AACJ,QAAM,qBAAqB,MAAM,QAAQ,SAAS,kBAAkB,IAChE,SAAS,mBAAmB;AAAA,IAC1B,CAAC,UAA2B,OAAO,UAAU,YAAY,4BAA4B,IAAI,KAAK;AAAA,EAChG,IACA,CAAC;AAEL,MAAI,CAAC,UAAU,CAAC,kBAAkB,mBAAmB,WAAW,GAAG;AACjE,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,IAC3B,GAAI,iBAAiB,EAAE,eAAe,IAAI,CAAC;AAAA,IAC3C,GAAI,mBAAmB,SAAS,IAAI,EAAE,mBAAmB,IAAI,CAAC;AAAA,EAChE;AACF;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/gateway-stripe",
-  "version": "0.6.7-develop.6572.1.3d8e83062f",
+  "version": "0.6.7-develop.6574.1.05dcf72ba8",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -62,21 +62,21 @@
     }
   },
   "dependencies": {
-    "@open-mercato/core": "0.6.7-develop.6572.1.3d8e83062f",
-    "@open-mercato/queue": "0.6.7-develop.6572.1.3d8e83062f",
-    "@open-mercato/ui": "0.6.7-develop.6572.1.3d8e83062f",
+    "@open-mercato/core": "0.6.7-develop.6574.1.05dcf72ba8",
+    "@open-mercato/queue": "0.6.7-develop.6574.1.05dcf72ba8",
+    "@open-mercato/ui": "0.6.7-develop.6574.1.05dcf72ba8",
     "@stripe/react-stripe-js": "^6.6.0",
     "@stripe/stripe-js": "^9.8.0",
     "stripe": "^22.3.0"
   },
   "peerDependencies": {
     "@mikro-orm/postgresql": "^7.0.14",
-    "@open-mercato/shared": "0.6.7-develop.6572.1.3d8e83062f",
+    "@open-mercato/shared": "0.6.7-develop.6574.1.05dcf72ba8",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@open-mercato/shared": "0.6.7-develop.6572.1.3d8e83062f",
+    "@open-mercato/shared": "0.6.7-develop.6574.1.05dcf72ba8",
     "@types/jest": "^30.0.0",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",

package/src/modules/gateway_stripe/__tests__/adapter-idempotency.test.ts

@@ -8,12 +8,101 @@ jest.mock('../lib/client', () => ({
   resolveStripeClient: jest.fn(),
 }))
 
+const capture = jest.fn()
+const createRefund = jest.fn()
+const cancel = jest.fn()
+const retrievePaymentIntent = jest.fn()
+const retrieveCharge = jest.fn()
+
+const stripe = {
+  paymentIntents: {
+    capture,
+    cancel,
+    retrieve: retrievePaymentIntent,
+  },
+  refunds: { create: createRefund },
+  charges: { retrieve: retrieveCharge },
+}
+
 const adapters: Array<[string, GatewayAdapter]> = [
   ['2023-10-16', stripeAdapterV20231016],
   ['2024-12-18', stripeAdapterV20241218],
   ['2025-02-24.acacia', stripeAdapterV20250224Acacia],
 ]
 
+describe('Stripe manual payment operation idempotency', () => {
+  beforeEach(() => {
+    jest.clearAllMocks()
+    ;(resolveStripeClient as jest.Mock).mockReturnValue(stripe)
+    capture.mockResolvedValue({ status: 'succeeded', amount_received: 1000, currency: 'usd', latest_charge: 'ch_1' })
+    createRefund.mockResolvedValue({ id: 're_1', status: 'succeeded', amount: 1000, currency: 'usd' })
+    cancel.mockResolvedValue({ status: 'canceled' })
+  })
+
+  it.each(adapters)('%s forwards the core idempotency key to capture', async (_version, adapter) => {
+    await adapter.capture({
+      sessionId: 'pi_1',
+      credentials: { secretKey: 'sk_test' },
+      idempotencyKey: 'payment-operation-key',
+    })
+
+    expect(capture).toHaveBeenCalledWith(
+      'pi_1',
+      expect.any(Object),
+      { idempotencyKey: 'payment-operation-key' },
+    )
+  })
+
+  it.each(adapters)('%s forwards the core idempotency key to refund', async (_version, adapter) => {
+    await adapter.refund({
+      sessionId: 'pi_1',
+      credentials: { secretKey: 'sk_test' },
+      idempotencyKey: 'payment-operation-key',
+    })
+
+    expect(createRefund).toHaveBeenCalledWith(
+      expect.objectContaining({ payment_intent: 'pi_1' }),
+      { idempotencyKey: 'payment-operation-key' },
+    )
+  })
+
+  it.each(adapters)('%s keeps a successful partial refund non-terminal', async (_version, adapter) => {
+    retrievePaymentIntent.mockResolvedValue({ amount_received: 4000, currency: 'usd' })
+    createRefund.mockResolvedValue({
+      id: 're_partial',
+      status: 'succeeded',
+      amount: 1000,
+      currency: 'usd',
+      charge: 'ch_1',
+    })
+    retrieveCharge.mockResolvedValue({ amount: 4000, amount_refunded: 1000 })
+
+    const result = await adapter.refund({
+      sessionId: 'pi_1',
+      amount: 10,
+      credentials: { secretKey: 'sk_test' },
+      idempotencyKey: 'partial-refund-operation',
+    })
+
+    expect(result.status).toBe('partially_refunded')
+    expect(retrieveCharge).toHaveBeenCalledWith('ch_1')
+  })
+
+  it.each(adapters)('%s forwards the core idempotency key to cancel', async (_version, adapter) => {
+    await adapter.cancel({
+      sessionId: 'pi_1',
+      credentials: { secretKey: 'sk_test' },
+      idempotencyKey: 'payment-operation-key',
+    })
+
+    expect(cancel).toHaveBeenCalledWith(
+      'pi_1',
+      expect.anything(),
+      { idempotencyKey: 'payment-operation-key' },
+    )
+  })
+})
+
 describe.each(adapters)('Stripe adapter %s session idempotency', (_version, adapter) => {
   it('passes the stable operation key to Stripe PaymentIntent creation', async () => {
     const create = jest.fn(async () => ({

package/src/modules/gateway_stripe/lib/adapters/v2023-10-16.ts

@@ -22,6 +22,8 @@ import {
   buildStripeMetadata,
   normalizeStripePaymentElementSettings,
   resolveStripeRendererKey,
+  resolveStripeRefundStatus,
+  stripeIdempotencyOptions,
 } from '../shared'
 import { verifyStripeWebhook } from '../webhook-handler'
 
@@ -76,11 +78,15 @@ export const stripeAdapterV20231016: GatewayAdapter = {
     const paymentIntent = input.amount
       ? await stripe.paymentIntents.retrieve(input.sessionId)
       : null
-    const captured = await stripe.paymentIntents.capture(input.sessionId, {
-      amount_to_capture: input.amount && paymentIntent
-        ? toCents(input.amount, paymentIntent.currency)
-        : undefined,
-    })
+    const captured = await stripe.paymentIntents.capture(
+      input.sessionId,
+      {
+        amount_to_capture: input.amount && paymentIntent
+          ? toCents(input.amount, paymentIntent.currency)
+          : undefined,
+      },
+      stripeIdempotencyOptions(input.idempotencyKey),
+    )
     return {
       status: mapStripeStatus(captured.status),
       capturedAmount: fromCents(captured.amount_received, captured.currency),
@@ -93,23 +99,30 @@ export const stripeAdapterV20231016: GatewayAdapter = {
     const paymentIntent = input.amount
       ? await stripe.paymentIntents.retrieve(input.sessionId)
       : null
-    const refund = await stripe.refunds.create({
-      payment_intent: input.sessionId,
-      amount: input.amount && paymentIntent
-        ? toCents(input.amount, paymentIntent.currency)
-        : undefined,
-      reason: mapRefundReason(input.reason),
-    })
+    const refund = await stripe.refunds.create(
+      {
+        payment_intent: input.sessionId,
+        amount: input.amount && paymentIntent
+          ? toCents(input.amount, paymentIntent.currency)
+          : undefined,
+        reason: mapRefundReason(input.reason),
+      },
+      stripeIdempotencyOptions(input.idempotencyKey),
+    )
     return {
       refundId: refund.id,
-      status: refund.status === 'succeeded' ? 'refunded' : 'pending',
+      status: await resolveStripeRefundStatus(stripe, refund, paymentIntent?.amount_received),
       refundedAmount: fromCents(refund.amount, refund.currency),
     }
   },
 
   async cancel(input: CancelInput): Promise<CancelResult> {
     const stripe = resolveStripeClient(input.credentials, '2023-10-16')
-    const cancelled = await stripe.paymentIntents.cancel(input.sessionId)
+    const cancelled = await stripe.paymentIntents.cancel(
+      input.sessionId,
+      {},
+      stripeIdempotencyOptions(input.idempotencyKey),
+    )
     return { status: mapStripeStatus(cancelled.status) }
   },
 

package/src/modules/gateway_stripe/lib/adapters/v2024-12-18.ts

@@ -22,6 +22,8 @@ import {
   buildStripeMetadata,
   normalizeStripePaymentElementSettings,
   resolveStripeRendererKey,
+  resolveStripeRefundStatus,
+  stripeIdempotencyOptions,
 } from '../shared'
 import { verifyStripeWebhook } from '../webhook-handler'
 
@@ -79,11 +81,15 @@ export const stripeAdapterV20241218: GatewayAdapter = {
       ? await stripe.paymentIntents.retrieve(input.sessionId)
       : null
 
-    const captured = await stripe.paymentIntents.capture(input.sessionId, {
-      amount_to_capture: input.amount && paymentIntent
-        ? toCents(input.amount, paymentIntent.currency)
-        : undefined,
-    })
+    const captured = await stripe.paymentIntents.capture(
+      input.sessionId,
+      {
+        amount_to_capture: input.amount && paymentIntent
+          ? toCents(input.amount, paymentIntent.currency)
+          : undefined,
+      },
+      stripeIdempotencyOptions(input.idempotencyKey),
+    )
 
     const capturedCurrencyCode = captured.currency.toUpperCase()
 
@@ -100,20 +106,23 @@ export const stripeAdapterV20241218: GatewayAdapter = {
       ? await stripe.paymentIntents.retrieve(input.sessionId)
       : null
 
-    const refund = await stripe.refunds.create({
-      payment_intent: input.sessionId,
-      amount: input.amount && paymentIntent
-        ? toCents(input.amount, paymentIntent.currency)
-        : undefined,
-      reason: mapRefundReason(input.reason),
-      metadata: input.metadata as Record<string, string> | undefined,
-    })
+    const refund = await stripe.refunds.create(
+      {
+        payment_intent: input.sessionId,
+        amount: input.amount && paymentIntent
+          ? toCents(input.amount, paymentIntent.currency)
+          : undefined,
+        reason: mapRefundReason(input.reason),
+        metadata: input.metadata as Record<string, string> | undefined,
+      },
+      stripeIdempotencyOptions(input.idempotencyKey),
+    )
 
     const refundCurrencyCode = refund.currency.toUpperCase()
 
     return {
       refundId: refund.id,
-      status: refund.status === 'succeeded' ? 'refunded' : 'pending',
+      status: await resolveStripeRefundStatus(stripe, refund, paymentIntent?.amount_received),
       refundedAmount: fromCents(refund.amount, refundCurrencyCode),
     }
   },
@@ -121,9 +130,11 @@ export const stripeAdapterV20241218: GatewayAdapter = {
   async cancel(input: CancelInput): Promise<CancelResult> {
     const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)
 
-    const cancelled = await stripe.paymentIntents.cancel(input.sessionId, {
-      cancellation_reason: 'requested_by_customer',
-    })
+    const cancelled = await stripe.paymentIntents.cancel(
+      input.sessionId,
+      { cancellation_reason: 'requested_by_customer' },
+      stripeIdempotencyOptions(input.idempotencyKey),
+    )
 
     return {
       status: mapStripeStatus(cancelled.status),

package/src/modules/gateway_stripe/lib/adapters/v2025-02-24.acacia.ts

@@ -22,6 +22,8 @@ import {
   buildStripeMetadata,
   normalizeStripePaymentElementSettings,
   resolveStripeRendererKey,
+  resolveStripeRefundStatus,
+  stripeIdempotencyOptions,
 } from '../shared'
 import { verifyStripeWebhook } from '../webhook-handler'
 
@@ -79,11 +81,15 @@ export const stripeAdapterV20250224Acacia: GatewayAdapter = {
       ? await stripe.paymentIntents.retrieve(input.sessionId)
       : null
 
-    const captured = await stripe.paymentIntents.capture(input.sessionId, {
-      amount_to_capture: input.amount && paymentIntent
-        ? toCents(input.amount, paymentIntent.currency)
-        : undefined,
-    })
+    const captured = await stripe.paymentIntents.capture(
+      input.sessionId,
+      {
+        amount_to_capture: input.amount && paymentIntent
+          ? toCents(input.amount, paymentIntent.currency)
+          : undefined,
+      },
+      stripeIdempotencyOptions(input.idempotencyKey),
+    )
 
     return {
       status: mapStripeStatus(captured.status),
@@ -98,18 +104,21 @@ export const stripeAdapterV20250224Acacia: GatewayAdapter = {
       ? await stripe.paymentIntents.retrieve(input.sessionId)
       : null
 
-    const refund = await stripe.refunds.create({
-      payment_intent: input.sessionId,
-      amount: input.amount && paymentIntent
-        ? toCents(input.amount, paymentIntent.currency)
-        : undefined,
-      reason: mapRefundReason(input.reason),
-      metadata: input.metadata as Record<string, string> | undefined,
-    })
+    const refund = await stripe.refunds.create(
+      {
+        payment_intent: input.sessionId,
+        amount: input.amount && paymentIntent
+          ? toCents(input.amount, paymentIntent.currency)
+          : undefined,
+        reason: mapRefundReason(input.reason),
+        metadata: input.metadata as Record<string, string> | undefined,
+      },
+      stripeIdempotencyOptions(input.idempotencyKey),
+    )
 
     return {
       refundId: refund.id,
-      status: refund.status === 'succeeded' ? 'refunded' : 'pending',
+      status: await resolveStripeRefundStatus(stripe, refund, paymentIntent?.amount_received),
       refundedAmount: fromCents(refund.amount, refund.currency),
     }
   },
@@ -117,9 +126,11 @@ export const stripeAdapterV20250224Acacia: GatewayAdapter = {
   async cancel(input: CancelInput): Promise<CancelResult> {
     const stripe = resolveStripeClient(input.credentials, STRIPE_API_VERSION)
 
-    const cancelled = await stripe.paymentIntents.cancel(input.sessionId, {
-      cancellation_reason: 'requested_by_customer',
-    })
+    const cancelled = await stripe.paymentIntents.cancel(
+      input.sessionId,
+      { cancellation_reason: 'requested_by_customer' },
+      stripeIdempotencyOptions(input.idempotencyKey),
+    )
 
     return {
       status: mapStripeStatus(cancelled.status),

package/src/modules/gateway_stripe/lib/shared.ts

@@ -1,4 +1,5 @@
 import type { PaymentGatewayPresentationRequest } from '@open-mercato/shared/modules/payment_gateways/types'
+import type Stripe from 'stripe'
 
 const ZERO_DECIMAL_CURRENCIES = new Set([
   'BIF',
@@ -35,6 +36,26 @@ export function fromCents(amount: number, currencyCode: string): number {
     : amount / 100
 }
 
+export function stripeIdempotencyOptions(idempotencyKey?: string): { idempotencyKey: string } | undefined {
+  return idempotencyKey ? { idempotencyKey } : undefined
+}
+
+export async function resolveStripeRefundStatus(
+  stripe: Pick<Stripe, 'charges'>,
+  refund: Stripe.Refund,
+  capturedAmount?: number,
+): Promise<'pending' | 'partially_refunded' | 'refunded'> {
+  if (refund.status !== 'succeeded') return 'pending'
+  const chargeId = typeof refund.charge === 'string' ? refund.charge : refund.charge?.id
+  if (chargeId) {
+    const charge = await stripe.charges.retrieve(chargeId)
+    return charge.amount_refunded < charge.amount ? 'partially_refunded' : 'refunded'
+  }
+  return capturedAmount !== undefined && refund.amount < capturedAmount
+    ? 'partially_refunded'
+    : 'refunded'
+}
+
 export function buildStripeMetadata(input: {
   paymentId: string
   tenantId: string