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

> Conecte sua conta de faturamento de remo, prepare produto, janela de pagamento e configurações 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)

Você pode receber um pagamento com Paddle A janela de pagamento abre pela Paddle Verifique sua conta, endereço do site e produtos que você vende para uso ao vivo para Paddle.

> [!NOTE]
>
> `transaction_checkout_not_enabled` O erro indica que o recurso de checkout em seu Paddle Verifique o status da verificação da conta. Paddle Painel e completas etapas de apoio.

## Modelo e garantia

Paddle Billing, a empresa líder mundial **Vendedor registrado (Mercante de Registro - MoR)** uma das infraestruturas:

* **O vendedor oficial é Paddle.com:** Quando seu jogador recebe crédito ou produto, você pode vender diretamente a fatura Paddle.com Market Ltd. edita. VAT (VAT) e as interrupções do imposto de vendas de acordo com o país do comprador estão no financeiro do país relacionado com sua entidade jurídica.
* **Fácil para desenvolvedores individuais:** O dono do servidor não precisa cortar uma conta eletrônica ou montar uma empresa para cada venda.
* [Paddle](https://www.paddle.com/help/start/account-verification/what-is-account-verification): A disponibilidade e os repasses dependem dos países atendidos e da aprovação da conta pelo provedor. Antes de publicar, confira os requisitos de verificação e os termos da sua conta.

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

> [card] Chave de API 1.
>
> Entrar a chave pdl live apikey  de sua conta ao vivo.

> [card] ID do produto 2.
>
> Entrar a identificação começando com o pro  do produto.

> [card] 3. Webhook Secret
>
> Entrar o valor chave secreto do link de notificação de pá.

> [card] 4- Token do lado do cliente
>
> Digite o Token do lado do cliente, começando com live  de sua conta ao vivo.

> [card] 5. Meio ambiente.
>
> Selecione ao vivo para a coleção real.

> [!NOTE]
>
> Os produtos, endereços de aviso e API Os interruptores de ambientes vivos e de teste na pá são completamente independentes uns dos outros. Paddle Painel de gestão para fazer uma coleção real e estão em Zonely Painel **Viva** Certifique-se de que o ambiente está selecionado.

## Defina o padrão de pagamento Link (Padrão de pagamento Link)

Identifique o nome de domínio padrão para combinar a janela de pagamento Paddle com seu site:

1. Do menu esquerdo do remo **Checkout** abra o cabeçalho **Configuração de saída** para a página.

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

> [card] Configuração de checkout
>
> Open Checkout página de configuração do menu esquerdo.

2. **Configurações** Localizado na aba **Ligação de pagamento padrão** digite o endereço de aviso prévio do seu site **Salve** Save com:
   ```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-pt-BR.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=c929f3d8df7c10e2f22be12277a350ff)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-01b-default-payment-link-pt-BR.png)

> [card] Ligação de pagamento padrão
>
> `https://siteniz.com/process/paddle` Guarde o endereço.

## 2. Live API Key e Token Token do lado do cliente recebendo

Prepare seus valores chave e token para se comunicar com Paddle API do seu site e abrir a janela de pagamento:

1. Abaixo do menu esquerdo do remo **Configurações** abrir e abrir parte **DEVELOPER TOOLS** de **Imprint** Clique na guia.

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

> [card] Autenticação.
>
> Switch to Developer Tools → Authentication page under Settings.

2. Linhas por página **Nova chave API** Clique no botão.
3. Dê sua chave no formulário pop-up (ex. `Zonely`).
4. **Expira em** para manter a chave ativa no campo **Nunca Despesas** opção Select.

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

> [card] Nome da chave.
>
> Dê seu nome chave Zonely.

> [card] Nunca se pode pagar despesas.
>
> Selecione Nunca expira para sua validade intemporal.

5. **Etiquetas** na seção **Todos.** Encontre o grupo para fazer seu site começar o pagamento e verificar as ordens **Leia mais** e **AaUppercase** Verifique as permissões e salve o interruptor.

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

> [card] Grupo de Autorização:
>
> Selecione toda a linha de autorização.

> [card] 2. Leia e escreva.
>
> Leia e salve duas das boxlets de gravação marcando.

6. Chave API ao vivo da janela para exibição (`pdl_live_apikey_...`) Copie e copie no seu painel de gerenciamento Zonely **API Chave** Cole-o no campo.

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

> [card] API Key Copy
>
> `pdl_live_apikey_` Colar o painel copiando a chave começando com.

7. **Imprint** página de topo **Tokens do lado do cliente** Clique na aba.

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

> [card] 1o. Tokens do lado do cliente.
>
> Das abas superiores para a área de fichas do lado do cliente.

8. Três pontos à direita do token ativo na lista (`...`) abrir e abrir menu **Copiando o símbolo.** Clique no botão. Copie `live_` iniciar chave do navegador com Zonely em seu painel de gestão **Token do lado do cliente** colá-lo no campo.

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

> [card] Entendido.
>
> Copie o token ao vivo com a opção de copiar token do menu de três pontos.

## 3. Criação de produtos e aquisição de valor de identificação de produto

Um produto deve ser criado para começar o pagamento na infraestrutura Paddle e a identificação deste produto (**ID do produto**) deve ser tomada:

1. 1 Menu esquerdo **Catálogo** Sob o cabeçalho **Casa** Clique na aba.

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

> [card] Menu de Produtos 1.
>
> Ir para o catálogo → Página de produtos do menu esquerdo.

2. No canto superior **+ Novo produto** Clique no botão.
3. Preencha informações do produto no formulário pop-up:
   * **Nome do produto:** Digite o nome do produto (por exemplo, `Kredi`).
   * **Categoria fiscal:** para produtos digitais `Standard digital goods` categoria Select.

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

> [card] Nome do produto
>
> Nome do produto `Kredi` Digite-o como

> [card] 2. Categoria de impostos.
>
> `Standard digital goods` Selecione a categoria.

4. **Salve** Salve o produto pressionando o botão.

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

> [card] -Economize.
>
> Clique no botão Salvar para salvar o produto.

5. Localizado na página de detalhes do produto criado `pro_` Iniciar com **ID do produto** copiar o valor no Zonely painel de gestão **ID do produto** colar na caixa.

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

> [card] ID do produto, copiado.
>
> `pro_` Copie a identificação do produto começando com.

## 4. Configure notificações de hook web

Abra o registro do webhook no painel Paddle para transferir instantaneamente pagamentos para o seu site:

1. Localizado no menu esquerdo da pá **Notícias** Sob o cabeçalho **Notícias** Clique na aba.

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

> [card] Notificações
>
> Abra a guia Notificações do menu Eventos.

2. Na página que abre **Novo destino** Clique no botão.
3. Preencha as configurações de notificação:
   * **Tipo de notificação:** **Webhook** Verifique a opção.
   * **URL:** Digite o endereço de aviso do seu site:
     ```txt theme={"theme":"css-variables"}
     https://siteniz.com/process/paddle
     ```
   * **Descrição:** Escreva uma descrição para este objetivo (por exemplo... `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-pt-BR.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=be0bbb02471871fe47266ae6db03fc71)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-11-new-destination-pt-BR.png)

> [card] Tipo de Notificação
>
> Check Webhook opção.

> [card] URL de ponto final
>
> `https://siteniz.com/process/paddle` digite o endereço.

> [card] Descrição
>
> Entrar uma descrição para o seu servidor.

4. **Tipo de uso** menu **plataforma** Selecione.
5. **Notícias** para garantir que seu site esteja completo e capture completamente os movimentos da conta **Todos.** Verifique a caixa e salve o objetivo.

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

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

> [card] Todos
>
> Marque todas as caixas para receber todos os eventos de notificação.

6. Clique no alvo criado do webhook **Notícias** Digite a opção.
7. Na janela que abre `pdl_ntfset_` Comece com **Chave secreta** valor de cópia e copie o valor no Zonely painel de gestão **Segredo do Webhook** Colar na caixa.

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

> [card] Chave secreta.
>
> `pdl_ntfset_` Colar o campo secreto Webhook copiando a chave começando com.

## Conecte o aviso de pagamento

Registro de pagamento **Editar** com aberto e **Chamada de volta URL** Copiando todo o endereço. URL área da ligação de notificação que você criou no Paddle com este endereço completo. **Chave secreta** Valor em Zonely **Segredo do Webhook** Devem estar registrados no campo.

> [!TIP]
>
> **API Chave** com **Token do lado do cliente** diferente. Não escreva a chave do servidor API para o campo chave do navegador. Painel de gerenciamento **Ligação de Teste** O botão verifica o produto e acesso API.

Este link é para coleta única, o valor do pagamento é preparado de acordo com a ordem e os impostos incluídos, pagamentos completados **Loja → Pagamentos** siga a seção.

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


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