# credit-based-billing

Скилл для биллинга на кредитах в Dodo Payments: пулы, гранты, списания по метрикам, перенос остатка и оверэдж.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 655 установок · ★ 12
- Автор: dodopayments
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/dodopayments/skills/tree/HEAD/dodo-payments/credit-based-billing/SKILL.md
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/skills/credit-based-billing

## Что делает

Скилл описывает, как собрать предоплаченный биллинг для токенов, вызовов API, вычислений или денежного баланса. Кредитный пул создаётся через `client.creditEntitlements.create(...)`, а каждое начисление оформляется грантом — из подписки, разового продукта, промо или переноса остатка. Расход списывается с баланса, и на каждую операцию пишется запись в леджере с `balance_before` и `balance_after`.

Внутри — таблица выбора модели биллинга, разбор полей создания кредитного пула и пример инициализации TypeScript SDK. Точность единиц задаётся от `0` до `10` и после создания не меняется, поэтому её выбирают до выдачи грантов. Суммы кредитов передаются десятичными строками, а не через числа с плавающей точкой. Продукт может нести до пяти кредитных пулов.

Ключ API держите на сервере: SDK читает `DODO_PAYMENTS_API_KEY`, а окружение задаётся явно — без `environment` клиент уходит в `live_mode`. Для разработки ставьте `test_mode`. Если нужны прямые списания за единицу без предоплаченного пула, это уже другая модель, и скилл сам отсылает к `usage-based-billing`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dodopayments/skills --skill credit-based-billing -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/credit-based-billing/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/credit-based-billing/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dodopayments/skills --skill credit-based-billing -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/credit-based-billing/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dodopayments/skills --skill credit-based-billing -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/credit-based-billing/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dodopayments/skills credit-based-billing
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/credit-based-billing/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dodopayments/skills --skill credit-based-billing -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dodopayments/skills --path dodo-payments/credit-based-billing
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/credit-based-billing/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add dodopayments/skills --skill credit-based-billing -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dodopayments/skills/tree/HEAD/dodo-payments/credit-based-billing/SKILL.md

## Когда брать
- включить ежемесячный лимит кредитов в подписку
- продавать разовые пакеты пополнения
- списывать кредиты за токены или вызовы API по метрике
- начислять промо-кредиты с записью причины
- настроить перенос остатка и срок годности кредитов

## Примеры запросов агенту
- создай кредитный пул для токенов с точностью 0 и сроком годности 30 дней
- покажи баланс и леджер клиента по кредитам
- настрой оверэдж с выставлением счёта в конце периода

## Похожие
- [convex-billing](https://affpapa.org/nevibecode/skills/convex-billing.md) — скилл · 35800 установок
- [cargo-billing](https://affpapa.org/nevibecode/skills/cargo-billing.md) — скилл · 9900 установок
- [billing-automation](https://affpapa.org/nevibecode/skills/billing-automation.md) — скилл · 11245 установок
- [clerk-billing](https://affpapa.org/nevibecode/skills/clerk-billing.md) — скилл · 16900 установок
- [cmux-billing](https://affpapa.org/nevibecode/skills/cmux-billing.md) — скилл · 3700 установок
- [huawei-cloud-billing-scout](https://affpapa.org/nevibecode/skills/huawei-cloud-billing-scout.md) — скилл · 17100 установок

Из того же набора: [dodopayments/skills](https://affpapa.org/nevibecode/by/dodopayments/skills.md) — 3 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md