@easypayment/medusa-paypal 0.7.3 → 0.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -322,6 +322,9 @@ function AdvancedCardPaymentsTab() {
322
322
  function PayPalApplePayPage() {
323
323
  return /* @__PURE__ */ jsxRuntime.jsx(reactRouterDom.Navigate, { to: "/settings/paypal/connection", replace: true });
324
324
  }
325
+ function PayPalGooglePayPage() {
326
+ return /* @__PURE__ */ jsxRuntime.jsx(reactRouterDom.Navigate, { to: "/settings/paypal/connection", replace: true });
327
+ }
325
328
  const config = adminSdk.defineRouteConfig({
326
329
  label: "PayPal Connection",
327
330
  hide: true
@@ -915,9 +918,6 @@ function PayPalConnectionPage() {
915
918
  ` })
916
919
  ] });
917
920
  }
918
- function PayPalGooglePayPage() {
919
- return /* @__PURE__ */ jsxRuntime.jsx(reactRouterDom.Navigate, { to: "/settings/paypal/connection", replace: true });
920
- }
921
921
  function PayPalPayLaterMessagingPage() {
922
922
  return /* @__PURE__ */ jsxRuntime.jsx(reactRouterDom.Navigate, { to: "/settings/paypal/connection", replace: true });
923
923
  }
@@ -1213,14 +1213,14 @@ const routeModule = {
1213
1213
  Component: PayPalApplePayPage,
1214
1214
  path: "/settings/paypal/apple-pay"
1215
1215
  },
1216
- {
1217
- Component: PayPalConnectionPage,
1218
- path: "/settings/paypal/connection"
1219
- },
1220
1216
  {
1221
1217
  Component: PayPalGooglePayPage,
1222
1218
  path: "/settings/paypal/google-pay"
1223
1219
  },
1220
+ {
1221
+ Component: PayPalConnectionPage,
1222
+ path: "/settings/paypal/connection"
1223
+ },
1224
1224
  {
1225
1225
  Component: PayPalPayLaterMessagingPage,
1226
1226
  path: "/settings/paypal/pay-later-messaging"
@@ -321,6 +321,9 @@ function AdvancedCardPaymentsTab() {
321
321
  function PayPalApplePayPage() {
322
322
  return /* @__PURE__ */ jsx(Navigate, { to: "/settings/paypal/connection", replace: true });
323
323
  }
324
+ function PayPalGooglePayPage() {
325
+ return /* @__PURE__ */ jsx(Navigate, { to: "/settings/paypal/connection", replace: true });
326
+ }
324
327
  const config = defineRouteConfig({
325
328
  label: "PayPal Connection",
326
329
  hide: true
@@ -914,9 +917,6 @@ function PayPalConnectionPage() {
914
917
  ` })
915
918
  ] });
916
919
  }
917
- function PayPalGooglePayPage() {
918
- return /* @__PURE__ */ jsx(Navigate, { to: "/settings/paypal/connection", replace: true });
919
- }
920
920
  function PayPalPayLaterMessagingPage() {
921
921
  return /* @__PURE__ */ jsx(Navigate, { to: "/settings/paypal/connection", replace: true });
922
922
  }
@@ -1212,14 +1212,14 @@ const routeModule = {
1212
1212
  Component: PayPalApplePayPage,
1213
1213
  path: "/settings/paypal/apple-pay"
1214
1214
  },
1215
- {
1216
- Component: PayPalConnectionPage,
1217
- path: "/settings/paypal/connection"
1218
- },
1219
1215
  {
1220
1216
  Component: PayPalGooglePayPage,
1221
1217
  path: "/settings/paypal/google-pay"
1222
1218
  },
