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

> Connect your Paddle Billing account; prepare product, payment window and webhook settings.

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

You can get one-time payment with Paddle Billing. The payment window opens by the Paddle and arranges the customer's sales bill. Check your account, site address and products you sell for live use to Paddle.

> [!NOTE]
>
> `transaction_checkout_not_enabled` The error indicates that the Checkout feature in your Paddle account has not been opened yet. Check the account verification status from the Paddle panel and complete live onboarding steps.

## MoR (Merchant of Record) Model and Assurance

Paddle Billing, the world’s leading enterprise **Registered Seller (Merchant of Record - MoR)** one of the infrastructures:

* **The Official Seller is Paddle.com:** When your player receives credit or product, you can directly sell the invoice Paddle.com Market Ltd. edits. VAT (VAT) and Sales Tax interruptions according to the country of the buyer are in the financial of the country related to its legal entity.
* **Ease for Individual Developers:** The server owner does not need to cut one e-bill or set up a company for each sale.
* [Paddle](https://www.paddle.com/help/start/account-verification/what-is-account-verification): Availability and payouts depend on supported countries and account approval by the provider. Before going live, check the verification requirements and the terms for your account.

## Registration areas

| 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-en.png?fit=max\&auto=format\&n=vqU0BjGNyRJAfyxV\&q=85\&s=5fbe2a31c99618300e9095b8dd143616)](https://docs.zonely.gen.tr/images/panel/payments-connections-site-guide-20261027/pay-paddle-en.png)

> [card] 1. API Key
>
> Enter the pdl\_live\_apikey\_ key from your live account.

> [card] 2. Product ID
>
> Enter the ID starting with the pro\_ of the product.

> [card] 3. Webhook Secret
>
> Enter the pdl\_ntfset\_ Secret key value of the paddle notification link.

> [card] 4. Client-side Token
>
> Enter Client-side Token, starting with live\_ of your live account.

> [card] 5. Environment
>
> Select Live for real collection.

> [!NOTE]
>
> The products, notice addresses and API switches of live (live) and test environments on the paddle are completely independent from each other. Since all steps are completed in the live Paddle management panel to make real collection and are in Zonely panel **live** make sure the environment is selected.

## 1. Define Default Payment Link (Default Payment Link)

Identify the default domain name to match the Paddle payment window with your site:

1. From the left menu of the paddle **Checkout** open the header **Checkout configuration** to the page.

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

> [card] 1. Checkout configuration
>
> Open Checkout configuration page from left menu.

2. **Settings** Located on the tab **Default payment link** enter your site’s notice address **Save** Save with:
   ```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-en.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=3a1eb91bd9535c873bae10814048216e)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-01b-default-payment-link-en.png)

> [card] 1. Default payment link
>
> `https://siteniz.com/process/paddle` Save the address.

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

Prepare your key and token values to communicate with your site’s Paddle API and open the payment window:

1. Below the left menu of the paddle **Settings** open and open part **DEVELOPER TOOLS** From **Imprint** Click on the tab.

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

> [card] 1. Authentication
>
> Switch to Developer Tools → Authentication page under Settings.

2. Rows per page **New API Key** Click on the button.
3. Give your key in the pop-up form (e.g.. `Zonely`).
4. **Expires at** to keep the key active in the field **Never Expense** Select option.

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

> [card] 1. Key Name
>
> Give your key name Zonely.

> [card] 2. Never Expenses
>
> Select Never expires for your time-less validity.

5. **Tags** in section **All** Find the group. To make your site to start payment and verify orders **Read More** and **AaUppercase** Check both of the permissions and save the switch.

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

> [card] 1. Authorization Group: All
>
> Select all the authorization line.

> [card] 2. Read & Write
>
> Read and save two of the Write boxlets by marking.

6. Live API key from window to display (`pdl_live_apikey_...`) Copy and copy it in your Zonely management panel **API Key** Paste it in the field.

[![Copy Live API Key (pdl\_live\_apikey\_...)](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-05-copy-api-key-en.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=7b18a878f36a8c7547fd8f69c3f6f679)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-05-copy-api-key-en.png)

> [card] 1. API Key Copy
>
> `pdl_live_apikey_` Paste the panel by copying the key starting with.

7. **Imprint** page from top tabs **Client-side tokens** Click on the tab.

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

> [card] 1. Client-side tokens
>
> From the upper tabs to the Client-side tokens area.

8. Three points on the right of the active token in the list (`...`) open and open menu **Copy token** Click on the button. Copy `live_` Starting browser key with Zonely in your management panel **Client-side Token** Paste it in the field.

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

> [card] 1. Copy token
>
> Copy the live token with the Copy token option from three point menu.

## 3. Product Creation and Product ID Value Acquisition

A product should be created to start payment in the Paddle infrastructure and the ID of this product (**Product ID**) should be taken:

1. Left menu **Catalog** Under the header **Home** Click on the tab.

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

> [card] 1. Products Menu
>
> Go to Catalog → Products page from left menu.

2. Right in the upper corner **+ New product** Click on the button.
3. Fill out product information in the pop-up form:
   * **Product Name:** Enter the product name (e.g. `Kredi`).
   * **Tax category:** For Digital Products `Standard digital goods` Select category.

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

> [card] 1. Product name
>
> Product name `Kredi` Enter it as

> [card] 2. Tax category
>
> `Standard digital goods` Select category.

4. **Save** Save the product by pressing the button.

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

> [card] 1. Save
>
> Click Save button to save the product.

5. Located in the detail page of the product created `pro_` Start with **Product ID** copy value and copy the value in Zonely management panel **Product ID** Paste in the box.

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

> [card] 1. Product ID Copy
>
> `pro_` Copy the product ID starting with.

## 4. Configure Webhook Notifications

Open webhook registration on the Paddle panel to instantly transfer payments to your site:

1. Located in the left menu of the paddle **News** Under the header **News** Click on the tab.

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

> [card] 1. Notifications
>
> Open Notifications tab from the Events menu.

2. On the page that opens **New destination** Click on the button.
3. Fill in the notification settings:
   * **Notification Type:** **webhook** Check the option.
   * **URL:** Enter your site’s notice address:
     ```txt theme={"theme":"css-variables"}
     https://siteniz.com/process/paddle
     ```
   * **Description:** Write a description for this goal (e.g... `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-en.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=957864ffc8bb1cd92ebdc2538390a310)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-11-new-destination-en.png)

> [card] 1. Notification Type
>
> Check Webhook option.

> [card] 2. Endpoint URL
>
> `https://siteniz.com/process/paddle` type the address.

> [card] 3. Description
>
> Enter a description for your server.

4. **Usage type** menu **platform** Select.
5. **News** In order to ensure that your site is completed and fully capture account movements **All** Check the box and save the goal.

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

> [card] 1. Usage type
>
> Select Platform option.

> [card] 2. All
>
> Check All the box to get all notification events.

6. Click on the created webhook target **News** Enter the option.
7. In the window that opens `pdl_ntfset_` Start with **Secret Key** copy value and copy the value in Zonely management panel **Webhook Secret** Paste in the box.

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

> [card] 1. Secret key
>
> `pdl_ntfset_` Paste the Webhook Secret field by copying the key starting with.

## Connect the payment notice

Payment record **Edit** with open and **Callback URL** Copy all the address. Update the URL area of the notification link you created in the Paddle with this full address. Link **Secret Key** value in Zonely **Webhook Secret** must be registered in the field.

> [!TIP]
>
> **API Key** with **Client-side Token** different. Do not write server API key to the browser key field. Management panel **Test Connection** The button verifys product and API access.

This link is for one-time collection. Payment amount is prepared according to order and tax included. Completed payments **Store → Payments** Follow the section.

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


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