@easypayment/medusa-payment-paypal 0.7.4

package/src/modules/paypal/migrations/20260201090000_create_paypal_webhook_event.ts

@@ -0,0 +1,29 @@
+import { Migration } from "@medusajs/framework/mikro-orm/migrations"
+
+export class Migration20260201090000 extends Migration {
+  async up(): Promise<void> {
+    this.addSql(`
+      CREATE TABLE IF NOT EXISTS "paypal_webhook_event" (
+        "id" text NOT NULL,
+        "event_id" text NOT NULL,
+        "event_type" text NOT NULL,
+        "resource_id" text NULL,
+        "payload" jsonb NOT NULL DEFAULT '{}'::jsonb,
+        "created_at" timestamptz NOT NULL DEFAULT now(),
+        "updated_at" timestamptz NOT NULL DEFAULT now(),
+        "deleted_at" timestamptz NULL,
+        CONSTRAINT "paypal_webhook_event_pkey" PRIMARY KEY ("id"),
+        CONSTRAINT "paypal_webhook_event_event_id_unique" UNIQUE ("event_id")
+      );
+
+      CREATE INDEX IF NOT EXISTS "idx_paypal_webhook_event_deleted_at"
+        ON "paypal_webhook_event" ("deleted_at");
+    `)
+  }
+
+  async down(): Promise<void> {
+    this.addSql(`
+      DROP TABLE IF EXISTS "paypal_webhook_event" CASCADE;
+    `)
+  }
+}

package/src/modules/paypal/migrations/20260401090000_create_paypal_metric.ts

@@ -0,0 +1,27 @@
+import { Migration } from "@medusajs/framework/mikro-orm/migrations"
+
+export class Migration20260401090000 extends Migration {
+  async up(): Promise<void> {
+    this.addSql(`
+      CREATE TABLE IF NOT EXISTS "paypal_metric" (
+        "id" text NOT NULL,
+        "name" text NOT NULL,
+        "data" jsonb NOT NULL DEFAULT '{}'::jsonb,
+        "created_at" timestamptz NOT NULL DEFAULT now(),
+        "updated_at" timestamptz NOT NULL DEFAULT now(),
+        "deleted_at" timestamptz NULL,
+        CONSTRAINT "paypal_metric_pkey" PRIMARY KEY ("id"),
+        CONSTRAINT "paypal_metric_name_unique" UNIQUE ("name")
+      );
+
+      CREATE INDEX IF NOT EXISTS "idx_paypal_metric_deleted_at"
+        ON "paypal_metric" ("deleted_at");
+    `)
+  }
+
+  async down(): Promise<void> {
+    this.addSql(`
+      DROP TABLE IF EXISTS "paypal_metric" CASCADE;
+    `)
+  }
+}

package/src/modules/paypal/migrations/20260701090000_add_paypal_webhook_event_processing.ts

@@ -0,0 +1,31 @@
+import { Migration } from "@medusajs/framework/mikro-orm/migrations"
+
+export class Migration20260701090000 extends Migration {
+  async up(): Promise<void> {
+    this.addSql(`
+      ALTER TABLE "paypal_webhook_event"
+        ADD COLUMN IF NOT EXISTS "event_version" text NULL,
+        ADD COLUMN IF NOT EXISTS "transmission_id" text NULL,
+        ADD COLUMN IF NOT EXISTS "transmission_time" timestamptz NULL,
+        ADD COLUMN IF NOT EXISTS "status" text NOT NULL DEFAULT 'pending',
+        ADD COLUMN IF NOT EXISTS "attempt_count" integer NOT NULL DEFAULT 0,
+        ADD COLUMN IF NOT EXISTS "next_retry_at" timestamptz NULL,
+        ADD COLUMN IF NOT EXISTS "processed_at" timestamptz NULL,
+        ADD COLUMN IF NOT EXISTS "last_error" text NULL;
+    `)
+  }
+
+  async down(): Promise<void> {
+    this.addSql(`
+      ALTER TABLE "paypal_webhook_event"
+        DROP COLUMN IF EXISTS "event_version",
+        DROP COLUMN IF EXISTS "transmission_id",
+        DROP COLUMN IF EXISTS "transmission_time",
+        DROP COLUMN IF EXISTS "status",
+        DROP COLUMN IF EXISTS "attempt_count",
+        DROP COLUMN IF EXISTS "next_retry_at",
+        DROP COLUMN IF EXISTS "processed_at",
+        DROP COLUMN IF EXISTS "last_error";
+    `)
+  }
+}

