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

> Connectez votre compte Paddle Billing ; préparez le produit, la fenêtre de paiement et les paramètres de webhook.

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

Vous pouvez obtenir un paiement unique avec la facture Paddle. La fenêtre de paiement s'ouvre par la Paddle et arrange la facture de vente du client. Vérifiez votre compte, l'adresse du site et les produits que vous vendez pour utilisation en direct à Paddle.

> [!NOTE]
>
> `transaction_checkout_not_enabled` L'erreur indique que la fonction Checkout de votre compte Paddle n'a pas encore été ouverte. Vérifiez l'état de vérification du compte depuis le panneau Paddle et effectuez des étapes de navigation en direct.

## Modèle et assurance du MoR (Merchant of Record)

Paddle Billing, le monde est la principale entreprise **Vendeur enregistré (Merchant of Record - MoR)** une des infrastructures:

* **Le vendeur officiel est Paddle.com:** Lorsque votre joueur reçoit un crédit ou un produit, vous pouvez vendre directement la facture Paddle.com Market Ltd. édite. VAT (VAT) et les interruptions de taxe de vente selon le pays de l'acheteur sont dans la finance du pays lié à sa personne morale.
* **Facilité pour les développeurs individuels :** Le propriétaire du serveur n'a pas besoin de couper une facture électronique ou de créer une entreprise pour chaque vente.
* [Paddle](https://www.paddle.com/help/start/account-verification/what-is-account-verification): La disponibilité et les versements dépendent des pays pris en charge et de la validation du compte par le prestataire. Avant la mise en ligne, vérifiez les exigences de vérification et les conditions de votre compte.

## Zones d'enregistrement

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

> [card] 1. Clé API
>
> Entrez la clé pdl live apikey  depuis votre compte en direct.

> [card] 2. ID du produit
>
> Entrez l'ID en commençant par le pro  du produit.

> [card] 3. Webhook Secret
>
> Entrez la valeur de clé secrète du lien de notification de palette pdl ntfset.

> [card] 4. Jeton côté client
>
> Entrez le token côté client, en commençant par live  de votre compte live.

> [card] 5. Environnement
>
> Sélectionnez Live pour une véritable collection.

> [!NOTE]
>
> Les produits, les adresses de notification et les commutateurs API des environnements vivants (en direct) et de test sur la palette sont totalement indépendants les uns des autres. Puisque toutes les étapes sont terminées dans le panneau de gestion Paddle en direct pour faire une réelle collection et sont dans le panneau Zonely **vivant** assurez-vous que l'environnement est sélectionné.

## 1. Définir le lien de paiement par défaut (lien de paiement par défaut)

Identifier le nom de domaine par défaut pour correspondre à la fenêtre de paiement Paddle avec votre site :

1. Depuis le menu de gauche du paddle **Départ**, ouvrez l'en-tête **Configuration de la vérification** vers la page.

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

> [card] 1. Configuration de la vérification
>
> Open Checkout page de configuration du menu de gauche.

2. **Paramètres** Situé sur l'onglet **Lien de paiement par défaut** entrer votre site , l'adresse de l'avis **Enregistrer** Enregistrer avec:
   ```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-fr.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=00e3c8e0c7030bf9b4957372ffcb9ca9)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-01b-default-payment-link-fr.png)

> [card] 1. Lien de paiement par défaut
>
> `https://siteniz.com/process/paddle` Enregistrer l'adresse.

## 2. Réception de la clé API et du jeton côté client

Préparez vos valeurs clés et jetons pour communiquer avec votre site -Paddle API et ouvrez la fenêtre de paiement :

1. Ci-dessous le menu gauche de la pagaie **Paramètres** ouvrir et ouvrir la partie **DEVELOPER TOOLS** De **Empreinte** Cliquez sur l'onglet.

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

> [card] 1. Authentification
>
> Switch to Developer Tools → Page d'authentification sous Paramètres.

2. Lignes par page **Nouvelle clé API** Cliquez sur le bouton.
3. Donnez votre clé sous forme contextuelle (par exemple `Zonely`).
4. **Expire à** pour maintenir la clé active dans le champ **Jamais de dépense** Select option.

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

> [card] 1. Nom de la clé
>
> Donnez votre nom de clé Zonely.

> [card] 2. Jamais de dépenses
>
> Select Ne jamais expirer pour votre validité intemporelle.

5. **Étiquettes** dans la section **Tous** Trouvez le groupe. Pour faire votre site pour commencer le paiement et vérifier les commandes **Lire plus** et **AaUppercase** Vérifiez les deux permissions et enregistrez le commutateur.

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

> [card] 1. Groupe d'autorisation : Tous
>
> Sélectionnez toute la ligne d'autorisation.

> [card] 2. Lire et écrire
>
> Lisez et enregistrez deux des boîtes d'écriture en marquant.

6. Live API touche de fenêtre pour afficher (`pdl_live_apikey_...`) Copiez et copiez-la dans votre panneau de gestion Zonely **Clé API** Collez-la dans le champ.

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

> [card] 1. Copie de la clé de l'API
>
> `pdl_live_apikey_` Coller le panneau en copieant la clé commençant par.

7. Page **Empreinte** depuis les onglets supérieurs **Jetons côté client** Cliquez sur l'onglet.

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

> [card] 1. Jetons côté client
>
> De l'onglet supérieur à la zone des jetons côté client.

8. Trois points à droite du jeton actif dans la liste (`...`) ouvrir et ouvrir le menu **Copier le jeton** Cliquez sur le bouton. Copier `live_` Entrée de la touche de navigateur avec Zonely dans votre panneau de gestion **Jeton côté client** Coller dans le champ.

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

> [card] 1. Copier le jeton
>
> Copier le jeton en direct avec l'option de jeton Copier à partir du menu en trois points.

## 3. Création de produits et acquisition de valeur d'identification de produit

Un produit doit être créé pour commencer le paiement dans l'infrastructure Paddle et l'ID de ce produit (**Numéro de produit**) doit être pris:

1. Menu gauche **Catalogue** Sous l'en-tête **Sommaire** Cliquez sur l'onglet.

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

> [card] 1. Menu Produits
>
> Go to Catalog → Page Produits du menu de gauche.

2. En haut du coin supérieur **+ Nouveau produit** Cliquez sur le bouton.
3. Remplir l'information sur le produit sous forme de fenêtre :
   * **Nom du produit:** Entrez le nom du produit (par exemple `Kredi`).
   * **Catégorie d'impôts:** Pour les produits numériques `Standard digital goods` Sélectionnez la catégorie.

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

> [card] 1. Nom du produit
>
> Nom du produit `Kredi` Entrez-le comme

> [card] 2. Catégorie d ' impôt
>
> `Standard digital goods` Sélectionner une catégorie.

4. **Enregistrer** Enregistrer le produit en appuyant sur le bouton.

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

> [card] 1. Enregistrer
>
> Cliquez sur le bouton Enregistrer pour enregistrer le produit.

5. Situé dans la page de détail du produit créé `pro_` Démarrer avec la valeur de copie **Numéro de produit** et copier la valeur dans Zonely panneau de gestion **Numéro de produit** Coller dans la boîte.

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

> [card] 1. Copie d'ID du produit
>
> `pro_` Copier l'ID du produit en commençant par.

## 4. Configurer les notifications de Webhook

Ouvrez l'inscription webhook sur le panneau Paddle pour transférer instantanément les paiements sur votre site:

1. Situé dans le menu gauche de la paddle **Nouvelles** Sous l'en-tête **Nouvelles** Cliquez sur l'onglet.

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

> [card] 1. Notifications
>
> Ouvrir l'onglet Notifications depuis le menu des événements.

2. Sur la page qui ouvre **Nouvelle destination** Cliquez sur le bouton.
3. Remplissez les paramètres de notification:
   * **Type de notification:** **webhook** Vérifiez l'option.
   * **URL:** Entrez l'adresse de l'avis de votre site:
     ```txt theme={"theme":"css-variables"}
     https://siteniz.com/process/paddle
     ```
   * **Exposé succinct:** Écrire une description de cet objectif (par exemple... `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-fr.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=eaeabaac887625ef1a19b3a5b5bacf47)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-11-new-destination-fr.png)

> [card] 1. Type de notification
>
> Check Webhook option.

> [card] 2. URL du point d'arrivée
>
> `https://siteniz.com/process/paddle` tapez l'adresse.

> [card] 3. Désignation des marchandises
>
> Entrez une description pour votre serveur.

4. Menu **Type d'utilisation** **plate-forme** Sélectionner.
5. **Nouvelles** Afin de s'assurer que votre site est complété et capture complètement les mouvements de compte **Tous** Cochez la case et enregistrez le but.

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

> [card] 1. Type d ' utilisation
>
> Sélectionnez l'option Plateforme.

> [card] 2. Tous
>
> Cochez toutes les cases pour obtenir tous les événements de notification.

6. Cliquez sur la cible webhook **Nouvelles** créée Saisissez l'option.
7. Dans la fenêtre qui ouvre `pdl_ntfset_` Démarrer avec la valeur de copie **Clé secrète** et copier la valeur dans le panneau de gestion Zonely **Webhook Secret** Coller dans la boîte.

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

> [card] 1. Clé secrète
>
> `pdl_ntfset_` Coller le champ Webhook Secret en copieant la clé commençant par.

## Connectez l'avis de paiement

Enregistrement de paiement **Modifier** avec ouvert et **Célébration URL** Copiez toute l'adresse. Mettez à jour la zone URL du lien de notification que vous avez créé dans le Paddle avec cette adresse complète. Lien **Clé secrète** valeur dans Zonely **Webhook Secret** doit être enregistré dans le champ.

> [!TIP]
>
> **Clé API** avec **Jeton côté client** différent. Ne pas écrire la clé API du serveur dans le champ de touche du navigateur. Panneau de gestion **Connexion d'essai** Le bouton vérifie le produit et l'accès API.

Ce lien est pour la collecte ponctuelle. Le montant du paiement est préparé selon la commande et la taxe incluses. Paiements complétés **Magasin → Paiements** Suivez la section.

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


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