Notion Entitlement

Duplique um template do Notion no espaço de trabalho do cliente quando ele comprar.

A autorização do Notion duplica um template que você preparou no espaço de trabalho do cliente pagante. O cliente autoriza através de OAuth, escolhe o espaço de trabalho no qual deseja que o template seja copiado, e o Dodo Payments gerencia a duplicação.

​

O que é entregue

• O cliente é solicitado a conectar seu espaço de trabalho do Notion via OAuth.
• Uma vez autorizado, o Dodo Payments duplica o template configurado no espaço de trabalho que ele escolheu.
• Em caso de cancelamento, o template duplicado permanece no espaço de trabalho do cliente (o Notion não suporta exclusão remota). A concessão é marcada como revoked para manutenção de registros.

Usos comuns incluem templates pagos do Notion, sistemas de produtividade e templates de OS/CRM.

​

Conectar Notion

1. Open Entitlements

   No seu dashboard do Dodo Payments, vá para Entitlements e clique em +.

2. Pick Notion

   Escolha Notion Template como a integração. Se o Notion ainda não estiver conectado, você será solicitado a Conectar Notion.

   

   Connect Notion prompt before the OAuth handoff.

   Clicar abre o Notion em uma nova aba. Faça login no espaço de trabalho que possui seus templates de origem, revise as permissões que o Dodo Payments solicita, e depois escolha as páginas (templates) que a integração pode ler e duplicar.

   

   Notion OAuth: review permissions, then pick the template pages to share.

   Quando o Notion redirecionar de volta, você verá uma confirmação de que o espaço de trabalho está conectado.

   

   Workspace connected — return to the Dodo Payments dashboard to continue.

3. Pick a template

   De volta ao dashboard, selecione o template para duplicar no seletor de templates. Apenas páginas que você autorizou na etapa anterior aparecem aqui. Dê um nome à autorização e clique em Criar Autorização.

   
4. Save the entitlement

   Salve e anexe a qualquer produto.

​

Fluxo do cliente

1. O cliente conclui o checkout.
2. O Dodo Payments cria uma concessão em status pending com um Notion oauth_url para que o cliente conecte seu espaço de trabalho.
3. O cliente autoriza através do link em seu e-mail ou portal do cliente e escolhe o espaço de trabalho no qual deseja que o template seja duplicado.
4. O Dodo Payments duplica o template. A concessão é movida para delivered.
5. Na revogação, a concessão é marcada como revoked; a cópia duplicada permanece no espaço de trabalho do cliente.

O Notion trata intencionalmente uma página duplicada como conteúdo próprio do destinatário. O Dodo Payments não pode excluir a cópia em caso de revogação.

​

Configuração necessária

Campo	Obrigatório	Descrição
notion_template_id	Sim	O ID do template. O seletor do dashboard preenche isso.

​

Criar via API

TypeScript

const entitlement = await client.entitlements.create({
  name: 'Study Notes',
  integration_type: 'notion',
  integration_config: {
    notion_template_id: 'tmpl_abc123',
  },
});

client.entitlements.create(
    name="Study Notes",
    integration_type="notion",
    integration_config={"notion_template_id": "tmpl_abc123"},
)

client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
  Name:            dodopayments.F("Study Notes"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeNotion),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigNotionConfigParam{
      NotionTemplateID: dodopayments.F("tmpl_abc123"),
    },
  ),
})

​

Webhooks

Veja eventos de webhook entitlement_grant.*:

• entitlement_grant.created inclui o Notion oauth_url.
• entitlement_grant.delivered dispara assim que o template é duplicado.
• entitlement_grant.revoked dispara no cancelamento; a cópia do cliente permanece intocada.

​

Solução de problemas

Customer didn't get the template

A concessão permanece pending até que o cliente complete o OAuth do Notion. Reenvie o e-mail de entrega; o link OAuth expira após uma semana, após a qual você pode revogar e recriar a concessão.

Template picker is empty

Reconecte o Notion de Entitlements → Integrations → Notion com o espaço de trabalho que possui os templates de origem.

Customer wants the template removed after refund

O Notion não permite a exclusão remota de páginas duplicadas. O cliente deve excluir a cópia de seu próprio espaço de trabalho.