@easypayment/medusa-paypal 0.1.0

package/.medusa/server/src/modules/paypal/webhook-processor.js

@@ -0,0 +1,265 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REQUIRED_EVENT_PREFIXES = exports.EVENT_STATUS_MAP = void 0;
+exports.isAllowedEventType = isAllowedEventType;
+exports.normalizeResource = normalizeResource;
+exports.normalizeEventVersion = normalizeEventVersion;
+exports.extractIdentifiers = extractIdentifiers;
+exports.extractDisputeDetails = extractDisputeDetails;
+exports.computeNextRetryAt = computeNextRetryAt;
+exports.processPayPalWebhookEvent = processPayPalWebhookEvent;
+const provider_ids_1 = require("./utils/provider-ids");
+exports.EVENT_STATUS_MAP = {
+    "CHECKOUT.ORDER.APPROVED": "authorized",
+    "CHECKOUT.ORDER.CANCELLED": "canceled",
+    "PAYMENT.CAPTURE.COMPLETED": "captured",
+    "PAYMENT.CAPTURE.DENIED": "error",
+    "PAYMENT.CAPTURE.REFUNDED": "canceled",
+    "PAYMENT.CAPTURE.REVERSED": "canceled",
+    "PAYMENT.AUTHORIZATION.CREATED": "authorized",
+    "PAYMENT.AUTHORIZATION.VOIDED": "canceled",
+    "PAYMENT.AUTHORIZATION.DENIED": "error",
+    "PAYMENT.REFUND.COMPLETED": "canceled",
+    "PAYMENT.REFUND.DENIED": "error",
+};
+exports.REQUIRED_EVENT_PREFIXES = [
+    "PAYMENT.CAPTURE.",
+    "CHECKOUT.ORDER.",
+    "PAYMENT.AUTHORIZATION.",
+    "PAYMENT.REFUND.",
+    "CUSTOMER.DISPUTE.",
+];
+function isAllowedEventType(eventType) {
+    return exports.REQUIRED_EVENT_PREFIXES.some((prefix) => eventType.startsWith(prefix));
+}
+function normalizeResource(payload) {
+    const resource = payload?.resource;
+    if (!resource) {
+        return {};
+    }
+    if (typeof resource === "string") {
+        try {
+            return JSON.parse(resource);
+        }
+        catch {
+            return {};
+        }
+    }
+    return resource;
+}
+function normalizeEventVersion(payload) {
+    const raw = payload?.event_version ??
+        payload?.resource_version ??
+        payload?.resource?.resource_version ??
+        payload?.resource?.version ??
+        null;
+    if (!raw) {
+        return null;
+    }
+    return String(raw).trim().replace(/^v/i, "");
+}
+function extractIdentifiers(resource) {
+    const relatedIds = resource?.supplementary_data?.related_ids || {};
+    const orderId = relatedIds?.order_id ||
+        resource?.purchase_units?.[0]?.custom_id ||
+        resource?.custom_id ||
+        resource?.purchase_units?.[0]?.reference_id;
+    const captureId = relatedIds?.capture_id ||
+        resource?.id ||
+        resource?.purchase_units?.[0]?.payments?.captures?.[0]?.id;
+    const refundId = relatedIds?.refund_id ||
+        resource?.id ||
+        resource?.purchase_units?.[0]?.payments?.refunds?.[0]?.id;
+    const cartId = resource?.custom_id ||
+        resource?.purchase_units?.[0]?.custom_id ||
+        resource?.purchase_units?.[0]?.reference_id;
+    return { orderId, captureId, refundId, cartId, resource };
+}
+function extractDisputeDetails(resource) {
+    const disputeId = String(resource?.dispute_id || resource?.id || "");
+    const disputedTx = Array.isArray(resource?.disputed_transactions)
+        ? resource.disputed_transactions[0]
+        : null;
+    const transactionId = disputedTx?.transaction_id || undefined;
+    const sellerTransactionId = disputedTx?.seller_transaction_id || undefined;
+    const customId = disputedTx?.custom_id || resource?.custom_id || undefined;
+    const orderId = resource?.order_id ||
+        resource?.supplementary_data?.related_ids?.order_id ||
+        customId ||
+        undefined;
+    const cartId = customId || undefined;
+    const amount = resource?.dispute_amount?.value ||
+        resource?.amount?.value ||
+        resource?.dispute_amount?.amount ||
+        undefined;
+    const currencyCode = resource?.dispute_amount?.currency_code ||
+        resource?.amount?.currency_code ||
+        resource?.dispute_amount?.currency ||
+        undefined;
+    return {
+        disputeId,
+        status: resource?.status || null,
+        reason: resource?.reason || null,
+        stage: resource?.dispute_life_cycle_stage || resource?.stage || null,
+        amount: amount ? String(amount) : null,
+        currencyCode: currencyCode ? String(currencyCode) : null,
+        transactionId: transactionId ? String(transactionId) : null,
+        sellerTransactionId: sellerTransactionId ? String(sellerTransactionId) : null,
+        orderId: orderId ? String(orderId) : null,
+        cartId: cartId ? String(cartId) : null,
+    };
+}
+async function resolveDisputeOrderId(container, orderId, cartId) {
+    const query = container.resolve("query");
+    const cleanedOrderId = orderId?.trim();
+    const cleanedCartId = cartId?.trim();
+    if (cleanedOrderId) {
+        try {
+            const { data } = await query.graph({
+                entity: "order",
+                fields: ["id"],
+                filters: { id: cleanedOrderId },
+            });
+            const match = data?.[0]?.id;
+            if (match) {
+                return String(match);
+            }
+        }
+        catch {
+            // ignore order lookup failures
+        }
+    }
+    if (cleanedCartId) {
+        try {
+            const { data } = await query.graph({
+                entity: "order",
+                fields: ["id", "cart_id"],
+                filters: { cart_id: cleanedCartId },
+            });
+            const match = data?.[0]?.id;
+            if (match) {
+                return String(match);
+            }
+        }
+        catch {
+            // ignore order lookup failures
+        }
+    }
+    return null;
+}
+function mergeRefunds(existing, incoming) {
+    const seen = new Set();
+    const merged = [];
+    for (const refund of [...existing, ...incoming]) {
+        const id = refund?.id ? String(refund.id) : "";
+        if (id && seen.has(id)) {
+            continue;
+        }
+        if (id) {
+            seen.add(id);
+        }
+        merged.push(refund);
+    }
+    return merged;
+}
+async function updatePaymentSession(container, cartId, status, data) {
+    const paymentCollectionService = container.resolve("payment_collection");
+    const paymentSessionService = container.resolve("payment_session");
+    const pc = await paymentCollectionService.retrieveByCartId(cartId).catch(() => null);
+    if (!pc?.id) {
+        return;
+    }
+    const sessions = await paymentSessionService.list({ payment_collection_id: pc.id });
+    const paypalSession = sessions?.find((s) => (0, provider_ids_1.isPayPalProviderId)(s.provider_id));
+    if (!paypalSession) {
+        return;
+    }
+    const existingData = (paypalSession.data || {});
+    const existingPaypal = (existingData.paypal || {});
+    const existingRefunds = Array.isArray(existingPaypal.refunds) ? existingPaypal.refunds : [];
+    const incomingRefunds = Array.isArray(data.refunds) ? data.refunds : null;
+    const nextRefunds = incomingRefunds
+        ? mergeRefunds(existingRefunds, incomingRefunds)
+        : existingRefunds;
+    await paymentSessionService.update(paypalSession.id, {
+        status,
+        data: {
+            ...existingData,
+            paypal: {
+                ...existingPaypal,
+                ...data,
+                refunds: nextRefunds,
+            },
+        },
+    });
+}
+function computeNextRetryAt(attemptCount) {
+    const scheduleMinutes = [5, 15, 30, 60, 120];
+    const delayMinutes = scheduleMinutes[Math.min(attemptCount - 1, scheduleMinutes.length - 1)];
+    if (!delayMinutes || attemptCount <= 0) {
+        return null;
+    }
+    return new Date(Date.now() + delayMinutes * 60 * 1000);
+}
+async function processPayPalWebhookEvent(container, input) {
+    const paypal = container.resolve("paypal_onboarding");
+    const resource = normalizeResource(input.payload);
+    const { orderId, captureId, refundId, cartId } = extractIdentifiers(resource);
+    const disputeDetails = input.eventType.startsWith("CUSTOMER.DISPUTE.") ? extractDisputeDetails(resource) : null;
+    const refundReason = String(resource?.note_to_payer || resource?.reason || resource?.seller_note || "").trim() ||
+        undefined;
+    const refundReasonCode = String(resource?.reason_code || resource?.reasonCode || "").trim() || undefined;
+    if (input.eventType.startsWith("CUSTOMER.DISPUTE.")) {
+        if (disputeDetails?.disputeId) {
+            const resolvedOrderId = await resolveDisputeOrderId(container, disputeDetails.orderId, disputeDetails.cartId);
+            await paypal.upsertDispute({
+                dispute_id: disputeDetails.disputeId,
+                status: disputeDetails.status,
+                reason: disputeDetails.reason,
+                stage: disputeDetails.stage,
+                amount: disputeDetails.amount,
+                currency_code: disputeDetails.currencyCode,
+                transaction_id: disputeDetails.transactionId,
+                seller_transaction_id: disputeDetails.sellerTransactionId,
+                order_id: resolvedOrderId || disputeDetails.orderId,
+                cart_id: disputeDetails.cartId,
+                payload: resource,
+            });
+        }
+    }
+    const status = exports.EVENT_STATUS_MAP[input.eventType];
+    if (status && cartId) {
+        const refundEntry = refundId || resource?.status
+            ? [
+                {
+                    id: refundId,
+                    status: resource?.status,
+                    reason: refundReason,
+                    reason_code: refundReasonCode,
+                    amount: resource?.amount,
+                    raw: resource,
+                },
+            ]
+            : null;
+        await updatePaymentSession(container, cartId, status, {
+            order_id: orderId,
+            capture_id: captureId,
+            refund_id: refundId,
+            refund_status: resource?.status,
+            refund_reason: refundReason,
+            refund_reason_code: refundReasonCode,
+            refunds: refundEntry || undefined,
+            webhook_event_type: input.eventType,
+            webhook_resource: resource,
+        });
+    }
+    return {
+        orderId,
+        captureId,
+        refundId,
+        cartId,
+        disputeId: disputeDetails?.disputeId,
+        resource,
+    };
+}
+//# sourceMappingURL=webhook-processor.js.map