1219
+ {
1220
+ Component: PayPalConnectionPage,
1221
+ path: "/settings/paypal/connection"
1222
+ },
1223
1223
  {
1224
1224
  Component: PayPalPayLaterMessagingPage,
1225
1225
  path: "/settings/paypal/pay-later-messaging"
package/README.md CHANGED
@@ -1,31 +1,54 @@
1
- <div align="center">
1
+ # PayPal for Medusa
2
2
 
3
- <h1>PayPal for Medusa</h1>
3
+ **Accept PayPal and advanced credit card payments in your Medusa v2 store — built by an official PayPal Partner.**
4
4
 
5
- <p><strong>PayPal payment plugin for Medusa</strong></p>
5
+ [![npm version](https://img.shields.io/npm/v/@easypayment/medusa-paypal?color=blue&label=npm)](https://www.npmjs.com/package/@easypayment/medusa-paypal)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
7
+ [![Medusa v2](https://img.shields.io/badge/Medusa-v2-9b59b6)](https://medusajs.com)
8
+ [![PayPal PPCP](https://img.shields.io/badge/PayPal-PPCP-003087)](https://developer.paypal.com)
6
9
 
7
- <p>
8
- <a href="https://www.npmjs.com/package/@easypayment/medusa-paypal"><img src="https://img.shields.io/npm/v/@easypayment/medusa-paypal?color=blue&label=npm" alt="npm version" /></a>
9
- <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT" /></a>
10
- <a href="https://medusajs.com"><img src="https://img.shields.io/badge/Medusa-v2-9b59b6" alt="Medusa v2" /></a>
11
- <a href="https://developer.paypal.com"><img src="https://img.shields.io/badge/PayPal-PPCP-003087" alt="PayPal PPCP" /></a>
12
- </p>
10
+ ---
11
+
12
+ ## 📋 Table of Contents
13
+
14
+ - [📦 What's included](#-whats-included)
15
+ - [✅ Requirements](#-requirements)
16
+ - [🚀 Installation](#-installation)
17
+ - [⚙️ Setup](#%EF%B8%8F-setup)
18
+ - [Step 1 — Configure medusa-config.ts](#step-1--configure-medusa-configts)
19
+ - [Step 2 — Run database migrations](#step-2--run-database-migrations)
20
+ - [Step 3 — Connect your PayPal account](#step-3--connect-your-paypal-account)
21
+ - [Step 4 — Enable providers in your region](#step-4--enable-providers-in-your-region)
22
+ - [Step 5 — Configure settings](#step-5--configure-settings-optional)
23
+ - [Step 6 — Add PayPal to your storefront](#step-6--add-paypal-to-your-storefront)
24
+ - [📄 License](#-license)
25
+
26
+ ---
13
27
 
14
- <p>PayPal, Credit/Debit Cards, Venmo, SEPA, iDEAL, Mercado Pago, Bancontact & more - by an official PayPal Partner</p>
28
+ ## 📦 What's included
15
29
 
16
- </div>
30
+ | Feature | Details |
31
+ |---|---|
32
+ | 🔵 **PayPal Smart Buttons** | One-click wallet checkout via PayPal |
33
+ | 💳 **Advanced Card Fields** | Hosted, PCI-compliant advanced credit card inputs |
34
+ | 🛠 **Admin Dashboard** | Connect, configure, and switch environments from Medusa Admin |
35
+ | 🌍 **Sandbox & Live** | Toggle between test and production without restarting |
36
+ | ⚡ **Webhooks** | Automatically registered and verified with built-in retry support |
37
+ | 🔐 **3D Secure** | Configurable SCA/3DS per transaction |
17
38
 
18
39
  ---
19
40
 
20
- ## Requirements
41
+ ## Requirements
21
42
 
22
- - Medusa v2
23
- - Node.js 18+
43
+ - Medusa **v2**
44
+ - Node.js **18+**
24
45
  - PostgreSQL
25
46
 
26
47
  ---
27
48
 
28
- ## Step 1 — Install
49
+ ## 🚀 Installation
50
+
51
+ **In your Medusa backend directory**, run:
29
52
 
30
53
  ```bash
31
54
  npm install @easypayment/medusa-paypal
@@ -33,7 +56,9 @@ npm install @easypayment/medusa-paypal
33
56
 
34
57
  ---
35
58
 
36
- ## Step 2 — Configure medusa-config.ts
59
+ ## ⚙️ Setup
60
+
61
+ ### Step 1 — Configure `medusa-config.ts`
37
62
 
38
63
  Add the plugin and both payment providers to your existing `medusa-config.ts`:
39
64
 
@@ -89,7 +114,7 @@ export default defineConfig({
89
114
 
90
115
  ---
91
116
 
92
- ## Step 3 — Run database migrations
117
+ ### Step 2 — Run database migrations
93
118
 
94
119
  ```bash
95
120
  npx medusa db:migrate
@@ -97,29 +122,32 @@ npx medusa db:migrate
97
122
 
98
123
  ---
99
124
 
100
- ## Step 4 — Connect your PayPal account
125
+ ### Step 3 — Connect your PayPal account
101
126
 
102
127
  1. Start your Medusa server
103
- 2. Open Medusa Admin → **Settings → PayPal → PayPal Connection**
128
+ 2. Open **Medusa Admin → Settings → PayPal → PayPal Connection**
104
129
  3. Choose **Sandbox** (testing) or **Live** (production)
105
- 4. Click **Connect to PayPal** and complete the PayPal onboarding flow
130
+ 4. Click **Connect to PayPal** and complete the onboarding flow
106
131
 
107
- Credentials are saved automatically. To connect manually instead, click **Insert credentials manually** and paste your Client ID and Secret from [developer.paypal.com](https://developer.paypal.com).
132
+ Credentials are saved automatically. Prefer manual setup? Click **Insert credentials manually** and paste your Client ID and Secret from [developer.paypal.com](https://developer.paypal.com/dashboard/).
108
133
 
109
134
  ---
110
135
 
111
- ## Step 5 — Enable providers in your region
136
+ ### Step 4 — Enable providers in your region
112
137
 
113
- 1. Medusa Admin → **Settings → Regions → [your region]**
138
+ 1. Go to **Medusa Admin → Settings → Regions → [your region]**
114
139
  2. Under **Payment Providers**, enable:
115
- - `pp_paypal_paypal` — Paypal (PAYPAL)
116
- - `pp_paypal_card_paypal_card` Paypal (CARD)
140
+
141
+ | Provider ID | Description |
142
+ |---|---|
143
+ | `pp_paypal_paypal` | PayPal Smart Buttons (wallet) |
144
+ | `pp_paypal_card_paypal_card` | Advanced Card Fields (card) |
117
145
 
118
146
  ---
119
147
 
120
- ## Step 6 — Configure settings (optional)
148
+ ### Step 5 — Configure settings *(optional)*
121
149
 
122
- All settings are in Medusa Admin → **Settings → PayPal** and take effect immediately with no server restart.
150
+ All settings live in **Medusa Admin → Settings → PayPal** and apply immediately no server restart needed.
123
151
 
124
152
  | Tab | What you can configure |
125
153
  |---|---|
@@ -129,14 +157,16 @@ All settings are in Medusa Admin → **Settings → PayPal** and take effect imm
129
157
 
130
158
  ---
131
159
 
132
- ## Step 7Connect the frontend package
160
+ ### Step 6Add PayPal to your storefront
133
161
 
134
- Install the storefront UI package to render PayPal at checkout:
162
+ The checkout UI is shipped as a separate package **install it inside your storefront project**, not in this backend.
135
163
 
136
- ```bash
137
- npm install @easypayment/medusa-paypal-ui
138
- ```
164
+ 📦 **[@easypayment/medusa-paypal-ui](https://www.npmjs.com/package/@easypayment/medusa-paypal-ui)** — React components, hooks, and a drop-in payment step adapter for Next.js App Router storefronts.
165
+
166
+ See the [storefront integration & testing guide →](https://www.npmjs.com/package/@easypayment/medusa-paypal-ui)
167
+
168
+ ---
139
169
 
140
- See the [medusa-paypal-frontend README](https://www.npmjs.com/package/@easypayment/medusa-paypal-ui) for integration steps.
170
+ ## 📄 License
141
171
 
142
- ---
172
+ MIT © [Easy Payment](https://www.npmjs.com/package/@easypayment/medusa-paypal)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@easypayment/medusa-paypal",
3
- "version": "0.7.3",
3
+ "version": "0.7.5",
4
4
  "description": "Industry-standard PayPal integration for Medusa v2",
5
5
  "license": "MIT",
6
6
  "main": "./.medusa/server/src/index.js",
@@ -63,7 +63,7 @@
63
63
  },
64
64
  "repository": {
65
65
  "type": "git",
66
- "url": "https://github.com/easypayment/medusa-paypal.git"
66
+ "url": "https://github.com/easypaymentplugins/medusa-paypal"
67
67
  },
68
68
  "keywords": [
69
69
  "medusa",