package/src/modules/paypal/migrations/20261101090000_remove_paypal_reconciliation_status.ts

@@ -0,0 +1,25 @@
+import { Migration } from "@medusajs/framework/mikro-orm/migrations"
+
+export class Migration20261101090000 extends Migration {
+  async up(): Promise<void> {
+    this.addSql(`
+      DELETE FROM "paypal_metric"
+      WHERE "name" = 'reconcile_status';
+
+      DROP TABLE IF EXISTS "paypal_reconciliation_status" CASCADE;
+    `)
+  }
+
+  async down(): Promise<void> {
+    this.addSql(`
+      CREATE TABLE IF NOT EXISTS "paypal_reconciliation_status" (
+        "id" text NOT NULL,
+        "status" text NOT NULL,
+        "data" jsonb NOT NULL DEFAULT '{}'::jsonb,
+        "created_at" timestamptz NOT NULL DEFAULT now(),
+        "updated_at" timestamptz NOT NULL DEFAULT now(),
+        CONSTRAINT "paypal_reconciliation_status_pkey" PRIMARY KEY ("id")
+      );
+    `)
+  }
+}

package/src/modules/paypal/migrations/20261201090000_remove_paypal_audit_log.ts

@@ -0,0 +1,26 @@
+import { Migration } from "@medusajs/framework/mikro-orm/migrations"
+
+export class Migration20261201090000 extends Migration {
+  async up(): Promise<void> {
+    this.addSql(`
+      DROP TABLE IF EXISTS "paypal_audit_log" CASCADE;
+    `)
+  }
+
+  async down(): Promise<void> {
+    this.addSql(`
+      CREATE TABLE IF NOT EXISTS "paypal_audit_log" (
+        "id" text NOT NULL,
+        "event_type" text NOT NULL,
+        "metadata" jsonb NULL,
+        "created_at" timestamptz NOT NULL DEFAULT now(),
+        "updated_at" timestamptz NOT NULL DEFAULT now(),
+        "deleted_at" timestamptz NULL,
+        CONSTRAINT "paypal_audit_log_pkey" PRIMARY KEY ("id")
+      );
+
+      CREATE INDEX IF NOT EXISTS "idx_paypal_audit_log_deleted_at"
+        ON "paypal_audit_log" ("deleted_at");
+    `)
+  }
+}

package/src/modules/paypal/migrations/20270101090000_set_paypal_environment_default_live.ts

@@ -0,0 +1,11 @@
+import { Migration } from "@mikro-orm/migrations"
+
+export class Migration20270101090000 extends Migration {
+  override async up(): Promise<void> {
+    this.addSql(`alter table if exists "paypal_connection" alter column "environment" set default 'live';`)
+  }
+
+  override async down(): Promise<void> {
+    this.addSql(`alter table if exists "paypal_connection" alter column "environment" set default 'sandbox';`)
+  }
+}

package/src/modules/paypal/migrations/20270102090000_add_paypal_seller_email.ts

@@ -0,0 +1,11 @@
+import { Migration } from "@mikro-orm/migrations"
+
+export class Migration20270102090000 extends Migration {
+  override async up(): Promise<void> {
+    this.addSql(`alter table if exists "paypal_connection" add column if not exists "seller_email" text null;`)
+  }
+
+  override async down(): Promise<void> {
+    this.addSql(`alter table if exists "paypal_connection" drop column if exists "seller_email";`)
+  }
+}

package/src/modules/paypal/migrations/20270103090000_add_paypal_seller_merchant_id.ts