package/.medusa/server/src/modules/paypal/webhook-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-processor.js","sourceRoot":"","sources":["../../../../../src/modules/paypal/webhook-processor.ts"],"names":[],"mappings":"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"}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# @easypayment/medusa-paypal
+
+PayPal backend plugin for **Medusa v2** (payment providers + Admin settings extensions).
+
+## Install
+
+```bash
+npm install @easypayment/medusa-paypal
+# or
+yarn add @easypayment/medusa-paypal
+```
+
+## Register in `medusa-config.ts`
+
+```ts
+plugins: [
+  { resolve: "@easypayment/medusa-paypal", options: {} },
+]
+```
+
+> If you also register the payment providers via the Payment module, use the exported provider paths under
+> `@easypayment/medusa-paypal/providers/*`.
+
+---
+
+## Included backend code
+
+- `src/modules/paypal/**` – PayPal module, provider, migrations, services, and utils.
+- `src/api/admin/paypal/**` – Admin PayPal routes.
+- `src/api/store/paypal/**` – Storefront PayPal routes.
+- `src/api/admin/payment-collections/[id]/payment-sessions/**` – Admin PayPal payment sessions route.
+- `src/api/store/payment-collections/[id]/payment-sessions/**` – Store PayPal payment sessions route.
+- `src/jobs/paypal-*.ts` – PayPal jobs (reconcile and webhook retry).
+
+## How to use this package (step-by-step)
+
+1. **Move PayPal backend code into the package**  
+   Keep all PayPal backend files in this package under `packages/paypal-backend/src`.
+
+2. **Point Medusa to the package**  
+   In `medusa-config.ts`, update the PayPal module/provider resolve paths to use
+   `./packages/paypal-backend/src/modules/paypal` (and the `dist` path for production).
+
+3. **Install dependencies (if needed)**  
+   If you later publish or share this package, add it to your project dependencies
+   via a `file:` dependency or workspace setup. For local use, the project can
+   reference the package by path.
+
+4. **Run the project**  
+   Start the Medusa server as usual:
+   - `pnpm dev` or `yarn dev`
+
+## Removing PayPal backend files from `src`
+
+Once the package is in place, remove the PayPal backend files from `src` so that
+only the package holds the backend implementation. The PayPal frontend/admin UI
+files can remain in `src/admin` if you still need them.
+
+
+## Publishing
+
+1. Update `name` in `package.json` to your npm scope (for example `@yourorg/medusa-paypal`).
+2. Run `npm install`.
+3. Run `npm run build` (or `npx medusa plugin:build`).
+4. Publish with `npm publish --access public` (scoped packages).
+
+> Note: The plugin ships its compiled output under `.medusa/server`, and the `exports` map exposes the Admin extension at `@scope/pkg/admin`.

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@easypayment/medusa-paypal",
+  "version": "0.1.0",
+  "private": false,
+  "description": "PayPal integration for Medusa v2 (payment providers + admin settings pages)",
+  "license": "MIT",
+  "keywords": [
+    "medusa-v2",
+    "medusa-plugin-integration",
+    "medusa-plugin-payment",
+    "paypal"
+  ],
+  "main": "./.medusa/server/src/index.js",
+  "types": "./.medusa/server/src/index.d.ts",
+  "files": [
+    ".medusa/server",
+    "src",
+    "package.json",
+    "README.md",
+    "LICENSE",
+    "tsconfig.json",
+    "postcss.config.cjs"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    "./admin": "./.medusa/server/src/admin/index.mjs",
+    "./workflows": "./.medusa/server/src/workflows/index.js",
+    "./providers/*": "./.medusa/server/src/providers/*/index.js",
+    "./modules/*": "./.medusa/server/src/modules/*/index.js",
+    "./*": "./.medusa/server/src/*.js"
+  },
+  "scripts": {
+    "build": "medusa plugin:build",
+    "develop": "medusa plugin:develop",
+    "prepublishOnly": "medusa plugin:build"
+  },
+  "devDependencies": {
+    "@medusajs/admin-sdk": "2.12.5",
+    "@medusajs/cli": "2.12.5",
+    "@medusajs/framework": "2.12.5",
+    "@medusajs/medusa": "2.12.5",
+    "@medusajs/test-utils": "2.12.5",
+    "@medusajs/ui": "^4.0.0",
+    "@medusajs/icons": "2.12.5",
+    "@swc/core": "^1.5.7",
+    "typescript": "^5.6.2"
+  },
+  "peerDependencies": {
+    "@medusajs/admin-sdk": "^2.12.0",
+    "@medusajs/framework": "^2.12.0",
+    "@medusajs/medusa": "^2.12.0",
+    "@medusajs/ui": "^4.0.0",
+    "@medusajs/icons": "^2.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/postcss.config.cjs

@@ -0,0 +1,3 @@
+module.exports = {
+  plugins: []
+}

package/src/admin/index.ts

@@ -0,0 +1,7 @@
+import { definePlugin } from "@medusajs/admin-sdk"
+import paypalRoute from "./routes/settings/paypal/page"
+
+export default definePlugin({
+  id: "paypal-backend",
+  routes: [paypalRoute],
+})

package/src/admin/routes/settings/paypal/_components/Tabs.tsx

@@ -0,0 +1,55 @@
+import React from "react"
+import { Link, useLocation } from "react-router-dom"
+
+type Tab = {
+  label: string
+  to: string
+}
+
+const BASE = "/settings/paypal"
+
+const TABS: Tab[] = [
+  { label: "PayPal Connection", to: `${BASE}/connection` },
+  { label: "PayPal Settings", to: `${BASE}/paypal-settings` },
+  { label: "Advanced Card Payments", to: `${BASE}/advanced-card-payments` },
+  { label: "Disputes", to: `${BASE}/disputes` },
+  { label: "Reconciliation Status", to: `${BASE}/reconciliation-status` },
+/*  { label: "Google Pay", to: `${BASE}/google-pay` },
+  { label: "Apple Pay", to: `${BASE}/apple-pay` },
+  { label: "Pay Later Messaging", to: `${BASE}/pay-later-messaging` }, */
+  { label: "Audit Logs", to: `${BASE}/audit-logs` },
+  { label: "Additional Settings", to: `${BASE}/additional-settings` },
+]
+
+function isActive(pathname: string, to: string) {
+  // exact match OR nested route under same tab
+  return pathname === to || pathname.startsWith(to + "/")
+}
+
+export default function PayPalTabs() {
+  const { pathname } = useLocation()
+
+  return (
+    <div className="border-b border-ui-border-base">
+      <div className="flex flex-wrap gap-6 text-sm">
+        {TABS.map((t) => {
+          const active = isActive(pathname, t.to)
+
+          return (
+            <Link
+              key={t.to}
+              to={t.to}
+              className={
+                active
+                  ? "border-b-2 border-ui-fg-base pb-2 font-medium text-ui-fg-base"
+                  : "pb-2 text-ui-fg-subtle hover:text-ui-fg-base"
+              }
+            >
+              {t.label}
+            </Link>
+          )
+        })}
+      </div>
+    </div>
+  )
+}

package/src/admin/routes/settings/paypal/_components/Toast.tsx

@@ -0,0 +1,51 @@
+import React, { useEffect } from "react"
+
+export type ToastKind = "success" | "error"
+
+export type ToastState = {
+  kind: ToastKind
+  message: string
+} | null
+
+type Props = {
+  toast: ToastState
+  onClose: () => void
+}
+
+export default function Toast({ toast, onClose }: Props) {
+  useEffect(() => {
+    if (!toast) return
+    const t = setTimeout(() => onClose(), 2500)
+    return () => clearTimeout(t)
+  }, [toast, onClose])
+
+  if (!toast) return null
+
+  const isSuccess = toast.kind === "success"
+
+  return (
+    <div className="fixed right-6 top-6 z-[9999]">
+      <div
+        className={[
+          "min-w-[280px] max-w-[420px] rounded-lg border px-4 py-3 shadow-md",
+          isSuccess ? "border-emerald-500/30 bg-emerald-500/10" : "border-rose-500/30 bg-rose-500/10",
+        ].join(" ")}
+        role="status"
+        aria-live="polite"
+      >
+        <div className="flex items-start gap-3">
+          <div className={["mt-0.5 h-2.5 w-2.5 rounded-full", isSuccess ? "bg-emerald-500" : "bg-rose-500"].join(" ")} />
+          <div className="flex-1 text-sm text-ui-fg-base">{toast.message}</div>
+          <button
+            type="button"
+            onClick={onClose}
+            className="text-ui-fg-subtle hover:text-ui-fg-base"
+            aria-label="Close"
+          >
+            ×
+          </button>
+        </div>
+      </div>
+    </div>
+  )
+}