> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion Entitlement

> Duplikasi template Notion ke dalam ruang kerja pelanggan saat mereka membeli.

<Info>
  Entitlement Notion menduplikasi template yang telah Anda siapkan ke dalam ruang kerja Notion pelanggan yang membayar. Pelanggan mengautentikasi melalui OAuth, memilih ruang kerja yang mereka inginkan template tersebut disalin ke dalamnya, dan Dodo Payments menangani duplikasinya.
</Info>

## Apa yang Dikirimkan

* Pelanggan diminta untuk menghubungkan ruang kerja Notion mereka melalui OAuth.
* Setelah diotorisasi, Dodo Payments menduplikasi template yang dikonfigurasi ke ruang kerja yang mereka pilih.
* Pada pembatalan, template yang diduplikasi tetap ada dalam ruang kerja pelanggan (Notion tidak mendukung penghapusan jarak jauh). Hibah ditandai `revoked` untuk penyimpanan catatan.

Penggunaan umum termasuk template berbayar Notion, sistem produktivitas, dan template OS/CRM.

## Hubungkan Notion

<Steps>
  <Step title="Open Entitlements">
    Di dasbor Dodo Payments Anda, pergi ke **Entitlements** dan klik **+**.
  </Step>

  <Step title="Pick Notion">
    Pilih **Notion Template** sebagai integrasi. Jika Notion belum terhubung, Anda akan diminta untuk **Connect Notion**.

    <Frame caption="Connect Notion prompt before the OAuth handoff.">
      <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/connect-prompt.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=90f1f2a60c96918a8da19665a24fcaca" alt="Panel entitlements baru meminta pedagang untuk menghubungkan Notion" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1133" data-path="images/entitlements/notion/connect-prompt.png" />
    </Frame>

    Mengklik membuka Notion di tab baru. Masuk ke ruang kerja yang memiliki template sumber Anda, tinjau izin yang diminta oleh Dodo Payments, lalu pilih halaman (template) yang diizinkan untuk dibaca dan diduplikasi oleh integrasi.

    <Frame caption="Notion OAuth: review permissions, then pick the template pages to share.">
      <div style={{ display: 'flex', gap: '12px', flexWrap: 'wrap', justifyContent: 'center' }}>
        <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/oauth-permissions.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=957e39812ac19bbf81cceb50f023a14a" alt="Layar izin OAuth Notion untuk Dodo Payments" style={{ maxHeight: '420px', width: 'auto' }} width="2000" height="1121" data-path="images/entitlements/notion/oauth-permissions.png" />

        <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/oauth-select-pages.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=1f8bd414d5900f9d246d96f15877aba1" alt="Pemilih halaman Notion memilih template mana yang dapat diakses oleh Dodo Payments" style={{ maxHeight: '420px', width: 'auto' }} width="2000" height="1138" data-path="images/entitlements/notion/oauth-select-pages.png" />
      </div>
    </Frame>

    Ketika Notion mengarahkan kembali, Anda akan melihat konfirmasi bahwa ruang kerja terhubung.

    <Frame caption="Workspace connected — return to the Dodo Payments dashboard to continue.">
      <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/connected.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=5e526d2cc12c27f526b2a6e469157bd8" alt="Halaman konfirmasi Notion Template terhubung dengan sukses" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1143" data-path="images/entitlements/notion/connected.png" />
    </Frame>
  </Step>

  <Step title="Pick a template">
    Kembali ke dasbor, pilih **template** untuk digandakan dari pemilih template. Hanya halaman yang Anda otorisasi di langkah sebelumnya yang muncul di sini. Berikan entitlement sebuah **nama** dan klik **Create Entitlement**.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/create.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=82a51c79ed0c6937abf866c187673ab7" alt="Formulir entitlement Notion dengan ruang kerja terhubung, pemilih template, dan bidang nama" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1135" data-path="images/entitlements/notion/create.png" />
    </Frame>
  </Step>

  <Step title="Save the entitlement">
    Simpan dan lampirkan ke produk apapun.
  </Step>
</Steps>

## Alur Pelanggan

1. Pelanggan menyelesaikan pembayaran.
2. Dodo Payments membuat hibah dengan status `pending` dengan Notion `oauth_url` untuk pelanggan menghubungkan ruang kerja mereka.
3. Pelanggan mengautentikasi melalui tautan di email atau portal pelanggan dan memilih ruang kerja yang mereka inginkan template diduplikasi ke dalamnya.
4. Dodo Payments menduplikasi template. Hibah berpindah ke `delivered`.
5. Pada pencabutan, hibah ditandai `revoked`; salinan yang diduplikasi tetap ada di ruang kerja pelanggan.

<Note>
  Notion sengaja memperlakukan halaman yang diduplikasi sebagai konten milik penerima. Dodo Payments tidak dapat menghapus salinan saat pencabutan.
</Note>

## Konfigurasi yang Diperlukan

| Field                | Diperlukan | Deskripsi                                |
| -------------------- | ---------- | ---------------------------------------- |
| `notion_template_id` | Ya         | ID template. Pemilih dasbor mengisi ini. |

## Membuat melalui API

<CodeGroup>
  ```typescript TypeScript theme={null} theme={null}
  const entitlement = await client.entitlements.create({
    name: 'Study Notes',
    integration_type: 'notion',
    integration_config: {
      notion_template_id: 'tmpl_abc123',
    },
  });
  ```

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

  ```go Go theme={null} theme={null}
  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"),
      },
    ),
  })
  ```
</CodeGroup>

## Webhooks

Lihat [`entitlement_grant.*` acara webhook](/developer-resources/webhooks/intents/entitlement-grant):

* `entitlement_grant.created` termasuk Notion `oauth_url`.
* `entitlement_grant.delivered` dipicu setelah template diduplikasi.
* `entitlement_grant.revoked` dipicu pada pembatalan; salinan pelanggan dibiarkan tidak terpengaruh.

## Pemecahan Masalah

<AccordionGroup>
  <Accordion title="Customer didn't get the template">
    Hibah tetap `pending` sampai pelanggan menyelesaikan OAuth Notion. Kirim ulang email pengiriman; tautan OAuth berakhir setelah satu minggu, setelah itu Anda dapat mencabut dan membuat ulang hibah.
  </Accordion>

  <Accordion title="Template picker is empty">
    Hubungkan kembali Notion dari **Entitlements → Integrations → Notion** dengan ruang kerja yang memiliki template sumber.
  </Accordion>

  <Accordion title="Customer wants the template removed after refund">
    Notion tidak memungkinkan penghapusan jarak jauh pada halaman yang diduplikasi. Pelanggan harus menghapus salinan dari ruang kerja mereka sendiri.
  </Accordion>
</AccordionGroup>