> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Paddle

> Подключите свой счет Paddle Billing; подготовьте продукт, окно оплаты и настройки веб-хука.

![Paddle logo](https://mintcdn.com/zonely-a8cd49e7/RhT7oGMq-hyCnspk/images/payments/merchant-providers-20261028/paddle.png?fit=max\&auto=format\&n=RhT7oGMq-hyCnspk\&q=85\&s=21ab32157f5b7d4233669ae9cfe4d085)

Вы можете получить единовременную оплату с помощью Paddle Billing. Окно оплаты открывается Paddle и организует счет клиента. Проверьте свою учетную запись, адрес сайта и продукты, которые вы продаете для использования в реальном времени, на Paddle.

> [!NOTE]
>
> `transaction_checkout_not_enabled` Ошибка указывает на то, что функция Checkout в вашем компьютере Paddle Счет еще не открыт. Проверьте статус проверки счета с Paddle Панель и полные живые шаги на борту.

## MoR (торговец звукозаписью) Модель и гарантия

Paddle Billing, ведущее в мире предприятие **Зарегистрированный продавец (Merchant of Record - MoR)**, является одной из инфраструктур:

* **Официальный продавец Paddle.com:** Когда ваш игрок получает кредит или продукт, вы можете напрямую продать счет Paddle.com Market Ltd. правки. VAT (VAT) и перерывы в налогообложении с продаж в соответствии с страной покупателя находятся в финансовом положении страны, связанной с его юридическим лицом.
* **Простота для индивидуальных разработчиков:** Владельцу сервера не нужно сокращать одну электронную ведомость или создавать компанию для каждой продажи.
* [Paddle](https://www.paddle.com/help/start/account-verification/what-is-account-verification): Доступность сервиса и выплаты зависят от поддерживаемых стран и одобрения аккаунта провайдером. Перед запуском проверьте требования к верификации и условия своего аккаунта.

## Регистрационные зоны

| Zonely Area | Информация для входа |
| - | - |
| **API Key** | Your live account `pdl_live_apikey_` Starting with the server API key. |
| **Идентификатор продукта** | Из продукта `pro_` Стартовый ID. Ценовой ID не используется. |
| **Webhook Secret** | Paddle notification link `pdl_ntfset_` Secret key value starting with. |
| **Client-side Token** | Your live account `live_` with the starting browser switch. |
| **Environment** | For actual collection **live** Select. |

[![API Key, Product ID, Webhook Secret, Client-side Token, Environment](https://mintcdn.com/zonely-a8cd49e7/vqU0BjGNyRJAfyxV/images/panel/payments-connections-site-guide-20261027/pay-paddle-ru.png?fit=max\&auto=format\&n=vqU0BjGNyRJAfyxV\&q=85\&s=354f5dfcf946403734e04077298c0e79)](https://docs.zonely.gen.tr/images/panel/payments-connections-site-guide-20261027/pay-paddle-ru.png)

> [card] 1. API Ключ
>
> Введите pdl live apikey ключ из своей учетной записи.

> [card] 2.Идентификатор продукта
>
> Введите идентификатор, начинающийся с pro  продукта.

> [card] 3.Секрет Webhook
>
> Введите значение pdl ntfset секретного ключа ссылки уведомления paddle.

> [card] 4. Клиентский токен
>
> Enter Клиентский токен, начиная с live  вашей учетной записи.

> [card] 5. Окружающая среда
>
> S Select Live для реальной коллекции.

> [!NOTE]
>
> Продукты, адреса уведомлений и переключатели API в живых (живых) и тестовых средах на веслах полностью независимы друг от друга.Так как все этапы выполнены в живой панели управления Paddle для создания реальной коллекции и находятся в панели Zonely **жить**, убедитесь, что среда выбрана.

## 1.Определить платежную ссылку по умолчанию (Default Payment Link)

Идентифицируйте доменное имя по умолчанию, чтобы соответствовать окну оплаты Paddle с вашим сайтом:

1. 1.Из левого меню весла **Проверка** откройте заголовок **Конфигурация Checkout** на страницу.

[![Checkout → Checkout configuration Menu](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-01a-checkout-config-ru.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=13d81739d609337ec3a82b0239a98d8b)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-01a-checkout-config-ru.png)

> [card] 1.Конфигурация контрольной проверки
>
> Open Страница конфигурации Checkout слева меню.

2. **Настройки** На вкладке **Ссылка для оплаты по умолчанию** введите адрес уведомления вашего сайта **Спасти** Сохранить с:
   ```txt theme={"theme":"css-variables"}
   https://siteniz.com/process/paddle
   ```

[![Default payment link (https://siteniz.com/process/paddle) and Save Button](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-01b-default-payment-link-ru.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=34344c294715865d6ad2c1400ccc6e9d)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-01b-default-payment-link-ru.png)

> [card] 1. Ссылка для неисполнения платежа
>
> `https://siteniz.com/process/paddle` Сохранить адрес.

## 2. Live API Ключ и клиентский токен

Подготовьте свои значения ключа и токена для связи с Paddle API вашего сайта и откройте окно оплаты:

1. 1.Под левым меню весла **Настройки** открытая и открытая часть **DEVELOPER TOOLS** От **отпечаток** Нажмите на вкладку.

[![DEVELOPER TOOLS → Authentication Menu](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-02-authentication-menu-ru.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=597d1539112bbed6b03b99cf2f7e58ef)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-02-authentication-menu-ru.png)

> [card] 1.Аутентификация
>
> Switch to Developer Tools → Страница аутентификации в разделе Настройки.

2. Ряды на странице **Новый ключ API** Нажмите на кнопку.
3. Дайте ключ в всплывающем виде (например, `Zonely`).
4. **Исчезновение в** для сохранения ключа в поле **Никогда не тратьте** Выберите опцию.

[![Name (Zonely), Expires at (Never Expires)](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-03-new-api-key-ru.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=e6bdb6948eaadf677e986d340abb103a)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-03-new-api-key-ru.png)

> [card] 1.Ключевое имя
>
> Give имя Zonely.

> [card] 2. Никогда не тратьте
>
> Select Никогда не истекает для вашей вневременной действительности.

5. **Тэги** в разделе **Все** Найти группу. Для того, чтобы ваш сайт начал оплату и проверку заказов **Читать далее** и **Вечерний ящик** Проверьте оба разрешения и сохраните переключатель.

[![Permissions (All), Authors (Read and write)](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-04-permissions-all-ru.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=2c7f4ddf16519b686c93b548cebe8ba2)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-04-permissions-all-ru.png)

> [card] 1.Группа авторизации: Все
>
> S Выберите всю авторизационную линию.

> [card] 2.Читать и писать
>
> Читайте и сохраняйте два из коробок Write пометкой.

6. 6.Живой ключ API от окна до дисплея (`pdl_live_apikey_...`) Копируйте и копируйте его в панели управления Zonely **API ключ** Вставьте его в поле.

[![Copy Live API Key (pdl\_live\_apikey\_...)](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-05-copy-api-key-ru.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=5c566006b6b4814fdca24db87c62f386)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-05-copy-api-key-ru.png)

> [card] 1. API Key Copy
>
> `pdl_live_apikey_` Вставьте панель, скопировав ключ, начинающийся с.

7. Страница **отпечаток** с верхних вкладок **Токены на стороне клиента** Нажмите на вкладку.

[![Client-side tokens Tab](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-06-client-side-token-ru.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=7ae6ad9b431f9d7d1defa18b53dd74b2)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-06-client-side-token-ru.png)

> [card] 1.Токены на стороне клиента
>
> От верхних вкладок до области токенов на стороне клиента.

8. Три точки справа от активного токена в списке (`...`) открывают и открывают меню **Копировать маркер** Нажмите на кнопку. Копируйте ключ браузера `live_` Стартовый ключ с Zonely в панели управления **Клиентский токен** Вставьте его в поле.

[![Copy Live Token with Copy token Option](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-06b-copy-token-ru.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=b2d78c80fbc9357d9ea9fcdffcd2be44)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-06b-copy-token-ru.png)

> [card] 1.Копировать токен
>
> Copy - живой токен с опцией Copy token из трех пунктов меню.

## 3.Создание продукта и приобретение стоимости продукта

Для начала оплаты в инфраструктуре Paddle необходимо создать продукт, а также взять идентификатор этого продукта (**Идентификатор продукта**):

1. Левое меню **Каталог** Под заголовком **Домой** Нажмите на вкладку.

[![Catalog Menu and Products Tab](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-07-catalog-products-ru.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=2fcacb613dc904172567c85728c9b22e)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-07-catalog-products-ru.png)

> [card] 1. Меню продуктов
>
> Go в каталог → Страница продуктов из левого меню.

2. 2.Вверху в верхнем углу **+ Новый продукт** Нажмите на кнопку.
3. Заполните информацию о продукте в всплывающем виде:
   * **Название продукта:** Введите название продукта (например, `Kredi`).
   * **Категория налога:** для цифровых продуктов `Standard digital goods` Выберите категорию.

[![Product name (Kredi), Tax category (Standard digital goods)](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-08-new-product-ru.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=f0c5e60527567f24b6cfa5cb6abeaabc)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-08-new-product-ru.png)

> [card] 1.Наименование продукта
>
> Продукт `Kredi` Введите как

> [card] 2. категория налогов
>
> `Standard digital goods` Выберите категорию

4. **Спасти** Сохранить продукт, нажав кнопку.

[![Save Button to Save Your Product](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-08b-save-product-ru.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=3a40616721fe5c2eb8816a93d57f4789)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-08b-save-product-ru.png)

> [card] 1.Спасибо.
>
> Click Кнопка Сохранить для сохранения продукта.

5. 5.На странице с подробностями продукта создан `pro_` Начните с **Идентификатор продукта** значение копирования и скопируйте значение в панели управления Zonely **Идентификатор продукта** Вставка в коробке.

[![Product ID (pro\_...) Copy](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-09-product-id-ru.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=4488a772345898d967b89a8aa1de62f3)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-09-product-id-ru.png)

> [card] 1. Копии с идентификатором продукта
>
> `pro_` Копировать идентификатор продукта, начиная с.

## 4.Настройка уведомлений Webhook

Открытая регистрация в сети Интернет на панели Paddle для мгновенного перевода платежей на ваш сайт:

1. 1.Расположен в левом меню весла **Новости** Под заголовком **Новости** Нажмите на вкладку.

[![Events Menu and Notifications Tab](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-10-notifications-menu-ru.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=b114b8d8df6131892f59275b3002cf91)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-10-notifications-menu-ru.png)

> [card] 1. Уведомления
>
> Закладка Open Уведомления из меню События.

2. 2.На странице, открывающей **Новый пункт назначения** Нажмите на кнопку.
3. Заполнить в настройках уведомления:
   * **Тип уведомления:** **веб-хук** Проверьте опцию.
   * **URL:** Введите адрес уведомления вашего сайта:
     ```txt theme={"theme":"css-variables"}
     https://siteniz.com/process/paddle
     ```
   * **Описание:** Напишите описание для этой цели (например, `Server`).

[![Notification type (Webhook), Endpoint URL (https://siteniz.com/process/paddle), Description](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-11-new-destination-ru.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=74a3b1df450f6585350e83a07531c3c5)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-11-new-destination-ru.png)

> [card] 1 Тип уведомления
>
> Check Web-cook option.

> [card] 2.Конечный URL
>
> `https://siteniz.com/process/paddle` тип адреса.

> [card] 3. Описание
>
> Enter описание для вашего сервера.

4. меню **Тип использования** **платформа** Выберите.
5. **Новости** Для того, чтобы ваш сайт был завершен и полностью захватывал движения учетной записи **Все** Проверьте поле и сохраните цель.

[![Usage type (Platform), Events (All)](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-12-events-all-ru.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=4b7aadb0a89404c1ce421fa994957441)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-12-events-all-ru.png)

> [card] 1. Тип использования
>
> S Select Platform option.

> [card] 2.Все.
>
> Check Все поля для получения всех уведомлений события.

6. 6.Нажмите на созданный веб-хук-мишень **Новости** Введите опцию.
7. 7.В окне, которое открывается `pdl_ntfset_` Начните с значения копии **Секретный ключ** и скопируйте значение в панели управления Zonely **Web-хук секрет** Вставка в коробке.

[![Secret key (pdl\_ntfset\_...)](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-13-secret-key-ru.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=12719f7de46d256dfbb1d445f43d3a62)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-13-secret-key-ru.png)

> [card] 1.Секретный ключ
>
> `pdl_ntfset_` Вставить поле Webhook Secret, скопировав ключ, начинающийся с.

## Подключите платежное уведомление

Платежная запись **Редактировать** с открытым и **Обновление URL** Копировать весь адрес. Обновить область URL ссылки уведомления, созданной вами в Paddle с этим полным адресом. Ссылка **Секретный ключ** значение в Zonely **Web-хук секрет** должно быть зарегистрировано в поле.

> [!TIP]
>
> **API ключ** с **Клиентский токен** отличается. Не записывайте сервер API ключ в поле ключа браузера. Панель управления **Тестовое соединение** Кнопка проверяет продукт и доступ API.

Эта ссылка для разового сбора. Сумма оплаты составляется по заказу и налогу включен. Заполненные платежи **Магазин → Платежи** Следуйте разделу.

[Payments](https://docs.zonely.gen.tr/ru/guides/payments.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.