Notion Entitlement

​

O que é entregue

• O cliente conecta seu espaço de trabalho do Notion pelo Customer Portal. O e-mail de confirmação do pagamento marca o entitlement como Action Required e inclui um link para o portal.
• Depois de autorizar, o Dodo Payments copia o template configurado para uma página compartilhada pelo cliente durante a autorização, no espaço de trabalho escolhido.
• Quando a concessão é revogada, a cópia permanece no espaço de trabalho do cliente. O Dodo Payments marca a concessão como Revoked para fins de registro e não exclui a cópia.

​

Conectar Notion

1

Open Entitlements

No dashboard do Dodo Payments, acesse Entitlements e clique em +.

2

Pick Notion

Escolha Notion Template como integração. Se o Notion ainda não estiver conectado, clique em Connect Notion.

O Notion é aberto em uma nova aba. Entre no espaço de trabalho que contém seus templates de origem e revise as permissões solicitadas pelo Dodo Payments. Em seguida, escolha as páginas (templates) que a integração pode ler e copiar.

Quando o Notion redireciona de volta, uma página de confirmação mostra que o espaço de trabalho está conectado.

3

Pick a Template

De volta ao dashboard, selecione em Template o template a ser copiado. Somente as páginas compartilhadas na etapa anterior aparecem aqui. Insira um Name para o entitlement e clique em Create Entitlement.

4

Attach It to a Product

Anexe o entitlement a qualquer produto. Consulte Anexar Entitlements a produtos.

​

Fluxo do cliente

1. O cliente conclui o checkout.
2. Dodo Payments cria uma concessão com status Pending. Dodo Payments tenta criar imediatamente uma URL de autorização do Notion e a armazena em oauth_url. Se isso falhar, oauth_url permanece como null até que o cliente inicie o fluxo de aceitação.
3. No Customer Portal, o cliente clica em Connect no entitlement, autoriza com o Notion, escolhe o workspace que receberá o template e compartilha pelo menos uma página com Dodo Payments.
4. Dodo Payments copia o template para uma página compartilhada nesse workspace. A concessão muda para Delivered.
5. Após a revogação, a concessão é marcada como Revoked, e a cópia permanece no workspace do cliente.

​

Configuração necessária

​

Criar via API

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode',
});

const entitlement = await client.entitlements.create({
  name: 'Study Notes',
  integration_type: 'notion',
  integration_config: {
    notion_template_id: '3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c',
  },
});

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

entitlement = client.entitlements.create(
    name="Study Notes",
    integration_type="notion",
    integration_config={"notion_template_id": "3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c"},
)

// client is a *dodopayments.Client, for example from
// dodopayments.NewClient(option.WithEnvironmentTestMode()); ctx is a context.Context.
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("3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c"),
    },
  ),
})

​

Webhooks

• entitlement_grant.created é acionado com status: "Pending". oauth_url pode já conter a URL de autorização do Notion. Se for null, ela será preenchida quando o cliente iniciar o fluxo de aceitação pelo Customer Portal.
• entitlement_grant.delivered é acionado depois que o template é copiado.
• entitlement_grant.revoked é acionado quando ocorre um cancelamento. A cópia do cliente permanece inalterada.

​

Solução de problemas