GitHub Entitlement

Hak GitHub menambahkan pelanggan berbayar sebagai kolaborator pada repositori pribadi. Anda memilih tingkat izin (pull, push, triage, maintain, atau admin) dan Dodo Payments menangani undangan, pelacakan penerimaan, dan penghapusan saat pembatalan.

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.

Penggunaan umum termasuk produk berbasis sumber, template berbayar, repo kode kursus, dan SDK klien terbatas.

Hubungkan GitHub

Open Entitlements

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

Pick GitHub

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

Panel hak baru meminta pedagang untuk menghubungkan GitHub — Connect GitHub prompt before the install handoff.

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.

Halaman Instal dan Otorisasi GitHub dengan opsi Semua repositori dan Hanya pilih repositori — GitHub Install & Authorize page — choose which repositories the app can manage.

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

Halaman konfirmasi berhasil terhubungnya Akses GitHub — Account connected — return to the Dodo Payments dashboard to continue.

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.

Formulir hak GitHub dengan Akses GitHub terhubung, pemilih repositori, dropdown izin, dan bidang nama — Creating a GitHub entitlement. Pick the repository and the permission you want customers to receive.

Save the entitlement

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

Tingkat Izin

Izin repositori standar GitHub berlaku:

Izin	Terbaik untuk
`pull`	Akses hanya baca. Pelanggan dapat mengkloning, mengambil, dan melihat repo.
`triage`	Akses baca ditambah kemampuan mengelola isu dan pull request.
`push`	Akses baca + tulis. Pelanggan dapat mendorong cabang dan membuka pull request.
`maintain`	Akses dorong ditambah pengelolaan pengaturan repositori (kecuali yang sensitif).
`admin`	Kontrol penuh repositori. Gunakan dengan hati-hati.

Berikan izin paling sedikit yang sesuai dengan kasus penggunaan Anda. Sebagian besar skenario konten berbayar hanya memerlukan pull.

Alur Pelanggan

Pelanggan menyelesaikan checkout.
Dodo Payments membuat grant dengan status Pending dan oauth_url untuk memungkinkan pelanggan menautkan akun GitHub mereka.
Pelanggan memberikan otorisasi melalui tautan di email atau customer portal mereka.
Dodo Payments mengundang akun GitHub pelanggan ke repository dengan izin yang dikonfigurasi. Grant berubah menjadi Delivered setelah undangan dibuat.
Jika subscription dibatalkan, dikembalikan dananya, atau dicabut, pelanggan dihapus sebagai collaborator.

Konfigurasi yang Diperlukan

Bidang	Diperlukan	Deskripsi
`target_id`	Ya	Repositori untuk mengundang pelanggan. Pemilih repositori dashboard mengisinya untuk Anda.
`permission`	Ya	Salah satu dari `pull`, `push`, `triage`, `maintain`, `admin`.

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

Event webhook standar entitlement_grant.* mencakup alur GitHub:

entitlement_grant.created mencakup oauth_url untuk otorisasi GitHub.
entitlement_grant.delivered aktif setelah undangan kolaborator dibuat.
entitlement_grant.failed aktif dengan error_code: "github_permission_denied" (atau serupa) jika Aplikasi GitHub kehilangan akses ke repositori.

Pemecahan Masalah

Repository picker is empty

Aplikasi Dodo Payments GitHub harus dipasang pada organisasi atau pengguna yang memiliki repositori. Buka Entitlement → Integrations → GitHub dan pasang ulang aplikasi tersebut, pastikan memberikan akses ke repositori yang relevan.

Grant fails with permission_denied

Instalasi Aplikasi GitHub tidak lagi memiliki akses ke repositori, atau repositori tersebut telah diubah/ditransfer. Berikan akses ulang kepada aplikasi tersebut dan pemberian akses berikutnya akan berhasil.

Customer hasn't accepted the invite

Pelanggan harus menerima undangan GitHub dari halaman notifikasi mereka atau dengan mengeklik tautan di email. Sampai mereka menerimanya, status mereka tetap “diundang”, tetapi mereka tidak dapat melakukan clone pada repo. Grant tetap oauth_url dari sudut pandang Dodo Payments; undangan itulah yang kami keluarkan.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Apa yang Diberikan

Hubungkan GitHub

Tingkat Izin

Alur Pelanggan

Konfigurasi yang Diperlukan

Buat melalui API

Webhooks

Pemecahan Masalah

​Apa yang Diberikan

​Hubungkan GitHub

​Tingkat Izin

​Alur Pelanggan

​Konfigurasi yang Diperlukan

​Buat melalui API

​Webhooks

​Pemecahan Masalah

Apa yang Diberikan

Hubungkan GitHub

Tingkat Izin

Alur Pelanggan

Konfigurasi yang Diperlukan

Buat melalui API

Webhooks

Pemecahan Masalah