導入

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.

​

特権とは何ですか？

​

利用可能な統合

​

付与の仕組み

​

付与のライフサイクル

​

イベントごとの付与の動作

​

最初の特権を作成する

1

Open Entitlements

Dodo Paymentsのダッシュボードで特権に移動し、**+**をクリックして新しい特権を作成します。

2

Pick an integration

統合タイプを選択します：ライセンスキー、デジタルファイル、Discord、GitHub、Telegram、Framer、またはNotion。プラットフォームの統合については、まだアカウントを接続していない場合は最初に接続してください。

3

Configure delivery

統合固有のフィールドを記入します。例えば、GitHubはリポジトリと権限レベルを問い合わせ、Discordはサーバーとオプションの役割を問い合わせ、ライセンスキーはアクティベーション制限と期限を問い合わせます。

4

Save

特権を保存します。これで、任意の製品に添付できるようになりました。

​

特権を製品に添付する

​

顧客体験

​

メールと顧客ポータル

​

OAuthベースの配信

​

取り消し

​

付与を管理する

import DodoPayments from 'dodopayments';

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

// List grants for an entitlement
const grants = await client.entitlements.grants.list('ent_abc123', {
  status: 'delivered',
});

// Revoke a single grant
await client.entitlements.grants.revoke('grant_xyz789', {
  path_id: 'ent_abc123',
});

​

API管理

​

Webhooks

​

ベストプラクティス

• 1つの配信チャンネルにつき1つの特権を使用する。 異なる役割目的を持つ製品間で同じDiscord特権を共有しないでください; きれいな取り消しのために役割ごとに1つ作成してください。
• 最初にテストモードで試す。 特権を作成し、テスト製品に添付し、チェックアウトを実行し、付与がpending → deliveredを経て移行するのを観察します。テストサブスクリプションの取り消しが付与を取り消すことを確認します。
• entitlement_grant.deliveredを聞く、payment.succeededではない。 支払いは履行が終了する前に成功することがあります（特にOAuthフローの場合）。配信済みイベントを待ってから、自分のシステムで依存する機能を解除してください。
• entitlement_grant.failedを実行可能なものとして扱う。 失敗した付与は、顧客が支払ったがアクセスを得られなかったことを意味します。これをサポートチームに伝えたり、再付与をトリガーしてください。
• revocation_reasonを保持フローにマップする。 subscription_on_holdの取り消しは修復可能です（顧客はカードを更新するかもしれません）。manualの取り消しは意図的です。顧客コミュニケーションでそれらを異なるに扱います。