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

> Conecta tu cuenta de facturación de Paddle; prepara productos, ventana de pago y configuración 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)

Usted puede obtener un pago único con Paddle Billing. La ventana de pago se abre por el Paddle y arregla la factura de ventas del cliente. Consulte su cuenta, dirección del sitio y productos que vende para uso en vivo a Paddle.

> [!NOTE]
>
> `transaction_checkout_not_enabled` El error indica que la función de Checkout en su cuenta Paddle no ha sido abierta todavía. Consulte el estado de verificación de la cuenta desde el panel Paddle y complete los pasos de a bordo en vivo.

## MoR (Merchant of Record) Model and Assurance

Paddle Billing, la empresa líder mundial **Registrado vendedor (Merchant of Record - MoR)** una de las infraestructuras:

* **El vendedor oficial es Paddle.com:** Cuando su jugador recibe crédito o producto, puede vender directamente la factura Paddle.com Market Ltd. edits. VAT (VAT) y las interrupciones del impuesto de ventas según el país del comprador están en la financiera del país relacionado con su entidad legal.
* **Facilidad para desarrolladores individuales:** El propietario del servidor no necesita cortar una línea electrónica o establecer una empresa para cada venta.
* [Paddle](https://www.paddle.com/help/start/account-verification/what-is-account-verification): La disponibilidad y los pagos al vendedor dependen de los países admitidos y de la aprobación de la cuenta por el proveedor. Antes de publicar, revisa los requisitos de verificación y las condiciones de tu cuenta.

## Áreas de registro

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

> [card] 1. API Key
>
> Enter la tecla pdl live apikey  de tu cuenta en vivo.

> [card] 2. ID de producto
>
> Enter la ID empezando por el pro  del producto.

> [card] 3. Secreto Webhook
>
> Enter el pdl ntfset  Valor clave secreto del enlace de notificación de remos.

> [card] 4. Token lado del cliente
>
> Enter Cliente-side Token, empezando por live  de tu cuenta en vivo.

> [card] 5. Medio ambiente
>
> Select Live para la colección real.

> [!NOTE]
>
> Los productos, las direcciones de aviso y API interruptores de ambientes vivos (en vivo) y de prueba en el paddle son completamente independientes entre sí. Puesto que todos los pasos se completan en vivo Paddle panel de gestión para hacer una colección real y están en Zonely panel **vivir** asegúrese de que el entorno sea seleccionado.

## 1. Define el vínculo de pago por defecto (enlace de pago por defecto)

Identificar el nombre de dominio predeterminado para que coincida con la ventana de pago Paddle con su sitio:

1. Desde el menú izquierdo del rejilla **Salida** abre el encabezado **Configuración de control** a la página.

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

> [card] 1. Configuración de salida
>
> Open Checkout page from left menu.

2. **Ajustes** Situado en la pestaña **Enlace de pago predeterminado** Introduzca la dirección de aviso de su sitio **Guardar** Guardar con:
   ```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-es.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=a1f996c6755d401aa02daa5fc268daa9)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-01b-default-payment-link-es.png)

> [card] 1. Enlace de pago por incumplimiento
>
> `https://siteniz.com/process/paddle` Guarda la dirección.

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

Prepare sus valores de clave y token para comunicarse con el Paddle API de su sitio y abra la ventana de pago:

1. Debajo del menú izquierdo del rejín **Ajustes** parte abierta y abierta **DEVELOPER TOOLS** Desde **Imprint** Haga clic en la pestaña.

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

> [card] 1. Autenticación
>
> Switch to Developer Tools → Página de autenticación bajo Ajustes.

2. Remaches por página **Nueva llave API** Pulse en el botón.
3. Dar su llave en el formulario pop-up (por ejemplo, `Zonely`).
4. **Expires at** para mantener la clave activa en el campo **Nunca se gasta** Seleccione opción.

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

> [card] 1. Nombre clave
>
> Give tu nombre de clave Zonely.

> [card] 2. Nunca se gastan
>
> Select Nunca expira por su validez sin tiempo.

5. **Etiquetas** en la sección **Todos** Encuentra el grupo. Para hacer que tu sitio inicie el pago y verificar pedidos **Leer más** y **AaUppercase** Compruebe ambos permisos y guardar el interruptor.

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

> [card] 1. Grupo de Autorización: Todos
>
> Seleccione toda la línea de autorización.

> [card] 2. Leer & Escribir
>
> Leer y guardar dos de los cuadros de Escribe por marcación.

6. Llavero API en vivo desde la ventana a la pantalla (`pdl_live_apikey_...`) Copia y copia en su panel de gestión Zonely **API Key** Pruébelo en el campo.

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

> [card] 1. Copia clave de API
>
> `pdl_live_apikey_` Pega el panel copiando la tecla comenzando con.

7. Página **Imprint** de las pestañas superiores **fichas de cliente lado** Haga clic en la ficha.

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

> [card] 1. Resultados del lado del cliente
>
> Desde las pestañas superiores hasta el área de fichas lado del cliente.

8. Tres puntos a la derecha del token activo en la lista (`...`) menú abierto y abierto **Copiado** Haga clic en el botón. Copiar `live_` Abra la tecla del navegador con Zonely en su panel de gestión **Token lado del cliente** Pruéelo en el campo.

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

> [card] 1. Copia de la ficha
>
> Copiar el token en vivo con la opción Copiar token desde el menú de tres puntos.

## 3. Creación de productos y adquisición de valor de identificación de productos

Se debe crear un producto para iniciar el pago en la infraestructura Paddle y se debe tomar el ID de este producto (**ID de producto**):

1. Menú izquierdo **Catálogo** Bajo el encabezado **Home** Haga clic en la pestaña.

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

> [card] 1. Menú de productos
>
> Ir al catálogo → Lista de productos desde el menú izquierdo.

2. En la esquina superior **+ Nuevo producto** Haga clic en el botón.
3. Rellene la información del producto en el formulario pop-up:
   * **Nombre del producto:** Introduzca el nombre del producto (por ejemplo, `Kredi`).
   * **Categoría fiscal:** Para Productos Digitales `Standard digital goods` Seleccionar categoría.

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

> [card] 1. Nombre del producto
>
> Nombre del producto `Kredi` Ingrese como

> [card] 2. Categoría fiscal
>
> `Standard digital goods` Seleccionar categoría.

4. **Guardar** Guardar el producto pulsando el botón.

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

> [card] 1. Salve
>
> Click Guardar botón para guardar el producto.

5. Situado en la página de detalles del producto creado `pro_` Inicio con **ID de producto** valor de copia y copiar el valor en el panel de gestión Zonely **ID de producto** Paste en la caja.

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

> [card] 1. ID del producto Copiado
>
> `pro_` Copia el ID del producto empezando por.

## 4. Configurar notificaciones Webhook

Abrir registro de Webhook en el panel Paddle para transferir pagos al instante a su sitio:

1. Situado en el menú izquierdo del rejilla **Noticias** Bajo el encabezado **Noticias** Haga clic en la ficha.

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

> [card] 1. Notificaciones
>
> Open Notifications pestaña del menú Eventos.

2. En la página que abre **Nuevo destino** Haga clic en el botón.
3. Llenar los ajustes de notificación:
   * **Tipo de notificación:** **webhook** Compruebe la opción.
   * **URL:** Introduzca la dirección de aviso de su sitio:
     ```txt theme={"theme":"css-variables"}
     https://siteniz.com/process/paddle
     ```
   * **Descripción:** Escribe una descripción de este objetivo (por ejemplo... `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-es.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=f78275fc72798ca711918d8e0425cbaf)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-11-new-destination-es.png)

> [card] 1. Tipo de notificación
>
> Check Webhook opción.

> [card] 2. URL de punto final
>
> `https://siteniz.com/process/paddle` escriba la dirección.

> [card] 3. Descripción
>
> Enter una descripción para su servidor.

4. Menú **Tipo de uso** **plataforma** Select.
5. **Noticias** Para asegurar que su sitio esté terminado y capturar completamente los movimientos de cuenta **Todos** Compruebe la caja y ahorre la meta.

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

> [card] 1. Tipo de uso
>
> Select Platform option.

> [card] 2. Todos
>
> Check Toda la caja para obtener todos los eventos de notificación.

6. Haga clic en el objetivo creado de Webhook **Noticias** Introduzca la opción.
7. En la ventana que abre `pdl_ntfset_` Comience con **Secret Key** valor de copia y copie el valor en el panel de gestión Zonely **Webhook Secret** Pegue en la caja.

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

> [card] 1. La clave secreta
>
> `pdl_ntfset_` Pega el campo Secreto Webhook copiando la clave comenzando con.

## Conecta el aviso de pago

Registro de pagos **Editar** con abierto y **Retroalimentación URL** Copiar toda la dirección. Actualizar el área URL del enlace de notificación que creó en el Paddle con esta dirección completa. Enlace **Secret Key** valor en Zonely **Webhook Secret** debe estar registrado en el campo.

> [!TIP]
>
> **API Key** con **Token lado del cliente** diferente. No escriba el servidor API clave en el campo de clave del navegador. Panel de administración **Prueba de conexión** El botón verifica el producto y el acceso API.

Este enlace es para una colección única. El importe de pago se prepara según el pedido y el impuesto incluidos. Pagos completados **Tienda → Pagos** Siga la sección.

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


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