Начало работы с PayPal для Medusa

В этом руководстве вы узнаете, как установить и настроить платежный провайдер PayPal для Medusa.

• Medusa v2.17.2 или новее
• Node.js v22.23.4, v24.22.1, v26.12.1 или новее
• Бизнес-аккаунт PayPal – зарегистрируйтесь или войдите
• Приложение в PayPal Developer Dashboard – зарегистрируйтесь или войдите
• Модуль интеграций

yarn add @gorgo/medusa-integration @gorgo/medusa-payment-paypal

Добавьте конфигурации провайдера модуля интеграций и платежного модуля Medusa в файл medusa-config.ts в приложении Medusa Admin:

medusa-config.ts
1// ...
2const PAYPAL_INTEGRATION_ID = "paypal-1"
3
4module.exports = defineConfig({
5  // ...
6  plugins: [
7    // ...
8    {
9      resolve: "@gorgo/medusa-integration",
10      options: {
11        encryptionKey: process.env.INTEGRATION_ENCRYPTION_KEY,
12        providers: [
13          {
14            resolve: "@gorgo/medusa-payment-paypal/providers/integration-paypal",
15            id: PAYPAL_INTEGRATION_ID,
16            options: {},
17          },
18        ],
19      },
20    },
21    {
22      resolve: "@gorgo/medusa-payment-paypal",
23      options: {},
24    },
25  ],
26  modules: [
27    // ...
28    {
29      resolve: "@medusajs/medusa/payment",
30      options: {
31        providers: [
32          {
33            resolve: "@gorgo/medusa-payment-paypal/providers/payment-paypal",
34            id: "paypal",
35            options: {
36              id: PAYPAL_INTEGRATION_ID
37            }
38          },
39        ],
40      },
41    },
42  ],
43})

Так зарегистрированный платёжный провайдер получает id pp_paypal_paypal, а его вебхук приходит на роут /hooks/payment/paypal_paypal.

Добавьте переменную окружения с секретным ключом шифрования:

.env
INTEGRATION_ENCRYPTION_KEY=supersecret

Client ID, секретный ключ и остальные настройки PayPal не входят в параметры провайдера. Их вы вводите в Medusa Admin, как описано в разделе Настройки PayPal в Medusa Admin.

Чтобы корректно обрабатывать платёжные уведомления от PayPal, настройте URL вебхука в своём приложении PayPal следующим образом:

1. Откройте своё приложение в разделе Apps & Credentials, выбрав окружение Sandbox или Live, как в настройках плагина.

2. В блоке Webhooks нажмите Add Webhook.

3. Добавьте новый URL вебхука в следующем формате:

   Webhook URL
   https://{YOUR_MEDUSA_DOMAIN}/hooks/payment/paypal_paypal

   Замените {YOUR_MEDUSA_DOMAIN} на домен вашего магазина Medusa.

4. Подпишите вебхук на события PAYMENT.AUTHORIZATION.CREATED и PAYMENT.CAPTURE.COMPLETED и сохраните его.

5. Скопируйте ID вебхука и введите его в поле ID вебхука в настройках PayPal в Medusa Admin. После этого кнопка Проверить соединение проверяет, что вебхук есть в этом окружении и подписан на оба события.