GitHub Entitlement

​

Apa yang Diberikan

• Pelanggan diundang ke repositori GitHub Anda melalui alur OAuth yang menghubungkan akun GitHub mereka ke pembelian.
• Setelah mereka menerima, GitHub memberikan mereka akses kolaborator pada tingkat izin yang dikonfigurasikan.
• Pembatalan, pengembalian dana, atau pencabutan manual menghapus kolaborator.

​

Hubungkan GitHub

1

Open Entitlements

Di dashboard Dodo Payments Anda, buka Entitlement dan klik + untuk memulai hak baru.

2

Pick GitHub

Pilih Akses GitHub sebagai integrasi. Jika GitHub belum terhubung, Anda akan diminta untuk Menghubungkan GitHub.

Mengklik akan membuka GitHub di tab baru. Masuk, kemudian pasang Dodo Payments GitHub App pada organisasi atau akun pengguna yang memiliki repositori. Anda dapat memberikan akses ke semua repositori atau hanya yang ingin Anda batasi.

Ketika GitHub mengarahkan kembali, Anda akan melihat konfirmasi bahwa akun telah terhubung.

3

Pick a repository and permission

Kembali ke dashboard, pilih repositori yang harus diberikan hak akses dan pilih tingkat izin. Pemilih repositori hanya menampilkan repositori yang dapat diakses Aplikasi GitHub. Berikan hak nama dan klik Buat Hak.

4

Save the entitlement

Simpan dan lampirkan hak kepada produk apa pun. Pelanggan yang membeli produk tersebut menerima undangan GitHub saat pengiriman.

​

Tingkat Izin

​

Alur Pelanggan

1. Pelanggan menyelesaikan checkout.
2. Dodo Payments membuat grant dalam status Pending. oauth_url adalah null hingga pelanggan memulai accept flow, dan pada saat itu akan diisi dengan URL otorisasi GitHub.
3. Pelanggan melakukan otorisasi melalui tautan di email atau Customer Portal.
4. Dodo Payments mengundang akun GitHub pelanggan ke repositori dengan izin yang dikonfigurasi. Grant berpindah ke Delivered setelah undangan dibuat.
5. Jika subscription dibatalkan, direfund, atau dicabut, pelanggan dihapus sebagai kolaborator.

​

Konfigurasi yang Diperlukan

​

Buat melalui API

const entitlement = await client.entitlements.create({
  name: 'Code Share Repository',
  integration_type: 'github',
  integration_config: {
    target_id: 'acme/private-sdk',
    permission: 'pull',
  },
});

client.entitlements.create(
    name="Code Share Repository",
    integration_type="github",
    integration_config={
        "target_id": "acme/private-sdk",
        "permission": "pull",
    },
)

client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
  Name:            dodopayments.F("Code Share Repository"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeGithub),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigGitHubConfigParam{
      TargetID:   dodopayments.F("acme/private-sdk"),
      Permission: dodopayments.F("pull"),
    },
  ),
})

​

Webhooks

• entitlement_grant.created dipicu dengan status: "Pending" dan oauth_url masih null; URL otorisasi GitHub diisi setelah pelanggan memulai accept flow dari email delivery atau Customer Portal.
• entitlement_grant.delivered dipicu setelah undangan kolaborator dibuat.
• entitlement_grant.failed dipicu dengan error_code: "github_permission_denied" (atau yang serupa) jika GitHub App kehilangan akses ke repositori.

​

Pemecahan Masalah