@easypayment/medusa-paypal 0.1.0

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/20260301090000_create_paypal_audit_log.ts

@@ -0,0 +1,26 @@
+import { Migration } from "@medusajs/framework/mikro-orm/migrations"
+
+export class Migration20260301090000 extends Migration {
+  async up(): Promise<void> {
+    this.addSql(`
+      CREATE TABLE IF NOT EXISTS "paypal_audit_log" (
+        "id" text NOT NULL,
+        "event_type" text NOT NULL,
+        "metadata" 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_audit_log_pkey" PRIMARY KEY ("id")
+      );
+
+      CREATE INDEX IF NOT EXISTS "idx_paypal_audit_log_deleted_at"
+        ON "paypal_audit_log" ("deleted_at");
+    `)
+  }
+
+  async down(): Promise<void> {
+    this.addSql(`
+      DROP TABLE IF EXISTS "paypal_audit_log" 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/20260501090000_create_paypal_dispute.ts

@@ -0,0 +1,40 @@
+import { Migration } from "@medusajs/framework/mikro-orm/migrations"
+
+export class Migration20260501090000 extends Migration {
+  async up(): Promise<void> {
+    this.addSql(`
+      CREATE TABLE IF NOT EXISTS "paypal_dispute" (
+        "id" text NOT NULL,
+        "dispute_id" text NOT NULL,
+        "status" text NULL,
+        "reason" text NULL,
+        "stage" text NULL,
+        "amount" text NULL,
+        "currency_code" text NULL,
+        "transaction_id" text NULL,
+        "seller_transaction_id" text NULL,
+        "order_id" text NULL,
+        "cart_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_dispute_pkey" PRIMARY KEY ("id"),
+        CONSTRAINT "paypal_dispute_dispute_id_unique" UNIQUE ("dispute_id")
+      );
+
+      CREATE INDEX IF NOT EXISTS "idx_paypal_dispute_deleted_at"
+        ON "paypal_dispute" ("deleted_at");
+      CREATE INDEX IF NOT EXISTS "idx_paypal_dispute_order_id"
+        ON "paypal_dispute" ("order_id");
+      CREATE INDEX IF NOT EXISTS "idx_paypal_dispute_cart_id"
+        ON "paypal_dispute" ("cart_id");
+    `)
+  }
+
+  async down(): Promise<void> {
+    this.addSql(`
+      DROP TABLE IF EXISTS "paypal_dispute" 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/models/paypal_audit_log.ts

@@ -0,0 +1,9 @@
+import { model } from "@medusajs/framework/utils"
+
+const PayPalAuditLog = model.define("paypal_audit_log", {
+  id: model.id().primaryKey(),
+  event_type: model.text(),
+  metadata: model.json().nullable(),
+})
+
+export default PayPalAuditLog

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

@@ -0,0 +1,21 @@
+import { model } from "@medusajs/framework/utils"
+
+const PayPalConnection = model.define("paypal_connection", {
+  id: model.id().primaryKey(),
+
+  environment: model.text(), // sandbox|live
+  status: model.text(),      // disconnected|pending|pending_credentials|connected|revoked
+
+  shared_id: model.text().nullable(),
+  auth_code: model.text().nullable(),
+
+  seller_client_id: model.text().nullable(),
+  seller_client_secret: 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_dispute.ts

@@ -0,0 +1,18 @@
+import { model } from "@medusajs/framework/utils"
+
+const PayPalDispute = model.define("paypal_dispute", {
+  id: model.id().primaryKey(),
+  dispute_id: model.text().unique(),
+  status: model.text().nullable(),
+  reason: model.text().nullable(),
+  stage: model.text().nullable(),
+  amount: model.text().nullable(),
+  currency_code: model.text().nullable(),
+  transaction_id: model.text().nullable(),
+  seller_transaction_id: model.text().nullable(),
+  order_id: model.text().nullable(),
+  cart_id: model.text().nullable(),
+  payload: model.json().nullable(),
+})
+
+export default PayPalDispute

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`).