Notion Entitlement

​

Yang Dikirimkan

• Pelanggan menghubungkan workspace Notion mereka dari Customer Portal. Email konfirmasi pembayaran menandai entitlement sebagai Action Required dan menyediakan tautan ke portal.
• Setelah mereka memberikan otorisasi, Dodo Payments menyalin template yang dikonfigurasi ke halaman yang dibagikan pelanggan selama proses otorisasi, di workspace yang mereka pilih.
• Saat grant dicabut, salinan tetap berada di workspace pelanggan. Dodo Payments menandai grant sebagai Revoked untuk pencatatan dan tidak menghapus salinannya.

​

Hubungkan Notion

1

Open Entitlements

Di dashboard Dodo Payments, buka Entitlements lalu klik +.

2

Pick Notion

Pilih Notion Template sebagai integrasi. Jika Notion belum terhubung, klik Connect Notion.

Notion terbuka di tab baru. Masuk ke workspace yang memiliki template sumber Anda dan tinjau izin yang diminta Dodo Payments. Lalu pilih halaman (template) yang dapat dibaca dan disalin oleh integrasi.

Saat Notion mengarahkan kembali, halaman konfirmasi menampilkan bahwa workspace telah terhubung.

3

Pick a Template

Kembali ke dashboard, pilih template yang akan disalin di bagian Template. Hanya halaman yang Anda bagikan pada langkah sebelumnya yang akan muncul di sini. Masukkan Name untuk entitlement lalu klik Create Entitlement.

4

Attach It to a Product

Lampirkan entitlement ke produk apa pun. Lihat Melampirkan Entitlement ke Produk.

​

Alur Pelanggan

1. Pelanggan menyelesaikan checkout.
2. Dodo Payments membuat grant dalam status Pending. Dodo Payments segera mencoba membuat URL otorisasi Notion dan menyimpannya di oauth_url. Jika gagal, oauth_url tetap null hingga pelanggan memulai alur penerimaan.
3. Di Customer Portal, pelanggan mengeklik Connect pada entitlement, memberikan otorisasi dengan Notion, memilih workspace untuk menerima template, dan membagikan setidaknya satu halaman kepada Dodo Payments.
4. Dodo Payments menyalin template ke halaman bersama di workspace tersebut. Grant berpindah ke Delivered.
5. Saat pencabutan, grant ditandai sebagai Revoked, dan salinannya tetap berada di workspace pelanggan.

​

Konfigurasi yang Diperlukan

​

Membuat melalui 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 dipicu dengan status: "Pending". oauth_url mungkin sudah berisi URL otorisasi Notion. Jika nilainya null, URL tersebut diisi setelah pelanggan memulai alur penerimaan dari Customer Portal.
• entitlement_grant.delivered dipicu setelah template disalin.
• entitlement_grant.revoked dipicu saat pembatalan. Salinan pelanggan tidak diubah.

​

Pemecahan Masalah