> ## 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

> Podłącz konto do składania Paddle Billing; przygotuj ustawienia produktu, okna płatności i haka.

![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)

Możesz otrzymać jednorazową płatność za pośrednictwem Paddle Billing. Okno płatności otwiera się za pomocą Paddle i organizuje rachunek sprzedaży klienta. Sprawdź swoje konto, adres strony i produkty, które sprzedajesz na żywo do Paddle.

> [!NOTE]
>
> `transaction_checkout_not_enabled` Błąd wskazuje, że funkcja Checkout na koncie Paddle nie została jeszcze otwarta. Sprawdź status weryfikacji konta w panelu Paddle i ukończ na żywo czynności pokładowe.

## MoR (Kupujący Nagrania) Model i zapewnienie

Paddle Billing, wiodąca światowa firma **Zarejestrowany sprzedawca (Merchant of Record - MoR)** jedną z infrastruktur:

* **Sprzedawcą oficjalnym jest Paddle.com:** Kiedy gracz otrzymuje kredyt lub produkt, można bezpośrednio sprzedać fakturę Paddle.com Market Ltd. edyts. VAT (VAT) i przerw w podatku sprzedaży według kraju nabywcy są w finanse kraju związanego z jego osobą prawną.
* **Łatwość dla indywidualnych deweloperów:** Właściciel serwera nie musi ciąć jednego e- bila ani zakładać firmy na każdą sprzedaż.
* [Paddle](https://www.paddle.com/help/start/account-verification/what-is-account-verification): Dostępność i wypłaty zależą od obsługiwanych krajów oraz zatwierdzenia konta przez dostawcę. Przed uruchomieniem sprawdź wymagania weryfikacyjne i warunki swojego konta.

## Obszary rejestracji

| Zonely Area | Information to enter |
| - | - |
| **API Key** | Your live account `pdl_live_apikey_` Starting with the server API key. |
| **Product ID** | Of the product `pro_` Starting ID. Price ID is not used. |
| **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-pl.png?fit=max\&auto=format\&n=vqU0BjGNyRJAfyxV\&q=85\&s=dff58279ab52d71467be06904e83cf80)](https://docs.zonely.gen.tr/images/panel/payments-connections-site-guide-20261027/pay-paddle-pl.png)

> [card] 1. Klucz API
>
> Enter Pdl \_ live \_ apikey \_ key z Twojego konta na żywo.

> [card] 2. Identyfikacja produktu
>
> Enter ID zaczynający się od pro \_ of the product.

> [card] 3. Sekret webhook
>
> Enter wartość klucza Pdl \_ ntfset \_ Secret dla powiadomień wiosłkowych link.

> [card] 4. Klient-strona Token
>
> Enter Klient - strona Token, zaczynając od live \_ of your live account.

> [card] 5. Środowisko
>
> Select Live for real collection.

> [!NOTE]
>
> Produkty, adresy powiadomień i przełączniki API na żywo (na żywo) i środowiska testowe na wiosło są całkowicie niezależne od siebie. Ponieważ wszystkie kroki są zakończone w live Paddle panel zarządzania, aby prawdziwy zbiór i są w Zonely panelu **Żywy** upewnij się, że środowisko jest wybrany.

## 1. Zdefiniuj domyślne płatności Link (domyślne płatności Link)

Określić domyślną nazwę domeny, aby dopasować okno płatności Paddle do Twojej strony:

1. Z lewego menu wiosła **Wymeldowanie** otworzyć nagłówka **Konfiguracja wymeldowania** na stronę.

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

> [card] 1. Konfiguracja wymeldowania
>
> Otwórz stronę konfiguracji Checkout z lewego menu.

2. **Ustawienia** Położony na karcie **Domyślny link do płatności** wprowadzić adres ogłoszenia witryny **Zapisz** Zapisz z:
   ```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-pl.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=a469c518c6f433fca642b3196adb0144)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-01b-default-payment-link-pl.png)

> [card] 1. Domyślny link do płatności
>
> `https://siteniz.com/process/paddle` Zapisz adresatów.

## 2. Live API Key i Client- side Token Receiving

Przygotuj swoje wartości kluczowe i symboliczne do komunikacji z Paddle witryny API i otwórz okno płatności:

1. Poniżej lewego menu wiosła **Ustawienia** otwarte i otwarte części **DEVELOPER TOOLS** Z **Nadruk** Kliknij na zakładkę.

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

> [card] 1. Uwierzytelnienie
>
> Switch do programisty Narzędzia → Strona uwierzytelniania pod Settings.

2. Wiersze na stronę **Nowy klucz API** Kliknij przycisk.
3. Daj klucz w postaci popow- up (np.. `Zonely`).
4. **Wygasa po**, aby utrzymać aktywny klucz w polu **Nigdy nie wydawaj** Wybierz opcję.

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

> [card] 1. Nazwa klucza
>
> Podaj swoją nazwę klucza Zonely.

> [card] 2. Nigdy nie wydatkuje
>
> Select Nigdy nie wygasa dla Twojej bezterminowej walidyty.

5. **Znaczniki** w sekcji **Wszystkie** Znajdź grupę. Aby dokonać witryny, aby rozpocząć płatności i zweryfikować zamówienia **Czytaj więcej** i **AaUppercase** Sprawdź obie uprawnienia i zapisać przełącznik.

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

> [card] 1. Grupa autoryzacyjna: Wszystkie
>
> Wybierz wszystkie pola autoryzacji.

> [card] 2. Czytaj i pisz
>
> Read i zapisać dwie z boxlets Write przez marking.

6. Żyć API klucz od okna do wyświetlania (`pdl_live_apikey_...`) Kopiuj i kopiuj w swoim Zonely panel zarządzający **API** Wkleić na boisku.

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

> [card] 1. Kopiuj klucz API
>
> `pdl_live_apikey_` Wklej panel kopiując klucz zaczynający się od.

7. Strona **Nadruk** z górnej zakładki **Kelent- side żetony** Kliknij na zakładkę.

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

> [card] 1. Dekeny z boku klienta
>
> Z Z górnych zakładek do żetonów z boku Klienta area.

8. Trzy punkty po prawej stronie aktywnego tokena na liście (`...`) otwarte i otwarte menu **Kopiuj token** Kliknij przycisk. Kopiuj `live_` Uruchomienie klawisz przeglądarki z Zonely w panelu zarządzania **Token po stronie klienta** Wklej go w polu.

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

> [card] 1. Kopiuj token
>
> Copy token live z opcją Kopiuj token z trzech menu.

## 3. Tworzenie produktu i ID produktu Zakup wartości

Należy stworzyć produkt, który rozpocznie płatność w infrastrukturze Paddle, a identyfikator tego produktu (**Identyfikator produktu**) powinien być:

1. Lewe menu **Katalog** Pod nagłówkiem **Spis treści** Kliknij na zakładkę.

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

> [card] 1. Menu produktów
>
> Go do katalogu → Strona produktów z lewego menu

2. Kliknij przycisk w prawym górnym rogu **+ Nowy produkt**.
3. Wypełnij informacje o produkcie w postaci rozwijanej:
   * **Nazwa produktu:** Podaj nazwę produktu (np. `Kredi`).
   * **Kategoria podatkowa:** Dla produktów cyfrowych `Standard digital goods` Wybierz kategorię.

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

> [card] 1. Nazwa produktu
>
> Nazwa produktu `Kredi` Wpisz go jako

> [card] 2. Kategoria podatkowa
>
> `Standard digital goods` Wybierz kategorię

4. **Zapisz** Zapisz produkt przez naciśnięcie przycisku.

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

> [card] 1. Zapisz
>
> Click Zapisz przycisk, aby zapisać product.

5. Położony w szczegółowej stronie produktu utworzonego `pro_` Start z **Identyfikator produktu** wartość kopii i skopiować wartość w Zonely panel zarządzania **Identyfikator produktu** Paste w polu.

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

> [card] 1. Identyfikator produktu Kopiuj
>
> `pro_` Kopiuj identyfikator produktu zaczynając od.

## 4. Konfiguracja powiadomień o haku internetowym

Otwórz rejestrację haka na panelu Paddle, aby natychmiast przenieść płatności na swoją stronę:

1. Położony w lewym menu wiosła **Aktualności** Pod nagłówkiem **Aktualności** Kliknij na zakładkę.

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

> [card] 1. Powiadomienia
>
> Open Notyfikacje z menu zdarzeń

2. Na stronie, która otwiera **Nowy cel** Kliknij przycisk.
3. Wypełnij ustawienia powiadomień:
   * **Typ zgłoszenia:** **hak** Sprawdź opcję.
   * **URL:** Wpisz adres ogłoszenia witryny:
     ```txt theme={"theme":"css-variables"}
     https://siteniz.com/process/paddle
     ```
   * **Opis:** Napisz opis dla tego celu (np. `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-pl.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=5352599cfc44d33edeaf0f641644c473)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-11-new-destination-pl.png)

> [card] 1. Typ zgłoszenia
>
> Check Option.

> [card] 2. URL punktu końcowego
>
> `https://siteniz.com/process/paddle` typ adresatów.

> [card] Opis
>
> Wpisz opis swojego serwera

4. **Rodzaj zastosowania** menu **platforma** Select.
5. **Aktualności** W celu zapewnienia, że witryna jest zakończona i w pełni uchwycić ruchy konta **Wszystkie** Sprawdź pole i zapisać cel.

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

> [card] 1. Rodzaj zastosowania
>
> Opcja platformy Select.

> [card] 2. Wszystkie
>
> Check Wszystkie pola, aby uzyskać wszystkie powiadomienia events.

6. Kliknij na utworzonym haku Wtyczka celu **Aktualności** Wprowadź opcję.
7. W oknie, które otwiera `pdl_ntfset_` Zacznij od **Tajny klucz** kopiowanie i kopiowanie wartości w Zonely panel zarządzający **Sekret webhook** Wklej do pudełka.

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

> [card] 1. Tajny klucz
>
> `pdl_ntfset_` Wklej pole Sekretu Webhook kopiując klucz zaczynając od.

## Połącz ogłoszenie o płatności

Zapis płatności **Edycja** z otwartym i **Callback URL** Kopiuj wszystkie adresy. Aktualizuj obszar URL w link powiadomienia, który stworzyłeś w Paddle z tym pełnym adresem. Link **Tajny klucz** wartość w Zonely **Sekret webhook** musi być zarejestrowany w polu.

> [!TIP]
>
> **API** z **Token po stronie klienta** odmienny. Nie pisz serwera API klucz do pola klucza przeglądarki. Panel zarządzający **Połączenie testowe** Przycisk verifys produkt i dostęp API.

Ten link jest dla jednorazowej kolekcji. Kwota płatności jest przygotowywana zgodnie z zamówieniem i podatkiem. Wykonane płatności **Przechowuj → Płatności** Postępuj zgodnie z sekcją.

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


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