AIKraft/AI/Войти
AIKraft/Skills/Биллинг на основе кредитов

Биллинг на основе кредитов

Complete guide for giving customers included, free, prepaid, promotional, or top-up credits using grants, balances, ledger deductions, rollover, expiry, alerts, and overage.

dodopayments official Другое

Что делает навык

Навык обеспечивает биллинг на основе кредитов, позволяя создавать предоплаченные, включенные в подписку или промо-кредиты с использованием системы грантов и неизменяемого реестра (ledger). Он решает задачу учета потребления токенов, API-вызовов или вычислений с возможностью настройки правил списания, переноса остатков и обработки превышения лимитов.

Когда применять

  • Включение ежемесячной нормы кредитов в подписку для автоматического обновления баланса.
  • Продажа разовых пакетов предоплаченных кредитов (top-up) для покрытия сверхлимитного использования.
  • Списание кредитов из пула при потреблении ресурсов (например, токенов модели) через метры.
  • Выдача промо- или компенсационных кредитов клиентам с фиксацией причины в реестре.
  • Настройка правил переноса неиспользованных кредитов (rollover), сроков действия (expiry) и штрафов за превышение (overage).

Как работает

  1. Создать определение кредитной нормы (credit entitlement) через метод client.creditEntitlements.create, указав единицы измерения, точность, правила переноса и обработки превышения.
  2. Привязать созданную кредитную норму к продукту (подписке, разовому платежу или продукту на основе потребления) в интерфейсе или через API.
  3. Запустить процесс оформления заказа через client.checkoutSessions.create, что автоматически создает грант (выдачу кредитов) для клиента.
  4. Для ручного начисления кредитов (например, за промоакции) использовать методы реестра с обязательным ключом идемпотентности.
  5. Проверять текущий баланс и историю транзакций клиента через client.creditEntitlements.balances.retrieve или клиентский ресурс listCreditEntitlements.

Примеры запросов агенту

Создай кредитную норму для токенов с точностью 0, сроком действия 30 дней и разрешением на перенос 25% остатка.
Привяжи существующую кредитную норму к продукту подписки, чтобы клиенты получали новый грант каждый биллинг-цикл.
Проверь текущий баланс и наличие задолженности (overage) для клиента по конкретной кредитной норме.

Что понадобится

  • SDK Dodo Payments с серверным хранением API-ключей (префиксы dodo_test_... или dodo_live_...).

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «credit-based-billing» из репозитория: # https://github.com/dodopayments/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r credit-based-billing/ ~/.claude/skills/credit-based-billing/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.