@@ -0,0 +1,11 @@
+import { Migration } from "@mikro-orm/migrations"
+
+export class Migration20270103090000 extends Migration {
+  override async up(): Promise<void> {
+    this.addSql(`alter table if exists "paypal_connection" add column if not exists "seller_merchant_id" text null;`)
+  }
+
+  override async down(): Promise<void> {
+    this.addSql(`alter table if exists "paypal_connection" drop column if exists "seller_merchant_id";`)
+  }
+}

package/src/modules/paypal/migrations/20270201000000_add_webhook_dead_letter.ts

@@ -0,0 +1,17 @@
+import { Migration } from "@medusajs/framework/mikro-orm/migrations"
+
+export class Migration20270201000000 extends Migration {
+  async up(): Promise<void> {
+    this.addSql(`
+      CREATE INDEX IF NOT EXISTS "idx_paypal_webhook_event_status_retry"
+        ON "paypal_webhook_event" ("status", "next_retry_at")
+        WHERE "status" = 'failed';
+    `)
+  }
+
+  async down(): Promise<void> {
+    this.addSql(`
+      DROP INDEX IF EXISTS "idx_paypal_webhook_event_status_retry";
+    `)
+  }
+}

package/src/modules/paypal/models/paypal_connection.ts

@@ -0,0 +1,23 @@
+import { model } from "@medusajs/framework/utils"
+
+const PayPalConnection = model.define("paypal_connection", {
+  id: model.id().primaryKey(),
+
+  environment: model.text(),
+  status: model.text(),
+
+  shared_id: model.text().nullable(),
+  auth_code: model.text().nullable(),
+
+  seller_client_id: model.text().nullable(),
+  seller_client_secret: model.text().nullable(),
+  seller_merchant_id: model.text().nullable(),
+  seller_email: model.text().nullable(),
+
+  app_access_token: model.text().nullable(),
+  app_access_token_expires_at: model.dateTime().nullable(),
+
+  metadata: model.json().nullable(),
+})
+
+export default PayPalConnection

package/src/modules/paypal/models/paypal_metric.ts

@@ -0,0 +1,9 @@
+import { model } from "@medusajs/framework/utils"
+
+const PayPalMetric = model.define("paypal_metric", {
+  id: model.id().primaryKey(),
+  name: model.text().unique(),
+  data: model.json().nullable(),
+})
+
+export default PayPalMetric

package/src/modules/paypal/models/paypal_settings.ts

@@ -0,0 +1,8 @@
+import { model } from "@medusajs/framework/utils"
+
+const PayPalSettings = model.define("paypal_settings", {
+  id: model.id().primaryKey(),
+  data: model.json().nullable(),
+})
+
+export default PayPalSettings

package/src/modules/paypal/models/paypal_webhook_event.ts

@@ -0,0 +1,19 @@
+import { model } from "@medusajs/framework/utils"
+
+const PayPalWebhookEvent = model.define("paypal_webhook_event", {
+  id: model.id().primaryKey(),
+  event_id: model.text().unique(),
+  event_type: model.text(),
+  event_version: model.text().nullable(),
+  transmission_id: model.text().nullable(),
+  transmission_time: model.dateTime().nullable(),
+  status: model.text().default("pending"),
+  attempt_count: model.number().default(0),
+  next_retry_at: model.dateTime().nullable(),
+  processed_at: model.dateTime().nullable(),
+  last_error: model.text().nullable(),
+  resource_id: model.text().nullable(),
+  payload: model.json().nullable(),
+})
+
+export default PayPalWebhookEvent

package/src/modules/paypal/payment-provider/README.md

@@ -0,0 +1,22 @@
+# PayPal Payment Provider (Checkout)
+
+This folder adds a **Payment Module Provider** so PayPal can appear in checkout.
+
+Register it in `medusa-config.ts` under the Payment module:
+
+```ts
+{
+  resolve: "@medusajs/medusa/payment",
+  options: {
+    providers: [
+      {
+        resolve: "./src/modules/paypal/payment-provider",
+        id: "paypal",
+        options: {},
+      },
+    ],
+  },
+}
+```
+
+Then enable PayPal in Admin -> Regions -> Payment Providers (use `paypal`).