소개

​

Entitlement란 무엇인가요?

​

사용 가능한 통합

​

승인 방식

​

승인 생명주기

​

Event별 Grant 동작

​

첫 Entitlement 만들기

1

Open Entitlements

Dashboard에서 Entitlements로 이동한 다음 **+**를 클릭하여 entitlement를 생성합니다.

2

Pick an Integration

Integration type을 선택합니다: License Key, Digital Files, Feature Flag, Discord, GitHub, Telegram, Figma, Framer 또는 Notion. Platform integration의 경우 아직 연결하지 않았다면 먼저 계정을 연결하세요.

3

Configure Delivery

Integration에 필요한 필드를 입력합니다. 예를 들어 GitHub는 repository와 permission level을 요구하고, Discord는 server와 선택적 role을 요구하며, License Key는 activations limit과 license length를 요구합니다.

4

Save

Create Entitlement를 클릭합니다. 이제 모든 product에 entitlement를 연결할 수 있습니다.

​

Product에 Entitlement 연결하기

​

고객 경험

​

Email 및 Customer Portal

​

OAuth 기반 전달

​

철회

​

Grant 관리

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('entg_xyz789', {
  id: 'ent_abc123',
});

# Assumes client = DodoPayments(bearer_token=os.environ["DODO_PAYMENTS_API_KEY"])
grants = client.entitlements.grants.list(
    "ent_abc123",
    status="Delivered",
)

client.entitlements.grants.revoke(
    "entg_xyz789",
    id="ent_abc123",
)

// Assumes client := dodopayments.NewClient() and ctx := context.Background().
grants, err := client.Entitlements.Grants.List(
  ctx, "ent_abc123",
  dodopayments.EntitlementGrantListParams{
    Status: dodopayments.F(dodopayments.EntitlementGrantListParamsStatusDelivered),
  },
)
if err != nil {
  panic(err.Error())
}
fmt.Println(len(grants.Items))

_, err = client.Entitlements.Grants.Revoke(ctx, "ent_abc123", "entg_xyz789")

​

API 관리

​

Webhook

​

Best Practices

• 전달 채널마다 entitlement 하나를 사용하세요. 역할 의도가 서로 다른 product 간에 하나의 Discord entitlement를 공유하지 마세요. 역할마다 entitlement를 하나씩 만들어 철회가 깔끔하게 처리되도록 하세요.
• 먼저 test mode에서 테스트하세요. Entitlement를 생성하고 test product에 연결한 다음 checkout을 실행하여 grant가 Pending에서 Delivered로 변경되는지 확인하세요. 그런 다음 test subscription을 취소하고 grant가 철회되는지 확인하세요.
• payment.succeeded가 아니라 entitlement_grant.delivered를 수신하세요. 특히 OAuth flow에서는 fulfillment가 완료되기 전에 결제가 성공할 수 있습니다. 자체 system에서 종속 feature를 unlock하기 전에 grant가 Delivered 상태가 될 때까지 기다리세요. 자동으로 fulfilled된 license key 또는 feature flag처럼 생성 시 전달되는 grant는 대신 entitlement_grant.created와 status: "Delivered"로 도착합니다.
• entitlement_grant.failed를 조치가 필요한 상태로 처리하세요. Failed grant는 고객이 결제했지만 액세스하지 못했다는 의미입니다. 이러한 grant를 support team에 표시하거나 re-grant를 trigger하세요.
• revocation_reason를 retention flow에 매핑하세요. subscription_on_hold revoke는 고객이 카드를 업데이트할 수 있으므로 복구할 수 있습니다. manual revoke는 의도적인 철회입니다. 고객 메시지에서 이 둘을 다르게 처리하세요.
• subscription.past_due에서 액세스를 철회하지 마세요. 이 event는 grace period를 시작하며 해당 기간이 끝날 때까지 고객이 액세스를 유지합니다. subscription.on_hold 또는 subscription.cancelled를 기다리세요.